日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.3-RELEASE-K, 13.0-RELEASE-K から 13.2-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
EM(4) FreeBSD カーネルインタフェースマニュアル EM(4)
名称
em -- Intel(R) PRO/1000 ギガビットイーサネットアダプタドライバ
書式
このドライバをカーネルにコンパイルするためには、次の行を利用者のカーネル
設定ファイルに置きます:
device iflib
device em
もう一つの方法として、ブート時にモジュールとしてドライバをロードするため
には、次の行を loader.conf(5) に置きます:
if_em_load="YES"
解説
em ドライバは、Intel 82540, 82541ER, 82541PI, 82542, 82543, 82544, 82545,
82546, 82546EB, 82546GB, 82547, 82571, 81572, 82573 と 82574 イーサネット
コントローラチップに基づく PCI ギガビットイーサネットアダプタのサポートを
行ないます。
また、em ドライバは、Intel 82575、82576、82580、i21x と i35x に基づいて
PCI PCI Express Gigabit Ethernet アダプタのサポートを行います。
ドライバは、82542 ベースアダプタのほかのすべてで送信/受信チェックサムオフ
ロードとジャンボフレーム (Jumbo Frame) をサポートします。
さらに、それは、82543, 82544 と 82547 コントローラチップに基づいているも
のを除いて、すべてのアダプタで TCP セグメンテーションオフロード (TSO) を
サポートします。ローカライズの目的のための led(4) API を通して em ドライ
バによってサポートされるアダプタの識別 LED を制御することができます。さら
なるハードウェア情報に関しては、ドライバに含まれる README を参照してくだ
さい。
ハードウェア要求条件に関連する質問については、利用者の Intel PRO/1000 ア
ダプタで提供された文書を参照してください。すべてのリストされたハードウェ
ア要求条件は FreeBSD での使用に適用されます。
受信と送信のジャンボフレーム (Jumbo Frame) のサポートはインタフェース MTU
設定によって行なわれます。ifconfig(8) ユーティリティで 1500 バイトより大
きい MTU を選択することは受信と送信のジャンボフレーム (Jumbo Frame) をア
ダプタに設定します。ジャンボフレーム (Jumbo Frame) のための最大の MTU サ
イズは 16114 です。
このドライバは、ハードウェアに補助された VLAN をサポートします。em ドライ
バは、次のメディアタイプをサポートします:
autoselect 速度と二重のための自動交渉を有効にします。
10baseT/UTP 10Mbps オペレーションを設定します。全二重モードを選択するた
めに mediaopt オプションを使用します。
100baseTX 100Mbps オペレーションを設定します。全二重モードを選択するた
めに mediaopt オプションを使用します。
1000baseSX 1000Mbps オペレーションを設定します。全二重モードだけがこの
速度でサポートされます。
1000baseTX 1000Mbps オペレーションを設定します。全二重モードだけがこの
速度でサポートされます。
em ドライバは次のメディアオプションをサポートします:
full-duplex 全二重オペレーションを強制的に設定します。
half-duplex 半二重オペレーションを強制的に設定します。
単にドライバを全二重に設定するために mediaopt を使用します。mediaopt が指
定されないなら、ドライバは半二重をデフォルトとします。
このデバイスの設定についての詳しい情報に関しては、ifconfig(8) を参照して
ください。
ハードウェア
em ドライバは、Intel 82540, 82541ER, 82541PI, 82542, 82543, 82544, 82545,
82546, 82546EB, 82546GB, 82547, 82571, 82572, 82573, 82574, 82575, 82576
と 82580 コントローラチップに基づくギガビットイーサネットアダプタをサポー
トします:
• Intel Gigabit ET Dual Port Server Adapter (82576)
• Intel Gigabit VT Quad Port Server Adapter (82575)
• Intel Single, Dual and Quad Gigabit Ethernet Controller (82580)
• Intel i210 and i211 Gigabit Ethernet Controller
• Intel i350 and i354 Gigabit Ethernet Controller
• Intel PRO/1000 CT Network Connection (82547)
• Intel PRO/1000 F Server Adapter (82543)
• Intel PRO/1000 Gigabit Server Adapter (82542)
• Intel PRO/1000 GT Desktop Adapter (82541PI)
• Intel PRO/1000 MF Dual Port Server Adapter (82546)
• Intel PRO/1000 MF Server Adapter (82545)
• Intel PRO/1000 MF Server Adapter (LX) (82545)
• Intel PRO/1000 MT Desktop Adapter (82540)
• Intel PRO/1000 MT Desktop Adapter (82541)
• Intel PRO/1000 MT Dual Port Server Adapter (82546)
• Intel PRO/1000 MT Quad Port Server Adapter (82546EB)
• Intel PRO/1000 MT Server Adapter (82545)
• Intel PRO/1000 PF Dual Port Server Adapter (82571)
• Intel PRO/1000 PF Quad Port Server Adapter (82571)
• Intel PRO/1000 PF Server Adapter (82572)
• Intel PRO/1000 PT Desktop Adapter (82572)
• Intel PRO/1000 PT Dual Port Server Adapter (82571)
• Intel PRO/1000 PT Quad Port Server Adapter (82571)
• Intel PRO/1000 PT Server Adapter (82572)
• Intel PRO/1000 T Desktop Adapter (82544)
• Intel PRO/1000 T Server Adapter (82543)
• Intel PRO/1000 XF Server Adapter (82544)
• Intel PRO/1000 XT Server Adapter (82544)
ローダ調整変数
カーネルをブートする前に loader(8) プロンプトで、または loader.conf(5) に
格納して調整変数を設定することができます。
hw.em.disable_crc_stripping
CRC フィールドのハードウェアの取り外しを無効にするか、または有効
にします。これは、CRC を取り外すことによって、IPMI 上のリモートア
クセスが、失敗するところで、BMC/IPMI 共有インタフェースで主に役に
立ちます。デフォルトは、0 です(有効にされる)。
hw.em.eee_setting
エネルギー効率イーサネットを無効にするか、または有効にします。デ
フォルトは、1 です (無効)。
hw.em.msix
MSI-X スタイルの割込みを有効にするか、または無効にします。デフォ
ルトは、1 です (有効)。
hw.em.smart_pwr_down
新しいアダプタの機能をスマートに電源を切ることを有効にするか、ま
たは無効にします。デフォルトは、0 です (無効)。
hw.em.sbp
プロミシャス (promiscuous) モードのとき、悪いパケットを表示しま
す。デフォルトは、0 です (オフ)。
hw.em.rxd
ドライバによって割り付けられた受信記述子の数。デフォルト値は、
82547 より新しいアタプタについては、1024 で、古いものについては、
256 です。他のものは、最大 4096 を持つことができますが、82542 と
82543 ベースのアダプタは、最大 256 の記述子を取り扱うことができま
す。
hw.em.txd
ドライバによって割り付けられた送信記述子の数。デフォルト値は、
82547 より新しいアタプタについては、1024 で、古いものについては、
256 です。他のものは、最大 4096 を持つことができますが、82542 と
82543 ベースのアダプタは、最大 256 の記述子を取り扱うことができま
す。
hw.em.rx_int_delay
この値は、1.024 マイクロ秒の単位で受信割り込みの生成をディレイ
(遅く) します。アダプタは、この機能が有効にされている状態でハング
アップするかもしれないので、デフォルト値は 0 です。
hw.em.rx_abs_int_delay
hw.em.rx_int_delay が 0 でなければ、この調整変数は、受信割り込み
が生成される最大のディレイ (遅れ) を制限します。
hw.em.tx_int_delay
この値は、1.024 マイクロ秒の単位で転送割り込みの生成をディレイ
(遅く) します。デフォルト値は 64 です。
hw.em.tx_abs_int_delay
hw.em.tx_int_delay が 0 でなければ、この調整変数は、転送割り込み
が生成される最大のディレイ (遅れ) を制限します。
関連ファイル
/dev/led/em* 識別 LED デバイスノード
使用例
em0 の識別 LED をブリンクします:
echo f2 > /dev/led/em0
再び em0 の識別 LED をオフにします:
echo 0 > /dev/led/em0
診断
em%d: Unable to allocate bus resource: memory 致命的な初期化エラーが発生
しました。
em%d: Unable to allocate bus resource: interrupt 致命的な初期化エラーが
発生しました。
em%d: watchdog timeout -- resetting デバイスがネットワークに応答を止めた
か、またはネットワーク接続 (ケーブル) に関する問題があります。
サポート
一般的な情報とサポートについては、次の Intel サポートウェブサイトに行って
ください。http://support.intel.com
問題がサポートしているアダプタでサポートしているカーネルのリリースされた
ソースコードで識別されるなら、<freebsd@intel.com> に問題に関する具体的な
情報をメールしてください。
関連項目
altq(4), arp(4), iflib(4), led(4), netintro(4), ng_ether(4), polling(4),
vlan(4), ifconfig(8)
歴史
em デバイスドライバは、FreeBSD 4.4 ではじめて登場しました。em は、igb デ
バイスドライバとマージされ、FreeBSD 12.0 の iflib フレームワークに変換さ
れました。
作者
em ドライバは、始めに Intel Corporation <freebsd@intel.com> によって書か
れました。それは、igb ドライバとマージされ、Matthew Macy
<mmacy@mattmacy.io> と Sean Bruno <sbruno@FreeBSD.org> によって iflib フ
レームワークに変換されました。
FreeBSD 12.2 January 30, 2019 FreeBSD 12.2