show tcp-forwarding status

Syntax

Description

Display the status of TCP mapping and the current TCP connections for each mapping. You can limit the display to a specific listening port/listening address combination, per routing instance. If you do not specify a routing instance, the default routing instance is assumed.

Options

listening-address ipv4-listening-address

IPv4 address that is part of a listening port/listening address combination. The listening address is one on the BNG that external management systems or remote devices must use when attempting to trigger connections on the listening port. You must also specify a listening port.

listening-port port-number

Port number that is part of a listening port/listening address combination. The listening port is one that the BNG monitors for connections to be triggered by external management systems or remote devices.

Range: 8000 through 8031

routing-instance routing-instance-name

Name of the routing instance for the TCP mapping.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show tcp-forwarding status command. Output fields are listed in the approximate order in which they appear.

Table 1: show tcp-forwarding status Output Fields
Field Name	Field Description
`Listening on`	Routing instance, IPv4 address, and port that the BNG is monitoring for connection triggers from external management systems or remote devices, in the following format: `[routing-instance-name]:ip-address:port-number` The following status and statistics are displayed for the TCP listening connection: `Status`—Current state of the BNG regarding the TCP connection: `listening`—The connection is active. `not-listening`—The connection is inactive. This is typically indicative of a misconfiguration, such as an invalid listening address for the routing instance. `Total Bytes`—Total number of bytes sent and received on the TCP listening connection. `Rx`—Received bytes. `Tx`—Transmitted bytes.
`Forwarding to`	Routing instance, IPv4 address, and port number where the BNG is forwarding data on the TCP connection, in the following format: `[routing-instance-name]:ip-address:port-number` The following statistics are displayed for the TCP port forwarding connection: `Total Bytes`—Total number of bytes sent and received on the TCP port forwarding connection. `Rx`—Received bytes. `Tx`—Transmitted bytes.
`Allowed Source Prefixes`	IPv4 source prefixes from which the BNG can accept connection requests. Request from all other addresses are rejected. A /32 mask indicates a single acceptable address. The allowed values are compared to the source address in the TCP header from the triggering entity.
`Connections`	Status and statistics for the configured TCP connections. `Max`—Configured maximum number of connections allowed on the listening port. `Active`—Number of TCP connections that are currently active on the listening port. `Source`—List of source address and source port combinations with which the BNG has a current connection. The field value is displayed in the following format: `source-ip-address:port-number` `Listening` and `Forwarding`—Status of the listening and forwarding connections. `connected`—The connection is active. `disconnected`—The connection is removed. This is a transient state, because the TCP connection pair is removed when disconnected. `Bytes`—Number of bytes transmitted and received on the listening or forwarding connections for the source address/port combination. `Rx`—Received bytes. `Tx`—Transmitted bytes.