.\" Japanese Version Copyright (c) 1998 Yoshiki Sugiura
.\"         all rights reserved.
.\" Translated  at Sat Jan 31 12:36:58 JST 1998
.\"         by Yoshiki Sugiura <yoy@mb.kcome.ne.jp>
.\" Updated Sat Dec 25 23:56:10 JST 1999
.\"         by Kentaro Shirakata <argrath@yo.rim.or.jp>
.\" Updated & Modified Tue Jan 29 19:24:09 JST 2002
.\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
.\" 
.\"WORD:	Maximum Transfer Unit	最大転送単位
.\"WORD:	Point-To-Point link	ポイント間接続
.TH IFCONFIG 8 "14 August 2000" "net-tools" "Linux Programmer's Manual"
.SH 名前
ifconfig \- ネットワーク・インタフェースの設定
.SH 書式
.B "ifconfig [interface]"
.br
.B "ifconfig interface [aftype] options | address ..."
.SH 説明
.B ifconfig
はカーネルによって認識されているネットワーク・インタフェースの設定に使用する。
特にブート時に、必要に応じてインタフェースを設定するために使用される。
ブート後には、デバッグやシステムチューニングなどの特殊な目的がなければ、
通常使うことはない。
.LP
引数が与えられないと、
.B ifconfig
は現在動作しているインタフェースの状態を表示する。
もし一つの\fBインタフェース\fRが引数として与えられると、
そのインタフェースの状態だけを表示する。
また
.B -a
が引数として与えられると、停止しているものも含めて、
すべてのインタフェースの状態を表示する。
以上のいずれでもない場合、ifconfig はインタフェースを設定する。

