ip - ルーティング、ネットワークデバイス、インターフェース、トンネルを表示/操作します。
概要
ip [ オプション ] オブジェクト { コマンド | ヘルプ }
ip [ -force ] -batch ファイル名
OBJECT := { address | addrlabel | fou | help | ila | ioam | l2tp | link | macsec | maddress |
monitor | mptcp | mroute | mrule | neighbor | neighbour | netconf | netns | nexthop |
ntable | ntbl | route | rule | sr | tap | tcpmetrics | token | tunnel | tuntap | vrf |
xfrm }
OPTIONS := { -V[ersion] | -h[uman-readable] | -s[tatistics] | -d[etails] | -r[esolve] | -iec |
-f[amily] { inet | inet6 | link } | -4 | -6 | -B | -0 | -l[oops] { 最大のアドレスフラッシュ試行回数 } | -o[neline] | -rc[vbuf] [サイズ] | -t[imestamp] | -ts[hort] | -n[etns] 名前 |
-N[umeric] | -a[ll] | -c[olor] | -br[ief] | -j[son] | -p[retty] }
オプション
-V, -Version
ip ユーティリティのバージョンを表示して終了します。
-h, -human, -human-readable
人間が読みやすい値とサフィックスを付けて統計情報を出力します。
-b, -batch <ファイル名>
指定されたファイルまたは標準入力からコマンドを読み込み、実行します。最初の失敗時に ip は終了します。
-force エラーが発生した場合でも、バッチモードで ip の実行を停止しません。コマンドの実行中にエラーが発生した場合、アプリケーションの戻り値はゼロ以外の値になります。
-s, -stats, -statistics
より多くの情報を出力します。オプションが 2 回以上出現する場合、情報の量が増加します。通常、情報は統計または時間値です。
-d, -details
より詳細な情報を出力します。
-l, -loops <カウント>
'ip address flush' ロジックが、すべてのアドレスが削除されるまで試行する最大ループ回数を指定します。デフォルトは 10 です。0 は、すべてのアドレスが削除されるまでループすることを意味します。
-f, -family <ファミリー>
使用するプロトコルファミリーを指定します。プロトコルファミリー識別子は、inet、inet6、bridge、mpls、または link のいずれかになります。このオプションが指定されていない場合、プロトコルファミリーは他の引数から推測されます。残りのコマンドラインからプロトコルファミリーを推測するのに十分な情報が得られない場合、ip はデフォルトのプロトコルファミリー（通常は inet または any）に戻ります。link は、ネットワークプロトコルが関与しない特殊なプロトコルファミリー識別子です。
-4 inet のショートカットです。
-6 inet6 のショートカットです。
-B bridge のショートカットです。
-M mpls のショートカットです。
-0 link のショートカットです。
-o, -oneline
各レコードを 1 行に出力し、改行を '\' 文字に置き換えます。これは、wc(1) でレコードをカウントしたり、grep(1) で出力を検索したりする場合に便利です。
-r, -resolve
システムの名前解決を使用して、ホストアドレスではなく DNS 名を出力します。
-n, -netns <NETNS>
指定されたネットワーク名前空間 NETNS に切り替えます。実際には、以下を実行するだけです。
ip netns exec NETNS ip [ OPTIONS ] OBJECT { COMMAND | help }
を
ip -n[etns] NETNS [ OPTIONS ] OBJECT { COMMAND | help }
として簡略化します。
-N, -Numeric
プロトコル、スコープ、dsfield などの番号を、人間が読める名前に変換する代わりに、直接出力します。
-a, -all
指定されたコマンドをすべてのオブジェクトに対して実行します。ただし、コマンドがこのオプションをサポートしている場合に限ります。
-c[color][={always|auto|never}]
カラー出力を設定します。パラメーターが省略された場合、または always の場合、stdout の状態に関係なくカラー出力が有効になります。パラメーターが auto の場合、stdout がターミナルであるかどうかがチェックされ、ターミナルであればカラー出力が有効になります。パラメーターが never の場合、カラー出力が無効になります。複数回指定された場合、最後に指定されたものが優先されます。このフラグは、-json が指定された場合にも無視されます。
使用されるカラーパレットは、COLORFGBG 環境変数によって影響を受ける可能性があります（ENVIRONMENT を参照）。
-t, -timestamp
モニターオプションを使用するときに、現在の時刻を表示します。
-ts, -tshort
-timestamp と同様ですが、より短い形式を使用します。
-rc, -rcvbuf<SIZE>
netlink ソケットの受信バッファーサイズを設定します。デフォルトは 1MB です。
-iec 人間が読みやすい IEC 単位でレートを出力します（例: 1Ki = 1024）。
-br, -brief
より読みやすくするために、基本情報のみをテーブル形式で出力します。このオプションは、ip addr show、ip link show、および ip neigh show コマンドでのみサポートされます。
-j, -json
結果を JavaScript オブジェクト表記 (JSON) で出力します。
-p, -pretty
デフォルトの JSON 形式はコンパクトで、解析効率が高いですが、ほとんどのユーザーにとっては読みづらくなっています。このフラグは、読みやすくするためにインデントを追加します。
-echo カーネルに、適用された構成を返すように要求します。
IP - コマンド構文
OBJECT
address
- プロトコル（IP または IPv6）アドレスをデバイスに設定します。
addrlabel
- プロトコルアドレス選択のラベル設定を管理します。
fou - Foo-over-UDP の受信ポート設定を管理します。
ila - インジケーターロケーターアドレス (ILA) を管理します。
ioam - IOAM 名前空間と IOAM スキーマを管理します。
l2tp - IP 上のイーサネットをトンネリングします (L2TPv3)。
link - ネットワークデバイスを管理します。
macsec - MACsec デバイス設定を管理します。
maddress
- マルチキャストアドレスを管理します。
monitor
- netlink メッセージを監視します。
mptcp - MPTCP パスマネージャーを管理します。
mroute - マルチキャストルーティングキャッシュエントリを管理します。
mrule - マルチキャストルーティングポリシーデータベース内のルールを管理します。
neighbour
- ARP または NDISC キャッシュエントリを管理します。
netconf
- ネットワーク構成の監視を管理します。
netns - ネットワーク名前空間を管理します。
nexthop
- ネクストホップオブジェクトを管理します。
ntable - ネイバーキャッシュの操作を管理します。
route - ルーティングテーブルエントリを管理します。
rule - ルーティングポリシーデータベース内のルールを管理します。
sr - IPv6 セグメントルーティングを管理します。
stats - インターフェース統計情報を管理および表示します。
tcp_metrics/tcpmetrics
- TCP メトリックを管理します。
token - トークン化されたインターフェース識別子を管理します。
tunnel - IP 上のトンネルを管理します。
tuntap - TUN/TAP デバイスを管理します。
vrf - 仮想ルーティングおよび転送デバイスを管理します。
xfrm - IPSec ポリシーを管理します。
オブジェクト名のすべては、完全な形式または省略形で記述できます。たとえば、address は addr または a と省略できます。
コマンド
オブジェクトに対して実行するアクションを指定します。可能なアクションのセットは、オブジェクトの型によって異なります。一般に、オブジェクトの追加、削除、表示（または一覧表示）は可能ですが、一部のオブジェクトではこれらの操作がすべて許可されていないか、追加のコマンドがあります。ヘルプコマンドはすべてのオブジェクトで利用可能です。利用可能なコマンドと引数の構文規則のリストを出力します。
コマンドが指定されていない場合、デフォルトのコマンドが想定されます。通常は、リスト、またはこのクラスのオブジェクトがリストできない場合は、ヘルプです。
環境
COLORFGBG
設定されている場合、その値は背景が暗いか明るいかを検出し、それに応じてコントラストの強い色を使用するために使用されます。
COLORFGBG環境変数は、通常、セミコロンで区切られた2つまたは3つの値を含んでいます。いずれの場合も、最後の値を取得します。この値が0〜6または8の場合、暗い背景に適した色を選択します。
COLORFGBG=";0" ip -c a
終了ステータス
コマンドが正常に実行された場合は0、構文エラーがある場合は1、カーネルによってエラーが報告された場合は2を返します。
例
ip addr
すべてのネットワークインターフェイスに割り当てられたアドレスを表示します。
ip neigh
カーネルの現在のネイバーテーブルを表示します。
ip link set x up
インターフェイスxを起動します。
ip link set x down
インターフェイスxを停止します。
ip route
ルーティングテーブルを表示します。
履歴
ipはAlexey N. Kuznetsovによって作成され、Linux 2.2に追加されました。
関連項目
ip-address(8), ip-addrlabel(8), ip-fou(8), ip-ioam(8), ip-l2tp(8), ip-link(8), ip-macsec(8), ipmaddress(8), ip-monitor(8), ip-mptcp(8), ip-mroute(8), ip-neighbour(8), ip-netconf(8), ipnetns(8), ip-nexthop(8), ip-ntable(8), ip-route(8), ip-rule(8), ip-sr(8), ip-stats(8), iptcp_metrics(8), ip-token(8), ip-tunnel(8), ip-vrf(8), ip-xfrm(8) IP Command reference ip-cref.ps
バグの報告
Network Developersメーリングリスト<_>にバグを報告してください。開発とメンテナンスは主にそこで行われます。メーリングリストに登録していなくても、メッセージを送信できます。
著者
Michail Litvakによるオリジナルのマニュアルページ<_>