ntx_nstat Command

Commands Reference, Volume 4

ntx_nstat Command

Purpose

Displays network information for the Network Terminal Accelerator (NTX).

Syntax

ntx_nstat [ -d Device ] [ -A ] [ -a ] [ -n ] [ -f AddressFamily ]

ntx_nstat [ -d Device ] [ -i ] [ -m ] [ -n ] [ -r ] [ -s ] [ -f AddressFamily ]

ntx_nstat [ -d Device ] [ -n ] [ -I Interface ] Interval

ntx_nstat [ -d Device ] [ -p Protocol ]

Description

The ntx_nstat command displays the contents of various network-related data structures known to the Network Terminal Accelerator adapter. You can use this command to display the following information:

A list of active sockets for each protocol
The contents of network data structures
Information regarding packet traffic on the configured network interfaces
Statistics about a named protocol

You can use the -n flag with any of the display formats to view network addresses in dot decimal form.

Active Sockets

To display information about active sockets use, the -a flag. This flag displays the following information:

Local addresses
Remote addresses
Send queue sizes in bytes
Receive queue sizes in bytes
Protocol
Internal state of the protocol

If a socket's address specifies a network, but no specific host address, the address appears in the form host.port or network.port. If a host or network address is to the adapter's host machine, the name of the host or network is displayed as it appears in the /etc/hosts or /etc/networks file. If a host or network is unknown, the ntx_nstat command displays the Internet address instead of the name. The format of the numeric address depends on the address family. Unspecified or wildcard address and ports appear as an * (asterisk).

To display the address of any protocol control blocks associated with sockets, use the -A flag with the -a flag.

Network Data Structures

To view information about the adapter's interfaces, use the -i flag. Currently, the adapter installation automatically configures the adapter's Ethernet address and the adapter's loopback interface.

Routing Status

To display the routing tables, use the -r flag. The routing table tracks the available routes and their statuses. Each route consists of a destination host or network and a gateway to use in forwarding packets. The routing table contains the following fields:

Destination   Gateway   Flags   Refs   Use   Interface

These fields contain the following information:

`Destination`	Identifies the destination host or network.
`Gateway`	Identifies the address of the outgoing interface. Direct routes are created for each interface attached to the local host.
`Flags`	Displays the state of the route. A route can have the following states: `U` The route is up. `G` The route is a gateway. `D` The route was created dynamically by a redirect. `M` The route was modified by a redirect.
`Refs`	Identifies the current number of active uses of the route. Connection-oriented protocols normally hold on to a single route for the duration of a connection. Connectionless protocols obtain a route while sending to the same destination.
`Use`	Provides a count of the number of packets sent using that route.
`Interface`	Indicates the network interface utilized for a route.

To display routing statistics instead of the routing table, use the -s flag with the -r flag.

Network Interface Statistics

To display a running count of the statistics related to the primary network interface and summary statistics for all other interface activity, use the Interval parameter. The primary network interface is the first interface found during autoconfiguration. The first line output summarizes system activity since the last reboot. Subsequent lines of output show values accumulated over the preceding interval.

To view information for a single interface, use the -I flag. This type of display provides a table of cumulative statistics for packets transferred, errors, and collisions. The network addresses of the interface and the maximum transmission unit (MTU) are also displayed.

Flags

-A	Displays the status of protocol control blocks associated with sockets. This flag is used for debugging. You must use this flag with the -a flag.
-a	Displays the state of all sockets. Normally, sockets used by server processes are not shown.
-d Device	Specifies the adapter device file. The default is the /dev/rhp0 file.
-f AddressFamily	Limits statistics or address control-block reports to those specified by the AddressFamily parameter. The only valid address family is inet (AF_INET).
-i	Displays the state of autoconfigured interfaces. Interfaces statically configured into a system, but not located at boot-time, are not shown.
-I Interface	Displays information about the interface identified by the Interface parameter. This flag is used with the Interval parameter.
-m	Displays statistics recorded by the adapter memory management routines including the allocation of memory buffers (mbufs).
-n	Displays Internet addresses instead of host or network names. You can use this flag with any of the display formats.
-p Protocol	Displays statistics about the specified protocol. You can specify either a well-known name or an alias for the Protocol parameter. Some protocol names and aliases are listed in the /etc/protocols file. A null response typically means that there are no statistics to report. If the protocol is unknown or if there is no statistics routine for it, the program displays the following message: ntx_nstat: unknown or uninstrumented protocol
-r	Displays the routing tables. When the -s flag is also present, the -r flag shows routing statistics instead.
-s	Displays per-protocol statistics.

Exit Status

This command returns the following exit values:

0	Successful completion.
>0	An error occurred.

Security

Access Control: Any user.

Auditing Events: N/A

Files

/usr/bin/ntx_nstat	Contains the ntx_nstat command.
/dev/rhp0	Default NTX raw device file name.

Related Information

The /dev/rhp file.

Network Terminal Accelerator Overview in AIX Versions 3.2 and 4 Asynchronous Communications Guide.