The netstat command is very helpful in monitoring the Ethernet, Fiber Distributed Data Interface (FDDI), and token ring network interfaces. The following sections contain sample system output and a description of the information for each network interface.
You can use the netstat -I ln0 -s command to obtain a listing of the Ethernet counters. The following is sample system output from this command:
ln0 Ethernet counters at Thu Nov 6 07:33:00 1992 1289 seconds since last zeroed 16812469 bytes received 4657308 bytes sent 42555 data blocks received 28418 data blocks sent 860360 multicast bytes received 7710 multicast blocks received 546 multicast bytes sent 13 multicast blocks sent 0 blocks sent, initially deferred 1864 blocks sent, single collision 5542 blocks sent, multiple collisions 6 send failures, reasons include: Excessive collisions 0 collision detect check failure 3 receive failures, reasons include: Block check error Framing Error 0 unrecognized frame destination 0 data overruns 0 system buffer unavailable 0 user buffer unavailable
The following section lists each field in the previous example alphabetically, and describes each field.
You can use the netstat -I interface -s command to obtain a listing of the Fiber Distributed Data Interface (FDDI) counters, status, and characteristics for the FDDI interface. The following is sample system output from this command for the fza0 interface. See faa(7), fta(7), fza(7), and mfa(7) for adapter error messages.
fza0 FDDI counters at Wed Jun 12 14:02:44 1992 89 seconds since last zeroed 6440875 ANSI MAC frame count 0 ANSI MAC frame error count 0 ANSI MAC frames lost count 37488 bytes received 39005 bytes sent 447 data blocks received 479 data blocks sent 30170 multicast bytes received 321 multicast blocks received 29163 multicast bytes sent 360 multicast blocks sent 0 transmit underrun errors 0 send failures 0 FCS check failures 0 frame status errors 0 frame alignment errors 0 frame length errors 0 unrecognized frames 0 unrecognized multicast frames 0 receive data overruns 0 system buffers unavailable 0 user buffers unavailable 0 ring reinitialization received 0 ring reinitialization initiated 0 ring beacon process initiated 0 ring beacon process received 0 duplicate tokens detected 0 duplicate address test failures 0 ring purger errors 0 bridge strip errors 0 traces initiated 0 traces received 0 LEM reject count 0 LEM events count 0 LCT reject count 0 TNE expired reject count 1 completed connection count 0 elasticity buffer errors fza0 FDDI status Adapter State: Running state LED State: Green Link State: On ring running Duplicate Address Condition: Absent Ring Purger State: Purger off Negotiated TRT: 7.987 ms Upstream Neighbor Address: 08-00-2B-18-B3-D7 UNA Timed Out: False Downstream Neighbor Address: 08-00-2B-1E-C0-3E Claim Token Yield: False Frame Strip Mode: Source address match Ring Error Reason: No reason Last Direct Beacon SA: 00-00-00-00-00-00 Physical Port State: In use Neighbor Physical Port Type: Master Reject Reason: No reason Physical Link Error Estimate: 15 fza0 FDDI characteristics Link Address: 08-00-2B-1B-AE-58 Firmware Revision: 1.2 ROM Revision: 1.0 SMT Version ID: 1 Requested TRT: 8.000 ms Maximum TRT: 173.015 ms Valid Transmission Time: 2.621 ms LEM Threshold: 8 Restricted Token Timeout: 1000.000 ms PMD Type ANSI multimode
The Downstream Neighbor Address and Restricted Token Timeout are reported only for the DEFZA firmware revision 1.2 and higher.
The following sections list each field in the previous example alphabetically, and describe each field.
This section lists the FDDI counters alphabetically.
This section lists the FDDI status alphabetically.
Halted | The adapter has a hardware or firmware error. |
Initialized | The adapter is initialized and waiting to be enabled. |
Maintenance | The adapter can only perform loopback operations. |
Resetting | The adapter is started or reset. |
Running State | The adapter is enabled. |
Uninitialized | The adapter is waiting to be initialized. |
Absent | The FDDI MAC entity determined that there is no duplicate of its own line address on the ring. |
Present | The FDDI MAC entity determined that a duplicate of its own line address exists on the ring. No data can be transmitted or received on the line until this logical ring fault is resolved. |
Unknown | The FDDI MAC entity is performing the duplicate address test to determine if any other stations on the ring have the same address as the line. |
Source Address Match | The station strips frames from the ring that contain its own address in the source address field. |
Bridge Strip | The station maintains a count of frames sent since obtaining the token, sends a void frame when the transmission is complete (two void frames if it is serving as ring purger), and strips the returning frames from the ring until the count of frames sent is decremented to zero. Bridge stripping is used by bridges because they are sensitive to no-owner frames and frequently send frames that do not contain their own address in the source address field. |
Green | The adapter is in Running State and the FDDI link is available. |
Green and blinking | The adapter is in Running State, but the link is unavailable. It may be caused by a disconnected cable. |
Off | The adapter is not enabled. |
Red | The adapter is in the Halted state, which is caused by a serious hardware or firmware problem. |
Red and blinking | The adapter is in an illegal topology or configuration. For example, it is connected to the wrong port of FDDI concentrator. |
Red and green | Standby. |
Broken | A hardware problem exists. |
Off Fault Recovery | The FDDI MAC entity is recovering from a logical ring fault such as a failure of the duplicate address test, a local or remote stuck beaconing condition, or ring operational oscillation. |
Off Maintenance | The FDDI MAC entity is performing loopback testing and online diagnostics. |
Off Ready | The FDDI MAC entity is ready for operation but is not yet connected to the logical ring. |
On Ring Initializing | The FDDI MAC entity is connecting to the logical ring. |
On Ring Running | The FDDI MAC entity is connected to the logical ring and is fully operational. |
A | The physical port on a dual attachment wiring concentrator (DAC) or dual attachment station (DAS) that connects to the incoming primary ring and the outgoing secondary ring of the FDDI dual ring. |
B | The physical port on a dual attachment wiring concentrator (DAC) or dual attachment station (DAS) that connects to the outgoing primary ring and the incoming secondary ring of the FDDI dual ring. |
Master | One of the physical ports on a wiring concentrator that connects to a single attachment station (SAS) such as a DECbridge 500 device. |
Slave | The physical port on a single attachment station (SAS) that connects to a wiring concentrator or another SAS. The physical port on a single attachment station (SAS) that connects to a wiring concentrator or another SAS. |
Unknown | No connection has been established. |
Broken | The physical port failed its diagnostic tests and is nonoperational. |
In use | The physical port established a connection and is fully operational. |
Off maintenance | The physical port is reserved for diagnostic testing and loopbacks. |
Off ready | The physical port is disabled. |
Starting | The physical port received a response from its neighbor physical port and is exchanging information and performing the link confidence test (LCT) before completing the connection. |
Failed | Same as Waiting, except that the physical port failed at least once; by failing the link confidence test (LCT) during initialization, by exceeding the link error monitor (LEM) threshold during operation, or because it is part of an illegal topology. |
Waiting | The physical port is establishing a connection and is waiting for a response from its neighbor physical port. |
Watching | Same as Starting, except that the physical port failed at least once; by failing the link confidence test (LCT) during initialization, by exceeding the link error monitor (LEM) threshold during operation, or because it is part of an illegal topology. |
LCT Both | The link confidence test (LCT) failed on both this physical port and the neighbor physical port. |
LCT Local | The link confidence test (LCT) failed on this physical port. |
LCT Remote | The link confidence test (LCT) failed on the neighbor physical port. |
LEM Failure | The bit error rate on the physical port exceeded the link error monitor (LEM) threshold. The LEM monitors the quality of the link during operation. |
No Reason | The physical port is initializing. This value is cleared when the physical port enters the In Use state. |
Remote Reject | The neighbor physical port broke the connection for an unknown reason. |
TNE Expired | The noise timer expired because a single noise event lasted for more than 1.31072 milliseconds. The noise timer is operational only when the physical port is In Use. |
Topology Rules | The neighbor physical port is an illegal match for this physical port; for example, an A and an A or a Master and a Master. |
Trace in Progress | A PC Trace occurred while the physical port was initializing. When a PC trace occurs, any physical ports that have not established a connection are shut down to prevent the topology from changing. |
Trace Received, Trace Off | The physical port was momentarily disabled because it received a PC trace when its own PC trace function was disabled. The Trace Disable switch is designed to protect the physical port from faulty implementations of the PC trace algorithm. The Trace Disable switch is not remotely manageable. |
Beaconing Initiated | A station initiated the ring beacon process because its TRT timer expired before the claim token process recovered the ring. The beacon process locates the ring break. The station downstream from the break will be stuck beaconing. (A station is stuck beaconing when its FDDI MAC entity has been beaconing longer than the time defined by the ANSI FDDI parameter T_Stuck.) |
Bridge Strip Error | A station using bridge frame stripping received a token before decrementing its Sent count to zero. In bridge strip mode, the station maintains a count of frames sent since obtaining the token, and decrements the count each time one of its frames returns. |
Directed Beacon Received | A station that is stuck beaconing sent a frame to the directed beacon multicast address, indicating the suspected cause of the ring break. (A station is stuck beaconing when its FDDI MAC entity has been beaconing longer than the time defined by the ANSI FDDI parameter T_Stuck.) This is the last recovery procedure before initiating the PC trace. |
Duplicate Address Detected | A station detected a duplicate of its own address. |
Duplicate Token Detected | A station received a token while it was holding the token. |
Initialization Initiated | The FDDI MAC entity of this station initiated the claim token process because it detected a configuration change or a missing token. |
Initialization Received | Another station initiated the claim token process because it detected a configuration change or a missing token. |
No Reason | The ring is operating correctly. |
OP Oscillation | The ring is suffering from ring OP (operational) oscillation. That is it repeatedly comes up briefly and then goes back into initialization. This problem is frequently caused by a duplicate address condition. |
PC Trace Initiated | A station that is stuck beaconing has forced its upstream neighbors to perform their self-tests. (A station is stuck beaconing when its FDDI MAC entity has been beaconing longer than the time defined by the ANSI FDDI parameter T_Stuck.) PC trace is the most drastic fault recovery procedure. |
Purge Error | The station serving as the ring purger received a token when it was not expecting one. The station expects two void frames and then the token when it is serving as the ring purger. |
Candidate | The ring is operational and the FDDI MAC entity is bidding to become the ring purger by sending Candidate Hello frames to the ring purger multicast address. The station with the highest station ID becomes the ring purger. |
Non Purger | The ring is operational and the FDDI MAC entity is not the ring purger, either because another station won the candidate bidding or because this line has a duplicate address. |
Purger | The ring is operational and the FDDI MAC entity is serving as ring purger, constantly purging the ring of fragments and no-owner frames. The station periodically sends Ring Purger Hello frames to the ring purger multicast address. |
Purger Off | The ring purger algorithm is not active because the ring is not operational. |
This section lists FDDI characteristics alphabetically.
The LEM threshold is expressed as the absolute value of the exponent of the bit error rate. The legal range for the threshold is 5 through 8, corresponding to the range of bit error rates, which is 1×10^-5 (0.00001) bit errors per second through 1×10^-8 (0.00000001) bit errors per second.
Multi Mode | Inexpensive thick core fiber combined with light-emitting diode (LED) sources and p-type intrinsic n-type (PIN) detectors. |
Single Mode | Expensive thin core fiber combined with laser diode sources and avalanche photodiode (APD) detectors. |
You can use the netstat -I tra0 -s command to obtain a listing of the token ring counters and other attributes. The following is sample system output from this command:
tra0 Token ring counters at Thu Mar 24 07:33:00 1993 82502 seconds since last zeroed 2230 bytes received 1704 bytes sent 34 data blocks received 20 data blocks sent 288 multicast bytes received 8 multicast blocks received 306 multicast bytes sent 13 multicast blocks sent 0 unrecognized frames 0 unrecognized multicast frames 0 transmit failures 0 transmit underrun errors 1 line errors 9 internal errors 4 burst errors 0 ARI/FCI errors 0 abort delimiters transmitted 3 lost frame errors 0 receive data overruns 0 frame copied errors 0 token errors 9 hard errors 3 soft errors 1 adapter resets 1 signal loss 5 beacon transmits 2 ring recoveries 0 lobe wire faults 0 removes received 0 single stations 0 self test tailures tra0 Token ring and host information: MAC address: 00-00-C9-19-4A-F3 Group address: 00-C0-00-80-00-00 Functional address: 00-C0-00-00-00-00 Physical drop number: 0 Upstream neighbor address: 00-00-10-C9-F5-3B Upstream physical drop number: 0 Transmit access priority: 0 Last major vector: Standby monitor present Ring status: No problems detected Monitor contender: Yes Soft error timer value: 2000 ms Local ring number: 0 Reason for transmitting beacon: No beacon Reason for receiving beacon: No beacon Last beacon upstream neighbor address: 00-00-10-C9-F3-4A Beacon station physical drop number: 0 Ring speed: 4Mbps Early token release: False Open status: Open Token ring chip: TMS380C26
This section lists the token ring counters alphabetically.
This section lists the token ring and host information alphabetically.
True | The station will release the token when it completes frame transmission. The default for 16 Mb/s rings. |
False | The station will release the token when it receives the transmitted frame header. The default for 4 Mb/s rings. |
Active monitor present | The active monitor requested a standby monitor present MAC frame from its nearest downstream neighbor. |
Beacon | Used by the adapter in the beacon process. |
Change parameters | The network manager is changing adapter parameters. |
Claim token | Used by the adapter in the monitor contention process. |
Duplicate address test | The adapter is verifying that its address is unique on the ring. |
Initialize ring station | The ring parameter server is setting adapter parameters. |
Lobe media test | The adapter is testing the continuity of the wire in a loopback path. |
Remove ring station | The network manager is requesting the adapter to remove itself from the ring. |
Report error | The adapter is reporting soft error events to the ring error monitor. |
Report monitor error | The adapter is reporting a problem with the active monitor or a possible duplicate station address to the ring error monitor. |
Report new monitor | The active monitor adapter, after winning contention, is reporting this status to the network manager. |
Report ring poll failure | The active monitor is reporting a failure in the ring poll process to the ring error monitor. |
Report station address | The adapter is reporting its station address to the network manager. |
Report station attachment | The adapter is reporting its attachment status to the network manager. |
Report station state | The adapter is reporting its state to the network manager. |
Report SUA change | The adapter is reporting a change in the stored upstream address (SUA) to the network manager. |
Report transmit forward | The adapter is reporting a frame that has been forwarded and stripped to the network manager. |
Request initialization | The adapter is requesting operational parameters from the ring parameter server. |
Request station address | The network manager is requesting a report station address MAC frame from the adapter. |
Request station attachment | The network manager is requesting a report station attachment MAC frame from the adapter. |
Request station state | The network manager is requesting a report station state MAC frame from the adapter. |
Response | The adapter is sending a positive acknowledgement to frames that require acknowledgement or is reporting syntax errors in the MAC frame. |
Ring purge | Used by the active monitor during the ring purge process. |
Standby monitor present | The adapter is responding to an active monitor present or standby monitor present MAC frame. |
Transmit forward | Used in the transmit forward process. |
No | The station will not participate in the monitor contention process. |
Yes | The station will participate in the monitor contention process. |
Close | The adapter is not operational on the ring. |
Open | The adapter is operational on the ring. |
Bit streaming | A monitor contention timeout occurred while an adapter was in monitor contention transmit mode and before a claim token MAC frame was received. |
Contention streaming | A monitor contention timeout occurred while an adapter was in monitor contention mode (transmit or receive) and received one or more claim token MAC frames. |
No beacon | The adapter is not receiving a beacon MAC frame. |
Signal loss | An adapter detected a signal loss. |
Bit streaming | A monitor contention timeout occurred while the adapter was in monitor contention transmit mode and before a claim token MAC frame was received. |
Contention streaming | A monitor contention timeout occurred while the adapter was in monitor contention mode (transmit or receive) and received one or more claim token MAC frames. |
No beacon | The adapter is not transmitting a beacon MAC frame. |
Signal loss | The adapter detected a signal loss on the ring. |
Auto removal error | The adapter failed the lobe wrap test and removed itself from the ring. |
Counter overflow | One of the adapter's error counters has exceeded its maximum value. |
Hard error | The adapter is transmitting beacon frames to or receiving beacon frames from the ring. |
Lobe wire fault | The adapter detected an open or short circuit in the cable between the adapter and the wiring concentrator. |
No problems detected | The ring is operating normally. |
Remove received | The adapter received a remove ring station MAC frame request and removed itself from the ring. |
Ring recovery | The adapter is observing claim token MAC frames on the ring. |
Signal loss | The adapter detected a loss of signal on the ring. |
Single station | The adapter sensed that it is the only station on the ring. |
Soft error | The adapter transmitted a report error MAC frame. |
Transmit beacon | The adapter is transmitting beacon frames on the ring. |