This command displays information about Border Gateway Protocol (BGP) neighbors.

Syntax   vrouter-bgp-neighbor-show

vrouter-name name-string

Specifies the name of the vRouter.

Specifies the following BGP neighbor arguments:

neighbor ip-address

Specifies the IP address of the neighbor.

ver ver-number 

Specifies the BGP version.

remote-as remote-as-number

Specifies the AS number of the remote connection.

msg_rcvd msg_rcvd-number

Specifies the number of messages received from the receive socket buffer.

msg_sent msg_sent-number

Specifies the number of messages written to the transmit socket buffer.

tblver tblver-number

Specifies the version of the routing table.

inQ inQ-number

Specifies the number of BGP packets queued for a neighbor.

outQ outQnumber

Specifies the number of BGP packets queued for transmission to a neighbor.

up/down up/down-string

Specifies if the neighbor is up or down.

state/pfxrcd state/pfxrcd-string

Specifies the current state of the BGP session. The state can be any of the following types:

1 — Idle

2 — Connect

3 — Active

4 — OpenSent

5 — OpenConfirm

6 — Established

remote-router remote-router-string

Specifies the neighbor router name.

multi-protocol ipv4-unicast|ipv6-unicast|

Specify a multi-protocol for BGP.

Formatting Options

format fields-to-display

Display output using a specific parameter. Use all to display all possible output.

parsable-delim character

Display output formatted for machine parsing using a specified delimiter.


Display output in ascending order.


Display output in descending order.

show dups

Display duplicate entries in the output.

layout vertical|horizontal

Format the output in a vertical or horizontal layout.

show-interval seconds-interval

Repeat the show command at a specified interval.


Display column headers or not.

limit-output number

Limit the display output to a specific number of entries.


Display the number of entries in the output. This is useful with vRouter show commands.


Display full values in the output instead of scaled approximate values.


Display integer values instead of mapped values


Aggregate output by specific parameters. If sum-by fields are specified, records that have the same value in sum-by fields are combined and displayed as one aggregate record. NOTE: This option is only available for show commands that collect statistics such as connection-stats-show.

Defaults   None

Access   CLI


Version 2.0

Command introduced.

Version 2.4.1

The parameter, remote-router, added.

Usage   Use this command to display information about BGP neighbors configured on a vRouter.

Examples  To display all information about BGP neighbors, use the following command:

CLI network-admin@switch > vrouter-bgp-neighbor-show

vrouter-name: vrouter33       


ver:          4

remote-as:    100

msg_rcvd:     324

msg_sent:     330

tblver:       0

inQ:          0

outQ:         0

up/down:      00:31:25

state/pfxrcd: 1

vrouter-name: vrouter55


ver:          4

remote-as:    100

msg_rcvd:     325

msg_sent:     330

tblver:       0

inQ:          0

outQ:         0

up/down:      00:31:26

state/pfxrcd: 1