[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]
AIX Version 4.3 Commands Reference, Volume 4
ntx_nstat Command
Purpose
Displays network information for the Network Terminal Accelerator (NTX).
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
Files: /dev/rhp.
"Configuring the Network Terminal Accelerator" in AIX Versions 3.2 and 4 Asynchronous Communications Guide
[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]