コンテンツにスキップ

FDB テーブル

概要

CONFIG_DB の FDB テーブルは静的 MAC アドレス エントリをプロビジョニングするテーブルである1。キー形式 FDB|<VlanName>|<MAC> で VLAN とMACアドレスを指定し、送出ポートとエントリ種別を保持する。

動的に学習された MAC エントリは APPL_DB の FDB_TABLE に書かれる。CONFIG_DB の FDB は静的エントリ（ユーザー手動設定や PAC/802.1X による設定）専用である。

コード由来デフォルト

field: type

fdborch.cpp:770 で string type = "dynamic"; と初期化される。type フィールドが省略されると "dynamic" がデフォルト値として使用される。

// sonic-swss/orchagent/fdborch.cpp:769-770
string port = "";
string type = "dynamic";

有効値: "static" / "dynamic" / "dynamic_local"（MCLAG ローカル扱い）。

field: port

fdborch.cpp:769 で string port = ""; と初期化される。port フィールドが省略されると空文字のまま addFdbEntry() に渡され、ポート解決に失敗するため FDB エントリが登録されない。実装上は必須フィールド。

SAI 型マッピング

type 値 SAI 型
"static" SAI_FDB_ENTRY_TYPE_STATIC
"dynamic" SAI_FDB_ENTRY_TYPE_DYNAMIC
"dynamic_local" SAI_FDB_ENTRY_TYPE_DYNAMIC（MCLAG ローカル）

key 構造

FDB|<VlanName>|<MAC>
  • <VlanName>: Vlan<id> 形式 (例: Vlan100)
  • <MAC>: MAC アドレス (例: 00:01:02:03:04:05)

フィールド一覧

フィールド 型 必須 デフォルト 説明
port string 実質必須 "" (空) 送出ポート名 (例: Ethernet0, PortChannel1)
type "static" | "dynamic" - "dynamic" エントリ種別。静的プロビジョニングには "static" を使用

購読者

  • orchagent / FdbOrch: APPL_DB の FDB_TABLE を購読して SAI FDB エントリを作成・削除する。CONFIG_DB FDB から APPL_DB FDB_TABLE への橋渡しは swssconfig が担う
  • PAC (sonic-pac) / paccfg: 802.1X 認証後、CONFIG_DB FDB テーブルを読み出して静的 MAC エントリの有無を確認する (pac_authmgrcfg.cpp:173)

データフロー

flowchart LR
  User["ユーザー / swssconfig"]
  CDB[("CONFIG_DB<br/>FDB")]
  APPDB[("APPL_DB<br/>FDB_TABLE")]
  FdbOrch["orchagent<br/>FdbOrch"]
  SAI["SAI<br/>sai_fdb_api"]

  User --> CDB
  CDB -->|swssconfig| APPDB
  APPDB --> FdbOrch
  FdbOrch --> SAI

動的学習エントリ

カーネルの FDB 学習イベントは fdbsyncd が netlink から受け取り APPL_DB の FDB_TABLE に直接書き込む。CONFIG_DB FDB を経由しない。

書き込み入り口

書き込み元 コード箇所 type 値
swssconfig (手動投入) swssconfig -d -j fdb.json "static" が一般的
PAC / 802.1X pac_authmgrcfg.cpp:64-76 "static"
fdbsyncd (自動学習) APPL_DB 直接 (CONFIG_DB を経由しない) "dynamic"

関連 CONFIG_DB / YANG / CLI

  • 関連 CONFIG_DB: VLAN、VLAN_MEMBER
  • 関連 CLI: show mac (FDB テーブル表示)、sonic-clear fdb all (動的エントリクリア)

例外条件・特殊挙動

  • port 省略時: addFdbEntry() でポート解決が失敗し、エントリが追加されない。エラーログ出力。
  • type の assert チェック: fdborch.cpp:830 で assert(type == "dynamic" || type == "dynamic_local" || type == "static") — 無効な type 値はプロセスクラッシュを引き起こす。
  • CONFIG_DB FDB は直接 orchagent に購読されない: FdbOrch は APPL_DB の FDB_TABLE を購読する。CONFIG_DB FDB は swssconfig を介して APPL_DB に転記される。

引用元

  1. sonic-swss-common/common/schema.h:358 — #define CFG_FDB_TABLE_NAME "FDB". https://github.com/sonic-net/sonic-swss-common/blob/master/common/schema.h ↩