1WICD-WIRELESS-SETTINGS.CONF(5)File Formats ManualWICD-WIRELESS-SETTINGS.CONF(5)
2
6 wicd-wired-settings.conf - controls Wicd's wireless network settings
7
10 This file contains configuration information for wireless interfaces in
11 Wicd.
12 This file is located at /etc/dhcp/wireless-settings.conf
13
17 bssid = <BSSID_of_network>
18 This value can be found using iwconfig(8).
19 essid = <ESSID_of_network>
21 This value can be found using iwconfig(8).
22 hidden = <True|False>
24 This option notes whether the network's ESSID is broadcast or
25 not.
26 channel = <integer_value>
28 Valid channels are dependent upon country.
29 This value can be found using iwconfig(8).
30 mode = <Master|Ad-hoc>
32 This value can be found using iwconfig(8).
33 enctype = <encryption_template>
35 This can take the value of any encryption template shown in
36 /etc/wicd/encryption/templates/.
37 encryption_method = WEP|WPA|WPA2>
39 This value can be found using iwconfig(8).
40 key = <plain_text_key>
42 Be sure this file is readable only by root.
43 automatic = <True|False>
45 This option determines whether Wicd should automatically connect
46 to this network.
47 ip = <None|ip_address>
49 Use this option if you have a static ip address for your system.
50 netmask = <None|networkmask>
52 This setting is only appropriate if a static ip address is con‐
53 figured above.
54 broadcast = <None|broadcast_address>
56 This setting is only appropriate if a static ip address is con‐
57 figured above.
58 gateway = <None|gateway_address>
60 This setting is only appropriate if a static ip address is con‐
61 figured above.
62 use_static_dns = <True|False>
64 True = use static DNS servers instead of accepting what the dhcp
65 server supplies.
66 use_global_dns = <True|False>
68 True = use the global DNS servers provided in wicd-manager-set‐
69 tings.conf(5).
70 This option is only appropriate if "use_static_dns = True"
71 dns1 = <None|ip_address>
73 Static DNS address if "use_static_dns = True" and
74 "use_global_dns = False"
75 dns2 = <None|ip_address>
77 Static DNS address if "use_static_dns = True" and
78 "use_global_dns = False"
79 dns3 = <None|ip_address>
81 Static DNS address if "use_static_dns = True" and
82 "use_global_dns = False"
83 use_settings_globally = <0|1>
85 Wicd keeps track of whether to autoconnect to networks based on
86 bssid. This ensures that you don't accidentally connect to
87 another network that is not yours but happens to have the same
88 essid - for example, there are a lot of commercial routers in
89 use with "linksys" as the essid.
90 0 = Do not use settings globally
91 1 = Use settings globally
92 has_profile = <True|False>
94 This parameter is used internally by Wicd and has no effect as
95 far as the user is concerned.
96 beforescript = <None|arbitrary_script>
98 This defines a script to run before Wicd brings up the connec‐
99 tion.
100 IMPORTANT - scripts should ONLY be writable by root and should
101 be located in a directory that is writable by only root.
102 afterscript = <None|arbitrary_script>
104 This defines a script to run after Wicd brings up the connec‐
105 tion.
106 IMPORTANT - scripts should ONLY be writable by root and located
107 in a directory that is writable by only root.
108 predisconnectscript = <None|arbitrary_script>
110 This defines a script to run before Wicd disconnects the inter‐
111 face.
112 postdisconnectscript = <None|arbitrary_script>
114 This defines a script to run after Wicd disconnects the inter‐
115 face.
116 IMPORTANT - scripts should ONLY be writable by root and located
117 in a directory that is writable by only root.
118
123 The "use_settings_globally" option determines how an individual net‐
124 work's configuration stanza starts. If the option is "0" (do not use
125 settings globally), then the stanza's top line will be the bssid of the
126 access point (in this format):
127 [00:15:3E:87:D3:68]
128 If the "option is set to "1" (use settings globally), then the first
129 line of the stanza will be in this format:
130 [essid:UA Public Wireless Network]
131
134 wicd(8), wicd-curses(8), wicd-manager-settings.conf(5), wicd-wired-set‐
135 tings.conf(5).
136 wicd-1.7.0 WICD-WIRELESS-SETTINGS.CONF(5)