show arp サブコマンド¶

概要¶

show arp は IPv4 の 隣接テーブル（ARP テーブル）を表示する click コマンド。実装は単なる薄いラッパで、内部では scripts/nbrshow を -4 付きで起動する¹。nbrshow 側が APPL_DB の NEIGH_TABLE と kernel の ip neigh 出力を突き合わせて表形式に整形する。

シグネチャ¶

show arp [<ipaddress>] [-if <iface>] [-n <namespace>] [-d <display>] [--verbose]

オプション	意味
`<ipaddress>` (positional, optional)	1 エントリのみ絞り込む IPv4 アドレス
`-if`, `--iface`	インタフェース名でフィルタ。`alias` モード時は `iface_alias_converter.alias_to_name()` で内部名へ変換
`-n`, `--namespace`	multi-ASIC 時の namespace 指定（`multi_asic_click_options` 由来）
`-d`, `--display`	`all` / `frontend` 等の display スコープ
`--verbose`	起動する `nbrshow` コマンド文字列を echo

起動コマンド¶

cmd = ['nbrshow', '-4']
if ipaddress: cmd += ['-ip', str(ipaddress)]
if iface:     cmd += ['-if', str(iface)]      # alias 名は内部名に変換
if namespace: cmd += ['-n', str(namespace)]
cmd += ['-d', str(display)]

nbrshow 自体は Python スクリプトで、scripts/nbrshow に置かれている。

別名と関連¶

show ip arp も同じ arp コマンドを show ip グループに add_command した結果として動く（cli 直下と ip サブ両方に同じ関数が登録される）。

クリア側は sonic-clear arp [<ipaddress>] [-n <ns>] が対称。詳細は clear (sonic-clear) コマンドを参照。

CONFIG_DB との接点¶

ARP テーブルは kernel の neighbor table（および swss/neighsyncd 経由で APPL_DB の NEIGH_TABLE に同期）で管理されるため、show arp 自体は CONFIG_DB を読まない。

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

flowchart LR
  CLI["show arp"]
  SRC0[("APP_DB<br/>NEIGH_TABLE")]
  V0["nbrshow (-4)"]
  SRC0 --> V0 --> CLI

凡例

show 系 (データソース → ラッパスクリプト → CLI) のミニ図。CONFIG_DB は経由しない。

引用元¶

実行例¶

典型的な使い方¶

# 例 1: ARP テーブル表示
show arp

よくある引数の組み合わせ¶

show arp 10.0.0.1
show arp -if Ethernet0
show arp -vrf Vrf_Red

期待される出力 (抜粋)¶

Address         MacAddress         Iface         Vlan
--------------  -----------------  ------------  ----
10.0.0.1        00:11:22:33:44:55  Ethernet0     -
10.0.0.5        00:11:22:33:44:66  Ethernet4     -
Total number of entries 2

運用ヒント¶

典型的な利用シーン¶

L3 隣接の MAC 解決状況、aging 状態の確認。
MC-LAG / VRRP 構成での ARP 同期検証。

よくある落とし穴¶

show arp は default VRF。VRF 内 ARP は show arp -V <vrf> または ip neigh show vrf <vrf>。
STATE_DB の NEIGH_TABLE と kernel ARP がズレる場合あり。両方で裏取り。