Devices                                                   rge(7D)



NAME
     rge - Realtek Gigabit/Fast Ethernet Network Adapter driver

SYNOPSIS
     /dev/rge


DESCRIPTION
     The rge Gigabit/Fast Ethernet driver  is  a  multi-threaded,
     loadable,   clonable,  GLD-based  STREAMS  driver supporting
     the Data Link Provider Interface, dlpi(7P), on  the  Realtek
     Gigabit/Fast Ethernet Network Adapter.


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

APLICATION PROGRAMING INTERFACE
     The cloning,  character-special device /dev/rge is  used  to
     access  all  Realtek Gigabit/Fast Ethernet devices installed
     within the system.


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


     The values returned by the driver in the DLINFOACK  primi-
     tive in response to the DLINFOREQ are as follows:

         o    Maximum SDU (with jumbo frame) is 7000.

         o    Minimum SDU is 0.

         o    DSLAP address length is 8 bytes.

         o    MAC type is DLETHER.

         o    SAP 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 Ethernet/IE  broadcast
              address (F:F:F:F:F:F).


     Once in the DLATACHED state, you must send  a  DLBINDREQ
     to  associate  a  particular Service Access Point (SAP) with
     the stream.



SunOS 5.11          Last change: 21 Dec 2007                    1






Devices                                                   rge(7D)



CONFIGURATION
     By default, the  rge  driver  performs  auto-negotiation  to
     select  the  link speed and mode. Link speed and mode can be
     any one of the following:

         o    1000 Mbps, full-duplex

         o    100 Mbps, full-duplex

         o    100 Mbps, half-duplex

         o    10 Mbps, full-duplex

         o    10 Mbps, half-duplex


     Alternatively, you can set the  capabilities  advertised  by
     the  rge  device using ndd(1M). The driver supports a number
     of parameters whose names begin with  adv.  Each  of  these
     parameters  contains  a boolean value that determines if the
     device advertises that mode of operation. The  advpausecap
     indicates  if  half/full  duplex pause is advertised to link
     partner. You can set advasympausecap to advertise to  the
     link partner that asymmetric pause is desired.


     For example, to prevent the device 'rge2'  from  advertising
     gigabit capabilities, enter (as super-user):

       # ndd -set /dev/rge2 adv1000fdxcap 0



     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.


     You can find the current parameter  settings  by  using  ndd
     -get.  In  addition,  the  driver exports the current state,
     speed, duplex setting, and working mode of the link via  ndd
     parameters (these are read only and may not be changed). For
     example, to check link state of device rge0:

       # ndd -get /dev/rge0 linkstatus
       1
       # ndd -get /dev/rge0 linkspeed
       100
       # ndd -get /dev/rge0 linkduplex
       2




SunOS 5.11          Last change: 21 Dec 2007                    2






Devices                                                   rge(7D)



     The output above indicates that the link is up  and  running
     at  100Mbps full-duplex. In addition, the driver exports its
     working mode by loopmode. If it is set to 0,  the  loopback
     mode is disabled.

FILES
     /dev/rge*                  Character special device.


     /kernel/drv/rge            32-bit x86 rge driver binary.


     /kernel/drv/amd64/rge      64-bit x86 rge driver binary.


     /kernel/drv/sparcv9/rge    SPARC rge driver binary.


ATRIBUTES
     See attributes(5) for a description of the following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Architecture                 SPARC, x86                  
    


SEE ALSO
     dladm(1M), attributes(5), streamio(7I), dlpi(7P)


     Writing Device Drivers


     STREAMS Programming Guide


     Network Interfaces Programmer's Guide













SunOS 5.11          Last change: 21 Dec 2007                    3