xsupplicant(8)

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 sup

ports a variety of authentication methods, including those com

monly 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 de

bug 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 support

ed 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@cs.umd.edu>, Nick L. Petroni Jr. <npetroni@cs.umd.edu>,

Bryan D. Payne <bdpayne@cs.umd.edu>, Chris Hessing <Chris.Hess

ing@utah.edu>, and Terry Simons <Terry.Simons@m.cc.utah.edu>.

This manual page was written by Eric Evans <eevans@sym

link.com> for the Debian system (but may be used by others). Per

mission is granted to copy, distribute and/or modify this docu

ment under the terms of the GNU General Public License, Version

2, or any later version published by the Free Software Founda

tion.

On Debian systems, the complete text of the GNU General

Public License can be found in /usr/share/common-licenses/GPL.

xsup

plicant(8)