fddipciadmin(1M) fddipciadmin(1M)
NAME [Toc] [Back]
fddipciadmin - show PCI FDDI interface status, and/or change FDDI
attributes
SYNOPSIS [Toc] [Back]
fddipciadmin [-rn] [-R t_req_time] [-N t_notify_time] interface_name
DESCRIPTION [Toc] [Back]
fddipciadmin 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
(Negotiated Target Token Rotation 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 Options [Toc] [Back]
The 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 VALUE [Toc] [Back]
Upon successful completion, fddipciadmin returns 0; otherwise it
returns 1.
Hewlett-Packard Company - 1 - HP-UX Release 11.11: July 2000
fddipciadmin(1M) fddipciadmin(1M)
ERRORS [Toc] [Back]
fddipciadmin 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.
+ Driver support error - returns "failed ioctl_request, check
the driver support," 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 linklevel
multicast addresses configured for this station, display driver
statistics, display link statistics, change T_Req time, change
T_Notify time, and exit the program.
EXAMPLES [Toc] [Back]
<< INTERFACE STATUS SUMMARY >>
MAC Address: 0x0060B0580E19 Wire Format: 0x00060D1A7098
Up Stream Neighbor: 0x080009455DD5 Wire Format: 0x100090A2BAAB
Down Stream Neighbor:0x0060B0580E03 Wire Format: 0x00060D1A70C0
RMT State: Ring_Op CF State: C_Wrap_A
Frame Count: 00322395 Token Count: 57108118
Receive Count: 00000339 Transmit Count: 342
Lost Count: 0 Error Count: 0
RingOp Count: 1
LER Estimate A: 10**-15 LER Estimate B: 10**-15
T_Req (ms): 7.9873 T_Neg (ms): 5.0001
Number of multicast addresses configured: 0
Hewlett-Packard Company - 2 - HP-UX Release 11.11: July 2000
fddipciadmin(1M) fddipciadmin(1M)
Fields 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 is Thru. 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. 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). This usually
indicates that a 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.
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.
Hewlett-Packard Company - 3 - HP-UX Release 11.11: July 2000
fddipciadmin(1M) fddipciadmin(1M)
Token Count The number of times a token (both restricted and nonrestricted
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 nonoperational
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.
AUTHOR [Toc] [Back]
fddipciadmin was developed by HP.
Hewlett-Packard Company - 4 - HP-UX Release 11.11: July 2000
fddipciadmin(1M) fddipciadmin(1M)
SEE ALSO [Toc] [Back]
fddi(7), netstat(1), mknod(1M).
Hewlett-Packard Company - 5 - HP-UX Release 11.11: July 2000 [ Back ] |
