NAME
xsupplicant − IEEE 802.1x/802.11i supplicant, (client).
SYNOPSIS
xsupplicant [-w] [-c config_file] [-i interface] [-d debug_level] [-f] [-D driver] [-z] [-t] [-q] [-a] [-s]
DESCRIPTION
xsupplicant is an 802.1x client, (supplicant), that supports a variety of authentication methods, including those commonly found in WPA and WPA2 networks. Additionally, it can manage associations from any number of configured profiles, including networks that are unprotected or use statically assigned WEP keys.
OPTIONS
|
−w |
Disable WPA/WPA2 support. |
−c configuration_file
The full path to the configuration file, (defaults to /etc/xsupplicant/xsupplicant.conf).
−i interface
Specify the network interface to authenticate for, (required).
−d debug_level
Set debug options, (defaults to none). Setting debug flags increases the verbosity of log messages and may be helpful in diagnosing problems.
|
0-7 |
Old style debug flags, (deprecated). |
|||
|
A |
Enable all debug flags. |
|||
|
c |
Enable CONFIG debug flag. |
|||
|
s |
Enable STATE debug flag. |
|||
|
a |
Enable AUTHTYPES debug flag. |
|||
|
i |
Enable INT debug flag. |
|||
|
n |
Enable SNMP debug flag. |
|||
|
e |
Enable EVERYTHING debug flag. |
|||
|
x |
Enable EXCESSIVE debug flag. |
Note: You cannot combine numeric and character flags.
|
−f |
Forces xsupplicant to run as a foreground process and log to standard out, (useful for debugging). |
−D driver
These days most drivers support the ioctls needed for WPA/WPA2 through the use of Wireless Extensions, for those that don’t, xsupplicant may be able to supply them. Running xsupplicant without any arguments will produce a list of supported cards. If you are unsure, leave this option unset.
|
-z |
Reset WEP key to all 0s when disassociating. | ||
|
-t |
Don’t use IW_ENCODE_TEMP in key setting requests. | ||
|
-q |
Terminate when defaulting to the authenticated state. | ||
|
-a |
Watch alternate interface index for wireless events. | ||
|
-s |
Remove an existing control socket if found, (useful in start up scripts). |
SEE ALSO
xsup_set_pwd(1), config-parser(1), xsup_monitor(1), xsup_ntpwdhash(1), xsup_get_state(1).
The Open1x User’s Guide in /usr/share/doc/xsupplicant.
AUTHOR
xsupplicant was written by Arunesh Mishra <arunesh [AT] cs.edu>, Nick L. Petroni Jr. <npetroni [AT] cs.edu>, Bryan D. Payne <bdpayne [AT] cs.edu>, Chris Hessing <Chris.Hessing [AT] utah.edu>, and Terry Simons <Terry.Simons [AT] m.edu>.
This manual page was written by Eric Evans <eevans [AT] sym-link.com> for the Debian system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2, or any later version published by the Free Software Foundation.
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.