ndstat(1M)


ndstat -- display network adapter driver statistics

Synopsis

/usr/bin/ndstat [-sSRlcC] [device_name]

Description

The ndstat utility displays statistics for each configured network adapter driver in several views. In addition to the driver name and address, ndstat polls the DLPI (Data Link Provider Interface) module for information on the services it provides, including:

ndstat understands the following options:

-s
verifies the device name only

-S
displays SAP information

-R
displays the Token-Ring source routing table

-l
displays media-specific statistics in long form

-c
clears all statistics

-C
clears Token-Ring route table

device_name
allows you to specify a single device name. If you do not use this option and there is more than one adapter configured, ndstat shows you the configuration for all of the devices. For MDI devices, the name is in the form netn-1, where n is the number of adapters configured in your system. For legacy DLPI and ODI drivers, the name is HSM_0.

Files

/usr/bin/ndstat
/usr/lib/netcfg/chains

Examples

Here is sample output from the basic ndstat command:
   Device       MAC address in use    Factory MAC Address 
   ------       ------------------    ------------------- 
   /dev/net0    00:00:c0:cb:ca:80     00:00:c0:cb:ca:80 
   

Multicast address table ----------------------- 01:00:5e:00:00:01

FRAMES Unicast Multicast Broadcast Error Octets Queue Length ---------- --------- --------- ------ ----------- ------------ In: 1559104 0 171752 867 497222655 0 Out: 1445668 3 16 165 536346107 0

Device
the name of the adapter driver

MAC address in use
the MAC (Media Access Control) address currently associated with the adapter. Although this is often the same as the Factory Address, alternative MAC addresses can be configured for some adapters.

Factory Address
the built-in address assigned by the adapter manufacturer (also called ``hardware address'')

Multicast address table
gives the multicast address in the same form as the Factory Address

Frames
number of frames that have gone in and out of the board, further broken down by:

Unicast
frames sent to or received from the multicast MAC address.

Multicast
frames sent to or received from multihost MAC addresses other than the broadcast address.

Broadcast
frames sent to or received from the broadcast MAC address.

Error
the number of frames that have gone in and out with errors

Octets
number of 8-bit ``bytes'' sent or received

Queue Length
number of STREAMS messages currently queued
ndstat -l displays the same basic information but adds information from the DLPI and MDI (MAC Driver Interface) modules, as well as media-specific statistics. Here is an example of the module display:
   DLPI Module Info: 2 SAPs open, 16 SAPs maximum 
                    96687 frames received destined for an unbound SAP 
   

MAC Driver Info: Media_type: Ethernet Min_SDU: 14, Max_SDU: 1514, Address length: 6 Interface speed: 10 Mbits/sec

Interface Versions: MDI 2

DLPI Module Info
information about this instance of the Data Link Provider Interface.

SAPs open
current number of active data link users

SAPs maximum
maximum number of active data link users allowed

frames received destined for an unbound SAP
frames discarded because they are sent to a Service Access Point (SAP) that is not bound by a DCS user.

MAC Driver Info
information about this Media Access Control (MAC) driver.

Media_type
Ethernet, Token-Ring, FDDI, ISDN

Min_SDU
minimum send data unit (packet size)

Max_SDU
maximum send data unit (packet size)

Address length
number of bytes in the MAC address

Interface speed
maximum throughput supported on this media interface

Interface Versions
MDI version number
ndstat -R displays the same basic information but adds a listing of the Token-Ring source routing table:
           Source routing table 
           ==================== 
           0/1 Source Routes in use 
           Short timer = 1000 ticks 
           Medium timer = 12000 ticks 
           Long timer = 90000 ticks 
           Garbage collector runs every 1500 ticks 
   

No source routing table entries present

ndstat -S displays the same basic information but adds a listing of SAP information:

                FRAMES FOR EACH SERVICE ACCESS POINT (SAP) 
           Unicast XID TEST Multicast Broadcast Error   Octets   Queue Length 
          -------- --- ---- --------- --------- ----- ---------- ------------ 
   

"IP" Ethernet-II type=0x0800: In: 1558996 0 0 0 123266 0 494301873 0 Out: 1445365 0 0 3 1 0 536324188 0 "ARP" Ethernet-II type=0x0806: In: 13 0 0 0 48388 0 2904256 0 Out: 236 0 0 0 15 0 14874 0

Unicast
to/from individual (non-group) MAC address

XID
exchange identifcation (LLC frame)

TEST
Test LLC frame

LLC
Logical Link Control

References

mdi(7), nd(1M), dlpid(1M)

``Configuring LAN connections''


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.