wicd-wireless-settings.conf (5)

Leading comments

Written by Robby Workman <rworkman@slackware.com>

(The comments found at the beginning of the groff file "man5/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 configured above.

broadcast = <None|broadcast_address>

This setting is only appropriate if a static ip address is configured above.

gateway = <None|gateway_address>

This setting is only appropriate if a static ip address is configured 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-settings.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 connection.
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 connection.
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 interface.

postdisconnectscript = <None|arbitrary_script>

This defines a script to run after Wicd disconnects the interface.
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 network'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 ALSO

wicd(8), wicd-curses(8), wicd-manager-settings.conf(5), wicd-wired-settings.conf(5).