Update man1 page
[wifi-radar.git] / man / man1 / wifi-radar.1
blobc94de19a283a83ce454c6387adf3ed29ebcb762f
1 .\" Author: Sean Robinson <seankrobinson@gmail.com>
2 .\" Copyright 2005 by Nicolas Brouard <nicolas.brouard@libertysurf.fr>
3 .\" Copyright 2009 by Sean Robinson
4 .\" -----------------------------------------------------------------
6 .TH wifi-radar 1 "July 2009" "WiFi Radar 2.0"
8 .SH NAME
10 WiFi Radar \- utility for managing WiFi profiles
12 .SH SYNOPSIS
14 .B wifi-radar
15 [\fIOPTION\fR]...
17 .SH DESCRIPTION
19 .B WiFi Radar
20 is a PyGTK2 utility for managing WiFi profiles.
21 .PP
22 It will look for the config file in
23 .B /etc/wifi-radar/wifi-radar.conf.
24 You can change that in wifi-radar.
25 .PP
26 If the configuration file does not exist, it will create it, so you
27 must always run it within a correctly permitted account (as root or use
28 sudo or pam).
29 .PP
30 Recent versions partially implement WPA-TKIP with wpa_supplicant. You
31 need a running wpa_supplicant installation with a
32 /etc/wpa_supplicant/wpa_supplicant.conf file.  Then by setting in your
33 /etc/wifi-radar/wifi-radar.conf file the "use_wpa = yes" option and
34 "wpa_driver = ipw" for example, wpa_supplicant will be launched when
35 you connect using this profile.
36 .PP
37 But currently you can't set your wpa_supplicant options like the psk,
38 proto, key_mgmt etc. using
39 .B wifi-radar.
40 Your wpa_supplicant
41 configuration file should be set and tested already. If you have
42 different networks set in wpa_supplicant.conf, then you can switch using
43 wifi-radar.
44 .PP
45 The
46 .B wifi-radar
47 script accepts the following command-line options:
49 .SH OPTIONS
51 .TP 8
52 \fB\-v\fR, \fB\-\-version\fR for printing the version.
54 .SH FILES
56 .TP 8
57 .B /etc/wifi-radar/wifi-radar.conf
58 See
59 .i wifi-radar.conf(5)
60 for more information.
62 .SH BUGS
64 Probably lots!
65 .PP
66 Because of repeated scanning, WiFi Radar is very power consuming.
67 .PP
68 Please report bugs to the mailing list
69 <https://lists.anl.gov/mailman/listinfo/wifi-radar>
71 .SH MORE INFORMATION
73 The GIT repository is available at
74 https://git.berlios.de/cgi-bin/gitweb.cgi?p=wifi-radar;a=summary
75 .PP
76 If you have questions, visit http://wifi-radar.berlios.de
78 .SH AUTHOR
80 This Python program was originally written by Ahmad Baitaimal
81 <ahmad@bitbuilder.com>.  It has been maintained at various times by
82 Brian Elliott Finley <brian@thefinleys.com> and Sean Robinson
83 <seankrobinson@gmail.com>.  Contributions have been provided by:
84 .IP \(bu 4
85 Douglas Breault <genkreton@comcast.net>
86 .IP \(bu 4
87 Nicolas Brouard <nicolas.brouard@libertysurf.fr>
88 .IP \(bu 4
89 Gary Case <gcase@redhat.com>
90 .IP \(bu 4
91 Jon Collette <jonc@etelos.com>
92 .IP \(bu 4
93 David Decotigny <com.d2@free.fr>
94 .IP \(bu 4
95 Simon Gerber <gesimu@gmail.com>
96 .IP \(bu 4
97 Joey Hurst <jhurst@lucubrate.org>
98 .IP \(bu 4
99 Ante Karamatic <ivoks@ubuntu.com>
100 .IP \(bu 4
101 Richard Monk <rmonk@redhat.com>
102 .IP \(bu 4
103 Kevin Otte <kotte@redhat.com>
104 .IP \(bu 4
105 Nathanael Rebsch <nathanael@dihedral.de>
106 .IP \(bu 4
107 Andrea Scarpino <andrea@archlinux.org>
108 .IP \(bu 4
109 Patrick Winnertz <winnie@debian.org>
111 .SH SEE ALSO
113 .I wifi-radar.conf(5)
114 .I wpa_supplicant(8)