日本語 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
BXE(4) FreeBSD カーネルインタフェースマニュアル BXE(4)
名称
bxe -- QLogic NetXtreme II Ethernet 10Gb PCIe アダプタドライバ
書式
このドライバをカーネルにコンパイルするためには、次の行を利用者のカーネル
設定ファイルに置きます:
device bxe
もう一つの方法として、ブート時にモジュールとしてドライバをロードするため
には、次の行を loader.conf(5) に置きます:
if_bxe_load="YES"
解説
bxe ドライバは、10Gb チップの QLogic NetXtreme II ファミリに基づいた PCIe
10Gb イーサネットアダプタのサポートを行います。ドライバは、ジャンボフレー
ム、VLAN タグ付け、チェックサムオフロード (IPv4, TCP, UDP, IPv6-TCP,
IPv6-UDP)、MSI-X 割り込み、TCP Segmentation Offload (TSO)、Large Receive
Offload (LRO) と Receive Side Steering (RSS) をサポートします。
ハードウェア
bxe ドライバは、下記を含む 10Gb イーサネットコントローラチップの QLogic
NetXtreme II ファミリに基づいた様々な NIC のサポートを行います:
• QLogic NetXtreme II BCM57710 10Gb
• QLogic NetXtreme II BCM57711 10Gb
• QLogic NetXtreme II BCM57711E 10Gb
• QLogic NetXtreme II BCM57712 10Gb
• QLogic NetXtreme II BCM57712-MF 10Gb
• QLogic NetXtreme II BCM57800 10Gb
• QLogic NetXtreme II BCM57800-MF 10Gb
• QLogic NetXtreme II BCM57810 10Gb
• QLogic NetXtreme II BCM57810-MF 10Gb
• QLogic NetXtreme II BCM57840 10Gb / 20Gb
• QLogic NetXtreme II BCM57840-MF 10Gb
設定
ドライバの振る舞いを調整するるために設定することができる多くの設定パラ
メータがあります。次のシステムブートの間に影響を受ける loader.conf(5)
ファイルによってこれらのパラメータを設定することができます。次のパラメー
タは、ドライバの ALL インスタンスに影響します。
hw.bxe.debug
DEFAULT = 0
ドライバのデフォルトのロギングレベルを設定します。より詳細につい
ては、下記の「診断とデバッグ」セクションを参照してください。
hw.bxe.interrupt_mode
DEFAULT = 2
デフォルトの割り込みモードを設定します: 0=IRQ, 1=MSI, 2=MSIX。
MSIX に設定され、割り付けが失敗するなら、ドライバは、ロールバック
し、MSI の割り付けを試みます。MSI の割り付けが失敗するなら、ドラ
イバは、ロールバックし、固定のレベル IRQ 割り付けを試みます。IRQ
割り付けが失敗するなら、ドライバのロードは、失敗します。MSI/MSIX
で、ドライバは、さらにデフォルト処理ために、もう 1 つの各キューの
ためのベクトルを割り付けることを試みます。
hw.bxe.queue_count
DEFAULT = 4
早いパスパケット処理のキューのデフォルト番号を設定します。1 つの
MSI/MSIX 割り込みベクトルは、キューごとに割り付けられることに注意
してください。
hw.bxe.max_rx_bufs
DEFAULT = 0
キューごとに割り付けられる受信バッファの最大数を設定します。ゼロ
(0) は、すべてのバッファ記述子のための受信バッファを割り付けるこ
とを意味します。デフォルトで、これは、この設定パラメータのための
最大値であるキューごとの 4080 のバッファと一致します。
hw.bxe.hc_rx_ticks
DEFAULT = 25
受信パスで一体化するホスト割り込みのためにチックの数を設定しま
す。
hw.bxe.hc_tx_ticks
DEFAULT = 50
受信パスで一体化するホスト割り込みのためにチックの数を設定しま
す。
hw.bxe.rx_budget
DEFAULT = 0xffffffff
割り込みで処理する受信パケットの最大数を設定します。予算 (budget)
が到達されるなら、残りの/保留中のパケットは、スケジュールされたタ
スクキューで処理されます。
hw.bxe.max_aggregation_size
DEFAULT = 32768
最大の LRO 集合体のバイトサイズを設定します。ハードウェアが集める
より多くのパケットのより高い値。最大は、65K です。
hw.bxe.mrrs
DEFAULT = -1
PCI MRRS を設定する: -1=Auto, 0=128B, 1=256B, 2=512B, 3=1KB
hw.bxe.autogreeen
DEFAULT = 0
AutoGrEEEN を設定する: 0=HW_DEFAULT, 1=FORCE_ON, 2=FORCE_OFF
hw.bxe.udp_rss
DEFAULT = 0
UDP のための 4 つのタプル (tuple) RSS を有効にする / 無効にする:
0=DISABLED, 1=ENABLED
キューの数と受信バッファを修正するとき、特に注意しなければなりません。
FreeBSD は、mbuf(9) 割り付けの最大数に制限されています。バッファの割り付
けが失敗するなら、インタフェースの初期化は、失敗し、インタフェースは、使
用可能になりません。ドライバは、バッファの割り付けのために最善を尽くしま
す。それは、すべてか、または努力なしです。
sysctl(8) を使用して、mbuf(9) の割り付けの制限を調整することができ、次の
ように netstat(1) で現在の使用法を見ることができます:
# netstat -m
# sysctl kern.ipc.nmbclusters
# sysctl kern.ipc.nmbclusters=<#>
動的にデフォルトの設定を上書きするためにインスタンスごとに設定することが
できる追加の設定パラメータがあります。下記の '#' は、ドライバのインスタン
ス / インタフェースのユニット番号と置き換えなければなりません:
dev.bxe.#.debug
DEFAULT = 0
ドライバのインスタンスのデフォルトのロギングレベルを設定します。
詳細については、上記の hw.bxe.debug と下記の「診断とデバッグ」セ
クションを参照してください。
dev.bxe.#.rx_budget
DEFAULT = 0xffffffff
ドライバのインスタンスのための割り込みで処理する受信パケットの最
大数を設定します。より詳細については、上記の hw.bxe.rx_budget を
参照してください。
追加の項目は、ifconfig(8) を使用して設定することができます:
MTU - Maximum Transmission Unit
DEFAULT = 1500
RANGE = 46-9184
# ifconfig bxe# mtu <n>
Promiscuous Mode
DEFAULT = OFF
# ifconfig bxe# [ promisc | -promisc ]
Rx/Tx Checksum Offload
DEFAULT = RX/TX CSUM ON
Rx と Tx の設定は、依存していないことに注意してください。
# ifconfig bxe# [ rxcsum | -rxcsum | txcsum | -txcsum ]
TSO - TCP Segmentation Offload
DEFAULT = ON
# ifconfig bxe# [ tso | -tso | tso6 | -tso6 ]
LRO - TCP Large Receive Offload
DEFAULT = ON
# ifconfig bxe# [ lro | -lro ]
診断とデバッグ
sysctl(8) を通して bxe によって公開された多くの統計値があります。
デフォルトのドライバの設定をダンプするためには:
# sysctl -a | grep hw.bxe
すべてのインスタンスの設定と詳細な統計値をダンプするためには:
# sysctl -a | grep dev.bxe
(ドライバにインスタンス / インタフェースのユニット番号で '#' を置き換え)
単一のインスタンスのための情報をダンプするためには:
# sysctl -a | grep dev.bxe.#
単一のインスタンスのすべてのキューのための情報をダンプするためには:
# sysctl -a | grep dev.bxe.#.queue
(キュー番号で追加の '#' を置き換え) 単一のインスタンスの単一のキューに対
する情報をダンプするためには:
# sysctl -a | grep dev.bxe.#.queue.#
bxe ドライバには、システムログに大量のデバッグメッセージをダンプする能力
があります。hw.bxe.debug sysctl(8) でロギングのデフォルトのレベルを設定す
ることができます。ダンプされているあまりにも多くのログ記録の結果となるか
もしれないので、この設定には注意してください。このパラメータがデフォルト
のパラメータであるので、すべてのインスタンスに影響し、ドライバのタイミン
グを劇的に変更します。デバッグを援助するよりよい選択肢は、dev.bxe.#.debug
sysctl(8) で特定のインスタンスのデバッグレベルを動的に変更することです。
これによって、利用者は、まとめてさまざまなデバッググループのログ記録のオ
ン/オフを切り替えることができます。
切り替えることができるさまざまなデバッググループは、次の通りです:
DBG_LOAD 0x00000001 /* ロードしアンロードします */
DBG_INTR 0x00000002 /* 割り込み処理 */
DBG_SP 0x00000004 /* slowpath 処理 */
DBG_STATS 0x00000008 /* stat 更新 */
DBG_TX 0x00000010 /* パケット送信 */
DBG_RX 0x00000020 /* パケット受信 */
DBG_PHY 0x00000040 /* phy/link 処理 */
DBG_IOCTL 0x00000080 /* ioctl 処理 */
DBG_MBUF 0x00000100 /* mbuf 情報のダンプ */
DBG_REGS 0x00000200 /* レジスタのアクセス */
DBG_LRO 0x00000400 /* lro 処理 */
DBG_ASSERT 0x80000000 /* デバッグのアサート */
DBG_ALL 0xFFFFFFFF /* flying monkeys */
例えば、bxe0 で受信パスの問題をデバッグするためには:
# sysctl dev.bxe.0.debug=0x22
終了するとき、ログ記録の裏打ちをオフにします:
# sysctl dev.bxe.0.debug=0
サポート
サポートの質問については、QLogic に承認された再販業者、または
http://support.qlogic.com または <support@qlogic.com> で電子メールによっ
て QLogic テクニカルサポートに連絡してください。
関連項目
netstat(1), altq(4), arp(4), netintro(4), ng_ether(4), vlan(4),
ifconfig(8)
歴史
bxe デバイスドライバは、FreeBSD 9.0 ではじめて登場しました。
作者
bxe ドライバは、Eric Davis <edavis@broadcom.com>,
David Christensen <davidch@broadcom.com> と
Gary Zambrano <zambrano@broadcom.com> によって書かれました。
FreeBSD 12.2 April 29, 2012 FreeBSD 12.2