home *** CD-ROM | disk | FTP | other *** search
/ Chip 2007 January, February, March & April / Chip-Cover-CD-2007-02.iso / boot / i386 / rescue / etc / sysconfig / network / ifcfg.template < prev    next >
Encoding:
Text File  |  2006-11-29  |  27.0 KB  |  795 lines
  1. ## This is a template for a network interface configuration file used with ifup.
  2. ## See 'man 8 ifup' for details.
  3. ## Additionally to the following variables you can set every variable from the
  4. ## interface independent configurations files (config, dhcp, wireless) also in
  5. ## the interface configuration file to overwrite the global settings.
  6.  
  7. ## Type: list(auto,hotplug,ifplugd,nfsroot,manual,off,onboot)
  8. ## Default: auto
  9. #
  10. # STARTMODE tells ifup when a interface should be set up. Possible values are:
  11. # - auto:    start it as soon as the interface is available. Either when booting
  12. #            or when a device is plugged or initialized at runtime
  13. # - hotplug: alias for auto, only difference is that configurations with that
  14. #            startmode are not considered to be mandatory if list of mandatory
  15. #            devices is derived automatically.
  16. # - ifplugd: interface will be controlled by ifplugd daemon. (If you like to use
  17. #            multiple interfaces mutually exclusive you have to set also
  18. #            IFPLUGD_PRIORITY.)
  19. # - nfsroot: Nearly like 'auto'. But interfaces with this startmode will never
  20. #            be shut down via 'rcnetwork stop'. 'ifdown <iface>' still works.
  21. #            Use this when you have a nfs root filesystem.
  22. # - manual:  start it only when ifup is called manually
  23. # - off:     will not be started at all
  24. # - onboot:  alias for auto, deprecated, only for backward compliance
  25. STARTMODE=
  26.  
  27. ## Type:    integer(0:100)
  28. ## Default: 0
  29. #
  30. # All interfaces with STARTMODE=ifplugd and with IFPLUGD_PRIORITY != 0 will be
  31. # used mutually exclusive. If more then one of these interfaces is 'plugged'
  32. # then we need a way to decide which interface to take up. Therefore we have to
  33. # set the priority of each interface.
  34. # Note: Connection detection of wireless devices is not very reliable.
  35. # Therefore we currently simple consider a wlan interface as always connected.
  36. # With a lower priority as all other interfaces it will then be set up if no
  37. # other connection is established.
  38. # A value of 0 means no priority set.
  39. #
  40. IFPLUGD_PRIORITY=
  41.  
  42. ## Type:    list(static,dhcp,autoip,dhcp+autoip,6to4)
  43. ## Default: static
  44. #
  45. # With BOOTPROTO you can choose in which mode the interface will be set up:
  46. # - static:      Set up static address(es)
  47. # - dhcp:        Start a dhcp client on that interface.
  48. # - autoip:      Automatic search for a free address and assign it statically.
  49. # - dhcp+autoip: Try dhcp and use autoip if dhcp fails.
  50. # - 6to4:        Set up ipv6 over ipv4 tunnel (see man ifcfg-tunnel)
  51. # If you use dhcp or autoip you may additionally specify static address(es).
  52. #
  53. BOOTPROTO=
  54.  
  55. ## Type:    string
  56. ## Default: ""
  57. #
  58. # If using a static configuration you have to set an IP address and a netmask
  59. # or prefix length. The following examples are equivalent:
  60. # 1) IPADDR=192.168.1.1
  61. #    NETMASK=255.255.255.0
  62. # 2) IPADDR=192.168.1.1
  63. #    PREFIXLEN=24              # NETMASK will be ignored
  64. # 3) IPADDR=192.168.1.1/24     # NETMASK and PREFIXLEN will be ignored
  65. #
  66. # For multiple addresses use this variable multiple times and extend them with
  67. # different suffixes. For example IPADDR_1=, IPADDR_2=. See section 'Multiple
  68. # addresses' in manpage ifcfg).
  69. #
  70. IPADDR=
  71.  
  72.  
  73. ## Type:    string
  74. ## Default: ""
  75. #
  76. # Set the network mask for the ip address. This variable will be ignored if a
  77. # prefixlength is set in variable PREFIXLEN in IPADDR.
  78. # For multiple addresses use the same suffixes as with IPADDR.
  79. #
  80. NETMASK=
  81.  
  82. ## Type:    integer(0,64)
  83. ## Default: ""
  84. #
  85. # Set the prefixlength of the ip address. This variable will be ignored if a
  86. # prefixlength is set in variable IPADDR.
  87. # For multiple addresses use the same suffixes as with IPADDR.
  88. #
  89. PREFIXLEN=
  90.  
  91. ## Type:    string
  92. ## Default: ""
  93. #
  94. # Set the broadcast address of the interface. If you leave it empty a default
  95. # will be used. See DEFAULT_BROADCAST in /etc/sysconfig/network/config.
  96. # For multiple addresses use the same suffixes as with IPADDR.
  97. #
  98. BROADCAST=
  99.  
  100. ## Type:    string
  101. ## Default: ""
  102. #
  103. # If you'd like to set up a point to point connection you may specify the
  104. # remote IP here.
  105. # For multiple addresses use the same suffixes as with IPADDR.
  106. #
  107. REMOTE_IPADDR=
  108.  
  109. ## Type:    string
  110. ## Default: ""
  111. #
  112. # Set a label for the interface. This may be neccessary if you still use
  113. # ifconfig and configured multiple addresses. (See manpage ifcfg).
  114. # For multiple addresses use the same suffixes as with IPADDR.
  115. #
  116. LABEL=
  117.  
  118. ## Type:    string
  119. ## Default: ""
  120. #
  121. # Set the  scope  of the area where this address is valid. 
  122. # See manpage ip for details.
  123. # For multiple addresses use the same suffixes as with IPADDR.
  124. #
  125. SCOPE=
  126.  
  127. ## Type:    string
  128. ## Default: ""
  129. #
  130. # Every other option from "ip address add" can be added here.
  131. # See manpage ip for details.
  132. # For multiple addresses use the same suffixes as with IPADDR.
  133. #
  134. IP_OPTIONS=
  135.  
  136. ## Type:    string
  137. ## Default: ""
  138. #
  139. # Set the interface type if ifup cannot determine it properly. This may be
  140. # needed if you use unusual interface names for special interfaces like
  141. # modems.
  142. #
  143. INTERFACETYPE=
  144.  
  145. ## Type:    integer
  146. ## Default: ""
  147. #
  148. # Set a specific Maximum Transmission Unit (MTU) for this interface.
  149. #
  150. MTU=
  151.  
  152. ## Type:    string
  153. ## Default: ""
  154. #
  155. # Set a specific link level address (LLADDR), a.k.a. MAC address or hardware
  156. # address, for this interface (if the driver supports it).
  157. #
  158. LLADDR=
  159.  
  160. ## Type:    string
  161. ## Default: ""
  162. #
  163. # Every other option from "ip link set" can be added here.
  164. # Example:
  165. #       LINK_OPTIONS="multicast off"
  166. # See manpage ip for details.
  167. #
  168. LINK_OPTIONS=
  169.  
  170. ## Type:    string
  171. ## Default: ""
  172. #
  173. # If this variable is not empty ifup will call ethtool with this
  174. # options. See manpage ethtool for available options.
  175. # If option string starts with a '-' (e.g. '-K iface rx on') then the
  176. # second word in the string will be replaced with the current interface
  177. # name. Else (e.g. 'autoneg off speed 10') ifup prepends '-s <interface>'.
  178. #
  179. ETHTOOL_OPTIONS=
  180.  
  181. ## Type:    yesno
  182. ## Default: yes
  183. #
  184. # This options defines whether the script /etc/ppp/poll.tcpip is run after
  185. # connecting to the internet via a dialup connection or not. The script
  186. # itself calls various jobs like fetchmail, fetchnews and sendmail.
  187. #
  188. RUN_POLL_TCPIP=
  189.  
  190. ## Type:    yesno
  191. ## Default: no
  192. #
  193. # If an interface may be controlled from a user via kinternet or cinternet you
  194. # have to set this variable to yes.
  195. #
  196. USERCONTROL=
  197.  
  198. ## Type:    string
  199. ## Default: ""
  200. #
  201. # This string is used as description of the device in YaST.
  202. # This variable is not used in ifup and friends.
  203. #
  204. NAME=
  205.  
  206. ## Type:    string
  207. ## Default: ""
  208. #
  209. # Internal variable for YaST. Don't change it.
  210. # This variable is not used in ifup and friends.
  211. #
  212. UNIQUE=
  213.  
  214. ## Type:    string
  215. ## Default: ""
  216. #
  217. # Internal variable for YaST. Don't change it.
  218. # This variable is not used in ifup and friends.
  219. #
  220. _nm_name=
  221.  
  222. ## Type:    yesno
  223. ## Default: no
  224. #
  225. # If the network is managed with NetworkManager but you want to control an
  226. # interface manually with ifup/down you can set this variable to 'yes'.
  227. #
  228. NM_CONTROLLED=no
  229.  
  230.  
  231. ##########################################################################
  232. ### FIXME:
  233. ### From here one up to 'bridge settings' the file is not up to date
  234.  
  235.  
  236. ## Multiple addresses
  237. ##    You can extend the variable name 'IPADDR' by any string you like (IPADDR_1,
  238. ##    IPADDR_FOO, IPADDRxxx, ...) and use these variables for your IP addresses.
  239. ##    If you need some additional parameters for these addresses, then just add
  240. ##    the same extension to these variable names.
  241. ##    IPADDR_AAA=1.2.3.4
  242. ##    NETMASK_AAA=255.0.0.0
  243. ##    BROADCAST_AAA=1.2.3.55
  244. ##    IPADDR_BBB=10.10.2.3/16
  245. ##    LABEL_BBB=BBB
  246. ##    an so on ...
  247. ##
  248. ## You do not need to set a label for any address. But then you should not use
  249. ## ifconfig any longer; go and use ip. If you want to use ifconfig then omit the
  250. ## label for your main address and set a label for every additional address.
  251.  
  252. ## Routing:
  253. ## If you need special routes for a configuration, then use a file named
  254. ## ifroute-<config> where <config> is the same string as in ifcfg-<config>.
  255. ## It has the same syntax like routes except one difference:
  256. ## If you omit the interface name (4th field) in the ifroute file it will be
  257. ## set to the current interface name when setting up the interface. You need to
  258. ## do this with hotpluggable devices, where you do not know which interface name
  259. ## they will get at the time when you plug them.
  260. ## See man 5 routes.
  261.  
  262.  
  263. ##########################################################################
  264. ## DHCP settings
  265.  
  266. ## Type: list("",yes,no)
  267. ## Default: ""
  268. #
  269. # Multiple DHCP clients:
  270. #
  271. # With two or more DHCP clients running, they would concurrently try to replace
  272. # the default route or rewrite resolv.conf, rewrite ntp.conf etc. There are two
  273. # ways of dealing with this conflict (and it is a conflict, because you can
  274. # have only one default route even though routes are stackable, and there can
  275. # only be one resolv.conf file):
  276. #
  277. #  1) allow both clients to do that stuff. This would work in many cases if
  278. #     only one of the interfaces is used at a time. However, it would lead to
  279. #     undefined behaviour.
  280. #
  281. #  2) allow only one of the DHCP clients to do that stuff. This implies
  282. #     that there would be a "primary" interface and a "secondary". This is the
  283. #     assumption the default configuration is based on. But since the system
  284. #     can't guess which interface is "more important" and should have the
  285. #     default route and resolver configuration associated with it, it simply
  286. #     chooses the first interface that is started with DHCP to be
  287. #     "authoritative".  Which one that is can be influenced by adding
  288. #     DHCLIENT_PRIMARY_DEVICE=yes to one of the /etc/sysconfig/network/ifcfg-*
  289. #     files. This can even be added to more than one file, to achieve the
  290. #     behaviour described in 1).  Thus, there is the flexibility to do it
  291. #     either way.
  292. #
  293. # Per default, only the DHCP client that is started first will be allowed to
  294. # change the default route / resolver configuration etc.  All other running
  295. # clients will only configure the interface with an address, but not change
  296. # "global" configuration.
  297. #
  298. # Thus, to specifically allow an interface's DHCP client to change "global"
  299. # configuration, set the following variable to "yes". Or you can make an
  300. # interface's DHCP client never change these settings if you set it to "no".
  301. # If you leave it empty then ifup-dhcp will decide.
  302. #
  303. DHCLIENT_PRIMARY_DEVICE=
  304.  
  305.  
  306. ## Type:
  307. ## Default:
  308. #
  309. # Even more finegrained control can be excerted by setting any of the variables
  310. # from /etc/sysconfig/network/dhcp here:
  311. DHCLIENT_DEBUG=
  312. DHCLIENT_SET_HOSTNAME=
  313. DHCLIENT_SET_DOMAINNAME=
  314. DHCLIENT_KEEP_SEARCHLIST=
  315. DHCLIENT_MODIFY_RESOLV_CONF=
  316. DHCLIENT_SET_DEFAULT_ROUTE=
  317. DHCLIENT_MODIFY_NTP_CONF=
  318. DHCLIENT_MODIFY_NIS_CONF=
  319. DHCLIENT_TIMEOUT=
  320. DHCLIENT_REBOOT_TIMEOUT=
  321. DHCLIENT_CLIENT_ID=
  322. DHCLIENT_HOSTNAME_OPTION=
  323. DHCLIENT_VENDOR_CLASS_ID=
  324. DHCLIENT_LEASE_TIME=
  325. DHCLIENT_ADDITIONAL_OPTIONS=
  326.  
  327.  
  328. ##########################################################################
  329. ## bridge settings. See ifcfg-bridge(5) and brctl(8) for mor information
  330. ## 
  331.  
  332. ## Type:    yesno
  333. ## Default: yes
  334. #
  335. # This option must be set to 'yes' to identify this interface as a bridge
  336. # interface.
  337. #
  338. BRIDGE='yes'
  339.  
  340. ## Type:    string
  341. ## Default: 
  342. #
  343. # This variable contains a space-separated list of N interfaces which take part 
  344. # in the bridging. You may use also hardware descriptions if your interface
  345. # names are not persistent.
  346. #
  347. BRIDGE_PORTS=''
  348.  
  349. ## Type:    integer(0:)
  350. ## Default: 
  351. #
  352. # This option sets the ethernet address ageing time, in seconds. After <time> 
  353. # seconds of not having seen a frame coming from a certain address, the bridge 
  354. # will delete that address from the forwarding database. Setting ageing time 
  355. # to zero makes all entries permanent.
  356. #
  357. BRIDGE_AGEINGTIME=''
  358.  
  359. ## Type:    integer(0:)
  360. ## Default:
  361. #
  362. # Forwarding delay time is the time in seconds spent in each of the listening
  363. # and learning states before the forwarding state is entered. This delay is  
  364. # so that when a new bridge comes onto a busy network it looks at some traffic 
  365. # before participating.
  366. #
  367. BRIDGE_FORWARDDELAY=''
  368.  
  369. ## Type:    integer(0:)
  370. ## Default:
  371. #
  372. # Periodically, a hello packet is sent out by the root bridge and the designated 
  373. # bridges. Hello packets are used to communicate information about the topology 
  374. # throughout the entire bridged local area network.
  375. #
  376. BRIDGE_HELLOTIME=''
  377.  
  378. ## Type:    integer(0:)
  379. ## Default:
  380. #
  381. # If a another bridge in the spanning tree does not send out a hello packet for
  382. # a long period of time, it is assumed to be dead. This timeout can be set with 
  383. # this variable.
  384. #
  385. BRIDGE_MAXAGE=''
  386.  
  387. ## Type:    string
  388. ## Default:
  389. #
  390. # This is a space-separated list of costs corresponding to the interfaces in 
  391. # BRIDGE_PORTS. Each interface in BRIDGE_PORTS could have a different speed 
  392. # and this value is used when deciding which link to use. Faster interfaces
  393. # should have lower costs. 
  394. #
  395. BRIDGE_PATHCOSTS=''
  396.  
  397. ## Type:    string
  398. ## Default:
  399. #
  400. # This is a space-separated list of priorities corresponding to the interfaces 
  401. # in BRIDGE_PORTS. The priority value is an unsigned 8-bit quantity (a number 
  402. # between 0 and 255), and has no dimension. This metric is used in the
  403. # designated port and root port selection algorithms.
  404. #
  405. BRIDGE_PORTPRIORITIES=''
  406.  
  407. ## Type:    integer(0:65535)
  408. ## Default: 
  409. #
  410. # This option sets the bridge's priority. The priority value is an unsigned 
  411. # 16-bit quantity (a number between 0 and 65535), and has no dimension. Lower 
  412. # priority values are 'better'. The bridge with the lowest priority will be
  413. # elected 'root bridge'.
  414. #
  415. BRIDGE_PRIORITY=''
  416.  
  417. ## Type:    list(on,off)
  418. ## Default: off
  419. #
  420. # Multiple ethernet bridges can work together to create even larger networks 
  421. # of ethernets using the IEEE 802.1d spanning tree protocol. This protocol  
  422. # is used for finding the shortest path between  two  ethernets, and for 
  423. # eliminating loops from the topology.
  424. # 
  425. # The spanning tree protocol can also be turned off (for those situations
  426. # where it just doesn't make sense, for example when this linux box is
  427. # the only bridge on the LAN, or when you know that there are no loops in
  428. # the topology.)
  429. #
  430. BRIDGE_STP=''
  431.  
  432. ## Type:    yesno
  433. ## Default:    ""
  434. #
  435. # Defines whether this interface is wireless or not.  This variable is usually
  436. # not set, WLAN capabilities get auto-detected in this case.  As the WIRELESS
  437. # variable is device speficic and not network specific, it can have no suffix.
  438. WIRELESS=''
  439.  
  440.  
  441. ## Type:    string
  442. ## Default:    "managed"
  443. #
  444. # Set the operating mode of the device, which depends on the network topology.
  445. # Set to ad-hoc for network composed of only one cell and without Access
  446. # Point, managed for network composed of many cells, with roaming or with an
  447. # Access Point, master if you want your system act as an Access Point or
  448. # synchronisation master. If unset, managed will be used.
  449. WIRELESS_MODE=''
  450.  
  451. ## Type:    string
  452. ## Default:    ""
  453. #
  454. # Set the SSID/ESSID (or Network Name - in some products it may also called
  455. # Domain ID). The ESSID is used to identify cells which are part of the same
  456. # virtual network. If emtpy or set to any the node will connect to the
  457. # Access Point with the best signal strength around (in managed operating
  458. # mode). For WLANs that make use of WPA (see WIRELESS_AUTH_MODE below)
  459. # you need to set your ESSID.
  460. WIRELESS_ESSID=''
  461.  
  462. ## Type:    list(open,sharedkey,psk,eap)
  463. ## Default:    open
  464. #
  465. # Sets authentication mode. The mode depends on the protection technology
  466. # beeing used, WEP or WPA. WEP (Wired Equivalent Privacy) is a system to
  467. # encrypt wireless network traffic, with an optional authentication on the
  468. # basis of the used encryption key. In most cases where WEP is used, open
  469. # mode (no authentication at all) is fine. This does not mean that you can
  470. # not use WEP encryption. Some networks may require sharedkey authentication.
  471. # NOTE: Shared key authentication makes it easier for a potential attacker to
  472. # break into your network. Unless you have specific needs for shared key
  473. # authentication, use the open mode. As WEP has been proved insecure, WPA
  474. # (Wi-Fi Protected Access) was defined to close its security wholes, but not
  475. # every hardware supports WPA. In case you want to use WPA-PSK (WPA preshared
  476. # key authentication, aka WPA "Home"), set this to psk. In case you want
  477. # to use WPA-EAP (WPA with Extensible Authentication Protocol, aka WPA
  478. # "Enterprise"), set this to eap. WPA authentication modes are only
  479. # possible when WIRELESS_MODE is set to managed.
  480. WIRELESS_AUTH_MODE=''
  481.  
  482. ## Type:    string
  483. ## Default:    ""
  484. #
  485. # When using WPA-PSK authentication, you need to specify your preshared key
  486. # here. The key is used for authentication and encryption purposes. You can
  487. # enter it in hex digits (needs to be exactly 64 digits long) or as passphrase
  488. # getting hashed (8 to 63 ASCII characters long).
  489. WIRELESS_WPA_PSK=''
  490.  
  491. ## Type:    string
  492. ## Default:    ""
  493. #
  494. # WPA-EAP can use different authentication modes. Supported
  495. # values are TLS, PEAP, and TTLS. Default is to allow any.
  496. # When using WIRELESS_AP_SCANMODE 2, this variable needs to be set.
  497. WIRELESS_EAP_AUTH=''
  498.  
  499. ## Type:    string
  500. ## Default:    ""
  501. #
  502. # Using this variable you can specify the WPA protocol to be used.
  503. # Valid values are WPA and RSN (aka WPA2, can be also used as synonym).
  504. # Default is to allow both. When using WIRELESS_AP_SCANMODE 2, this
  505. # variable needs to be set, otherwise WPA will be used as fallback.
  506. WIRELESS_WPA_PROTO=''
  507.  
  508. ## Type:    string
  509. ## Default:    ""
  510. #
  511. # Needs to be set in conjunction with WPA-EAP. Set to your identity as
  512. # configured on the RADIUS server.
  513. WIRELESS_WPA_IDENTITY=''
  514.  
  515. ## Type:    string
  516. ## Default:    ""
  517. #
  518. # Needs to be set in conjunction with WPA-EAP. Set to your password as
  519. # configured on the RADIUS server.
  520. WIRELESS_WPA_PASSWORD=''
  521.  
  522. ## Type:    string
  523. ## Default:    "anonymous"
  524. #
  525. # Sets anonymous identity. Default is "anonymous". The anonymous identity is
  526. # used with WPA-EAP protocols that support different tunnelled identities
  527. # (e.g., TTLS).
  528. WIRELESS_WPA_ANONID=''
  529.  
  530. ## Type:    string
  531. ## Default:    ""
  532.  
  533. # Used with WPA-EAP. If you want to check the RADIUS server's authenticity,
  534. # which is highly recommended, you need specify the certificate of the
  535. # CA (Certification Authority) which signed the server's certificate.
  536. # Point this variable to the certificate file including full path.
  537. WIRELESS_CA_CERT=''
  538.  
  539. ## Type:    string
  540. ## Default:    ""
  541. #
  542. # Used with WPA-EAP. If you are using TLS as authentication protocol you need
  543. # to authenticate yourself through a client certificate. Point this variable
  544. # to the certificate file including full path.
  545. WIRELESS_CLIENT_CERT=''
  546.  
  547. ## Type:    string
  548. ## Default:    ""
  549. #
  550. # Used with WPA-EAP. Authentication mode TLS uses a public/private key method
  551. # to encrypt negotiation data. Point this variable to the file containing your
  552. # client private key including full path.
  553. WIRELESS_CLIENT_KEY=''
  554.  
  555. ## Type:    string
  556. ## Default:    ""
  557. #
  558. # Used with WPA-EAP. Set to the passphrase of your client private key file.
  559. WIRELESS_CLIENT_KEY_PASSWORD=''
  560.  
  561. ## Type:    yesno
  562. ## Default:    yes
  563. #
  564. # Defines whether hidden SSID scan support should be enabled.  Setting this to
  565. # "no" can speed up scanning and makes the usage of WIRELESS_PRIORITY
  566. # possible. This is only used in conjunction with wpa_supplicant.
  567. WIRELESS_HIDDEN_SSID=''
  568.  
  569. ## Type:    integer
  570. ## Default:    ""
  571. #
  572. # This variable only makes sense used in conjunction with multiple
  573. # networks. If you want to prefer one configured network for over another, set
  574. # the respecitve WIRELESS_PRIORITY variable (means, with the same suffix) to a
  575. # higher value (integer only). NOTE: This does not work for networks that are
  576. # configured with WIRELESS_HIDDEN_SSID="yes" (which is default). For networks
  577. # with hidden SSID scanning support the suffix number is important.  The
  578. # network with the lowest suffix number gets probed first.
  579. WIRELESS_PRIORITY=''
  580.  
  581. ## Type:    list(0,1,2)
  582. ## Default:    1
  583. #
  584. # Defines which SSID scan mode should be used. Mode 0 means the driver
  585. # performs the scan. Mode 1 means wpa_supplicant takes care of scanning.  Mode
  586. # 2 is basically the same as mode 0 but the access point gets chosen by
  587. # security policy and SSID. This mode does not support multiple network
  588. # settings. Default is "1" for most drivers. Try "0" or "2" if you have
  589. # problems associating to your access point. This variable can have no
  590. # suffix. This is only used in conjuntion with wpa_supplicant.
  591. WIRELESS_AP_SCANMODE=''
  592.  
  593. ## Type:    string
  594. ## Default:    ""
  595. #
  596. # If have configured a WPA mode in WIRELESS_AUTH_MODE you can use this
  597. # variable to supply a custom wpa_supplicant.conf that will be used instead of
  598. # the one ifup would generate. The file has to be specified with full path. Of
  599. # course you can setup any configuration suitable for wpa_supplicant with
  600. # this, not only WPA modes. This variable can have no suffix. If you want to
  601. # have multiple network support, you need to create a wpa_supplicant.conf with
  602. # mulitle network sections (see wpa_supplicant documentation).
  603. WIRELESS_WPA_CONF=''
  604.  
  605. ## Type:    yesno
  606. ## Default:    yes
  607. #
  608. # If you configured only one wireless network and are not using WPA, the
  609. # device can be set up without using wpa_supplicant, although it would be
  610. # possible to use it. This variable defines whether wpa_supplicant should be
  611. # used in that case.
  612. PREFER_WPA_SUPPLICANT=''
  613.  
  614. ## Type:    string
  615. ## Default:    ""
  616. #
  617. # In environments with multiple Access points you may want to define the one
  618. # to connect to by entering its MAC address. Format is 6x2 hex digits,
  619. # seperated by colons, eg 01:02:03:04:05:06.
  620. WIRELESS_AP=''
  621.  
  622. ## Type:    yesno
  623. ## Default:    no
  624. #
  625. # If set to yes, ifup tries to enable power saving for this device. This is
  626. # not supported by all cards resp. drivers.
  627. WIRELESS_POWER=''
  628.  
  629. ## Type:    string
  630. ## Default:    ""
  631. # Set the nickname, or the station name. Most 802.11 products do define it,
  632. # but this is not used as far as the protocols (MAC, IP, TCP) are concerned
  633. # and completely accessory as far as configuration goes. If this variable is
  634. # empty the hostname will be used as nick.
  635. WIRELESS_NICK=''
  636.  
  637. ## Type:    string
  638. ## Default:    ""
  639. #
  640. # Set the Network ID (in some products it is also called Domain ID). As all
  641. # adjacent wireless networks share the same medium, this parameter is used to
  642. # differenciate them (create logical colocated networks) and identify nodes
  643. # belonging to the same cell.
  644. WIRELESS_NWID=''
  645.  
  646. ## Type:    string
  647. ## Default:    ""
  648. #
  649. # With this variable you can define the channel being used. This is only
  650. # applicable to ad-hoc and master operating modes. Channels are usually
  651. # numbered starting at 1, and you may use iwpriv(8) to get the total number of
  652. # channels and list the available frequencies. Depending on regulations, some
  653. # frequencies/channels may not be available.
  654. WIRELESS_CHANNEL=''
  655.  
  656. ## Type:    integer
  657. ## Default:    ""
  658. #
  659. # Set the sensitivity threshold. This is the lowest signal level for which we
  660. # attempt a packet reception, signal lower than this are not received. This
  661. # is used to avoid receiving background noise.
  662. WIRELESS_SENS=''
  663.  
  664. ## Type:    string
  665. ## Default:    "auto"
  666. #
  667. # Usually the highest bitrate available gets used. If you have specific needs
  668. # to set a bitrate, you can do it here (rates are in Mbit/s). Bitrates above
  669. # 11 are only available for cards compliant to 802.11a or 802.11g standards.
  670. WIRELESS_RATE=''
  671.  
  672. ## Type:    string
  673. ## Default:    ""
  674. #
  675. # You can define up to 4 WEP encryption keys. You can use WEP with open and
  676. # sharedkey authentication. The key can be entered in different formats:
  677. # Either directly in hex digits, with or without dashes, or in the key's ASCII
  678. # representation (prefix s: ), or as a passphrase which will be hashed (prefix
  679. # h: ). The amount of hex digits resp. length of the ASCII key depends on the
  680. # key size being used: 10 hex digits or 5 ASCII characters for 64 bit keys, 26
  681. # hex digits or 6 to 13 ASCII characters for 128 bit keys (see
  682. # WIRELESS_KEY_LENGTH below). Examples:
  683. #
  684. # WIRELESS_KEY_0="0123-4567-89"
  685. # WIRELESS_KEY_0-"s:hello"
  686. # WIRELESS_KEY_0="h:mysecretphrase"
  687. #
  688. # You  can also use 1, 2, or 3 as suffix for multiple key settings. This
  689. # is usually not necessary. Leave empty if you do not want WEP.
  690. WIRELESS_KEY=''
  691.  
  692. ## Type:    list(40,104)
  693. ## Default:    104
  694. #
  695. # Defines the length in bits for all keys used. There are currently 40 and 104
  696. # bit keys supported. Sometimes they are also called 64 resp. 128 bits
  697. # (depends on whether you count the 24 bit initialization vetor or not).
  698. # This variable is only meaningful if you enter the key as passphrase.
  699. WIRELESS_KEY_LENGTH=''
  700.  
  701. ## Type:    list(0,1,2,3)
  702. ## Default:    0
  703.  
  704. # Sets the default WEP key. The default key is used to encrypt outgoing
  705. # packets, incoming ones are decrypted with the key number specified in the
  706. # packet. This defaults to 0.
  707. WIRELESS_DEFAULT_KEY=''
  708.  
  709.  
  710.  
  711. ## Type:    string
  712. ## Default:    "off"
  713. #
  714. # RTS/CTS adds a handshake before each packet transmission to make sure that
  715. # the channel is clear. This adds overhead, but increase performance in case
  716. # of hidden nodes or large number of active nodes. Possible values: any
  717. # integer (representing the size of the smallest packet for which the node
  718. # sends RTS), auto, fixed, or off.
  719. WIRELESS_RTS=''
  720.  
  721. ## Type:    string
  722. ## Default:    "off"
  723. #
  724. # Fragmentation allow to split a IP packet in a burst of smaller fragments
  725. # transmitted on the medium. In most cases this adds overhead, but in very
  726. # noisy environment this reduce the error penalty. Possible values: any
  727. # integer (representing the maximum fragment size), auto, fixed, or off.
  728. WIRELESS_FRAG=''
  729.  
  730. ## Type:    string
  731. ## Default:    ""
  732. #
  733. # If you need other options for iwconfig, then write the complete option string
  734. # as you would append it to iwconfig but without the interface name to the
  735. # variables below. For multiple options you may (but need not) add linebreaks in
  736. # the string.
  737. WIRELESS_IWCONFIG_OPTIONS=''
  738.  
  739. ## Type:    string
  740. ## Default:    ""
  741. #
  742. # If you need to set options for iwspy, then write the complete option string as
  743. # you would append it to iwspy but without the interface name to the variables
  744. # below. For multiple options you may (but need not) add linebreaks in the
  745. # string.
  746. WIRELESS_IWSPY_OPTIONS=''
  747.  
  748. ## Type:    string
  749. ## Default:    ''
  750. #
  751. # If you need to set options for iwpriv then write the complete option string as
  752. # you would append it to iwpriv but without the interface name to the variables
  753. # below. For multiple options you may (but need not) add linebreaks in the
  754. # string.
  755. WIRELESS_IWPRIV_OPTIONS=''
  756.  
  757. ## Type:    string
  758. ## Default:    ''
  759. #
  760.  
  761. # For WPA modes you can set the WPA protocol to be used, WPA or RSN
  762. # (aka WPA2).  Default is to allow both protocols. When using
  763. # WIRELESS_AP_SCANMODE 2, this variable needs to be set, or WPA will
  764. # be used as fallback. Note: WPA2 can be used as an alias for RSN.
  765. WIRELESS_WPA_PROTO=''
  766.  
  767. ## Type:    string
  768. ## Default:    ''
  769. #
  770. # WPA modes support two different encryption systems, TKIP and
  771. # CCMP. This variable defines which to use for unicast communication.
  772. # Default is to allow both. In case you want to restrict it to one
  773. # protocol, set this variable. When using WIRELESS_AP_SCANMODE 2, this
  774. # variable needs to be set, otherwise TKIP will be used as fallback.
  775. WIRELESS_CIPHER_PAIRWISE=''
  776.  
  777. ## Type:    string
  778. ## Default:    ''
  779. #
  780. # WPA modes support two different encryption systems, TKIP and
  781. # CCMP. This variable defines which to use for broad-/multicast
  782. # communication.  Default is to allow both. In case you want to
  783. # restrict it to one protocol, set this variable. When using
  784. # WIRELESS_AP_SCANMODE 2, this variable needs to be set, otherwise
  785. # TKIP will be used as fallback.
  786. WIRELESS_CIPHER_GROUP=''
  787.  
  788. ## Type:    string
  789. ## Default:    ''
  790. #
  791. # When using WPA-EAP with PEAP authentication, you can use
  792. # this variable to force which PEAP version (0 or 1) to be used.
  793. # Default is to allow both.
  794. WIRELESS_PEAP_VERSION=''
  795.