Skip to content

chalkctl node routes

chalkctl node routes <node> [<prefix>] [flags]

Shows the routes of a node of a router image: the routes in its kernel, of the main table unless --vrf names a VRF, whose table it shows, or --table names another table or all, and the paths the BGP instance of that VRF selected, the best of a prefix marked *. A path the instance imports from another VRF names that VRF as its peer. With a prefix, it shows the routes to that range and to ranges within it; with --protocol, the kernel's routes of that protocol alone, and BGP's paths only for bgp. --vrf and --table exclude each other, and --vrf fails on a node whose image does not know VRFs. A router whose image carries no BGP shows the kernel's routes alone. A node of another image answers that the router layer is not in its image. The command needs a reader client file or the secrets file.

Flags

Flag Type Default Description
--address list of [NODE=]ADDR each node's address in the inventory Address of a node's chalkd: host or host:port for the node the command names, or NODE=ADDR for any node; may be repeated.
--config string $CHALKOSCONFIG, else ~/.config/chalkos/config, unless --secrets is given Client file to authenticate with instead of the secrets file.
--identity list of string ~/.config/chalkos/age.key, ~/.ssh/id_ed25519, ~/.ssh/id_rsa File holding an age identity to decrypt the secrets with; may be repeated.
--inventory string $CHALKOSINVENTORY, else chalkos.yaml in the current directory, when it exists Inventory naming the cluster's nodes, their addresses and their config files.
--protocol string — Only the kernel's routes of this protocol, such as kernel, static, ra, dhcp or bgp.
--secrets string — Cluster secrets path (.age, .enc.*, or plaintext), provider URI, or - for standard input.
--table string main The kernel's routing table: main, local, default, all or a number.
--vrf string — A VRF, by the name of its VRF document, or default: its table and its BGP instance's paths.

Examples

# Every route of r1's main table and BGP's paths.
chalkctl node routes r1

# Every IPv6 route, in the kernel and in BGP.
chalkctl node routes r1 ::/0

# The routes of the VRF tenant: its table and its BGP instance's paths.
chalkctl node routes r1 --vrf tenant

# The routes zebra installed from BGP in every table, and BGP's paths.
chalkctl node routes r1 --protocol bgp --table all

See also

  • chalkctl node: Manage a node's access, activate its staged image, reboot it and show its diagnostics and routes