rge(7d) - osol9

1rge(7D)                             Devices                            rge(7D)
2
3
4

NAME

6       rge - Realtek Gigabit/Fast Ethernet Network Adapter driver
7

SYNOPSIS

9       /dev/rge
10
11

DESCRIPTION

13       The  rge  Gigabit/Fast  Ethernet driver is a multi-threaded,  loadable,
14       clonable,   GLD-based   STREAMS   driver  supporting   the  Data   Link
15       Provider  Interface,  dlpi(7P),  on   the Realtek Gigabit/Fast Ethernet
16       Network Adapter.
17
18
19       The rge driver  functions  includes  controller  initialization,  frame
20       transmit  and  receive,  promiscuous  and  multicast support, and error
21       recovery and reporting.
22

APPLICATION PROGRAMMING INTERFACE

24       The cloning,  character-special device /dev/rge is  used to access  all
25       Realtek Gigabit/Fast Ethernet devices installed within the system.
26
27
28       The  rge driver is managed by the dladm(1M) command line utility, which
29       allows VLANs to be defined  on  top  of  rge   instances  and  for  rge
30       instances to be aggregated. See dladm(1M) for more details.
31
32
33       The  values  returned  by  the  driver  in the DL_INFO_ACK primitive in
34       response to the DL_INFO_REQ are as follows:
35
36           o      Maximum SDU (with jumbo frame) is 7000.
37
38           o      Minimum SDU is 0.
39
40           o      DSLAP address length is 8 bytes.
41
42           o      MAC type is DL_ETHER.
43
44           o      SAP length value is  -2, meaning the physical address compo‐
45                  nent  is  followed  immediately  by  a  2-byte sap component
46                  within the DLSAP address.
47
48           o      Broadcast address value is Ethernet/IEEE  broadcast  address
49                  (FF:FF:FF:FF:FF:FF).
50
51
52       Once in the DL_ATTACHED state, you must send a DL_BIND_REQ to associate
53       a particular Service Access Point (SAP) with the stream.
54

CONFIGURATION

56       By default, the rge driver performs auto-negotiation to select the link
57       speed and mode. Link speed and mode can be any one of the following:
58
59           o      1000 Mbps, full-duplex
60
61           o      100 Mbps, full-duplex
62
63           o      100 Mbps, half-duplex
64
65           o      10 Mbps, full-duplex
66
67           o      10 Mbps, half-duplex
68
69
70       Alternatively,  you  can  set  the  capabilities  advertised by the rge
71       device using ndd(1M). The driver supports a number of parameters  whose
72       names  begin  with  adv_.  Each  of these parameters contains a boolean
73       value that determines if the device advertises that mode of  operation.
74       The  adv_pause_cap indicates if half/full duplex pause is advertised to
75       link partner. You can set adv_asym_pause_cap to advertise to  the  link
76       partner that asymmetric pause is desired.
77
78
79       For  example,  to  prevent  the  device 'rge2' from advertising gigabit
80       capabilities, enter (as super-user):
81
82         # ndd -set /dev/rge2 adv_1000fdx_cap 0
83
84
85
86       All capabilities default to enabled. Note that changing any  capability
87       parameter  causes the link to go down while the link partners renegoti‐
88       ate the link speed/duplex using the newly changed capabilities.
89
90
91       You can find the current parameter settings by using ndd -get. In addi‐
92       tion,  the driver exports the current state, speed, duplex setting, and
93       working mode of the link via ndd parameters (these are  read  only  and
94       may not be changed). For example, to check link state of device rge0:
95
96         # ndd -get /dev/rge0 link_status
97         1
98         # ndd -get /dev/rge0 link_speed
99         100
100         # ndd -get /dev/rge0 link_duplex
101         2
102
103
104
105       The  output  above indicates that the link is up and running at 100Mbps
106       full-duplex. In addition,  the  driver  exports  its  working  mode  by
107       loop_mode. If it is set to 0, the loopback mode is disabled.
108

FILES

110       /dev/rge*                  Character special device.
111
112
113       /kernel/drv/rge            32-bit x86 rge driver binary.
114
115
116       /kernel/drv/amd64/rge      64-bit x86 rge driver binary.
117
118
119       /kernel/drv/sparcv9/rge    SPARC rge driver binary.
120
121

ATTRIBUTES

123       See attributes(5) for a description of the following attributes:
124
125
126
127
128       ┌─────────────────────────────┬─────────────────────────────┐
129       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
130       ├─────────────────────────────┼─────────────────────────────┤
131       │Architecture                 │SPARC, x86                   │
132       └─────────────────────────────┴─────────────────────────────┘
133