 |
» |
|
|
|
NAMEfddipciadmin — show PCI FDDI interface status, and/or change FDDI attributes SYNOPSISfddipciadmin
[-rn]
[-R
t_req_time]
[-N
t_notify_time]
interface_name DESCRIPTIONfddipciadmin
displays information about the status of the
PCI FDDI
interface.
The
fddipciadmin
utility first shows summary information about the PCI FDDI interface.
It then displays a menu that allows the user to refresh statistics and
display other interface attributes. The menu also allows
the
T_Req
time (Token Request Time) and
T_Notify
time to be changed.
Superuser privilege is required to change those attributes. When invoked with the command line options,
fddipciadmin
executes the options and exits without showing the summary information
and the menu. Command-Line OptionsThe following options are available:
- -r
Display the current
T_Req
time of an interface.
When specified with the
-R
option, the
-r
is always processed before
-R
regardless the position of the two appear in the command line. - -R t_req_time
Change the
T_Req
time of an interface.
The time is specified in milliseconds.
It must be within the range of 4 and 165. - -n
Display the current
T_Notify
time of an interface.
When specified with the
-N
option, the
-n
is always processed before
-N
regardless the position of the two appear in the command line. - -N t_notify_time
Change the
T_Notify
time of an interface.
The time is specified in seconds.
It must be within the range of 2 and 30.
fddipciadmin
requires the command-line argument:
- interface_name
Specifies the interface name for the
PCI FDDI
device (for example,
lan2)
or the name of the character device file
for the PCI FDDI device (for example,
/dev/lan2).
RETURN VALUEUpon successful completion,
fddipciadmin
returns 0; otherwise it returns 1. ERRORSfddipciadmin
fails if any of the following conditions is encountered:
Command used incorrectly - Usage message is returned. Device is not a PCI FDDI device - returns /dev/interface_name is not a valid device Check the interface name. Use
lanscan
to display interface name and type.
Use
ioscan
to determine the type of FDDI device.
Check that the driver was properly installed
(use the
dmesg
command or
what /stand/vmunix
and look for the PCI FDDI driver, fddi4). Device does not exist - returns device file /dev/interface_name does not exist Check the interface name. Use
lanscan
to display interface name and type. Hardware or driver support error - returns failed ioctl_request, check the hardware where
ioctl_request
is the name of the
ioctl
operation requested.
Make sure the user has the right privilege.
Check if the request is supported by the driver.
Check the LEDs on the card.
Run
lanscan
and check the hardware state.
When
fddipciadmin
starts, it reads the current statistics from the PCI FDDI driver.
From the
fddipciadmin
menu you can force
fddipciadmin
to re-read (refresh) these statistics.
The
fddipciadmin
menu also has options to re-display the summary information,
display SMT (FDDI Station Management) attributes, display FDDI MAC (Media
Access Control) attributes, display Port A attributes, display Port B
attributes, display
path attributes (attributes of the logical segment of the FDDI ring that
passes through this station),
display the link-level multicast addresses configured for this station,
display driver
statistics, display link statistics,
change
T_Req
time, change
T_Notify
time, and exit the program. EXAMPLESFields are defined as follows: - MAC Address
Medium Access Control (unit) Address.
Specifies the 48-bit
MAC
Address of the node in canonical (Least Significant Bit) hexadecimal format.
The
Wire Format
shows the MAC address in Most Significant Bit order. - Up Stream Neighbor
Upstream Neighbor's
(MAC)
Address.
Specifies the
MAC
Address of the upstream neighbor in canonical hexadecimal format.
The
Wire Format
shows the MAC address in Most Significant Byte order. - Down Stream Neighbor
Downstream Neighbor's
(MAC)
Address.
Specifies the
MAC
Address of the downstream neighbor in canonical hexadecimal format.
The
Wire Format
shows the MAC address in Most Significant Byte order. - RMT State
Ring Management State.
Indicates whether the state is: Isolated, Non_Op,
Ring_Op, Detect, Non_Op_Dup, Ring_Op_Dup, Directed, Trace or Unknown.
The normal state is Ring_Op. Isolated usually indicates that the interface is
not connected to the network.
Refer to the
RMT
description in the
ANSI FDDI/SMT
specification for more details. - CF State
(Attachment) Configuration State of the station.
Indicates whether the state is: Isolated,
Local_A, Local_B, Local_S, Wrap_A, Wrap_B, Wrap_AB, Wrap_S, C_Wrap_A,
C_Wrap_B, C_Wrap_S, Thru or Unknown.
The normal state for a Dual Attach Station is Thru.
The Wrap_A, Wrap_B, Wrap_AB, C_Wrap_A and C_Wrap_B states indicate that
there is only a single data ring. Data for the ring is transmitted
and received through the same port (A or B).
For a Single Attach Station (the A or B port is attached
to the M port of an FDDI device such as a concentrator),
C_Wrap_A or C_Wrap_B is the normal
operating state, depending on the port used.
For a Dual Attach Station, a wrap state
usually indicates that the dual ring is wrapped
(a failure was detected and a surrounding node is "wrapping"
and using either the A or B port to send and receive data) or this is a
transitory startup state indicating that the A or B port is ready to be
incorporated into the ring.
The Isolated state indicates that there is no internal connection between
MAC (Media Access Control) and PHY (Physical
Layer Protocol) modules. Usually indicates the
card is not cabled to ring.
Refer to the CF_State variable description in the
ANSI FDDI/SMT
specification for more details. - Frame Count
Specifies the total number of frames received with End Delimiter
by the station.
This count includes void frames, token frames,
beacon frames, claim frames,
SMT
frames and
LLC
frames. - Token Count
The number of times a token (both restricted and non-restricted tokens)
has been received. Useful for determining the network load. - Receive Count
Specifies the total number of
non-MAC frames (SMT or LLC frames) with an address recognized by the station
and successfully received by the station. - Transmit Count
Specifies the total number of non-MAC transmit frames originated
by this station. - Lost Count
Specifies the total number of frames received
with format error detected.
When the station detects a frame with a format error,
it strips the rest of the frame from the ring
and replaces it with Idle symbols. - Error Count
Specifies the total number of frames received
with the End Delimiter not set (not 'S'). - RingOp Count
Ring Operational Count.
Indicates the number of times the ring has entered an operational state from a
non-operational state. (This value is not required to be exact and the
actual count may be greater than the number shown.) - LER Estimate A
Link Error Rate Estimate.
Specifies the estimated long term average link error rate for Port A. - LER Estimate B
Link Error Rate Estimate.
Specifies the estimated long term average link error rate for Port B. - T_Req
Token Request Time.
Specifies the requested Target Token Rotation Time
(TTRT)
by the local station in the claim token process in
milliseconds.
Refer to the
T_Req
value description in the
ANSI FDDI/SMT
specification for more details. - T_Neg
Negotiated Target Token Rotation Time
(TTRT).
Specifies the target rotation time
being used by all the stations on the ring.
This value is negotiated during the claim token process.
The value of
T_Neg
is in milliseconds.
Refer to the
T_Neg
value description in the
ANSI FDDI/SMT
specification for more details. - Number of multicast addresses configured
Specifies the number of link-level multicast addresses configured for this
interface.
AUTHORfddipciadmin
was developed by HP. |
