Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

show tcp-forwarding status

 

Syntax

Release Information

Command introduced in Junos OS Release 18.3R1 on MX Series routers.

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-addressIPv4 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-numberPort 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-nameName of the routing instance for the TCP mapping.

Required Privilege Level

view

List of Sample Output

show tcp-forwarding status

show tcp-forwarding status (Listening Port and Address)

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.

Sample Output

show tcp-forwarding status

user@host> show tcp-forwarding status

show tcp-forwarding status (Listening Port and Address)

user@host> show tcp-forwarding status listening-port 203.0.113.50 listening-address 8002