routeadm [-p [option]]
routeadm [-R root-dir] [-e option ...] [-d option...] [-r option...] [-s var=value]
routeadm [-l fmri]
routeadm [-m fmri key=value [key=value]...]
routeadm [-u]
routeadm コマンドは、IP 転送およびルーティングに関するシステム全体の構成を管理するために使用します。IP 転送とは、あるネットワークから別のネットワークに IP パケットを渡すことです。IP ルーティングとは、経路指定プロトコルを使用して経路を決定することです。
IP ルーティング機能は、サービス管理機構 (SMF) 内のサービスとしても表現され、次の障害管理リソース識別子 (FMRI) を使用して svcadm(1M) によって管理することもできます。
svc:/network/routing/route:default svc:/network/routing/ripng:default
関連する例については、「使用例」を参照してください。
ルーティングと転送の有効化および無効化に加え、routeadm は SMF ベースのルーティングデーモンサービスとの対話に使用されます。ルーティングデーモンサービスは routeadm アプリケーションプロパティーグループが存在することによって識別され、routeadm はこれを使用して特定のサービスを管理します。ルーティングデーモンサービスは、その動作に関連するプロパティーを routing アプリケーションプロパティーグループ内に指定することもできます。これらは routeadm –m によって変更できます。そのようなプロパティーグループを持たないサービスの FMRI が指定された場合、エラーが発行され、操作は実行されません。ルーティングデーモンが SMF に変換されていない場合は、ipv4[または 6]-routing-daemon、ipv4[または 6]-routing-daemon-args、および ipv4[または 6]-routing-stop-cmd 変数を使用して、IPv4 または IPv6 ルーティング用の適切なデーモンを指定できます。routeadm は、指定に応じた適切な svc:/network/routing/legacy-routing:ipv4[または 6] サービスを使用して、そのデーモンを実行します。この変換処理は、有効化 (–e)、無効化 (–d)、または更新 (–u) コマンドを発行したときに行われます。
上記の「形式」に示されている最初の使用法は、現在の構成を報告します。
次のコマンド行オプションがサポートされています。
解析可能な形式で構成を出力します。option を指定すると、指定したオプションまたは変数の構成だけが表示されます。
routeadm が変更を適用する代替ルートディレクトリを指定します。これは、変更されるシステムのルートディレクトリが別の場所にマウントされている JumpStart スクリプト内から使用する場合に便利です。
指定されたオプションを有効にします。これにより、関連付けられたサービスを有効にできるように準備します。routing-svcs 変数を使用して、次のブート時または routeadm –u の実行時に有効にするルーティングデーモンを指定します。
指定されたオプションを無効にします。これにより、関連付けられたサービスを無効にできるように準備します。routing-svcs 変数を使用して、次のブート時または routeadm –u の実行時に無効にするルーティングデーモンを指定します。
SMF ルーティングデーモンサービスの routing アプリケーションプロパティーグループに含まれているすべてのプロパティーを一覧表示します。
SMF ルーティングデーモンサービスの routing アプリケーションプロパティーグループに含まれているプロパティー key のプロパティー値を value に変更します。複数値プロパティーの場合、変更操作ではプロパティー名を複数回使用することができ、関連付けられた値がそれぞれ追加されます。
指定されたオプションをシステムのデフォルトに戻します。システムのデフォルトは、各 option の説明で明記されています。
現在構成されているオプションを、実行中のシステムに適用します。このようなオプションには、IP 転送の有効化と無効化、ルーティングデーモンの起動と強制終了などが含まれます (指定されている場合)。デフォルトに設定されているものについては、システムの状態は変更されません。このオプションは、リブートせずに変更を適用するために管理者が使用します。また、このオプションによって SMF 以外の構成がアップグレードされ、一連の引数を含むこともあるデーモンの停止コマンドを呼び出す代わりに、該当するサービスを単純に有効にできるようになります。
特定の変数の文字列値を、間にスペースを含まないコンマ区切りのリストで指定します。無効なオプションが指定された場合、警告メッセージが表示され、プログラムは終了します。次の変数を指定できます。
有効にするルーティングデーモンサービスを指定します。ルーティングデーモンサービスが IPv4 か IPv6 か (したがって routeadm –e/–d ipv4(6)-routing の実行時に有効にされるか無効にされるか) は、routeadm アプリケーションプロパティーグループ内のプロパティー値に基づいて判定されます。デフォルト: route:default ripng:default
ipv4-routing が有効な場合に起動するルーティングデーモンを指定します。指定するルーティングデーモンは、実行可能バイナリまたはシェルスクリプトである必要があります。指定されたプログラムが SMF サービスにマップされる場合は、そのサービスが使用され、有効化時にプログラムのデーモン引数がサービスのプロパティーに転送されます。デフォルト: ""
ipv4-routing が有効な場合に ipv4-routing-daemon に渡す起動時引数を指定します。デフォルト: 引数なし
ipv4-routing が無効な場合にルーティングデーモンを停止するために実行するコマンドを指定します。<command> には、実行可能バイナリかシェルスクリプト、または system(3C) で解析可能な文字列を指定できます。デフォルト: ""
ipv6-routing が有効な場合に起動するルーティングデーモンを指定します。指定するルーティングデーモンは、実行可能バイナリまたはシェルスクリプトである必要があります。指定されたプログラムが SMF サービスにマップされる場合は、そのサービスが使用され、有効化時にプログラムのデーモン引数がサービスのプロパティーに転送されます。デフォルト: ""
ipv6-routing が有効な場合に ipv6-routing-daemon に渡す起動時引数を指定します。デフォルト: ""
ipv6-routing が無効な場合にルーティングデーモンを停止するために実行するコマンドを指定します。<command> には、実行可能バイナリかシェルスクリプト、または system(3C) で解析可能な文字列を指定できます。デフォルト: ""
複数の –e、–d 、および –r オプションをコマンド行で指定できます。–e、–d、および –r によって加えられる変更は永続的ですが、そのあとで –u オプションを指定して routeadm を呼び出さないかぎり、実行中のシステムには適用されません。
–e、–d、および –r オプションの引数 (上記では option... と示されている) としては、次のオプションを使用します。
すべての IPv4 インタフェースのグローバルな転送構成を制御します。システムのデフォルトは disabled です。有効な場合、IP は必要に応じてインタフェースへの、およびインタフェースからの、IPv4 パケットの転送を行います。無効な場合、IP は必要に応じてインタフェースへの、およびインタフェースからの、IPv4 パケットの転送を行いません。
IPv4 ルーティングデーモンを実行するかどうかを決定します。/etc/defaultrouter ファイルが存在しない場合はシステムのデフォルトは enabled (defaultrouter(4) を参照)、存在する場合はデフォルトは disabled です。このオプションの値にはすべての IPv4 ルーティングサービスの状態が反映されるため、いずれかの IPv4 ルーティングサービスが有効であれば ipv4-routing は有効になります。これにより、ユーザーは svcadm(1M) および routeadm を使用してルーティングサービスと対話できます。routing-svcs 変数で指定された IPv4 ルーティングサービスは、ユーザーが明示的に ipv4-routing を有効にする次回のブート時に有効になるように準備されます。デフォルトでは、in.routed の SMF ルーティングデーモンサービス (svc:/network/routing/route:default) が指定されます。
すべての IPv6 インタフェースのグローバルな転送構成を制御します。システムのデフォルトは disabled です。有効な場合、IP は必要に応じてインタフェースへの、およびインタフェースからの、IPv6 パケットの転送を行います。無効な場合、IP は必要に応じてインタフェースへの、およびインタフェースからの、IPv6 パケットの転送を行いません。
IPv6 ルーティングデーモンを実行するかどうかを決定します。システムのデフォルトは disabled です。このオプションの値にはすべての IPv6 ルーティングサービスの状態が反映されるため、いずれかの IPv6 ルーティングサービスが有効であれば ipv6-routing は有効になります。これにより、ユーザーは svcadm(1M) および routeadm を使用してルーティングサービスと対話できます。routing-svcs 変数で指定された IPv6 ルーティングサービスは、ユーザーが明示的に ipv6-routing を有効にする次回のブート時に有効になるように準備されます。デフォルトでは、in.ripngd の SMF ルーティングデーモンサービス (svc:/network/routing/ripng:default) が指定されます。
転送の設定とルーティングの設定は関連していますが、互いに依存しているわけではありません。たとえば、ルーターは通常 IP パケットを転送しルーティングプロトコルを使用しますが、パケットを転送し経路指定プロトコルを使用しないようにルーターを構成することも管理者の自由です。その場合、管理者は転送を有効にし、ルーティングを無効にし、ルーターのルーティングテーブルに静的な経路を入力することになります。
転送設定はグローバル設定です。各インタフェースには、特定のインタフェースとのパケット転送が可能かどうかを決定する IFF_ROUTER 転送フラグもあります。そのフラグは、ifconfig(1M) のルーターオプションによって独立して制御できます。グローバルな転送設定が変更された (つまり、–u が発行されて値が enabled から disabled、またはその逆に変更された) 場合、システム内のすべてのインタフェースフラグが同時に変更され、新しいグローバルポリシーが反映されます。DHCP によって自動的に構成されるインタフェースでは、そのインタフェース固有の IFF_ROUTER フラグがクリアされます。
新しいインタフェースが ifconfig によって plumb された場合、インタフェース固有の転送フラグの値は、現在のグローバルな転送値に従って設定されます。したがって、転送値はすべての新しいインタフェースの「デフォルト」になります。
IPv4 転送はデフォルトで無効になっています。次のコマンドは、IPv4 転送を有効にします。
example# routeadm -e ipv4-forwarding使用例 2 構成されている設定を実行中のシステムに適用する
前の例では、システムの設定は変更されましたが、次のようなコマンドを使用しないかぎり、次回のリブートまで有効になりません。
example# routeadm -u使用例 3 設定をそのデフォルトに戻す
最初の例で変更した設定をそのデフォルトに戻すには、次のように入力します。
example# routeadm -r ipv4-forwarding example# routeadm -u使用例 4 in.routed を –q フラグ付きで起動する
–q フラグを設定することは、SMF サービスでは quiet_mode プロパティーを true に設定することで表されます。次の一連のコマンドは、in.routed を –q フラグ付きで起動します。
example# routeadm -m route:default quiet_mode=true example# routeadm -e ipv4-routing -u
プロパティーの名前およびそれらがデーモンの動作にどのように関連するかの詳細については、in.routed(1M) を参照してください。
次の終了ステータスが返されます。
正常終了。
システム構成の取得または変更中にエラーが発生しました。
IP 転送およびルーティングのパラメータ。(編集するものではありません。)
属性についての詳細は、マニュアルページの attributes(5) を参照してください。
|
ifconfig(1M), in.routed(1M), ipadm(1M), svcadm(1M), gateways(4), attributes(5), smf(5)