Manual Pages for UNIX Operating System command usage for man igb

Devices                                                   igb(7D)



NAME
     igb - Intel 82575 1Gb PCI Express NIC Driver

SYNOPSIS
     /dev/igb*


DESCRIPTION
     The igb Gigabit Ethernet driver is a  multi-threaded,  load-
     able, clonable, GLD-based STREAMS driver supporting the Data
     Link Provider Interface, dlpi(7P),  on  Intel 82575  Gigabit
     Ethernet controllers.


     The igb driver functions include controller  initialization,
     frame  transmit  and receive, promiscuous and multicast sup-
     port, and error recovery and reporting.


     The igb driver and hardware support auto-negotiation, a pro-
     tocol  specified  by  the  1000   Base-T   standard.   Auto-
     negotiation allows each device to advertise its capabilities
     and  discover  those of its peer (link partner). The highest
     common  denominator  supported  by  both link  partners   is
     automatically  selected,  yielding  the  greatest  available
     throughput, while requiring no manual configuration. The igb
     driver also allows you to configure the advertised capabili-
     ties to less than the maximum (where the full speed  of  the
     interface  is  not required), or to force a specific mode of
     operation, irrespective of  the  link  partner's  advertised
     capabilities.

APPLICATION PROGRAMMING INTERFACE
     The cloning character-special device,  /dev/igb, is used  to
     access all  Intel 82575 Gigabit devices installed within the
     system.


     The igb driver is managed  by the  dladm(1M)  command   line
     utility,  which  allows   VLANs  to be defined on top of igb
     instances and  for igb  instances  to  be  aggregated.   See
     dladm(1M) for more details.


     You must send an explicit DL_ATTACH_REQ message to associate
     the opened stream with a particular device (PPA). The PPA ID
     is interpreted as an unsigned integer data type  and   indi-
     cates  the  corresponding device instance (unit) number. The
     driver returns an error (DL_ERROR_ACK)  if   the  PPA  field
     value  does not correspond to a valid device instance number
     for the system. The device is initialized  on  first  attach
     and de-initialized (stopped) at last detach.



SunOS 5.11          Last change: 20 Jul 2007                    1






Devices                                                   igb(7D)



     The values returned by the driver in the DL_INFO_ACK  primi-
     tive in response to your DL_INFO_REQ are:

         o    Maximum SDU is 9000.

         o    Minimum SDU is 0.

         o    DLSAP address length is 8.

         o    MAC type is DL_ETHER.

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

         o    Broadcast address value is the Ethernet/IEEE broad-
              cast address (FF:FF:FF:FF:FF:FF).

              Once in the DL_ATTACHED  state,  you  must  send  a
              DL_BIND_REQ  to associate a particular SAP with the
              stream.

CONFIGURATION
     By default, the  igb  driver  performs  auto-negotiation  to
     select  the  link speed and mode. Link speed and mode can be
     any one of the following, (as described  in   the  IEEE803.2
     standard):


     1000 Mbps, full-duplex.


     100 Mbps, full-duplex.


     100 Mbps, half-duplex.


     10 Mbps, full-duplex.


     10 Mbps, half-duplex.


     The auto-negotiation protocol  automatically  selects  speed
     (1000  Mbps, 100 Mbps, or 10 Mbps) and operation mode (full-
     duplex or half-duplex) as  the  highest  common  denominator
     supported by both link partners.






SunOS 5.11          Last change: 20 Jul 2007                    2






Devices                                                   igb(7D)



     Alternatively, you can set the  capabilities  advertised  by
     the  igb  device using ndd(1M). The driver supports a number
     of parameters whose names begin with adv_ (see below).  Each
     of these parameters contains a boolean value that determines
     if the device advertises that mode of operation.  For  exam-
     ple,   the adv_1000fdx_cap parameter indicates if 1000M full
     duplex is advertised to link partner. The   adv_autoneg  cap
     parameter controls whether auto-negotiation is performed. If
     adv_autoneg_cap is set to 0,  the driver forces the mode  of
     operation   selected  by  the  first  non-zero  parameter in
     priority order as shown below:

                               (highest priority/greatest throughput)
               adv_1000fdx_cap         1000Mbps full duplex
               adv_100fdx_cap          100Mpbs full duplex
               adv_100hdx_cap          100Mbps half duplex
               adv_10fdx_cap           10Mpbs full duplex
               adv_10hdx_cap           10Mpbs half duplex
                                       (lowest priority/least throughput)



     All capabilities default to enabled. Note that changing  any
     capability  parameter  causes  the link to go down while the
     link partners renegotiate the link  speed/duplex  using  the
     newly changed capabilities.

FILES
     /dev/igb*                  Special character device.


     /kernel/drv/igb            32-bit device driver (x86).


     /kernel/drv/amd64/igb      64-bit device driver (x86).


     /kernel/drv/sparcv9/igb    64-bit device driver (SPARC).


     /kernel/drv/igb.conf       Configuration file.


SEE ALSO
     dladm(1M),  ndd(1M),  netstat(1M),  driver.conf(4),   attri-
     butes(5), streamio(7I), dlpi(7P),


     Writing Device Drivers






SunOS 5.11          Last change: 20 Jul 2007                    3






Devices                                                   igb(7D)



     STREAMS Programming Guide


     Network Interfaces Programmer's Guide



















































SunOS 5.11          Last change: 20 Jul 2007                    4