IP

Section: Linux (8)
Updated: 20 Dec 2011
Index Return to Main Contents

名前

ip - ルーティング、ネットワークデバイス、インタフェース、トンネルの表示と操作をする。

書式

ip [ OPTIONS ] OBJECT { COMMAND | help }

ip [ -force ] -batch filename

OBJECT := { link | address | addrlabel | route | rule | neigh | ntable | tunnel | tuntap | maddress | mroute | mrule | monitor | xfrm | netns }

OPTIONS := { -V[ersion] | -h[uman-readable] | -s[tatistics] | -d[etails] | -r[esolve] | -iec | -f[amily] { inet | inet6 | link } | -4 | -6 | -I | -D | -B | -0 | -l[oops] { maximum-addr-flush-attempts } | -o[neline] | -rc[vbuf] [size] | -t[imestamp] | -ts[hort] | -n[etns] name | -a[ll] | -c[olor] | -br[ief] | -j[son] | -p[retty] }

オプション

-V, -Version

ip ユーティリティのバージョンを表示して、終了する。

-h, -human, -human-readable

人間が読みやすいように、値の後に (サイズ) 拡張子を付けて統計値を出力する。

-b, -batch <FILENAME>

指定したファイルまたは標準入力からコマンドを読み込んで起動する。最初の失敗で、ip が終了する。

-force

バッチモードでエラーがあっても ip を終了させない。コマンドの実行中にエラーがあった場合、アプリケーションのリターンコードは 0 以外になる。

-s, -stats, -statistics

より多くの情報を出力する。オプションを 2 回以上指定すると、情報量が増える。ルールとして、情報は統計値や時間に関する値である。

-d, -details

より詳細な情報を出力する。

-l, -loops <COUNT>

'ip address flush' のロジックがギブアップするまでの、最大ループ数を指定する。デフォルトは 10 である。ゼロ (0) はすべてのアドレスが削除されるまでループすることを意味する。

-f, -family <FAMILY>

使用するプロトコルファミリーを指定する。プロトコルファミリーの識別子は、 inet, inet6, bridge, mpls,link のいずれかである。オプションが指定されない場合、他の引数からプロトコルファミリーを推定する。他のコマンドラインでファミリーを推定するのに十分な情報が与えられない場合、 ip はデフォルトのファミリー inet または any を選択する。 link は特別なファミリーの識別子で、ネットワークプロトコルが含まれていない。

-4

-family inet のショートカット。

-6

-family inet6 のショートカット。

-B

-family bridge のショートカット。

-M

-family mpls のショートカット。

-0

-family link のショートカット。

-o, -oneline

ラインフィードを '\' で置換し、各レコードを 1 行で出力する。これはレコードを wc(1) で数えたり、出力を grep(1) したりするのに便利である。

-r, -resolve

ホストアドレスではなく、DNS 名を表示するのにシステム名のリゾルバーを使う。

-n, -netns <NETNS>

ネットワークネームスペース NETNS を指定するように ip を切り替える。実際にこれは、

ip netns exec NETNS ip [ OPTIONS ] OBJECT { COMMAND | help }

の実行を

ip -n[etns] NETNS [ OPTIONS ] OBJECT { COMMAND | help }

のように簡略化する。

-a, -all

指定したコマンドをすべてのオブジェクトに実行する。これはコマンドがこのオプションをサポートしているかに依存する。

-c[color][={always|auto|never}

カラー出力を設定する。パラメータが省略されるか always の場合、標準出力の状態に関わらずカラー出力が有効化される。パラメータが auto の場合、カラー出力を有効化する前に、標準出力が端末かをチェックする。パラメータが never の場合、カラー出力が無効化される。複数回指定されると、最後の指定が先に指定されたものより優先される。このフラグは -json が指定された場合、無視される。

カラーパレットは COLORFGBG 環境変数に影響される (環境変数 を参照すること)。

-t, -timestamp

モニターオプションを使う場合、現在時刻を表示する。

-ts, -tshort

-timestamp と同様であるが、短いフォーマットを使う。

-rc, -rcvbuf<SIZE>

netlink ソケットの受信バッファサイズを設定する。デフォルトは 1MB である。

-iec

人間が読みやすい IEC 単位でレートを出力する (例 1Ki = 1024)。

-br, -brief

基本的な情報のみを読みやすいようにテーブル形式で表示する。このオプションは、現在 ip addr show と ip link show コマンドでのみサポートされている。

-j, -json

結果を JavaScript Object Notation (JSON) で出力する。

-p, -pretty

デフォルトの JSON フォーマットはコンパクトで、パースするには効率的であるが、多くのユーザには読みづらい。このフラグは、読みやすいようにインデントを追加する。

IP - コマンド書式

OBJECT

address: - デバイスのプロトコル (IP または IPv6) アドレス
addrlabel: - プロトコルアドレスセクションのラベル設定
l2tp: - イーサーネットオーバー IP でのトンネル (L2TPv3)
link: - ネットワークデバイス
maddress: - マルチキャストアドレス
monitor: - ネットリンクメッセージの監視
mroute: - マルチキャストルーティングのキャッシュエントリ
mrule: - マルチキャストルーティングのポリシーデータベース内のルール
neighbour: - ARP または NDISC のキャッシュエントリの管理
netns: - ネットワークネームスペースの管理
ntable: - 近隣 (neighbor) キャッシュの操作の管理
route: - ルーティングテーブルのエントリ
rule: - ルーティングポリシーのデータベース内のルール
tcp_metrics/tcpmetrics: - TCP メトリクスの管理
token: - トークン化されたインタフェース識別子の管理
tunnel: - トンネルオーバー IP
tuntap: - TUN/TAP デバイスの管理
xfrm: - IPSec ポリシーの管理

すべてのオブジェクトの名前は、完全に指定することもできるし、省略形で指定することもできる。例えば address は addr と省略できるし、単に a と省略もできる。

COMMAND

オブジェクトに対して実行するアクションを指定する。指定可能なアクションのセットは、オブジェクトタイプに依存する。ルールとして、オブジェクトに対して add, delete,show (または list) が指定可能である。しかし、いくつかのオブジェクトでは、これらの操作が許可されておらず、他のコマンドがあったりもする。 help コマンドはすべてのオブジェクトで利用可能である。このコマンドは、指定可能なコマンドと、引数の書式のリストを表示する。

コマンドが指定されない場合、デフォルトコマンドが仮定される。通常は list であるが、指定された種別のオブジェクトがリストできない場合は、 help が仮定される。