Provided by: wifi-radar_2.0.s08+dfsg-1.1ubuntu1_all bug

NAME

       wifi-radar.conf - configuration file for WiFi Radar

SYNOPSIS

       wifi-radar.conf

DESCRIPTION

       wifi-radar.conf  is the configuration file for WiFi Radar (wifi-radar(1)) a PyGTK2 utility
       for managing WiFi profiles in GNU/Linux.

       The file is an ini-type format with three global sections: [DEFAULT], [DHCP],  and  [WPA].
       These are followed by zero or more profile sections.

       The settings contained in the configuration file can all be edited from within WiFi Radar,
       either through the Preferences button or the Edit button.  But you are free  to  edit  the
       configuration file manually if you like.

Interpolated Strings

       It  is  possible  to  use  configuration  options  in  the  value of other options. To use
       interpolated strings, surround any option from the configuration file with %( and )s.  So,
       to  use  the interface option from the [DEFAULT] section in the value of any other option,
       use %(interface)s in the option's value.

Global Settings

   [DEFAULT]
       General options.

       auto_profile_order
           Comma-separated list of profiles, surrounded by square brackets, specifying the  order
           of  profiles  in  the  main  window.   An  example  value:  ['test:00:00:00:00:00:00',
           'WinterPalace:']

           (default: [])

       commit_required
           Set to True if iwconfig(8) commit should be used after each iwconfig command.

           (default: False)

       ifconfig_command
           Specify the path to ifconfig(8), the command to use when manipulating the IP  settings
           of the NIC.

           (default: /sbin/ifconfig)

       ifup_required
           Set to True if the NIC must be activated (i.e. ifconfig wlan0 up) before scanning will
           work.

           (default: False)

       interface
           Specifies the interface to scan. Set to the name of your NIC (e.g.   eth1  or  wlan0).
           The special value 'auto_detect' will use the first-found WiFi interface.

           (default: auto_detect)

       iwconfig_command
           Specify  the  path  to iwconfig(8), the command to use when trying to associate with a
           network.

           (default: /sbin/iwconfig)

       iwlist_command
           Specify the path to iwlist(8), the command to use for scanning for access points.

           (default: /sbin/iwlist)

       logfile
           Sets the location of the log file.

           (default: /var/log/wifi-radar.log)

       loglevel
           This sets the verbosity of messages sent to the logfile.  The number given here  is  a
           threshold  value, only those messages emitted by WiFi Radar which exceed loglevel will
           be written to the logfile.  The maximum (and default) value of 50 means to  only  save
           the  most  critical  messages  and  a  loglevel of 0 means to save all messages to the
           logfile.

           (default: 50)

       route_command
           Specify the path to route(8), the command to use to set up network routing if DHCP  is
           not used.

           (default: /sbin/route)

       speak_command
           Specify  the  path  to  the  command to use to speak status messages.  This can be any
           program which takes a string on the command line.

           (default: /usr/bin/say)

       speak_up
           Set to True to use the speak command.

           (default: False)

       version
           The version of WiFi Radar  which  created  this  configuration  file.  This  value  is
           overwritten by WiFi Radar each time the configuration file is saved.

   [DHCP]
       Options for the DHCP client used by WiFi Radar.

       args
           The  parameters  to  pass to the DHCP client when acquiring a lease (i.e. setting up a
           connection).

           (default: -D -o -i dhcp_client -t %(timeout)s)

       command
           The command to use to automatically set up the IP networking.  This can  be  any  DHCP
           client,  like  dhcpcd(8) or dhclient(8), which forks into the background or exits when
           it acquires an IP address or fails.

           (default: /sbin/dhcpcd)

       kill_args
           The parameters to pass to the DHCP client when disconnecting from a network.

           (default: -k)

       pidfile
           Specify where the DHCP client saves its state info.  This file is used if the standard
           DHCP disconnect does not work and WiFi Radar must kill the client on its own.

           (default: /etc/dhcpc/dhcpcd-%(interface)s.pid)

       timeout
           The time (in seconds) to allow the DHCP client to try to acquire a lease.  If the DHCP
           client does not stop itself after this length of time plus five  seconds,  WiFi  Radar
           will force the client to end.

           (default: 30)

   [WPA]
       Options for the WPA supplicant used by WiFi Radar.

       args
           The parameters to pass to the WPA supplicant when associating with the network.

           (default: -B -i %(interface)s -c %(configuration)s -D %(driver)s -P %(pidfile)s)

       command
           Specify the command to use as the WPA supplicant.

           (default: /usr/sbin/wpa_supplicant)

       configuration
           The WPA supplicant's configuration file.

           (default: /etc/wpa_supplicant.conf)

       driver
           The WPA supplicant driver to use.

           (default: wext)

       kill_command
           The command to use to end the WPA supplicant.

           The default is an empty value.

       pidfile
           Specify where the WPA supplicant saves its state info.

           (default: /var/run/wpa_supplicant.pid)

