scman(7D)




NAME

     scman - SUNW,scman Sun Fire high end server management  net-
     work device driver


SYNOPSIS

     /dev/scman


DESCRIPTION

     The  scman (7D) network device driver is a  loadable,  clon-
     able, STREAMS hardware driver that supports the dlpi connec-
     tionless data link provider interface  over  the  SUNW,scman
     network  controller.  The scman controller provides a highly
     available, secure communication channel between the  dynamic
     system domains and the Sun Fire high end system controller.

     The scman driver provides basic support for  the  SUNW,scman
     controller. Driver functions include network initialization,
     frame transit and receive, multicast  and  promiscuous  sup-
     port, and error recovery and reporting.

     The scman controller is physically located in each Sun  Fire
     high-end  server  dynamic  system  domain  and  connects  to
     SUNWdman controllers found in  each  active  dynamic  system
     domain  in  the Sun Fire high-end chassis. See dman(7D). All
     links are point-to-point and are internal to  the  Sun  Fire
     high-end  server  chassis.  Traffic  between the system con-
     troller and the dynamic system domains is not accessible  by
     any  third  party; for example, another system domain within
     the Sun Fire 15K chassis. All system domains are  accessible
     through the scman controller.

     The link layer frame format is identical  to  that  used  by
     Ethernet (sys/ethernet.h).


APPLICATION PROGRAMMING INTERFACE

     The /dev/scman cloning character-special device is  used  to
     access the SUNW,scman controller installed on the system.


