Index Index for
Section 9
Index Alphabetical
listing for D
Bottom of page Bottom of
page		 

dot5Entry(9s)


NAME

  dot5Entry - Network: Defines status and parameters for a Token Ring network
  interface


SYNOPSIS

  _________________________________
  Member Name		  Data Type
  _________________________________
  dot5TrnNumber		  int
  dot5IfIndex		  int
  dot5Commands		  int
  dot5RingStatus	  int
  dot5RingState		  int
  dot5RingOpenStatus	  int
  dot5RingSpeed		  int
  dot5UpStream[6]	  u_char
  dot5ActMonParticipate	  int
  dot5Functional[6]	  u_char
  _________________________________


MEMBERS

  dot5TrnNumber
      Specifies the total number of Token Ring adapters in the system.

  dot5IfIndex
      Specifies the network interface number for this Token Ring adapter on
      this system.

  dot5Commands
      Specifies one of the following commands:

      MIB1231_COMM_OPEN
	  Opens the station.

      MIB1231_COMM_RESET
	  Resets the station.

      MIB1231_COMM_CLOSE
	  Closes the station.

      MIB1231_COMM_NO_OP
	  Has no effect.

  dot5RingStatus
      Specifies one or more of the following values to indicate the current
      status of the station:

      MIB1231_RSTATUS_NO_PROB
	  No problems detected

      MIB1231_RSTATUS_RING_RECOVERY
	  Ring recovery

      MIB1231_RSTATUS_SINGLE_STATION
	  Single station

      MIB1231_RSTATUS_REMOVE_RCVD
	  Remove received

      MIB1231_RSTATUS_RESERVED
	  Reserved

      MIB1231_RSTATUS_AUTO_REM_ERROR
	  Auto-removal error

      MIB1231_RSTATUS_LOBE_WIRE_FAULT
	  Lobe wire fault

      MIB1231_RSTATUS_TRANSMIT_BEACON
	  Transmit beacon

      MIB1231_RSTATUS_SOFT_ERROR
	  Soft error

      MIB1231_RSTATUS_HARD_ERROR
	  Hard error

      MIB1231_RSTATUS_SIGNAL_LOSS
	  Signal loss

      MIB1231_RSTATUS_NO_STATUS
	  No status (open not completed)

  dot5RingState
      When the dot5Commands member contains MIB1231_OPEN or MIB1231_CLOSE,
      specifies the progress of the open or close operation as one of the
      following values:

      MIB1231_RSTATE_OPENED
	  Station is opened.

      MIB1231_RSTATE_CLOSED
	  Station is closed.

      MIB1231_RSTATE_OPENING
	  Open operation is in progress.

      MIB1231_RSTATE_CLOSING
	  Close operation is in progress.

      MIB1231_RSTATE_OPEN_FAILURE
	  An error occurred during an open operation.

      MIB1231_RSTATE_RING_FAILURE
	  An error occurred on the ring.

  dot5RingOpenStatus
      When the dot5Commands member contains MIB1231_OPEN, specifies the
      progress of the open operation as one of the following values:

      MIB1231_ROSTATUS_NOOPEN
	  No open operation was attempted.

      MIB1231_ROSTATUS_BADPARM
	  A bad parameter was received.

      MIB1231_ROSTATUS_LOBEFAILED
	  Lobe failure occurred.

      MIB1231_ROSTATUS_SIG_LOSS
	  Signal loss occurred.

      MIB1231_ROSTATUS_INS_TIMEOUT
	  Insertion timed out.

      MIB1231_ROSTATUS_RING_FAILED
	  Ring failure occurred.

      MIB1231_ROSTATUS_BEACONING
	  Beacon transmit is in progress.

      MIB1231_ROSTATUS_DUPLICATE_MAC
	  A duplicate MAC address was received.

      MIB1231_ROSTATUS_REQ_FAILED
	  The request failed.

      MIB1231_ROSTATUS_REM_RECVD
	  A remove request was received.

      MIB1231_ROSTATUS_OPEN
	  The most recent open operation succeeded.

  dot5RingSpeed
      Specifies the bandwidth of the ring as one of the following values:

      MIB1231_RSPEED_UNKNOWN
	  Unknown

      MIB1231_RSPEED_1_MEG
	  1 megabit

      MIB1231_RSPEED_4_MEG
	  4 megabits

      MIB1231_RSPEED_16_MEG
	  16 megabits

  dot5UpStream[6]
      Specifies the media access (MAC) address of the upstream neighboring
      station on the ring.

  dot5ActMonParticipate
      Specifies one of the following values:

      MIB1231_ACTMON_TRUE
	  The station participates in active monitor selection.

      MIB1231_ACTMON_FALSE
	  The station does not participate in active monitor selection.

  dot5Functional[6]
      Specifies a bit mask of all Token Ring functional addresses for which
      this station accepts frames.










DESCRIPTION

  The dot5Entry data structure contains status and parameter information for
  a Token Ring network interface, according to RFC 1231 in the IEEE 802.5
  Token Ring MIB. It is filled in only when the ctr_type member of the ctrreq
  data structure contains either TRN_MIB_ENTRY or TRN_STAT_ENTRY. The
  SIOCRDCTRS and SIOCRDZCTRS ioctl commands use this data structure to return
  information to a user process.


FILES

  <net/if.h>


SEE ALSO

  Data Structures: ctrreq(9s)

Index Index for
Section 9
Index Alphabetical
listing for D
Top of page Top of
page