Skip to content

Show commands#

Show system information

Summary#

Command Description
show Show system information
show address-pools Show dynamic address pools: show address-pools [<name>]
show alarms Show active alarms
show captures Show active packet captures
show cgn Show CG-NAT (NAT44) information
show cgn bindings Show CG-NAT bindings: show cgn bindings [<inside-ip>]
show cgn groups Show CG-NAT IP groups and pool utilisation
show cgn summary Show CG-NAT status and counters
show circuits Show CPE GRE/BGP circuits with tunnel and BGP session state
show circuits vrf Show circuits in one customer VRF
show configuration Show running configuration
show licensing Show licensing status
show licensing telemetry Show the exact telemetry payload the box will send
show protocols Show protocol information
show protocols bgp Show BGP information
show protocols bgp neighbor Show BGP neighbor detail
show protocols bgp summary Show BGP peer summary
show protocols isis Show IS-IS information
show protocols isis adjacencies Show IS-IS adjacencies
show protocols l2tp Show L2TP information
show protocols l2tp tunnels Show L2TP tunnels
show protocols ospf Show OSPF information
show protocols ospf adjacencies Show OSPF adjacencies (OSPFv2 and OSPFv3)
show protocols pppoe Show PPPoE information
show protocols pppoe statistics Show PPPoE statistics
show radius Show RADIUS information
show radius servers Show RADIUS server status
show route Show the IPv4 routing table (default VRF)
show route vrf Show the IPv4 routing table for a VRF
show source-vrf Show source-VRF classification information
show source-vrf rules Show programmed source-VRF classification rules
show subscribers Show subscriber information
show subscribers local Show locally-defined subscribers (no external auth server)
show subscribers sessions Show subscriber sessions
show subscribers summary Show subscriber summary
show system Show system information
show system hardware Show hardware inventory
show system interfaces Show network interfaces
show system status Show system status
show system uptime Show system uptime
show system version Show system version
show vrfs Show configured VRFs and live session counts
show web-ui Show Web UI information
show web-ui auth Show Web UI authentication configuration
show web-ui auth sessions Show active Web UI sessions

Commands#

show address-pools#

Show dynamic address pools: show address-pools [<name>]

Accepts an optional positional argument <name> — show one pool's subnets

Example

user@bng> show address-pools
(no address pools configured)

show alarms#

Show active alarms

Example

user@bng> show alarms
Severity  Alarm ID       Instance  Age          Detail                                                                 
--------  -------------  --------  -----------  -----------------------------------------------------------------------
MAJOR     cgn.pool.high  public-a  7d 03:14:09  CG-NAT IP group 'public-a' is 94% allocated (7712 of 8192 port blocks).

1 active alarm(s).
(lifetime: 1 raised, 0 cleared, 0 events, 0 events dropped)

show captures#

Show active packet captures

Example

user@bng> show captures
Session ID  Destination IP  Max Packets  Max Duration  Started             
----------  --------------  -----------  ------------  --------------------
40213       10.20.2.50      unlimited    unlimited     2026-08-03T10:24:00Z

1 active captures

show cgn bindings#

Show CG-NAT bindings: show cgn bindings [<inside-ip>]

Accepts an optional positional argument <inside-ip> — filter to one inside (subscriber) IPv4 address

show cgn groups#

Show CG-NAT IP groups and pool utilisation

Example

user@bng> show cgn groups
Group        Outside VRF  Public subnets  Chunk  Port cap  Bindings  Chunks used/total
-----------  -----------  --------------  -----  --------  --------  -----------------
residential  (default)    203.0.113.0/24  512    2048      0         -

show cgn summary#

Show CG-NAT status and counters

Example

user@bng> show cgn summary
Enabled:            yes
Running:            no (activates at startup)
Active bindings:    0 / 8192
  auto-learned:     0
Max flows:          2000000
IP groups:          1

show circuits#

Show CPE GRE/BGP circuits with tunnel and BGP session state

show circuits vrf#

Show circuits in one customer VRF

Accepts an optional positional argument <name> — customer VRF name (as configured in routing.vrfs)

show configuration#

Show running configuration

Accepts an optional positional argument <section> — configuration section (e.g., protocols, system)

Example

