ifup - ネットワークインターフェースを起動する
ifdown - ネットワークインターフェースを停止する
ifquery - インターフェース構成を解析する
SYNOPSIS
ifup [-nv] [--no-act] [--verbose] [-i FILE|--interfaces=FILE] [--state-dir=DIR] [--allow CLASS]
-a|IFACE...
ifup -h|--help
ifup -V|--version
ifdown [-nv] [--no-act] [--verbose] [-i FILE|--interfaces=FILE] [--state-dir=DIR] [--allow CLASS]
-a|IFACE...
ifquery [-nv] [--verbose] [-i FILE|--interfaces=FILE] [--state-dir=DIR] [--allow CLASS] IFACE...
ifquery -l|--list [-nv] [--verbose] [-i FILE|--interfaces=FILE] [--state-dir=DIR] [--allow CLASS]
[-a|IFACE...]
ifquery --state [--state-dir=DIR] [--allow CLASS] [-a|IFACE...]
DESCRIPTION
ifup および ifdown コマンドは、/etc/network/interfaces ファイル内のインターフェース定義に基づいて、ネットワークインターフェースを構成（または、それぞれ、構成解除）するために使用できます。ifquery コマンドは、インターフェース構成を解析するために使用できます。
OPTIONS
オプションの概要は以下に示します。
-a, --all
ifup に指定した場合、"auto" とマークされたすべてのインターフェースに影響を与えます。インターフェースは、/etc/network/interfaces で定義されている順に起動されます。--allow と組み合わせると、指定されたクラスのすべてのインターフェースに対して動作します。ifdown に指定した場合、定義されたすべてのインターフェースに影響を与えます。インターフェースは、現在の状態ファイルにリストされている順に停止されます。/etc/network/interfaces に定義されているインターフェースのみが停止されます。
-f, --force
インターフェースの構成または構成解除を強制します。
--ignore-errors
コマンドまたはスクリプトのいずれかが失敗した場合でも、続行します。
-h, --help
オプションの概要を表示します。
--allow=CLASS
/etc/network/interfaces の allow-CLASS 行にリストされているインターフェースのみに動作させます。
-i FILE, --interfaces=FILE
/etc/network/interfaces ではなく、FILE からインターフェース定義を読み取ります。
--state-dir=DIR
インターフェース状態を /run/network ではなく、DIR に保存します。
-X PATTERN, --exclude=PATTERN
PATTERN を使用して、操作するインターフェースのリストからインターフェースを除外します。PATTERN は通常のシェルグロブ構文を使用します。シェルワイルドカードを使用しない場合、正確なインターフェース名と一致する必要があります。このオプションを複数回指定すると、複数のパターンが除外されます。
-o OPTION=VALUE
OPTION を VALUE に設定します。これは、/etc/network/interfaces に記述されている場合と同じです。
-n, --no-act
インターフェースを構成したり、"up" または "down" コマンドを実行したりしません。
--no-mappings
マッピングを実行しません。詳細については、interfaces(5) を参照してください。
--no-scripts
/etc/network/if-*.d/ のスクリプトを実行しません。
--no-loopback
ループバックインターフェースの特別な処理を無効にします。デフォルトでは、ループバックインターフェース（Linux の lo）は内部的に "auto" インターフェースとして事前に定義されているため、ifup -a で自動的に起動されます。ループバックデバイスをユーザーが再定義した場合、インターフェースは一度だけ構成されます。ただし、別のインターフェースもループバックとして定義されている場合、通常どおり構成されます。このオプションを指定すると、この動作が無効になり、ループバックインターフェースは自動的に構成されません。
-V, --version
著作権およびバージョン情報を表示します。
-v, --verbose
実行されたコマンドを表示します。
-l, --list
ifqueryの場合、指定されたクラスに一致するすべてのインターフェイスをリストします。クラスが指定されていない場合は、autoとしてリストされているすべてのインターフェイスを出力します。
--state
ifqueryの場合、インターフェイスの状態をダンプします。インターフェイスが指定されていない場合は、一緒に起動されたすべてのインターフェイスと、それらに割り当てられた論理インターフェイスをリストし、成功を示すステータスコードで終了します。1つ以上のインターフェイスが指定された場合、これらのインターフェイスの状態のみを表示します。すべての指定されたインターフェイスが起動している場合は、成功コードが返されます。それ以外の場合は、0が返されます。
例
ifup -a
/etc/network/interfacesでautoとして定義されているすべてのインターフェイスを起動します。
ifup eth0
インターフェイスeth0を起動します。
ifup eth0=home
インターフェイスeth0を論理インターフェイスhomeとして起動します。
ifdown -a
現在起動しているすべてのインターフェイスを停止します。
ifquery -l
autoキーワードで指定されたすべてのインターフェイスの名前を出力します。
ifquery -l --allow=hotplug
allow-hotplugキーワードで指定されたすべてのインターフェイスの名前を出力します。
ifquery eth0
ifupdown構成で指定されたインターフェイスオプションを表示します。各キーと値のペアは、": "を区切り文字として、個別の行に出力されます。
注意事項
ifup、ifdown、およびifqueryは、実際には異なる名前で呼び出される同じプログラムです。
このプログラムは、ネットワークインターフェイスを直接構成しません。代わりに、ipなどの低レベルのユーティリティを実行して処理を行います。
ifdownが呼び出された場合、ifupがまだ実行されているかどうかを確認します。その場合、SIGTERMがifupに送信されます。
インターフェイスの停止処理中に、ifdownは--ignore-errorsが指定された場合と同様に、エラーを無視します。
ファイル
/etc/network/interfaces
ネットワークインターフェイスの定義。詳細については、interfaces(5)を参照してください。
/run/network/ifstate
ネットワークインターフェイスの現在の状態
並行性
Ifupdownは、同じインターフェイスに対する同時実行のifupおよびifdown呼び出しがシリアルに実行されるように、インターフェイスごとのロックを使用します。ただし、異なるインターフェイスに対する呼び出しは、並行して実行できます。
終了ステータス
ifupおよびifdownの場合、指定されたインターフェイスがすべて正常に（起動または停止）された場合は、終了ステータスは0になります。エラーが発生した場合は、1になります。これらのコマンドの結果はべき等です。すでに起動しているインターフェイスに対してifupを実行すると、終了ステータスは0になり、同様に、起動していないインターフェイスに対してifdownを実行した場合も、終了ステータスは0になります。
ifqueryは通常、一致するifaceスタンザを持つインターフェイスがある場合は終了ステータス0を返し、一致するスタンザがない場合は1を返します。ifquery --stateは、指定されたインターフェイスが既知であるが起動していない場合にも、終了ステータス1を返します。
既知のバグ/制限事項
プログラムは、ネットワークインターフェイスがアップしているかダウンしているかの記録を保持します。例外的な状況下では、これらの記録がインターフェイスの実際の状態と矛盾する可能性があります。たとえば、ifupを使用して起動され、後でifconfigを使用して構成解除されたインターフェイスは、依然として「アップ」として記録されます。これを修正するには、--forceオプションを使用して、プログラムがインターフェイスの現在の状態を考慮せずに、構成または構成解除コマンドを実行するように強制できます。
^ fupまたはifdownが正しく機能するには、ファイル/run/network/ifstateが書き込み可能である必要があります。この場所が書き込み可能でない場合（たとえば、ルートファイルシステムが読み取り専用でマウントされているためにシステムリカバリが行われている場合）、/run/network/ifstateを書き込み可能な場所にシンボリックリンクする必要があります。それが不可能な場合は、--forceオプションを使用して、ファイルを更新せずに構成または構成解除コマンドを実行できます。
プログラムは自動的に実行されないことに注意してください。ifupだけでは、ハードウェアのインストールによって出現したインターフェイスを起動することも、ハードウェアの取り外しによって消えたインターフェイスを停止することもできません。ネットワークインターフェイスの構成を自動化するには、udev(7)またはifplugd(8)などの他のパッケージをインストールする必要があります。
著者
ifupdownスイートはAnthony Townsによって作成され、現在はSantiago Ruano RincónとJosue Ortegaによって保守されています。
多くの人々が時間とともにifupdownの開発に貢献しており、完全な履歴は/usr/share/doc/ifupdown/changelog.Debian.gzにあります。