Guide

CLI Reference

Ze provides an interactive CLI and single-command execution for runtime queries and control. All CLI access goes through the daemon's SSH server.

Usage

ze cli                              # Interactive CLI with tab completion
ze cli -c "show bgp peer list"   # Execute single command and exit
ze show peer upstream1 detail         # Read-only query (safe for scripts)
ze cli -c "request peer upstream1 teardown 2" # One-shot command (full access)

Modes

Command Access Use Case
ze cli Interactive, full Exploring, monitoring, operating
ze show <cmd> Read-only Scripting, monitoring dashboards
ze cli -c <cmd> Full Automation, route injection

Peer Commands

Command Description
show bgp peer list List all peers (brief)
show bgp peer <sel> detail Show peer details and statistics
request peer <sel> teardown <code> Graceful session closure with NOTIFICATION
delete bgp peer <name> Remove peer
request peer <sel> pause Pause reading from peer (flow control)
request peer <sel> resume Resume reading from peer
show bgp peer <sel> capabilities Show negotiated capabilities
show bgp summary BGP summary table

Peer selector: * (all), exact IP, glob patterns (192.168.*.*), exclusion (!addr), or peer name.

Route Commands

Command Description
peer <sel> update text <attrs> nlri <family> <op> <prefix> Text-format UPDATE
peer <sel> update hex <hex> Hex-format UPDATE
show bgp rib received [peer] [family] Show Adj-RIB-In
show bgp rib sent [peer] [family] Show Adj-RIB-Out
clear bgp rib in [peer] Clear Adj-RIB-In
clear bgp rib out [peer] Clear Adj-RIB-Out

See Route Injection guide for UPDATE syntax details.

Cache Commands

Command Description
cache list List cached messages
cache forward <id> <peer> Forward cached message to peer
cache release <id> Release message from cache

Event Subscription

Command Description
bgp monitor Stream live events (see Monitoring guide)
bgp monitor peer <addr> event <type> direction <dir> Filtered stream

Commit Workflow

Named update windows for atomic route changes:

Command Description
request commit start <name> Begin named update window
request commit end <name> End window and send updates
request commit eor <name> Send End-of-RIB for window
request commit rollback <name> Discard changes
request commit show <name> Show commit status
request commit list List named commits

RPKI Commands

Command Description
show bgp rpki status RTR session count and VRP counts
show bgp rpki cache Cache server connection details
show bgp rpki roa ROA table summary
show bgp rpki summary Validation statistics

Daemon Control

Command Description
request shutdown Graceful shutdown
route-refresh <family> Send route refresh request
help List all commands
command-list All commands with descriptions
command-help <name> Detailed help for a command

Signals

Command Description
ze signal reload Reload configuration
ze signal stop Graceful shutdown (no GR marker)
ze signal restart Graceful restart (with GR marker)
ze signal quit Goroutine dump and exit
ze status Check if daemon is running

Interactive Features

In ze cli interactive mode: