e1000g(4d) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

e1000g(4d)

e1000g(4D)                Device Drivers & /dev files               e1000g(4D)

NAME
       e1000g, e1000 - Intel PRO/1000 Gigabit family of network interface con‐
       trollers

SYNOPSIS
       /dev/e1000g

DESCRIPTION
       The e1000g Gigabit Ethernet driver is a multi-threaded, loadable, clon‐
       able, GLD-based STREAMS driver supporting the Data Link Provider Inter‐
       face, dlpi(4P), over Intel PRO/1000 family of Gigabit controllers. This
       driver supports multiple Intel Gigabit controllers installed within the
       system.  The  e1000g  driver provides basic support including chip ini‐
       tialization, frame transmit and receive, multicast support,  and  error
       recovery and reporting.

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


       The e1000g driver is managed by  the  dladm(8)  command  line  utility,
       which  allows  VLANs  to  be defined on top of e1000g instances and for
       e1000g instances to be aggregated. See dladm(8) 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 indicates the corresponding device in‐
       stance (unit) number. The driver returns an error (DL_ERROR_ACK) if the
       PPA field value does not correspond to a valid device instance number.


       The values returned by the driver in the DL_INFO_ACK primitive  in  re‐
       sponse to the DL_INFO_REQ are as follows:

           o      Maximum SDU (with jumbo frame) is as high as 16298.


           o      Minimum  SDU is 0. The driver pads to the mandatory 60-octet
                  minimum packet size.


           o      The dlsap address length is 8.


           o      MAC type is DL_ETHER.


           o      The sap length value is −2, means that the physical  address
                  component  is followed immediately by a 2-byte sap component
                  within the DLSAP address.


           o      The broadcast address value is Ethernet/IEEE  broadcast  ad‐
                  dress (FF:FF:FF:FF:FF:FF).


CONFIGURATION
       The e1000g driver is managed by the dladm(8) command line utility.


       By  default,  the e1000g driver performs auto-negotiation to select the
       link speed and mode. Link speed and mode can be any one of the  follow‐
       ing, as described in the IEEE 803.2 standard:


         1000Mbps full duplex
         100Mbps full duplex
         100Mbps half duplex
         10Mbps full duplex
         10Mbps half duplex


       Note -



         The link mode of 1000Mbps half duplex is not supported.



       Forced link mode of 1000Mbps full duplex is not supported.


       The e1000g driver does not support the use of shared RAM on the board.

   Configuration File Options
       The following e1000g.conf configuration options are supported:

       AutoNegAdvertised

           This is a bitmap for the speeds advertised during auto-negotiation.




             Bit    |  7  |  6  |   5   |   4   |  3   |  2   |  1  |  0
             Setting| N/A | N/A | 1000F |  N/A  | 100F | 100H | 10F | 10H



           The adapter only auto-negotiates to a speed that is advertised. For
           example:  AutoNegAdvertised = 4 causes an adapter to only advertise
           auto-negotiation at 100 Mbps, full duplex. No other link speeds are
           accepted or given during auto-negotiation. AutoNegAdvertised=47 ad‐
           vertises all speeds available, This is the same as  using  the  de‐
           fault setting of 0.

           0-255    Allowed values


           0        Default



       ForceSpeedDuplex

           Specifies the speed and duplex mode for each instance.

           If you set ForceSpeedDuplex=7,4, the e1000g0 is set to auto-negoti‐
           ate  and  e1000g1  is set to 100 Mbps, full duplex. Note that fiber
           optic Ethernet adapters ignore this setting.

           Allowed values are:

           1    10 Megabits per second, Half Duplex.


           2    10 Megabits per second, Full Duplex.


           3    100 Megabits per second, Half Duplex.


           4    100 Megabits per second, Full Duplex.


           7    Auto-negotiate speed and duplex. (Default).



       MaxFrameSize

           Upper limit on the maximum MTU size that the driver allows. All In‐
           tel  gigabit  adapters  (except  the  82542-based  Intel   PRO/1000
           adapter) allow the configuration of jumbo frames.

           For  an  Intel PRO/1000 adapter that is later than 82571 (including
           82571), the maximum MTU accepted by the MAC is  9216.  For  others,
           the  maximum  MTU  accepted by the MAC is 16298. To configure jumbo
           frames, use e1000g.conf. Using dladm(8) with the  adapter  instance
           and  the  mtu argument configures adapter for the maximum allowable
           jumbo frame size.

           Allowed values are:

           0    Standard Ethernet frames with a MTU equal to 1500. (Default).


           1    Jumbo frames with a maximum MTU of 4010.


           2    Jumbo frames with a maximum MTU of 8106.


           3    Jumbo frames with a maximum MTU of 16298.



       FlowControl

           Flow control utilizes Ethernet XON and unicast and  multicast  XOFF
           packets to allow Ethernet equipment to slow down the stream of data
           between two Ethernet devices.

           Allowed values are:

           0    Disable.  Packets  can  get  dropped in high-throughput situa‐
                tions, leading to reduced network performance.


           1    Receive only.


           2    Transmit only.


           3    Receive and transmit. (Default).


           4    Use adapter's EEPROM-programmed factory default setting.



       TbiCompatibilityEnable

           You must enable this feature on Intel 82543CG-based copper adapters
           to operate correctly with TBI mode Ethernet hardware.

           Allowed values are:

           0    Disable.


           1    Enable. (Default).



       SetMasterSlave

           Controls the PHY master/slave setting. Manually forcing  master  or
           slave  can  reduce time needed to link with Planex 08TX and IO data
           switches. This setting should remain as the hardware default.

           Allowed values are:

           0    Hardware default. (Default).


           1    Force master.


           2    Force slave.


           3    Force auto.




       By default, the following configuration options are  not  displayed  in
       the  e1000g.conf  file.  Although they are configurable, you should not
       change these options:

       NumRxDescriptors        Number of available receive descriptors. Multi‐
                               ple receive descriptors increase  receive  per‐
                               formance, but decrease available memory.

                               80-4096    Allowed values.


                               2048       Default. (MTU < 4010).


                               1024       Default. (MTU >= 4010).



       NumTxDescriptors        Number of transmit descriptors available to the
                               driver.  Multiple transmit descriptors increase
                               transmit performance,  but  decrease  available
                               memory.

                               80-4096    Allowed values.


                               2048       Default. (MTU < 4010).


                               1024       Default. (MTU >= 4010).



       NumRxFreeList           Number of pre-allocated buffers that the driver
                               can   use  for  received  data.  Pre-allocating
                               buffers can improve receive performance but de‐
                               crease available memory.

                               60-4096    Allowed values.


                               4096       Default. (MTU < 4010).


                               2048       Default. (MTU >= 4010).



       NumTxFreeList           Number of pre-allocated buffers that the driver
                               can  use  for  transmit  data.   Pre-allocating
                               buffers  can  improve  transmit performance but
                               decrease available memory.

                               80-4096    Allowed values.


                               2304       Default. (MTU < 4010).


                               1152       Default. (MTU >= 4010).



       MaxNumReceivePackets    Maximum number of receive packets that the dri‐
                               ver can handle for each interrupt.

                               CPU utilization can be lowered through more ef‐
                               ficient interrupt management. If this value  is
                               increased,  the  time  needed  by  the  CPU  to
                               process the  individual  interrupts  increases,
                               thereby  nullifying any performance gains real‐
                               ized by handling less interrupts.

                               0-1024    Allowed values.


                               32        Default.



FILES
       dev/e1000g                    Character special device.


       /kernel/drv/e1000g.conf       Driver configuration file.


       /kernel/drv/sparcv9/e1000g    SPARC kernel module.


       /kernel/drv/amd64/e1000g      x86 kernel module.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE VALUE _ ArchitectureSPARC, x86


SEE ALSO
       dlpi(4P), attributes(7), dladm(8), ifconfig(8), kstat(8), ping(8)


       Intel PRO/1000 Gigabit Adapter Driver Installation Notes for Solaris


       Writing Device Drivers in Oracle Solaris 11.4


       STREAMS Programming Guide


       Managing Network Virtualization and Network Resources in Oracle Solaris
       11.4


       Managing Network Datalinks in Oracle Solaris 11.4

Oracle Solaris 11.4               11 May 2021                       e1000g(4D)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3