日本語 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
XL(4) FreeBSD カーネルインタフェースマニュアル XL(4)
名称
xl -- 3Com Etherlink XL と Fast Etherlink XL イーサネットデバイスドライバ
書式
このドライバをカーネルにコンパイルするためには、次の行を利用者のカーネル
設定ファイルに置きます:
device miibus
device xl
もう一つの方法として、ブート時にモジュールとしてドライバをロードするため
には、次の行を loader.conf(5) に置きます:
if_xl_load="YES"
解説
xl ドライバは、3Com "ブーメラン (boomerang)"、"サイクロン (cyclone)"、"ハ
リケーン (hurricane)" と "トルネード (tornado)" バスマスタ Etherlink XL
チップに基づく PCI イーサネットアダプタと組み込みまれたコントローラのサ
ポートを行ないます。
Etherlink XL チップは、外部にアタッチされた PHY トランシーバのための MII
バスと同様に組み込みの 10baseT、10base2 と 10base5 トランシーバをサポート
します。3c905 シリーズは、全二重または半二重で 10/100 Mbps をサポートする
ために National Semiconductor NS 83840A 10/100 PHY を通常使用します。
3c905B アダプタには、以前のドライバとの互換性のために MII 上にマップされ
た組み込みの自動ネゴシエーションロジックがあります。3c905-TX または
3c905B-TX のような Fast Etherlink XL アダプタは、全二重または半二重のいず
れかで 10Mbps または 100Mbps のデータレート (速度) の能力があり、あらゆる
サポートされたモードのための手動で設定するか、またはリンク相手で可能な限
り高いモードを自動ネゴシエーションすることができます。
xl ドライバは、次のメディアタイプをサポートします:
autoselect メディアタイプとオプションの自動選択を有効にしま
す。このオプションが外部の PHY または組み込みの自動
ネゴシエーションロジックがある 3c905 と 3c905B アダ
プタでのみ利用可能であることに注意してください。
3c900 アダプタのために、ドライバは、EEPROM で指定さ
れたモードを選択します。ユーザは、メディアオプショ
ンを /etc/rc.conf ファイルに追加することによって、
これを変更することができます。
10baseT/UTP 10Mbps オペレーションを設定します。また、mediaopt
オプションは、全二重または半二重モードのいずれかを
選択するために使用することができます。
100baseTX 100Mbps (ファーストイーサネット) オペレーションを設
定します。また、mediaopt オプションは、全二重または
半二重モードのいずれかを選択するために使用すること
ができます。
10base5/AUI (COMBO カードだけで利用可能な) AUI トランシーバを有
効にします。
10base2/BNC (COMBO カードだけで利用可能な) BNC coax トランシー
バを有効にします。
xl ドライバは、次のメディアオプションをサポートします:
full-duplex 全二重オペレーションを強制的に設定します。
half-duplex 半二重オペレーションを強制的に設定します。
100baseTX メディアタイプは、アダプタでサポートされている場合のみ、利用可
能であることに注意してください。このデバイスの設定に関するより詳しい情報
については、ifconfig(8) を参照してください。
ハードウェア
xl ドライバは、次のハードウェアをサポートします:
• 3Com 3c900-TPO
• 3Com 3c900-COMBO
• 3Com 3c905-TX
• 3Com 3c905-T4
• 3Com 3c900B-TPO
• 3Com 3c900B-TPC
• 3Com 3c900B-FL
• 3Com 3c900B-COMBO
• 3Com 3c905B-T4
• 3Com 3c905B-TX
• 3Com 3c905B-FX
• 3Com 3c905B-COMBO
• 3Com 3c905C-TX
• 3Com 3c980, 3c980B と 3c980C サーバアダプタ
• 3Com 3cSOHO100-TX OfficeConnect アダプタ
• 3Com 3c450 HomeConnect アダプタ
• 3Com 3c555, 3c556 と 3c556B mini-PCI アダプタ
• 3Com 3C3SH573BT, 3C575TX, 3CCFE575BT, 3CXFE575BT, 3CCFE575CT,
3CXFE575CT, 3CCFEM656, 3CCFEM656B と 3CCFEM656C, 3CXFEM656,
3CXFEM656B と 3CXFEM656C CardBus アダプタ
• 3Com 3c905-TX, 3c905B-TX 3c905C-TX, 3c920B-EMB と 3c920B-EMB-WNM 組み
込みアダプタ
CardBus カードの 3C656 ファミリと MiniPCI カードの 3C556 ファミリの両方に
は、組み込みの独自仕様のモデムがあります。xl ドライバも、いかなる他の
FreeBSD ドライバも、モデムをサポートしません。
診断
xl%d: couldn't map memory 致命的な初期化エラーが生じました。
xl%d: couldn't map interrupt 致命的な初期化エラーが生じました。
xl%d: device timeout デバイスには、ネットワークに応答することを停止した
か、またはネットワーク接続 (ケーブル) に関して問題があります。
xl%d: no memory for rx list ドライバが、受信リングのための mbuf の割り付
けに失敗しました。
xl%d: no memory for tx list パッド (pad) バッファを割り付けるか、または
クラスタに mbuf チェーンを折りたたむとき、ドライバが、送信リングのための
mbuf の割り付けに失敗しました。
xl%d: command never completed! 3c90x ASIC に発行されたいくつかのコマンド
が、次を完了するために時間がかかります: ドライバが、継続する前にステータ
スレジスタの 'コマンド実行中' のビットがクリアされるまで、待つことになっ
ています。まれな事例で、このビットは、クリアされないことがあります。無限
の待ちループに陥るのを避けるために、ドライバは、あきらめる前に有限回数だ
けビットをポーリングし、その時点でメッセージを出力します。このメッセージ
は、低速のマシンでドライバの初期化の間に印刷されます。利用者がこのメッ
セージを見るが、ドライバが正常に機能し続けるなら、たぶんメッセージを、無
視することができます。
xl%d: chip is in D3 power state -- setting to D0 このメッセージは、電源
管理をサポートする 3c905B アダプタだけに適用されます。いくつかのオペレー
ティングシステムは、シャットダウンするとき、3c905B を低消費電力モードに
し、いくつかの PCI BIOS は、それを設定する前に、この状態のチップを明らか
にすることに失敗します。3c905B は、D3 状態で PCI 設定のすべてを失うので、
BIOS が時間内にそれをフルパワーモードに戻せないなら、正しくそれを設定する
ことができません。ドライバは、この状態を検出して、D0 (フルパワー) 状態に
アダプタを戻すことがこころみますが、これは、ドライバを完全な操作状態に復
帰するためには十分ではありません。利用者がブート時にこのメッセージを見
で、ドライバがネットワークインタフェースとしてデバイスのアタッチに失敗し
たなら、利用者は、デバイスを適切に設定させるために 2 つ目のウォームブート
を実行しなければなりません。
この状態は、別のオペレーティングシステムからウォームブートするときのみ生
じることに注意してください。FreeBSD をブートする前に利用者のシステムの電
源を切るなら、カードは、正しく設定されるべきです。
xl%d: WARNING: no media options bits set in the media options register!
3c905-TX アダプタを組み込んだいくつかの Dell Latitude ドッキングステー
ションでドライバを使用するとき、この警告が現れます。何らかの理由で、この
特定の機器のメディアオプションレジスタの 'MII 利用可能' ビットは、たとえ
設定されるべきであっても、設定されません (3c905-TX は、常に外部 PHY トラ
ンシーバを使用します)。ドライバは、PCI デバイス ID ワードに基づいて適切な
メディアタイプの推測を試みます。ドライバは、作者が、それが製造上の欠陥で
あると考えるので、この状態に関する多くのノイズ (訳注: メッセージ) を出し
ます。
xl%d: transmission error: %d
xl%d: tx underrun, increasing tx start threshold to %d bytes このメッ
セージは、アダプタが様々なロード量の下で転送バッファを調整している間に現
れ、ほとんど害はありません。それらを無視してもたぶん安全です。
関連項目
altq(4), arp(4), cardbus(4), miibus(4), netintro(4), ng_ether(4),
pccard(4), polling(4), ifconfig(8)
歴史
xl デバイスドライバは、FreeBSD 3.0 ではじめて登場しました。
作者
xl ドライバは、Bill Paul <wpaul@ctr.columbia.edu> によって書かれました。
FreeBSD 12.2 January 23, 2008 FreeBSD 12.2