user@bng> show configuration routing
routing {
    asn 65000;
    routerId 10.255.255.10;
    hostname bng-demo-a;
    peers {
        [0] {
            address 10.255.255.2;
            description pe01.hul1;
            vpnOnly false;
            bfd false;
        }
        [1] {
            address 10.255.255.3;
            description pe02.hul1;
            vpnOnly false;
            bfd false;
        }
    }
    vrfs {
        [0] {
            name internet;
            tableId 100;
            rd 65000:100;
            importRt {
                65000:100;
            }
            exportRt {
                65000:100;
            }
            gatewayIp 100.64.0.1;
            gatewayIpv6 2001:db8:64::1;
            l2tpEndpointIp null;
            originateDefaultRoute false;
            cgnIpGroup null;
        }
        [1] {
            name wholesale-a;
            tableId 208;
            rd 65000:208;
            importRt {
                65000:208;
            }
            exportRt {
                65000:208;
            }
            gatewayIp 100.64.8.1;
            gatewayIpv6 ;
            l2tpEndpointIp null;
            originateDefaultRoute false;
            cgnIpGroup null;
        }
    }
    routerId6 ;
    enableVrfIpv6 true;
    localInterfaces null;
    staticRoutes null;
    cgnPoolOriginations null;
    originateDefaultRoute false;
    managementNetwork null;
    igp {
        protocol isis;
        interfaces [];
        isis {
            net 49.0001.0102.5525.5010.00;
            level level-2-only;
        }
        ospf null;
        interfaceList [];
        loopbackInterfaces [];
        coreInterfaces [];
        isIsis true;
        isOspf false;
        isNone false;
        rendersIgp false;
        isisOrDefault {
            net 49.0001.0102.5525.5010.00;
            level level-2-only;
        }
        ospfOrDefault {
            area 0.0.0.0;
            interfaceAreas null;
            enableOspfv3 null;
        }
    }
    isisNet null;
    isisInterfaces null;
    greTunnelListeners null;
    cpeGreCircuits null;
    subscriberPoolOriginations null;
    effectiveIgp {
        protocol isis;
        interfaces [];
        isis {
            net 49.0001.0102.5525.5010.00;
            level level-2-only;
        }
        ospf null;
        interfaceList [];
        loopbackInterfaces [];
        coreInterfaces [];
        isIsis true;
        isOspf false;
        isNone false;
        rendersIgp false;
        isisOrDefault {
            net 49.0001.0102.5525.5010.00;
            level level-2-only;
        }
        ospfOrDefault {
            area 0.0.0.0;
            interfaceAreas null;
            enableOspfv3 null;
        }
    }
}

show licensing#

Show licensing status

show licensing telemetry#

Show the exact telemetry payload the box will send

show protocols bgp neighbor#

Show BGP neighbor detail

Accepts an optional positional argument <address> — neighbor IPv4 address

show protocols bgp summary#

Show BGP peer summary

show protocols isis adjacencies#

Show IS-IS adjacencies

Example

user@bng> show protocols isis adjacencies
Neighbor   Interface  Level  State  Hold  SNPA          
---------  ---------  -----  -----  ----  --------------
pe01.hul1  ens3f1     L2     Up     27s   2020.2020.2020
pe02.hul1  ens3f1     L2     Up     24s   2020.2020.2021

show protocols l2tp tunnels#

Show L2TP tunnels

Accepts an optional positional argument <id> — tunnel ID

show protocols ospf adjacencies#

Show OSPF adjacencies (OSPFv2 and OSPFv3)

Example

user@bng> show protocols ospf adjacencies
Neighbor      Interface  Proto   State   Pri  Dead  Address   
------------  ---------  ------  ------  ---  ----  ----------
10.255.255.2  core0      OSPFv2  Full/-  1    33s   10.255.1.1
10.255.255.2  core0      OSPFv3  Full/-  1    35s   fe80::1

show protocols pppoe statistics#

Show PPPoE statistics

Example

user@bng> show protocols pppoe statistics
PPPoE sessions:      3
  locally terminated:     2
  via L2TP (LAC/LNS):     1

Walled garden:       0
With a service plan: 3

Per service VLAN:
  101        3

show radius servers#

Show RADIUS server status

Example

user@bng> show radius servers
Host        Port  Weight  Status  Failures  Requests
----------  ----  ------  ------  --------  --------
10.20.2.20  1812  10      ALIVE   0         0       
10.20.2.21  1812  10      ALIVE   0         0

Total: 2 servers, 2 alive, 0 dead

show route#

Show the IPv4 routing table (default VRF)

show route vrf#

Show the IPv4 routing table for a VRF

