]>
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 | ||
de1fc6ce JR |
77 | [ DEFAULTHANDLING=yes|no ] (used in configuration for ATM interfaces, |
78 | obsolete variable) | |
79 | [ HANDLING=0|1|2|3 ] (0 is default; used ie. in ATM configuration, for | |
80 | details see ifup script) | |
81 | ||
2fb1e1f2 | 82 | if DEVICE=eth*; then |
b2d62426 AM |
83 | |
84 | [ MEDIA={auto|10baseT|10base2|AUI} ] | |
2fb1e1f2 | 85 | [ MACADDR=<hw address> ] |
a6c22d3d AM |
86 | |
87 | if DEVICE=wireless interface (man iwconfig(8)) | |
1c481055 AM |
88 | WLAN_UPEARLY=<yes>|<no> Up device before setting any WLAN parameters |
89 | (needed for some drivers) | |
a6c22d3d AM |
90 | WLAN_ESSID=<ESSID or Network Name (Domain ID)>|any|off |
91 | WLAN_NWID=<Network ID (Domain ID)>|off | |
92 | WLAN_FREQ=<frequency> (2.422G) | |
93 | WLAN_CHANNEL=<channel number> (3) | |
94 | WLAN_SENS=<the sensitivity threshold> | |
95 | WLAN_MODE=ad-hoc|managed|master|repeater|secondary|auto | |
96 | WLAN_AP=<Access Point address>|any|auto|off | |
97 | WLAN_NICKNAME=<station nickname) | |
98 | WLAN_BITRATE=<bitrate like 11M>|auto|fixed | |
99 | WLAN_RTS_THRESHOLD=<rts/cts threshold>|auto|fixed|off | |
100 | WLAN_FRAGMENTATION_THRESHOLD=<frag threshold>|auto|fixed|off | |
101 | WLAN_KEY=XXXX-XXXX-XXXX-XXXX|XXXXXXXX|s:<ascii string> | |
2fb1e1f2 ER |
102 | if WLAN_KEY; then |
103 | WLAN_KEY_1=... <optional> | |
104 | WLAN_KEY_2=... <optional> | |
105 | WLAN_KEY_3=... <optional> | |
106 | WLAN_KEY_4=... <optional> | |
107 | WLAN_KEY_CURRENT=index <optional> | |
108 | fi | |
a6c22d3d AM |
109 | WLAN_ENCRYPTION=on|off|open|restricted |
110 | WLAN_POWER=period <value>|timeout <value>|on|off|all|unicast|multicast | |
111 | WLAN_TXPOWER=<power in dBm>|<power in mW>mW|auto|on|off | |
112 | WLAN_RETRY=limit <value>|lifetime <value> | |
113 | WLAN_COMMIT=yes|no (some cards require manual commit of changes) | |
49ee1da7 AM |
114 | if WLAN_WPA=yes; then |
115 | WLAN_WPA_DRIVER=<driver; see -D option of wpa_supplicant> | |
116 | WLAN_WPA_CONFIG=<path to wpa_supplicant config file> | |
117 | WLAN_WPA_OPTIONS=[additional wpa_supplicant options] | |
118 | fi | |
a6c22d3d | 119 | fi |
3bbbad5c | 120 | |
de1fc6ce | 121 | elif DEVICE=ppp* || DEVICE=sl* ; then |
3bbbad5c | 122 | |
b2d62426 AM |
123 | PERSIST=yes|no |
124 | MODEMPORT=<device, say /dev/modem> | |
125 | LINESPEED=<speed, say 115200> | |
3bbbad5c | 126 | DEFABORT=yes|no |
ba4d0a62 AM |
127 | DIRECT_CONNECT=yes|no (direct connection without chat/wvdial used for example |
128 | on SDI or leased lines) | |
3bbbad5c | 129 | |
b2d62426 | 130 | if DEVICE=ppp* ; then |
3bbbad5c | 131 | |
03f9cfee | 132 | AUTH=yes|no |
de1fc6ce | 133 | PEERDNS=yes|no |
b2d62426 AM |
134 | DEFROUTE=yes|no |
135 | ESCAPECHARS=yes|no | |
41d90072 | 136 | HOLDOFF=30 |
9f120d98 | 137 | HARDFLOWCTL=yes|no (yes implies "modem crtscts" options) |
b2d62426 AM |
138 | PPPOPTIONS=<arbitrary option string> |
139 | PAPNAME=<"name $PAPNAME" on pppd command line> | |
de1fc6ce JR |
140 | REMIP=<remote ip4 address, normally unspecified> |
141 | REMIP6=<remote ip6 address, normally unspecified> | |
b2d62426 AM |
142 | MRU= |
143 | DISCONNECTTIMEOUT=<number of seconds, default currently 5> | |
144 | RETRYTIMEOUT=<number of seconds, default currently 60> | |
145 | INITSCRIPT=<modem command> | |
146 | DATAFORCHAT=<list of variables> | |
147 | <anything>=<anything> (for chat script) | |
de1fc6ce JR |
148 | IPV6_PPP=yes|no (use IPv6 for ppp ?) |
149 | if IPV6_PPP = yes ; then | |
150 | IPV6_CP_USEV4=yes|no (use local IPv4 mapped addresses | |
151 | as IPv6 addresses) | |
152 | IPV6_CP_PERSISTENT=yes|no (use EUI-48 addresses | |
153 | as IPv6 addresses; not | |
154 | supported on Linux, yet) | |
155 | or by default use address specified by IP6_PRIM_IF | |
156 | and REMIP6 | |
157 | fi | |
b5931384 AM |
158 | PPPOA=yes|no (generic PPP over ATM) |
159 | if PPPOA = yes ; then | |
160 | PPPOA_VPI=<VPI number> | |
161 | PPPOA_VCI=<VCI number> | |
162 | fi | |
c3bd5d9f | 163 | PPPOE_DEV=<ethX> (PPP over Ethernet device) |
b5931384 AM |
164 | if PPPOE_DEV exists ; then |
165 | PPPOE_KERNEL=yes|no (use or not kernel space PPPoE support) | |
166 | PPPOE_OPT=<options> (used only with userspace pppoe program) | |
167 | fi | |
168 | PPPOA_EAGLE=yes|no (eagle-usb support) | |
169 | if PPPOA_EAGLE = yes ; then | |
170 | PPPOA_OPT=<options> (used only with userspace pppoa program) | |
171 | fi | |
172 | PPPOA_SPEEDTOUCH=yes|no (speedtouch support) | |
173 | if PPPOA_SPEEDTOUCH = yes ; then | |
174 | PPPOA_KERNEL=yes|no (use or not kernel space PPPoA support) | |
175 | PPPOA_VPI=<VPI number> | |
176 | PPPOA_VCI=<VCI number> | |
177 | PPPOA_OPT=<options> (used only with userspace pppoa program) | |
178 | fi | |
c3bd5d9f AM |
179 | UNIT=yes|no (pass unit option to pppd (depends on DEVICE name) |
180 | defaults to yes) | |
b7be30eb | 181 | WVDIALSECT= (section in wvdial config maybe) |
de1fc6ce | 182 | fi |
b2d62426 | 183 | |
de1fc6ce | 184 | if DEVICE=sl* ; then (SLIP) |
de1fc6ce JR |
185 | PROTOCOL=slip|cslip|adaptive |
186 | REMIP=<remote ip4 address> | |
187 | REMIP6=<remote ip6 address, normally unspecified> | |
188 | fi | |
189 | ||
190 | elif DEVICE=br* ; then /* Bridge */ | |
191 | ||
192 | BRIDGE_DEVS=<list of devices betwen which do bridging> | |
193 | Note: separation configuration for devices in this list | |
194 | should be avoided ! | |
195 | AGEING=<ethernet (MAC) address ageing time in seconds> | |
196 | GCINT=<garbage collection interval time for the bridge in seconds> | |
197 | ||
198 | SPANNING_TREE=yes|no (enable SPT - Spanning Tree Protocol) | |
199 | if SPANNING_TREE=yes ; then | |
200 | BRIDGEPRIO=<bridge's priority; 0-65535; less == better> | |
201 | FD=<bridge forward delay time in seconds> | |
202 | HELLO=<bridge hello time in seconds> | |
203 | MAXAGE=<maximum message age in seconds> | |
204 | PATHCOST_PORT=<port number> | |
205 | PATHCOST=<cost of the port specified in PATHCOST_PORT> | |
206 | Note: both PATHCOST_PORT and PATHCOST must be | |
207 | specified to set cost of port | |
208 | PORTPRIO_PORT=<port> | |
209 | PORTPRIO=<port priority used by port selection algorithms; | |
210 | a number between 0 and 255> | |
211 | Note: see note above | |
b2d62426 | 212 | fi |
a6c22d3d | 213 | elif DEVICE=irda* ; then /* IrDA */ |
3bbbad5c | 214 | |
a6c22d3d AM |
215 | IRDAPORT=<device, say /dev/ttyS1> |
216 | DONGLE=<driver, see README.irattach from irda-utils package> | |
217 | DISCOVERY=yes|no (starts discovery of remote IrDA devices) | |
b2d62426 | 218 | fi |
3bbbad5c | 219 | |
2967b929 ER |
220 | # You can also run some other programs *after* device has been brought up or down. |
221 | # Just create functions run_up() and run_down(). | |
201c98b9 AM |
222 | run_up() |
223 | { | |
2967b929 | 224 | echo "This will be executed after device is brought up!" |
201c98b9 AM |
225 | } |
226 | ||
227 | run_down() | |
228 | { | |
2967b929 | 229 | echo "This will be executed after device is brought down!" |
201c98b9 | 230 | } |