]>
Commit | Line | Data |
---|---|---|
520df687 ER |
1 | # $Id$ |
2 | # | |
de1fc6ce | 3 | DEVICE=<name> |
5301b5f6 AM |
4 | |
5 | [ BOOTPRIO=number ] | |
6 | ifcfg-* interfaces are configured in BOOTPRIO order starting | |
7 | from lowest value first. You need to set BOOTPRIO in _all_ your | |
8 | ifcfg* files because if you won't do that only these interfaces | |
9 | with BOOTPRIO variable will be configured. Use the same schema | |
d584de99 AM |
10 | when setting variable for example BOOTPRIO=number |
11 | or BOOTPRIO="number" because sorting is done by sort command. | |
5301b5f6 | 12 | |
16eb00d9 | 13 | [ BOOTPROTO={none|bootp|dhcp|pump} ] |
de1fc6ce JR |
14 | You can specify which dhcp client to use with the DHCP_CLIENT, if |
15 | the DHCP_CLIENT is not specified we trying to launch in order : | |
16 | /sbin/dhcpcd | |
17 | /sbin/dhclient | |
18 | /sbin/dhcpxd | |
19 | /sbin/pump | |
20 | if you have a preferred client define the DHCP_CLIENT variable. | |
3b2875b6 | 21 | You can also pass some options to dhcp client via DHCP_OPTIONS. |
de1fc6ce | 22 | |
16eb00d9 JR |
23 | [ BOOTPROTO6={none|dhcp6|v4compat} |
24 | dhcp6 isn't supported, yet. | |
de1fc6ce JR |
25 | v4compat uses available IPv4 addresses (ie. from DHCPv4) |
26 | and then convert them to IPv6 (IPv4-compatible) to use with | |
27 | automatic tunnels | |
28 | ||
29 | ||
30 | IPADDR="(IPv4 or IPv6 address)/prefix" | |
31 | IP_AOPTS="broadcast xxx etc" (by default broadcast is autocalculated) | |
32 | IP_ROPTS="" | |
33 | ||
34 | IPADDR1= | |
35 | IP_AOPTS1= options for ip addr add | |
36 | IP_ROPTS1= options for ip route add (currently used only for IP4_PRIM_IF) | |
37 | ||
38 | IP4_PRIM_IF="1" # number of primary IPv4 interface (IPADDRx) | |
39 | IP4_SRC_IF="1" # number of IPv4 address for ip's ,,src'' parameter | |
3bbbad5c ER |
40 | IP6_PRIM_IF="" # |
41 | IP6_SRC_IF="" # | |
de1fc6ce | 42 | |
03f9cfee | 43 | [ ONBOOT={no|yes} ] |
3bbbad5c | 44 | [ HOTPLUG={no|yes} ] - bring up from hotplug (udev for example) (default to no) |
6a2c03da | 45 | [ MULTICAST={|no|yes} ] - for eth automatically set to yes |
46 | [ ARP={no|yes} ] - for eth automatically set to yes | |
de1fc6ce JR |
47 | [ IPV6_DISABLE_AUTOCONF={yes|no} ] - disable IPv6 autoconfiguration |
48 | ||
49 | [ IPX=yes|no ] | |
50 | if IPX=yes ; then | |
51 | ||
52 | IPXNETNUM_{802_2,802_2TR,802_3,EtherII,SNAP} | |
53 | IPXPRIMARY_{802_2,802_2TR,802_3,EtherII,SNAP}=yes|no | |
54 | IPXACTIVE_{802_2,802_2TR,802_3,EtherII,SNAP}=yes|no | |
55 | fi | |
56 | ||
b2d62426 AM |
57 | [ MTU= ] |
58 | [ METRIC= ] | |
6a2c03da | 59 | [ PROXYARP={yes|no} ] |
b2d62426 | 60 | |
45f7fc7c AM |
61 | QDISC=[sfq|teql0|red|prio|...] (queueing discipline) |
62 | QDISC_CLASS=[htb|cbq|none] (use cbq|htb as class based discipline; | |
63 | if none specified and bandwidth_out present | |
64 | then tbf is used) | |
65 | BANDWIDTH_IN=[upstream limit in kilobites, supported on 2.4 only] | |
66 | BANDWIDTH_OUT=[downstream limit in kilobites] | |
642c5ec3 | 67 | |
59c43d6f JR |
68 | VLAN_REORDER_HDR=[0|1] When this is set, the VLAN device will move the |
69 | ethernet header around to make it look exactly like a | |
70 | real ethernet device. This may help programs such | |
71 | as DHCPd which read the raw ethernet packet and | |
72 | make assumptions about the location of bytes. | |
73 | If you don't need it, don't turn it on, because there | |
74 | will be at least a small performance degradation. | |
75 | Default is ON. | |
76 | ||
3bf0ecee AM |
77 | [ VLAN_GVRP=yes|no ] Enable GVRP. |
78 | ||
de1fc6ce JR |
79 | [ DEFAULTHANDLING=yes|no ] (used in configuration for ATM interfaces, |
80 | obsolete variable) | |
81 | [ HANDLING=0|1|2|3 ] (0 is default; used ie. in ATM configuration, for | |
82 | details see ifup script) | |
83 | ||
2fb1e1f2 | 84 | if DEVICE=eth*; then |
b2d62426 AM |
85 | |
86 | [ MEDIA={auto|10baseT|10base2|AUI} ] | |
2fb1e1f2 | 87 | [ MACADDR=<hw address> ] |
a6c22d3d | 88 | |
d9ce326a AM |
89 | if macvlan |
90 | MACVLAN_DEV=<exitsting base interface eg. eth0> | |
91 | MACVLAN_MACADDR=<desired hw address of new interface> | |
92 | fi | |
93 | ||
94 | ||
a6c22d3d | 95 | if DEVICE=wireless interface (man iwconfig(8)) |
1c481055 AM |
96 | WLAN_UPEARLY=<yes>|<no> Up device before setting any WLAN parameters |
97 | (needed for some drivers) | |
a6c22d3d AM |
98 | WLAN_ESSID=<ESSID or Network Name (Domain ID)>|any|off |
99 | WLAN_NWID=<Network ID (Domain ID)>|off | |
100 | WLAN_FREQ=<frequency> (2.422G) | |
101 | WLAN_CHANNEL=<channel number> (3) | |
102 | WLAN_SENS=<the sensitivity threshold> | |
103 | WLAN_MODE=ad-hoc|managed|master|repeater|secondary|auto | |
104 | WLAN_AP=<Access Point address>|any|auto|off | |
105 | WLAN_NICKNAME=<station nickname) | |
106 | WLAN_BITRATE=<bitrate like 11M>|auto|fixed | |
107 | WLAN_RTS_THRESHOLD=<rts/cts threshold>|auto|fixed|off | |
108 | WLAN_FRAGMENTATION_THRESHOLD=<frag threshold>|auto|fixed|off | |
109 | WLAN_KEY=XXXX-XXXX-XXXX-XXXX|XXXXXXXX|s:<ascii string> | |
2fb1e1f2 ER |
110 | if WLAN_KEY; then |
111 | WLAN_KEY_1=... <optional> | |
112 | WLAN_KEY_2=... <optional> | |
113 | WLAN_KEY_3=... <optional> | |
114 | WLAN_KEY_4=... <optional> | |
115 | WLAN_KEY_CURRENT=index <optional> | |
116 | fi | |
a6c22d3d AM |
117 | WLAN_ENCRYPTION=on|off|open|restricted |
118 | WLAN_POWER=period <value>|timeout <value>|on|off|all|unicast|multicast | |
119 | WLAN_TXPOWER=<power in dBm>|<power in mW>mW|auto|on|off | |
120 | WLAN_RETRY=limit <value>|lifetime <value> | |
121 | WLAN_COMMIT=yes|no (some cards require manual commit of changes) | |
49ee1da7 AM |
122 | if WLAN_WPA=yes; then |
123 | WLAN_WPA_DRIVER=<driver; see -D option of wpa_supplicant> | |
124 | WLAN_WPA_CONFIG=<path to wpa_supplicant config file> | |
125 | WLAN_WPA_OPTIONS=[additional wpa_supplicant options] | |
126 | fi | |
a6c22d3d | 127 | fi |
3bbbad5c | 128 | |
de1fc6ce | 129 | elif DEVICE=ppp* || DEVICE=sl* ; then |
3bbbad5c | 130 | |
b2d62426 AM |
131 | PERSIST=yes|no |
132 | MODEMPORT=<device, say /dev/modem> | |
133 | LINESPEED=<speed, say 115200> | |
3bbbad5c | 134 | DEFABORT=yes|no |
ba4d0a62 AM |
135 | DIRECT_CONNECT=yes|no (direct connection without chat/wvdial used for example |
136 | on SDI or leased lines) | |
3bbbad5c | 137 | |
b2d62426 | 138 | if DEVICE=ppp* ; then |
3bbbad5c | 139 | |
03f9cfee | 140 | AUTH=yes|no |
de1fc6ce | 141 | PEERDNS=yes|no |
b2d62426 AM |
142 | DEFROUTE=yes|no |
143 | ESCAPECHARS=yes|no | |
78524463 | 144 | SYNC=yes|no (yes implies "sync" option) |
41d90072 | 145 | HOLDOFF=30 |
9f120d98 | 146 | HARDFLOWCTL=yes|no (yes implies "modem crtscts" options) |
b2d62426 AM |
147 | PPPOPTIONS=<arbitrary option string> |
148 | PAPNAME=<"name $PAPNAME" on pppd command line> | |
de1fc6ce JR |
149 | REMIP=<remote ip4 address, normally unspecified> |
150 | REMIP6=<remote ip6 address, normally unspecified> | |
b2d62426 AM |
151 | MRU= |
152 | DISCONNECTTIMEOUT=<number of seconds, default currently 5> | |
153 | RETRYTIMEOUT=<number of seconds, default currently 60> | |
154 | INITSCRIPT=<modem command> | |
155 | DATAFORCHAT=<list of variables> | |
156 | <anything>=<anything> (for chat script) | |
de1fc6ce JR |
157 | IPV6_PPP=yes|no (use IPv6 for ppp ?) |
158 | if IPV6_PPP = yes ; then | |
159 | IPV6_CP_USEV4=yes|no (use local IPv4 mapped addresses | |
160 | as IPv6 addresses) | |
161 | IPV6_CP_PERSISTENT=yes|no (use EUI-48 addresses | |
162 | as IPv6 addresses; not | |
163 | supported on Linux, yet) | |
164 | or by default use address specified by IP6_PRIM_IF | |
165 | and REMIP6 | |
166 | fi | |
b5931384 AM |
167 | PPPOA=yes|no (generic PPP over ATM) |
168 | if PPPOA = yes ; then | |
169 | PPPOA_VPI=<VPI number> | |
170 | PPPOA_VCI=<VCI number> | |
171 | fi | |
c3bd5d9f | 172 | PPPOE_DEV=<ethX> (PPP over Ethernet device) |
b5931384 AM |
173 | if PPPOE_DEV exists ; then |
174 | PPPOE_KERNEL=yes|no (use or not kernel space PPPoE support) | |
175 | PPPOE_OPT=<options> (used only with userspace pppoe program) | |
176 | fi | |
177 | PPPOA_EAGLE=yes|no (eagle-usb support) | |
178 | if PPPOA_EAGLE = yes ; then | |
179 | PPPOA_OPT=<options> (used only with userspace pppoa program) | |
180 | fi | |
181 | PPPOA_SPEEDTOUCH=yes|no (speedtouch support) | |
182 | if PPPOA_SPEEDTOUCH = yes ; then | |
183 | PPPOA_KERNEL=yes|no (use or not kernel space PPPoA support) | |
184 | PPPOA_VPI=<VPI number> | |
185 | PPPOA_VCI=<VCI number> | |
186 | PPPOA_OPT=<options> (used only with userspace pppoa program) | |
187 | fi | |
c3bd5d9f AM |
188 | UNIT=yes|no (pass unit option to pppd (depends on DEVICE name) |
189 | defaults to yes) | |
b7be30eb | 190 | WVDIALSECT= (section in wvdial config maybe) |
de1fc6ce | 191 | fi |
b2d62426 | 192 | |
de1fc6ce | 193 | if DEVICE=sl* ; then (SLIP) |
de1fc6ce JR |
194 | PROTOCOL=slip|cslip|adaptive |
195 | REMIP=<remote ip4 address> | |
196 | REMIP6=<remote ip6 address, normally unspecified> | |
197 | fi | |
198 | ||
199 | elif DEVICE=br* ; then /* Bridge */ | |
200 | ||
201 | BRIDGE_DEVS=<list of devices betwen which do bridging> | |
202 | Note: separation configuration for devices in this list | |
203 | should be avoided ! | |
204 | AGEING=<ethernet (MAC) address ageing time in seconds> | |
205 | GCINT=<garbage collection interval time for the bridge in seconds> | |
206 | ||
207 | SPANNING_TREE=yes|no (enable SPT - Spanning Tree Protocol) | |
208 | if SPANNING_TREE=yes ; then | |
209 | BRIDGEPRIO=<bridge's priority; 0-65535; less == better> | |
210 | FD=<bridge forward delay time in seconds> | |
211 | HELLO=<bridge hello time in seconds> | |
212 | MAXAGE=<maximum message age in seconds> | |
213 | PATHCOST_PORT=<port number> | |
214 | PATHCOST=<cost of the port specified in PATHCOST_PORT> | |
215 | Note: both PATHCOST_PORT and PATHCOST must be | |
216 | specified to set cost of port | |
217 | PORTPRIO_PORT=<port> | |
218 | PORTPRIO=<port priority used by port selection algorithms; | |
219 | a number between 0 and 255> | |
220 | Note: see note above | |
b2d62426 | 221 | fi |
a6c22d3d | 222 | elif DEVICE=irda* ; then /* IrDA */ |
3bbbad5c | 223 | |
a6c22d3d AM |
224 | IRDAPORT=<device, say /dev/ttyS1> |
225 | DONGLE=<driver, see README.irattach from irda-utils package> | |
226 | DISCOVERY=yes|no (starts discovery of remote IrDA devices) | |
b2d62426 | 227 | fi |
3bbbad5c | 228 | |
2967b929 ER |
229 | # You can also run some other programs *after* device has been brought up or down. |
230 | # Just create functions run_up() and run_down(). | |
201c98b9 AM |
231 | run_up() |
232 | { | |
2967b929 | 233 | echo "This will be executed after device is brought up!" |
201c98b9 AM |
234 | } |
235 | ||
236 | run_down() | |
237 | { | |
2967b929 | 238 | echo "This will be executed after device is brought down!" |
201c98b9 | 239 | } |