LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

birdc

Control client for the BIRD routing daemon

TLDR

Show protocols
$ birdc show protocols
copy
Show routes
$ birdc show route
copy
Show protocol details
$ birdc show protocols all [bgp1]
copy
Reload configuration
$ birdc configure
copy
Disable protocol
$ birdc disable [bgp1]
copy

SYNOPSIS

birdc [options] [command]

DESCRIPTION

birdc is the client for the BIRD routing daemon. It connects to the BIRD daemon via a control socket and allows querying routing information, managing protocols, and reconfiguring the daemon.The tool is the primary interface for monitoring and controlling BIRD.

PARAMETERS

-s socket

Control socket path
-r
Restricted mode

CONFIGURATION

/etc/bird.conf

Main configuration file for the BIRD routing daemon that birdc controls. Distributions such as Debian use /etc/bird/bird.conf instead. The default control socket is /run/bird/bird.ctl (older builds use /var/run/bird/bird.ctl).

COMMON COMMANDS

show protocols [all] [name]

Display routing protocols status
show route [all]
Display routing table
show interfaces
Show network interfaces
show status
Show daemon status
configure [file]
Reload configuration
enable protocol
Enable protocol
disable protocol
Disable protocol
restart protocol
Restart protocol
down
Shut down BIRD daemon

WORKFLOW

$ # Show all protocols
birdc show protocols

# Detailed protocol info
birdc show protocols all bgp1

# Show routing table
birdc show route

# Show specific route
birdc show route for 192.0.2.0/24

# Reload config
birdc configure

# Restart BGP session
birdc restart bgp1
copy

INTERACTIVE MODE

$ # Start interactive session
birdc

bird> show protocols
bird> show route all
bird> exit
copy

INSTALL

sudo apt install bird2
copy
sudo dnf install bird
copy
sudo pacman -S bird
copy
sudo apk add bird
copy
sudo zypper install bird
copy
nix profile install nixpkgs#bird2
copy

CAVEATS

Requires BIRD daemon running. Socket permissions may restrict access. Some commands need privileges. Configuration errors can disrupt routing. Changes are immediate (no confirmation).

HISTORY

birdc has been part of the BIRD suite since its creation in 1998 as the control interface for the routing daemon. BIRD was developed by Ondrej Filip, Pavel Machek, and Martin Mares, and is now maintained by CZ.NIC Labs. Up to BIRD 1.x a separate birdc6 client controlled the IPv6 daemon; BIRD 2.x merged IPv4 and IPv6 into a single daemon, so birdc alone now manages both.

SEE ALSO

bird(8), bgpctl(8), vtysh(1)

RESOURCES

Copied to clipboard
Kai