DLPI

     The scman driver is a style 2 data link provider  interface.
     All  M_PROTO  and M_PCPROTO type messages are interpreted as
     DLPI primitives.  Valid   DLPI  primitives  are  defined  in
     sys/dlpi.h.  Refer  to  dlpi(7P)  for  more  information. An
     explicit DL_ATTACH_REQ message by the user  is  required  to
     associate the opened stream with a particular device or phy-
     sical point of attachment (PPA).

     The  PPA ID is interpreted as an unsigned long data type and
     indicates  the  corresponding device instance (unit) number.
     The only valid unit number is 0. An error (DL_ERROR_ACK)  is
     returned  by  the  driver  if  the  PPA field value does not
     correspond to  a  valid  device  instance  number  for  this
     system.  The  device  is initialized on the first attach and
     deinitialized (stopped) upon the last detach.

     The values returned by the scman driver in  the  DL_INFO_ACK
     primitive in response to the DL_INFO_REQ from the user are:

        o  Maximum service data units (SDU) are 1500.

        o  Minimum SDU is 0.

        o  Data link service access point (DLSAP) address  length
           is 8.

        o  Media access control (MAC) type is DL_ETHER.

        o  Service access point (SAP) length value is -2, meaning
           the physical address component is followed immediately
           by a two-byte SAP component within the DLSAP address.

        o  Service mode is DL_CLDLS.

        o  Optional quality  of  service  (QOS)  support  is  not
           included; the  QOS fields are 0.

        o  Provider style is DL_STYLE2.

        o  Version is DL_VERSION_2.

        o  Broadcast address  value  is  Ethernet/IEEE  broadcast
           address (0xFFFFFF).

     Once in the DL_ATTACHED state, you can transmit  DL_BIND_REQ
     to  associate  a  particular  SAP with the stream. The scman
     driver interprets the  SAP field within the  DL_BIND_REQ  as
     an  Ethernet  type;  as  a result, valid values for the  SAP
     field are in the 0 through 0xFFFF range. Only  one  Ethernet
     type can be bound to the stream at any time.

     If you select the  SAP with a value of 0, the receiver  will
     be in 802.3  mode. All frames received from the media having
     a type field in the range from 0 through 1500 are assumed to
     be 802.3  frames and are routed up all open streams that are
     bound to  SAP value 0. If more than one stream is  in  802.3
     mode,  then  the  frame is duplicated and routed up multiple
     streams as DL_UNITDATA_IND messages.

     In transmission, the  driver  checks  the   DL_BIND_REQ  SAP
     field  to  determine if the  SAP value is 0 and the destina-
     tion type field is in the range  from  0  through  1500.  If
     either  is  true, the driver computes the length of the mes-
     sage,  not  including  the  initial  M_PROTO  message  block
     (mblk),  of  all  subsequent  DL_UNITDATA_REQ  messages  and
     transmits 802.3  frames that have  this  value  in  the  MAC
     frame header length field.

     The scman driver DLSAP address format consists of  the  six-
     byte  physical (Ethernet) address component followed immedi-
     ately by the two-byte  SAP  (type)  component  producing  an
     eight-byte   DLSAP address. Applications should not be hard-
     coded to this  implementation-specific  DLSAP  address  for-
     mat, but instead use information returned in the DL_INFO_ACK
     primitive to compose and decompose  DLSAP addresses. The SAP
     length,  full  DLSAP  length, and  SAP physical ordering are
     included within the DL_INFO_ACK. The physical address length
     can be computed by subtracting the  SAP length from the full
     DLSAP address length or by issuing the  DL_PHYS_ADDR_REQ  to
     obtain  the  current  physical  address  associated with the
     stream.

     Once in the DL_BOUND state, you can transmit frames  on  the
     Ethernet  by  sending  DL_UNITDATA_REQ messages to the scman
     driver. The scman driver routes received Ethernet frames  as
     DL_UNITDATA_IND  messages up all open and bound streams hav-
     ing a  SAP matching the  Ethernet  type.  Received  Ethernet
     frames  are  duplicated and routed up multiple open streams,
     if  necessary.  The  DLSAP  address  contained  within   the
     DL_UNITDATA_REQ  and  DL_UNITDATA_IND  messages  consists of
     both the SAP (type) and physical (Ethernet) components.

 PRIMITIVES
      In addition to the mandatory  connectionless  DLPI  message
     set, the scman driver  supports the following primitives.

     The DL_ENABMULTI_REQ and DL_DISABMULTI_REQ primitives enable
     or   disable   reception   of   individual  multicast  group
     addresses. A set of multicast addresses may  be  iteratively
     created and modified on a per-stream basis using these prim-
     itives. These primitives are accepted by the driver  in  any
     state following DL_ATTACHED.

     The DL_PROMISCON_REQ and DL_PROMISCOFF_REQ  primitives  with
     the  DL_PROMISC_PHYS  flag set in the dl_level field enables
     or disables reception of all promiscuous mode frames on  the
     media,  including  frames  generated by the local host. When
     used with the DL_PROMISC_SAP flag set, this enables or  dis-
     ables  reception  of  all   SAP (Ethernet type) values. When
     used with the DL_PROMISC_MULTI flag  set,  this  enables  or
     disables  reception  of  all multicast group addresses.  The
     effect of each is always on a per-stream basis and  indepen-
     dent  of   other   SAP  and physical level configurations on
     this stream or other streams.

     The DL_PHYS_ADDR_REQ primitive returns the six-octet  Ether-
     net address currently associated (attached) to the stream in
     the DL_PHYS_ADDR_ACK primitive. This primitive is valid only
     in states following a successful DL_ATTACH_REQ.

     The DL_SET_PHYS_ADDR_REQ primitive is not supported.

 scman DRIVER
     The scman driver operates at 10 Mbps, full-duplex.


PARAMETER LIST

     The scman driver allows you to set and get  various  parame-
     ters  for the SUNW,scman device. The parameter list includes
     current transceiver status, current link status, interpacket
     gap,  local transceiver capabilities, and link partner capa-
     bilities.


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
   |        ATTRIBUTE TYPE       |        ATTRIBUTE VALUE      |
   | ____________________________|_____________________________|_
   |  Architecture               |  Sun Fire high-end systems  |
   |_____________________________|_____________________________|
   | Availability                | SUNWscdvr                   |
   |_____________________________|_____________________________|


FILES

     The scman driver utilizes the following files:

     /dev/scman
           Special character device

     /platform/sun4u/kernel/drv/scman.conf
            System-wide default device driver properties


SEE ALSO

     ndd(1M), netstat(1M), driver.conf(4), dman(7D), eri(7D),

     dlpi(7P)


Man(1) output converted with man2html