Per-profile Settings

       Each  profile header consists of the network name (a.k.a. ESSID), followed by a colon, and
       optionally followed by the network address (a.k.a. BSSID).  The BSSID may be blank if  the
       profile  is  a  roaming profile.  So a sample roaming profile section name could look like
       [WinterPalace:].

       available
           Used internally by WiFi Radar  to  indicate  whether  an  access  point  is  currently
           detected, it should always be False in the configuration file.

           (default: False)

       bssid
           A  copy  of  the  BSSID in the section name, it is used to calculate the section name.
           The BSSID is the network address, it usually matches the AP address.  It may be  blank
           in a roaming profile.

           (default: 00:00:00:00:00:00)

       channel
           The channel to use to connect with the network.

           (default: auto)

       con_postscript
           The command to run after connecting to the network.

           The default is an empty value.

       con_prescript
           The command to run before connecting to the network.

           The default is an empty value.

       dis_postscript
           The command to run after disconnecting from the network.

           The default is an empty value.

       dis_prescript
           The command to run before disconnecting from the network.

           The default is an empty value.

       dns1
           The primary DNS server.  Part of the static configuration to use when not using DHCP.

           The default is an empty value.

       dns2
           The  secondary  DNS  server.   Part  of the static configuration to use when not using
           DHCP.

           The default is an empty value.

       domain
           The domain (e.g. winterpalace.org) of the network.  Part of the  static  configuration
           to use when not using DHCP.

           The default is an empty value.

       encrypted
           Whether the network is encrypted.  The value for this option is determined by scanning
           and will be overwritten if changed manually in the configuration file.

           (default: False)

       essid
           The network name.  This is a copy of the ESSID in the section  name  and  is  used  to
           calculate the section name.

           The default is an empty value.

       gateway
           The  IP address of the gateway to other networks.  Part of the static configuration to
           use when not using DHCP.

           The default is an empty value.

       ip  The fixed IP address to use on this network.  Part of the static configuration to  use
           when not using DHCP.

           The default is an empty value.

       key The WEP encryption key.  This is not used with WPA.

           The default is an empty value.

       known
           This  is  used  internally  by  WiFi  Radar  to indicate whether an access point has a
           configured profile, it should always be True in the configuration file.

           (default: True)

       mode
           This is the association mode to use.  This is not the same as the mode reported by the
           AP.   In  fact, this should be a reflection of the AP mode (i.e. Master mode AP should
           be Managed mode here).

           (default: auto)

       netmask
           The netmask (e.g. 192.168.1.0/255) to use.  Part of the static  configuration  to  use
           when not using DHCP.

           The default is an empty value.

       protocol
           The  WiFi  protocol  used  by  the access point (AP).  This is only used as a place to
           store the protocol read from the AP.  This will be overwritten the next time the AP is
           scanned.

           (default: g)

       roaming
           Set to True if this is a roaming profile.

           (default: False)

       security
           This  should/will  be the security mode (i.e. open or restricted), but as it currently
           causes crashes, it is not used.

           The default is an empty value.

       signal
           The signal level read from the access point (AP).  This is  used  internally  by  WiFi
           Radar, the value will be overwritten each time the configuration file is saved.

           (default: 0)

       use_dhcp
           When set to True, WiFi Radar will ask the DHCP client to configure the IP settings.

           (default: True)

       use_wpa
           When  set  to  True, WiFi Radar will ask the WPA supplicant to handle associating with
           the access point.

           (default: False)

       wpa_driver
           The card driver the WPA supplicant should use.

           The default is an empty value.

EXAMPLE

       [DEFAULT]
       auto_profile_order = ['test:00:00:00:00:00:00', 'WinterPalace:']
       commit_required = False
       ifconfig_command = /sbin/ifconfig
       ifup_required = True
       interface = auto_detect
       iwconfig_command = /sbin/iwconfig
       iwlist_command = /sbin/iwlist
       logfile = /var/log/wifi-radar.log
       loglevel = 50
       route_command = /sbin/route
       speak_command = /usr/bin/say
       speak_up = False
       version = 2.0.s02

       [DHCP]
       args = -D -o -i dhcp_client -t %(timeout)s
       command = /sbin/dhcpcd
       kill_args = -k
       pidfile = /etc/dhcpc/dhcpcd-%(interface)s.pid
       timeout = 30

       [WPA]
       args = -B -i %(interface)s -c %(configuration)s -D %(driver)s -P %(pidfile)s
       command = /usr/sbin/wpa_supplicant
       configuration = /etc/wpa_supplicant.conf
       driver = wext
       kill_command =
       pidfile = /var/run/wpa_supplicant.pid

       [test:00:00:00:00:00:00]
       available = False
       bssid = 00:00:00:00:00:00
       channel = auto
       con_postscript =
       con_prescript =
       dis_postscript =
       dis_prescript =
       dns1 =
       dns2 =
       domain =
       encrypted = False
       essid = test
       gateway =
       ip =
       key =
       known = True
       mode = auto
       netmask =
       protocol = g
       roaming = False
       security =
       signal = 0
       use_dhcp = True
       use_wpa = False
       wpa_driver =

       [WinterPalace:]
       available = False
       bssid =
       channel = auto
       con_postscript =
       con_prescript =
       dis_postscript =
       dis_prescript =
       dns1 =
       dns2 =
       domain =
       encrypted = True
       essid = WinterPalace
       gateway =
       ip =
       key = 123456789ABCDEF
       known = True
       mode = auto
       netmask =
       protocol = g
       roaming = True
       security =
       signal = 0
       use_dhcp = True
       use_wpa = False
       wpa_driver =

FILES

       /etc/wifi-radar/wifi-radar.conf

BUGS

       Probably lots!

SEE ALSO

       wifi-radar(1) wpa_supplicant.conf(5)