WICD-WIRELESS-SETTINGS.CONF(5)WICD-WIRELESS-SETTINGS.CONF(5)NAME
wicd-wired-settings.conf - controls Wicd's wireless network settings
DESCRIPTION
This file contains configuration information for wireless interfaces in
Wicd.
This file is located at /etc/wicd/wireless-settings.conf
SETTINGS
bssid = <BSSID_of_network>
This value can be found using iwconfig(8).
essid = <ESSID_of_network>
This value can be found using iwconfig(8).
hidden = <True|False>
This option notes whether the network's ESSID is broadcast or
not.
channel = <integer_value>
Valid channels are dependent upon country.
This value can be found using iwconfig(8).
mode = <Master|Ad-hoc>
This value can be found using iwconfig(8).
enctype = <encryption_template>
This can take the value of any encryption template shown in
/etc/wicd/encryption/templates/.
encryption_method = WEP|WPA|WPA2>
This value can be found using iwconfig(8).
key = <plain_text_key>
Be sure this file is readable only by root.
automatic = <True|False>
This option determines whether Wicd should automatically connect
to this network.
ip = <None|ip_address>
Use this option if you have a static ip address for your system.
netmask = <None|networkmask>
This setting is only appropriate if a static ip address is con‐
figured above.
broadcast = <None|broadcast_address>
This setting is only appropriate if a static ip address is con‐
figured above.
gateway = <None|gateway_address>
This setting is only appropriate if a static ip address is con‐
figured above.
use_static_dns = <True|False>
True = use static DNS servers instead of accepting what the dhcp
server supplies.
use_global_dns = <True|False>
True = use the global DNS servers provided in wicd-manager-set‐
tings.conf(5).
This option is only appropriate if "use_static_dns = True"
dns1 = <None|ip_address>
Static DNS address if "use_static_dns = True" and
"use_global_dns = False"
dns2 = <None|ip_address>
Static DNS address if "use_static_dns = True" and
"use_global_dns = False"
dns3 = <None|ip_address>
Static DNS address if "use_static_dns = True" and
"use_global_dns = False"
use_settings_globally = <0|1>
Wicd keeps track of whether to autoconnect to networks based on
bssid. This ensures that you don't accidentally connect to
another network that is not yours but happens to have the same
essid - for example, there are a lot of commercial routers in
use with "linksys" as the essid.
0 = Do not use settings globally
1 = Use settings globally
beforescript = <None|arbitrary_script>
This defines a script to run before Wicd brings up the connec‐
tion.
IMPORTANT - scripts should ONLY be writable by root and should
be located in a directory that is writable by only root.
afterscript = <None|arbitrary_script>
This defines a script to run after Wicd brings up the connec‐
tion.
IMPORTANT - scripts should ONLY be writable by root and located
in a directory that is writable by only root.
predisconnectscript = <None|arbitrary_script>
This defines a script to run before Wicd disconnects the inter‐
face.
postdisconnectscript = <None|arbitrary_script>
This defines a script to run after Wicd disconnects the inter‐
face.
IMPORTANT - scripts should ONLY be writable by root and located
in a directory that is writable by only root.
OTHER
The "use_settings_globally" option determines how an individual net‐
work's configuration stanza starts. If the option is "0" (do not use
settings globally), then the stanza's top line will be the bssid of the
access point (in this format):
[00:15:3E:87:D3:68]
If the "option is set to "1" (use settings globally), then the first
line of the stanza will be in this format:
[essid:UA Public Wireless Network]
SEE ALSOwicd(8), wicd-curses(8), wicd-manager-settings.conf(5), wicd-wired-set‐
tings.conf(5).
wicd-1.7.2.4 WICD-WIRELESS-SETTINGS.CONF(5)
