---
name: "xsupplicant"
section: "8"
platform: "linux"
package: "xsupplicant"
version: "1.2.4.dfsg.1-3"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/xsupplicant"
---

# xsupplicant(8)

IEEE 802.1x/802.11i supplicant, (client).

## 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)](/xsup_set_pwd/1.md), [**config-parser**(1)](/config-parser/1.md), [**xsup\_monitor**(1)](/xsup_monitor/1.md),  [**xsup\_ntpwdhash**(1)](/xsup_ntpwdhash/1.md), [**xsup\_get\_state**(1)](/xsup_get_state/1.md).

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.Hessing@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). 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.