unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 fddipciadmin(1M)					    fddipciadmin(1M)




 NAME
      fddipciadmin - show PCI FDDI interface status, and/or change FDDI
      attributes

 SYNOPSIS
      fddipciadmin [-rn] [-R t_req_time] [-N t_notify_time] interface_name

 DESCRIPTION
      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
      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
      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
      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 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.

 EXAMPLES
		    << 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 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.

 AUTHOR
      fddipciadmin was developed by HP.




 Hewlett-Packard Company	    - 4 -     HP-UX Release 11.11: July 2000






 fddipciadmin(1M)					    fddipciadmin(1M)




 SEE ALSO
      fddi(7), netstat(1), mknod(1M).




















































 Hewlett-Packard Company	    - 5 -     HP-UX Release 11.11: July 2000