.SH アドレス・ファミリー
インタフェース名の直後に置かれた引数が、
サポートされているアドレス・ファミリーの名前として認識されると、
すべてのプロトコル・アドレスの解釈と表示は、
そのアドレス・ファミリーに従う。
現在サポートされているアドレス・ファミリーは次の通り:
.B inet
(TCP/IP, デフォルト),
.B inet6
(IPv6),
.B ax25
(AMPR Pakcet Radio),
.B ddp
(Appletalk フェーズ 2),
.B ipx
(Novell IPX),
.B netrom
(AMPR Packet radio).
.SH オプション
.TP
.B interface
インタフェースの名前である。
これは通常、ドライバーの名前に装置の番号を付けたものである。
例えば、
.B eth0
は最初のイーサネット・インタフェースである。
.TP
.B up
このフラグは、インタフェースを活動状態にする。
インタフェースに新しいアドレスを割り当てた場合は、
暗黙のうちにこの up が指定される。
.TP
.B down
このフラグは、このインタフェースのドライバを停止する。
.TP
.B "[\-]arp"
ARP プロトコルの使用を有効/無効にする。
.TP
.B "[\-]promisc"
.B 無差別 (promiscuous)
モードを有効/無効にする。
もし有効にすると、ネットワーク上のすべてのパケットは
このインタフェースにより受信される。
.TP
.B "[\-]allmulti"
.B 全マルチキャスト (all-multicast)
モードを有効/無効にする。
もし有効にすると、ネットワーク上のすべてのマルチキャスト・パケットは
このインタフェースにより受信される。
.TP
.B "metric N"
この引数はインタフェースメトリックを設定する。
.TP
.B "mtu N"
この引数はインタフェースの最大転送単位 (MTU) を設定する。
.TP
.B "dstaddr addr"
(PPPのような) ポイント間接続においてリモートの IP アドレスを設定する。
この引数はすでに古い仕様となったので、代りに
.B pointopoint
キーワードを使用すること。
.TP
.B "netmask addr"
このインタフェースの IP ネットワークマスクを設定する。この値は通常、
(IP アドレスに対応する) クラス A,B,C の ネットマスクがデフォルトで設定
されるが、値を指定することも可能である。
.TP
.B "add addr/prefixlen"
IPv6 アドレスをインタフェースに追加する。
.TP
.B "del addr/prefixlen"
IPv6 アドレスをインタフェースから削除する。
.TP
.B "tunnel aa.bb.cc.dd"
新規の SIT (IPv6-in-IPv4) デバイスを作成し、
与えられた対象アドレスにトンネルする。
.TP
.B "irq addr"
このデバイスにより使用される割り込みを設定する。
ただし、すべてのデバイスで動的な IRQ 設定の変更が可能なわけではない。
.TP
.B "io_addr addr"
このデバイスの I/O 開始アドレスを設定する。
.TP
.B "mem_start addr"
このデバイスにより使用される共有メモリーの開始アドレスを設定する。
これは、いくつかのデバイスでのみ必要とされる。
.TP
.B "media type"
このデバイスで使用される、物理ポートもしくは媒体タイプを設定する。
すべてのデバイスで、この設定の変更が可能なわけではない。
また可能なものでも、どの値をサポートしているかはデバイスによって異なる。
.B type
の値は、
.B 10base2
(thin イーサネット),
.B 10baseT
(twisted-pair 10Mbps イーサネット),
.B AUI 
(外部トランシーバー) などである。
.B auto
は特殊な媒体指定で、
ドライバーに媒体を自動検出するよう伝える。
同じく、すべてのドライバでこれが可能であるわけではない。
.TP
.B "[-]broadcast [addr]"
アドレスを指定すると、このインタフェースに
プロトコルブロードキャストアドレスを設定する。
指定されないと、このインタフェースに
.B IFF_BROADCAST
フラグを設定 (もしくは解除) する。
.TP
.B "[-]pointopoint [addr]"
.B ポイント間接続 (point-to-point)
モードを有効にする。
これは二つのマシン間だけで直接接続し、
他が干渉できないことを意味する。
.br
アドレスも指定された場合は、リンクの相手側のプロトコルアドレスを設定する。
これにより、
.B dstaddr
は古い仕様となった。指定されない場合
.B IFF_POINTOPOINT
フラグを設定もしくは解除するだけである。
.TP
.B hw class address
デバイスドライバーがこの操作をサポートしていれば、
インタフェースのハードウェアアドレスを設定する。
このキーワードの後には、ハードウェアのクラスの名前と
ハードウェアアドレスにあたる ASCII 文字列が続かなくてはならない。
現在サポートされるハードウェアクラスは
.B ether
(イーサネット),
.B ax25
(AMPR AX.25),
.BR ARCnet ,
.B netrom
(AMPR NET/ROM) である。
.TP
.B multicast
インタフェースのマルチキャストフラグを設定する。
通常はドライバーが自動で設定するので、
.TP
.B address
このインタフェースに割り当てる IP アドレス。
.TP
.B txqueuelen length
デバイスの送信キューの長さをセットする。
遅延が大きく、遅いデバイス (モデム、ISDN) に対して
小さい値をセットすると、
大量転送中に telnet のようなインタラクティブなトラフィックが
あまり邪魔されないようにできる。
.SH 注意
カーネルリリース 2.2 からは、
エイリアスされたインタフェースに対する
明示的なインタフェース統計がなくなった。
元のアドレスに対して表示される統計は、
同じデバイスの全ての別名アドレスで共通のものとなる。
アドレス毎の統計が欲しい場合は、
.BR ipchains (8)
コマンドを使って、そのアドレスの明示的な集計ルールを追加すること。
.LP
イーサネットデバイスドライバの割り込み問題により、
EAGAIN で失敗する。
より詳細な情報は
.I http://cesdis.gsfc.nasa.gov/linux/misc/irq-conflict.html
を参照すること。
.SH ファイル
.I /proc/net/socket 
.br
.I /proc/net/dev
.br
.I /proc/net/if_inet6
.SH バグ
Appletalk DDP と IPX はアドレスの表示はするが、
このコマンドにより変更することはできない。
.SH 関連項目
route(8), netstat(8), arp(8), rarp(8), ipchains(8)
.SH 著者
Fred N. van Kempen, <waltje@uwalt.nl.mugnet.org>
.br
Alan Cox, <Alan.Cox@linux.org>
.br
Phil Blundell, <Philip.Blundell@pobox.com>
.br
Andi Kleen