ROUTE_TABLE (APPL_DB)¶

概要¶

APPL_DB:ROUTE_TABLE は IPv4/IPv6 ユニキャストルート（デフォルト VRF および VRF-aware）を保持するテーブル。 fpmsyncd がカーネルの netlink メッセージ（RTM_NEWROUTE / RTM_DELROUTE、アドレスファミリ AF_INET / AF_INET6）を受信すると RouteTableFieldValueTupleWrapper を通じて書き込む。 routeorch の doRouteTask() がこのテーブルを購読し、SAI route_entry を作成・更新・削除する。

データフロー¶

flowchart LR
  FRR["FRR / zebra<br/>(ルートテーブル管理)"]
  KERN["Linux kernel<br/>(IP ルーティング)"]
  FPMS["fpmsyncd<br/>onRouteMsg()"]
  APPL[("APPL_DB<br/>ROUTE_TABLE")]
  RORCH["routeorch<br/>doRouteTask()"]
  SAI["SAI Route API<br/>route_entry"]
  HW["ASIC"]
  FRR -->|FPM netlink| FPMS
  KERN -->|netlink RTM_NEWROUTE| FPMS
  FPMS -->|ProducerStateTable SET| APPL
  APPL -->|ConsumerStateTable| RORCH
  RORCH --> SAI --> HW

key 構造¶

ROUTE_TABLE|<prefix>
ROUTE_TABLE|<vrf-name>:<prefix>

<prefix>: CIDR 形式の IPv4 または IPv6 プレフィクス（例: 192.168.1.0/24, 2001:db8::/32）
<vrf-name>: VRF 名（非デフォルト VRF の場合。Vrf プレフィクスで始まる必要がある）

管理 VRF（mgmt）宛のルートは fpmsyncd がスキップする。

フィールド¶

フィールド	型	デフォルト	説明
`nexthop`	string	`""` (省略)	ゲートウェイ IP アドレスのカンマ区切りリスト。ECMP 時は複数エントリをカンマで並べる
`ifname`	string	`""` (省略)	出力インタフェース名のカンマ区切りリスト。`nexthop` と要素数を一致させる必要がある
`blackhole`	boolean string	`"false"` (省略)	`"true"` のとき `SAI_PACKET_ACTION_DROP` を設定するブラックホールルート
`protocol`	string	`""` (省略)	ルート起源プロトコル名。`getProtocolString()` が rtm_protocol 番号から変換（例: `"bgp"`, `"static"`, `"ospf"`）。省略時は routeorch が無視
`weight`	string	`""` (省略)	ECMP ネクストホップ重みのカンマ区切りリスト。省略時は均等分散
`nexthop_group`	string	`""` (省略)	NhgOrch が管理する NHG インデックスキー文字列。指定時は `nexthop`/`ifname` と排他
`mpls_nh`	string	`""` (省略)	outgoing MPLS ラベル操作のカンマ区切りリスト（SRv6/MPLS ハイブリッド経路用）
`vni_label`	string	`""` (省略)	EVPN VXLAN の VNI 値。存在すれば overlay_nh フラグが有効になる
`router_mac`	string	`""` (省略)	EVPN 宛先 VTEP の MAC アドレス
`segment`	string	`""` (省略)	SRv6 SID-list テーブルキー（`SRV6_SID_LIST_TABLE` の key を参照）
`seg_src`	string	`""` (省略)	SRv6 encap の source アドレス

コード由来デフォルトの根拠¶

`blackhole` — デフォルト `"false"` (フィールド省略)¶

RouteTableFieldValueTupleWrapper の C++ 初期値として string("false") が宣言され、非 ZMQ パスでは "false" に一致する場合は fvVector に追加しない:

// sonic-swss fpmsyncd/routesync.h:117
string blackhole = string("false");

// fpmsyncd/routesync.cpp:1022-1024
if (blackhole != string("false")) {
    fvVector.push_back(FieldValueTuple("blackhole", blackhole.c_str()));
}

RTN_BLACKHOLE タイプのルートのみ fvw.blackhole = "true" にセットされる（routesync.cpp L2177）。routeorch 側では bool blackhole = false を初期値としてフィールド不在を false と解釈する（routeorch.cpp L737, L765-L766）。

`protocol` — デフォルト `""` (フィールド省略)¶

C++ 初期値は string()（空文字列）。空文字列のとき APPL_DB に書かない:

// fpmsyncd/routesync.h:116
string protocol = string();

// fpmsyncd/routesync.cpp:1019-1021
if (protocol != string()) {
    fvVector.push_back(FieldValueTuple("protocol", protocol.c_str()));
}

getProtocolString() は libnl の rtnl_route_proto2str() を呼んで rtm_protocol 番号を文字列に変換する。未知プロトコルは数値文字列となる。

`nexthop` / `ifname` — デフォルト `""` (フィールド省略)¶

両フィールドとも C++ 初期値は string()。空のとき APPL_DB に書かない。 RTN_UNICAST かつ nexthop が空・非 blackhole の場合、routeorch はルートをスキップする:

// orchagent/routeorch.cpp:857
if (alsv.size() == 0 && !blackhole && !srv6_nh)

NHG ID を持つルートでマルチ NH の場合は nexthop_group のみが書かれ、 nexthop/ifname は書かれない。

`nexthop_group` — `nexthop`/`ifname` と排他¶

nexthop_group と nexthop/ifname を同時に書くと routeorch がエラーにする:

// orchagent/routeorch.cpp:810-814
if (!nhg_index.empty() && (!ips.empty() || !aliases.empty()))
{
    SWSS_LOG_ERROR("Route %s has both nexthop_group and ips/aliases", key.c_str());
    it = consumer.m_toSync.erase(it);
    continue;
}

`weight` — デフォルト `""` (フィールド省略、均等分散)¶

空文字列のとき省略。orchagent 側で weight 不在 = 均等 ECMP として扱う。 fpmsyncd の getNextHopWt() が weight を取得し、非空のときのみ fvw.weight を設定する（routesync.cpp L2285-L2288）。

制約・注意事項¶

eth0, docker0, eth1-midplane 宛のルートは fpmsyncd がスキップし DEL を発行する
管理 VRF (mgmt*) 宛のルートは fpmsyncd がスキップする（SWSS_LOG_INFO のみ）
ZMQ 有効時（ORCH_NORTHBOND_ROUTE_ZMQ_ENABLED）は全フィールドを常に送信（空文字列含む）
DEL 操作の前に暗黙的な DEL が走る（warm restart 非使用時）。これにより古いフィールドが Redis から消去される
nexthop_group と nexthop/ifname の同時指定はエラー

購読者¶

routeorch::doRouteTask() (sonic-swss/orchagent/routeorch.cpp): SAI route_entry の作成・更新・削除

書き込み元¶

fpmsyncd::RouteSync::onRouteMsg() (sonic-swss/fpmsyncd/routesync.cpp): カーネル netlink IPv4/IPv6 ルート受信時
fpmsyncd::RouteSync::onSrv6Msg() (sonic-swss/fpmsyncd/routesync.cpp): SRv6 VPN ルート受信時