コンフィグの書式
コンフィグの記述ルールや書式凡例の読み方を説明します。
- キー
- 区切り文字(コロン":")
- バリュー
また、一つの機能の動作を設定するための一連のパラメータを「エントリ」と呼び、エントリは後述するインデックス番号やインタフェース名によって識別されます。
次の例は三つのパラメータを設定したコンフィグの記述です。interface.ge0.ipv4.address : 192.168.0.1/24
route.ipv4.0.destination : default
route.ipv4.0.gateway : pppoe0
- 1行目はインタフェースを設定する一つのエントリです。
- 2行目から3行目は静的経路を設定する一つのエントリです。
コンフィグ記述上の注意
- コンフィグ内にキーの重複がある場合は、重複行が全てエラーになります。
- キーの記述に空白を含めるとエラーになります。
- 未定義のキーが記述された行はエラーになります。
- コンフィグ中にコメントは記述できません。
- 全角文字などマルチバイト文字は使用できません。
- キー、及びバリューの前後に記述された空白は無視します。
- 空行(改行のみの行)は無視します。
- キーのみでバリューが記述されていない行は無視します。
- コロンが複数記述されている場合は、最も左側のコロンを区切りとして扱います。
パラメータの書式凡例
機能ごとに設定可能なパラメータの一覧を示すコンフィグパラメータリファレンスでは、コンフィグの書式を次のように記載しています。
キー | バリュー | ||||
---|---|---|---|---|---|
|
|
||||
|
|
||||
|
|
||||
|
|
キー
区切り文字(":")の左側に記述する「キー」は各機能の設定項目に相当し、システムに定義済みの文字列で記述します。
表記 | 意味 |
---|---|
[](例:filter.ipv4.[].action) | ピリオドに挟まれた空の"[]"はエントリのインデックス番号の記述箇所を示します。インデックス番号は8桁の任意の整数を指定できます。 |
[0-n](例:interface.ipsec[0-63]) | 数値範囲を含む"[0-n]"は主にインタフェース名の表現で使用しています。範囲内の整数を指定できます。 |
インデックス番号の記述
同一の機能で複数のエントリを設定可能な場合には、パラメータが所属するエントリを区別するためのインデックス番号をキー中に記述します。
キーにインデックス番号を含むパラメータの記述例を次に示します。
filter.ipv4.111.label : filter-example1
filter.ipv4.111.direction : in
filter.ipv4.111.action : pass
filter.ipv4.222.label : filter-example2
filter.ipv4.222.direction : out
filter.ipv4.222.action : block
-
"[]" をインデックス番号に置き換えて記述します。
インデックス番号の書式の注意
- インデックス番号は数字で記述します。8桁以内の正の数が使用でき、連番である必要はありません。また、「001」といった記述が可能ですが、処理上は「1」として扱います(文字列ではなく数値として扱います)。
- コンフィグ上の記述順によらず、インデックス番号を数値として昇順ソート(最小値が先頭)した上で動作に反映します。
キー | 読み方 |
---|---|
|
DHCPv6クライアントのコンフィグエントリを4個まで設定できます。
ひとつの機能の構成に複数種のキーを含む場合は共通パートのみ示し、固有パートを "..." として省略しています。 |
|
"[]" を複数含むキーの説明箇所では、最後の "[]" を置き換えるインデックス番号の個数上限を示します。
このキーの場合は最大4個のDHCPv6クライアント設定それぞれについて、Prefix Delegationの設定が35個まで設定できます。 注: 書式の解釈とは別に機能全体に係る上限が存在する場合は個別の注意書きとして記載します。
|
インタフェース名の記述
インタフェース名はシステムに定義され、複数個使用可能なインタフェースは"pppoe[0-1]"のようにインタフェースの番号を"[0-n]"の書式で示します。
キー | バリュー |
---|---|
interface.pppoe[0-1].id |
<String> |
interface.pppoe[0-1].password |
<String> |
キーにインタフェース名を含むパラメータの記述例を次に示します。
interface.pppoe0.id : id001@example.jp
interface.pppoe0.password : PassPhrase
interface.pppoe1.id : id002@example.jp
interface.pppoe1.password : PassWord
- "[0-n]" を、使用するインタフェースの番号に置き換えて記述します。
インタフェース名の書式の注意
- 使用可能な個数が1個のインタフェースは"wwan0"のように固定文字列で示します。
- バリューとしてインタフェース名を指定する場合の書式も同様です。
バリュー
区切り文字(":")の右側に記述する「バリュー」は設定項目に対する設定値に相当し、パラメータごとに定義された規則に従った文字列で記述します。
表記 | 意味 |
---|---|
|
特に装飾のない文字列表記はシステムに定義された固定のキーワード文字列です。そのまま記述します。
|
|
"<>" で括られた文字列表記は、任意の数値や文字列、または固定のキーワード文字列の候補から記述します。入力時に"<>"記号は不要です。使用可能な文字や数値の範囲および候補は基本的に項目内に記載しますが、共通事項はバリュー名のリンク先に記載する場合があります。
|
|
機能有効化時に、当該キーが設定されていない場合の動作を記載します。
|
表記 | 意味 |
---|---|
keyword-a | keyword-b | <varname> |
"|" で区切られたキーワードは選択肢です。いずれか一つを指定します。 |
0-9999 |
数値を"-"で繋いだ値は数値の下限と上限を示します。通常は正の整数を十進数で指定します。 |
[0-9] |
"[.....]" で括られた文字列表記は使用可能な文字種に制限があることを示します。[0-9]は整数のみ、[-.A-Za-z]はハイフン、ピリオド、および英大文字小文字が使用できることを示します。 |
[-.A-Za-z] |
- 特殊文字の入力
- バリューの文字列に以下の特殊文字を含める場合は、表に示すエスケープシーケンスを入力してください。
特殊文字 エスケープシーケンス \(バックスラッシュまたは円マーク) \\ "(二重引用符) \" |(バーティカルバー)※Shellコマンドインタフェースでの直接入力時のみ \| 空白 バリュー全体を二重引用符(" ")で括る
- エスケープ文字としての\や"はバリューの文字数にカウントされません。
説明文中の省略表記
- 例:
interface.pppoe0...
制約
機能を設定するにあたり特定の条件があるキーは同欄に記載ます。