VOQ_INBAND_INTERFACE テーブル¶

概要¶

VOQ_INBAND_INTERFACE テーブルは VOQ chassis におけるラインカード間のインバンド通信用論理インターフェース (Ethernet-IB<n>) を CONFIG_DB に定義する³。BGP internal-neighbor などのコントロールプレーン通信に使われる。テーブルは 2 段構造:

VOQ_INBAND_INTERFACE_LIST (key: name)
VOQ_INBAND_INTERFACE_IPPREFIX_LIST (key: name, ip-prefix)

データフロー (自動生成)¶

flowchart LR
  CDB[("CONFIG_DB<br/>VOQ_INBAND_INTERFACE")]
  DM["intfmgrd"]
  CDB --> DM
  APPDB[("APP_DB<br/>APP_DB")]
  DM --> APPDB
  SYNCD["syncd"]
  APPDB --> SYNCD

凡例

CONFIG_DB から SAI までの典型経路を docs/reference/config-db-orch-map.md から機械生成したミニ図。詳細・例外は本ページ本文と対応表を参照。

key 構造¶

VOQ_INBAND_INTERFACE|<name>
VOQ_INBAND_INTERFACE|<name>|<ip-prefix>

VOQ_INBAND_INTERFACE_LIST フィールド¶

フィールド	型	デフォルト	説明
`name` (key)	string パターン `Ethernet-IB[0-9]+`	—	インバンド IF 名
`inband_type`	string パターン `port\\|Port`	`port`	インバンドタイプ

VOQ_INBAND_INTERFACE_IPPREFIX_LIST フィールド¶

フィールド	型	説明
`name` (key)	leafref → `VOQ_INBAND_INTERFACE_LIST.name`	親インターフェース
`ip-prefix` (key)	`sonic-ip-prefix`	アサイン IP プレフィックス

制約¶

name は Ethernet-IB<数値> パターン
inband_type は port または Port

購読者¶

intfmgrd / intfsyncd (sonic-swss)
bgpcfgd / bgpd — BGP internal neighbor のソース interface として使う場合

値依存挙動マトリクス¶

本テーブルは enum フィールドが少なく、フィールドはほぼ string パターンで制御される。

フィールド	値	実挙動
`inband_type`	`port`	インバンドタイプを port に設定（デフォルト、YANG default "port"）
`inband_type`	`Port`	`port` と同義。YANG pattern "port\|Port" で両方許可
`inband_type`	省略	YANG default `"port"` が補完される
`inband_type`	その他	YANG pattern 違反で reject
`name`	`Ethernet-IB<n>`	有効な VOQ インバンド IF 名
`name`	その他	YANG `pattern "Ethernet-IB[0-9]+"` 違反で reject

例外条件・特殊挙動 ¶

名前パターン (YANG): pattern "Ethernet-IB[0-9]+" — パターン違反は YANG バリデーションで reject される¹。
inband_type パターン (YANG): pattern "port|Port" のみ許可¹。
IP プレフィクス leafref (YANG): VOQ_INBAND_INTERFACE_IPPREFIX_LIST の name は VOQ_INBAND_INTERFACE_LIST/name への leafref — 対応エントリが存在しない場合 YANG バリデーションで reject¹。
デフォルト補完: inband_type 省略時は YANG default "port" が補完される¹。
インタフェース未 ready: 親インタフェースが STATE_DB に未登録の場合 intfmgrd はリトライ待ちとなる（通常の VLAN_INTERFACE と同動作）²。

引用元¶

運用ヒント¶

典型値¶

key 形式: VOQ_INBAND_INTERFACE|<name> (例 VOQ_INBAND_INTERFACE|Ethernet-IB0)、VOQ_INBAND_INTERFACE|<name>|<ip-prefix>。
inband_type=port が一般的。

よくある誤設定¶

name が Ethernet-IB<n> パターンに一致しない命名で YANG validation エラー。
VOQ chassis 以外の単体スイッチで設定して効果が無い (VOQ 専用)。

確認コマンド¶

sonic-db-cli CONFIG_DB keys 'VOQ_INBAND_INTERFACE|*'
show interfaces status Ethernet-IB0
show ip interface | grep Ethernet-IB

sonic-buildimage/src/sonic-yang-models/yang-models/sonic-voq-inband-interface.yang https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-voq-inband-interface.yang ↩↩↩↩
sonic-swss/cfgmgr/intfmgr.cpp https://github.com/sonic-net/sonic-swss/blob/master/cfgmgr/intfmgr.cpp ↩
YANG 定義: sonic-voq-inband-interface.yang. https://github.com/sonic-net/sonic-buildimage/blob/9ea932ec2e18f35e58268ec2e4456b1d4afd65cd/src/sonic-yang-models/yang-models/sonic-voq-inband-interface.yang ↩