APPL_DB VRF_TABLE テーブル¶

概要¶

VRF_TABLE は APPL_DB 上に存在する VRF エントリテーブル。vrfmgrd が CONFIG_DB VRF テーブルを購読し、Linux VRF デバイス (ip vrf add) を作成した後に APP_VRF_TABLE_NAME = "VRF_TABLE" へ pass-through 書き込みを行う¹。orchagent 内の VRFOrch がこのテーブルを購読し、sai_virtual_router_api->create_virtual_router() を通じてハードウェア VRF (SAI Virtual Router) を生成する²。テーブル名定数は schema.h:80 で APP_VRF_TABLE_NAME = "VRF_TABLE" と定義される³。

key 構造¶

VRF_TABLE|<vrfName>

<vrfName> は CONFIG_DB の VRF key と同一。YANG sonic-vrf.yang のパターン制約 Vrf[a-zA-Z0-9_-]+ を満たす文字列（例: VrfRed）および mgmt が書き込まれる。

フィールド一覧¶

フィールド	型	必須	説明
`fallback`	boolean	-	CONFIG_DB から pass-through。orchagent で silent drop (dead field)
`vni`	uint32	-	L3 VNI マッピング。`0` = なし
`v4`	boolean	-	IPv4 admin state (YANG 未定義・VNET 経由のみ)
`v6`	boolean	-	IPv6 admin state (YANG 未定義・VNET 経由のみ)
`src_mac`	MAC address	-	Virtual Router の送信元 MAC (YANG 未定義)
`ttl_action`	packet action	-	TTL=1 パケットの処理 (YANG 未定義)
`ip_opt_action`	packet action	-	IP オプション付きパケットの処理 (YANG 未定義)
`l3_mc_action`	packet action	-	L3 マルチキャスト unknown の処理 (YANG 未定義)
`mgmtVrfEnabled`	boolean	-	orchagent で explicit ignore
`in_band_mgmt_enabled`	boolean	-	orchagent で explicit ignore

書き込み主体¶

vrfmgrd: CONFIG_DB VRF のフィールドを kfvFieldsValues(t) でそのまま転送する (vrfmgr.cpp:303)。フィールドの追加・補完・変換は行わない。

購読者¶

orchagent / VRFOrch: VRF_TABLE を SubscriberStateTable で購読。sai_virtual_router_api->create_virtual_router() または set_virtual_router_attribute() を呼ぶ。成功後 STATE_VRF_OBJECT_TABLE|<vrfName> に state=ok を書き込む²。

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

flowchart LR
  CDB[("CONFIG_DB<br/>VRF")]
  VRFMGRD["vrfmgrd"]
  CDB --> VRFMGRD
  APPDB[("APPL_DB<br/>VRF_TABLE")]
  VRFMGRD --> APPDB
  VRFORCH["orchagent<br/>VRFOrch"]
  APPDB --> VRFORCH
  SAI["SAI<br/>sai_virtual_router_api"]
  VRFORCH --> SAI
  STATEDB[("STATE_DB<br/>VRF_OBJECT_TABLE")]
  VRFORCH --> STATEDB

凡例

CONFIG_DB → APPL_DB → SAI の典型経路。vrfmgrd が APPL_DB 書き込み主体。

制約¶

vni を一度設定した VRF に別の VNI を設定しようとすると VRFOrch::updateVrfVNIMap が "VRF is already mapped to vni" エラーを返す。一旦 vni=0 にリセットが必要²。
ref_count > 0（インタフェース・ルートが参照中）の VRF は削除できない (vrforch.cpp:169-170)。
VRF 削除時は STATE_VRF_OBJECT_TABLE のエントリも削除される (m_stateVrfObjectTable.del、vrforch.cpp:193)。

引用元¶

フィールドの暗黙デフォルト・コード由来挙動 (Phase A)¶

調査日 2026-05-15。ソース: sonic-swss/orchagent/vrforch.cpp、vrforch.h、cfgmgr/vrfmgr.cpp、sonic-swss-common/common/schema.h

vrfmgrd の pass-through 挙動¶

