Manual Pages for UNIX Operating System command usage for man rge

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.

APPLICATION PROGRAMMING 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 DL_INFO_ACK  primi-
     tive in response to the DL_INFO_REQ 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 DL_ETHER.

         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/IEEE  broadcast
              address (FF:FF:FF:FF:FF:FF).


     Once in the DL_ATTACHED state, you must send  a  DL_BIND_REQ
     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  adv_pause_cap
     indicates  if  half/full  duplex pause is advertised to link
     partner. You can set adv_asym_pause_cap 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 adv_1000fdx_cap 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 link_status
       1
       # ndd -get /dev/rge0 link_speed
       100
       # ndd -get /dev/rge0 link_duplex
       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 loop_mode. 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.


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE 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