Accepts an optional positional argument <name> — vRF name (as configured in routing.vrfs)

show source-vrf rules#

Show programmed source-VRF classification rules

show subscribers local#

Show locally-defined subscribers (no external auth server)

Example

user@bng> show subscribers local
Type  Subscriber            IPv4  IPv6  VRF  Plan     Down/Up (kbit)  Status                            
----  --------------------  ----  ----  ---  -------  --------------  ----------------------------------
ppp   alice@example.net     -     -     -    default  100000/50000    online 7d 03:14:09 (session 40213)
ppp   acme-ltd@example.net  -     -     -    default  100000/50000    online 7d 03:14:09 (session 40215)

2 local subscribers (2 online)

show subscribers sessions#

Show subscriber sessions

Accepts an optional positional argument <id> — session ID

Example

user@bng> show subscribers sessions
Session ID  Type  Username              IPv4          VRF          Uptime       Bytes (up/down)  Pkts (up/down)
----------  ----  --------------------  ------------  -----------  -----------  ---------------  --------------
40213       ppp   alice@example.net     100.64.12.37  residential  7d 03:14:09  0B/0B            0/0           
40214       ppp   bob@example.net       100.64.12.38  residential  7d 03:14:09  0B/0B            0/0           
40215       ppp   acme-ltd@example.net  100.64.12.39  residential  7d 03:14:09  0B/0B            0/0           
40216       ipoe  0a:1b:2c:3d:4e:5f     100.64.20.11  residential  7d 03:14:09  0B/0B            0/0

4 sessions displayed

show subscribers summary#

Show subscriber summary

Example

user@bng> show subscribers summary
Total sessions:    4
IPoE sessions:     1
PPPoE sessions:    3

Per-VRF counts:
  residential: 4

Refused bring-ups: 0

show system hardware#

Show hardware inventory

Example

user@bng> show system hardware
CPU
  Model:        AMD EPYC 9124 16-Core Processor
  Topology:     2 socket(s), 32 core(s), 64 thread(s), 2 NUMA node(s)

Memory
  Total:        137.4G
  NUMA 0:      68.7G
  NUMA 1:      68.7G
  Hugepages:    1048576kB — 12 free of 16

Board
  System:       Supermicro AS -1115SV-WTNRT
  BIOS:         American Megatrends International, LLC. 2.1 10/17/2024

Network adapters
PCI           Vendor             Model                                    Driver    NUMA
------------  -----------------  ---------------------------------------  --------  ----
0000:03:00.0  Intel Corporation  Ethernet Controller X710 for 10GbE SFP+  vfio-pci  0   
0000:03:00.1  Intel Corporation  Ethernet Controller X710 for 10GbE SFP+  vfio-pci  0   
0000:07:00.0  Intel Corporation  I210 Gigabit Network Connection          igb       0

Filesystems
Mount  Type  Total   Available
-----  ----  ------  ---------
/      ext4  966.4G  805.3G

show system interfaces#

Show network interfaces

Example

user@bng> show system interfaces
Interface     Role        Owner       State    Speed   MTU    MAC                PCI         
------------  ----------  ----------  -------  ------  -----  -----------------  ------------
0000:03:00.0  subscriber  dataplane   up       10000M  -      -                  0000:03:00.0
0000:03:00.1  network     dataplane   up       10000M  -      -                  0000:03:00.1
eno1          management  kernel-vrf  up       1000M   1500   ac:1f:6b:12:34:56  0000:07:00.0
lo            loopback    kernel      unknown  -       65536  00:00:00:00:00:00  -

show system status#

Show system status

Example

user@bng> show system status
System status:     active
Version:           0.1.0
Active sessions:   4
  IPoE:            1
  PPPoE:           3

FIB sync:          not running

show system uptime#

Show system uptime

Example

user@bng> show system uptime
Control plane up:  7d 03:14:09
Host up:           7d 03:14:09

show system version#

Show system version

Example

user@bng> show system version
NetavoBng version 0.1.0

show vrfs#

Show configured VRFs and live session counts

Example

user@bng> show vrfs
VRF          Table  RD         Import RT  Export RT  Sessions
-----------  -----  ---------  ---------  ---------  --------
internet     100    65000:100  65000:100  65000:100  0       
wholesale-a  208    65000:208  65000:208  65000:208  0

show web-ui auth#

Show Web UI authentication configuration

show web-ui auth sessions#

Show active Web UI sessions