vrfmgrd (vrfmgr.cpp:303) は CONFIG_DB フィールドを加工せずそのまま APP_DB へ転送する。フィールド省略はそのまま省略として VRFOrch に届く。

m_appVrfTableProducer.set(vrfName, kfvFieldsValues(t));

`vni` — コード由来デフォルト `0`¶

VRFOrch::addOperation の先頭で uint32_t vni = 0 と初期化される (vrforch.cpp:30)。フィールド省略時または明示的 vni=0 の場合、vni != 0 条件が成立せず updateVrfVNIMap() は呼ばれない。VNI マッピングなしが暗黙デフォルト。

uint32_t vni = 0;                              // vrforch.cpp:30
...
else if (name == "vni")
{
    vni = static_cast<uint32_t>(request.getAttrUint(name));
    continue;  // SAI attrs には追加しない
}
...
if (vni != 0)
{
    error = updateVrfVNIMap(vrf_name, vni);    // VNI マッピング処理
}

`v4` / `v6` — SAI デフォルト依存 (YANG 未定義)¶

フィールドが存在する場合は SAI_VIRTUAL_ROUTER_ATTR_ADMIN_V4_STATE / ADMIN_V6_STATE に変換されるが、CONFIG_DB sonic-vrf.yang に定義がなく通常の config vrf add では書き込まれない。省略時は SAI attrs に追加されないため SAI/ASIC 実装のデフォルト値が使用される。VNET テーブル経由で直接書き込む場合にのみ機能する残存コード。

`src_mac` — 省略時はスイッチ MAC を SAI が使用 (YANG 未定義)¶

フィールドが存在する場合は SAI_VIRTUAL_ROUTER_ATTR_SRC_MAC_ADDRESS に変換。省略時は SAI 側がスイッチのデフォルト MAC を適用する。YANG 未定義・通常経路では書き込まれない。

`ttl_action` / `ip_opt_action` / `l3_mc_action` — 省略時は SAI デフォルト (YANG 未定義)¶

フィールド	SAI 属性	省略時の挙動
`ttl_action`	`VIOLATION_TTL1_PACKET_ACTION`	SAI デフォルト（通常 `TRAP`）
`ip_opt_action`	`VIOLATION_IP_OPTIONS_PACKET_ACTION`	SAI デフォルト
`l3_mc_action`	`UNKNOWN_L3_MULTICAST_PACKET_ACTION`	SAI デフォルト

いずれも request.getAttrPacketAction(name) で SAI attrs に変換されるが、YANG 未定義のため通常 APP_DB に書き込まれない。

`mgmtVrfEnabled` / `in_band_mgmt_enabled` — explicit ignore¶

VRFOrch はこれらのフィールドを明示的に読み飛ばす。SAI 属性への変換も STATE_DB への書き込みも行わない。

// vrforch.cpp:74-78
else if ((name == "mgmtVrfEnabled") || (name == "in_band_mgmt_enabled"))
{
    SWSS_LOG_INFO("MGMT VRF field: %s ignored", name.c_str());
    continue;
}

`fallback` — dead field (silent drop at orchagent)¶

vrforch.h:34 で { "fallback", REQ_T_BOOL } として宣言されているが、VRFOrch::addOperation のすべての if/else チェーンに "fallback" の分岐が存在しない。結果として else ブランチに落ち SWSS_LOG_ERROR("Logic error: Unknown attribute: %s") が出力されてフィールドが破棄される。

vrfmgrd は fallback を pass-through するため APP_DB には届く
VRFOrch がそれを silent drop → SAI・Linux カーネル・FRR のいずれにも影響しない
fallback=true を CONFIG_DB に設定してもデフォルト VRF へのフォールバックは機能しない
これは dead field であり YANG default false のみが有効な設定状態

STATE_DB 書き戻し¶

VRFOrch は VRF 作成・更新成功後に STATE_VRF_OBJECT_TABLE|<vrfName> へ state=ok を書き込む (vrforch.cpp:120, 150)。この state は vrfmgrd::isVrfObjExist() による削除タイミング制御に使用される。