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:
-
MAC (Media Access Control) frame transmission information
-
Media-specific services for Ethernet and Token-Ring,
including the Token-Ring source routing table.
-
SNAP (Sub Network Access Protocol) information,
used when Ethernet-oriented stacks (such as TCP/IP)
run on non-Ethernet networks.
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.