bgpctl
TLDR
Show BGP summary (neighbor status)
SYNOPSIS
bgpctl [-n] [-s socket] command [arguments]
DESCRIPTION
bgpctl is the control program for OpenBGPD, an implementation of the Border Gateway Protocol version 4. It communicates with the running bgpd daemon to display routing information and control BGP sessions.
The command provides visibility into the BGP Routing Information Base (RIB), neighbor session states, and allows administrative actions like resetting sessions or injecting routes. It connects to bgpd via a Unix socket.
bgpctl is part of the OpenBGPD project, which originated in OpenBSD and has been ported to other operating systems.
PARAMETERS
show summary
Display neighbor status overview.show neighbor [peer]
Show detailed neighbor information.show rib [options]
Display routing information base.show network
Show configured network statements.show fib [options]
Show forwarding information base.neighbor peer up
Bring up a neighbor session.neighbor peer down
Bring down a neighbor session.neighbor peer clear
Clear and reset a session.neighbor peer refresh
Request route refresh.network add prefix
Add a network to advertise.network delete prefix
Remove a network advertisement.-n
Show IP addresses instead of names.-s socket
Connect to alternate control socket.
CAVEATS
Requires appropriate permissions to access bgpd control socket. Some commands may disrupt BGP sessions and cause routing changes. The clear command tears down the TCP session while refresh performs a soft reset. Route changes may take time to propagate through the network.
HISTORY
bgpctl is part of OpenBGPD, which was developed by Henning Brauer and Claudio Jeker for OpenBSD starting in 2003. It was designed as a clean, secure implementation of BGP after concerns about other implementations. The portable version for Linux and other systems has been available since 2016. OpenBGPD is known for its simplicity and security focus.
