1.\" Copyright (c) 2005 Sam Leffler <sam@errno.com>
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.Dd July 28, 2018
26.Dt WPA_SUPPLICANT 8
27.Os
28.Sh NAME
29.Nm wpa_supplicant
30.Nd "WPA/802.11i Supplicant for wireless network devices"
31.Sh SYNOPSIS
32.Nm
33.Op Fl BdhKLqstuvW
34.Op Fl b Ar br_ifname
35.Fl c Ar config-file
36.Op Fl C Ar ctrl
37.Op Fl D Ar driver
38.Op Fl f Ar debug file
39.Op Fl g Ar global ctrl
40.Fl i Ar ifname
41.Op Fl o Ar override driver
42.Op Fl O Ar override ctrl
43.Op Fl P Ar pid file
44.Oo Fl N
45.Fl i Ar ifname
46.Fl c Ar config-file
47.Op Fl C Ar ctrl
48.Op Fl D driver
49.Op Fl p Ar driver_param
50.Op Fl b Ar br_ifname
51.No ...
52.Oc
53.Sh DESCRIPTION
54The
55.Nm
56utility
57is an implementation of the WPA Supplicant component,
58i.e., the part that runs in the client stations.
59It implements WPA key negotiation with a WPA Authenticator
60and EAP authentication with an Authentication Server.
61In addition,
62.Nm
63controls the roaming and IEEE 802.11
64authentication/association support of the
65.Xr wlan 4
66module and can be used to configure static WEP keys
67based on identified networks.
68.Pp
69The
70.Nm
71utility
72is designed to be a
73.Dq daemon
74program that runs in the
75background and acts as the backend component controlling
76the wireless connection.
77It supports separate frontend programs such as the
78text-based
79.Xr wpa_cli 8
80program.
81.Pp
82The following arguments must be specified on the command line:
83.Bl -tag -width indent
84.It Fl i Ar ifname
85Use the specified wireless interface.
86.It Fl c Ar config-file
87Use the settings in the specified configuration file when managing
88the wireless interface.
89See
90.Xr wpa_supplicant.conf 5
91for a description of the configuration file syntax and contents.
92.Pp
93Changes to the configuration file can be reloaded by sending a
94.Dv SIGHUP
95to the
96.Nm
97process or with the
98.Xr wpa_cli 8
99utility, using
100.Dq Li "wpa_cli reconfigure" .
101.El
102.Sh OPTIONS
103The following options are available:
104.Bl -tag -width indent
105.It Fl b
106Optional bridge interface name.
107.It Fl B
108Detach from the controlling terminal and run as a daemon process
109in the background.
110.It Fl d
111Enable debugging messages.
112If this option is supplied twice, more verbose messages are displayed.
113.It Fl D
114Driver name (can be multiple drivers: nl80211,wext).
115.It Fl f
116Log output to debug file instead of stdout.
117.It Fl g
118Global ctrl_interface.
119.It Fl h
120Show help text.
121.It Fl K
122Include key information in debugging output.
123.It Fl L
124Display the license for this program on the terminal and exit.
125.It Fl N
126Start describing a new interface.
127.It Fl o
128Overrides driver parameter for new interfaces.
129.It Fl O
130Override ctrl_interface parameter for new interfaces.
131.It Fl p
132Specify driver parameters.
133.It Fl P
134File in which to save the process PID.
135.It Fl q
136Decrease debugging verbosity (i.e., counteract the use of the
137.Fl d
138flag).
139.It Fl s
140Send log messages through
141.Xr syslog 3
142instead of to the terminal.
143.It Fl t
144Include timestamp in debug messages.
145.It Fl v
146Display version information on the terminal and exit.
147.It Fl W
148Wait for a control interface monitor before starting.
149.El
150.Sh SEE ALSO
151.Xr ath 4 ,
152.Xr ipw 4 ,
153.Xr iwi 4 ,
154.Xr ral 4 ,
155.Xr rum 4 ,
156.Xr ural 4 ,
157.Xr wlan 4 ,
158.Xr wpi 4 ,
159.Xr zyd 4 ,
160.Xr wpa_supplicant.conf 5 ,
161.Xr devd 8 ,
162.Xr ifconfig 8 ,
163.Xr wpa_cli 8
164.Sh HISTORY
165The
166.Nm
167utility first appeared in
168.Fx 6.0 .
169.Sh AUTHORS
170The
171.Nm
172utility was written by
173.An Jouni Malinen Aq Mt j@w1.fi .
174This manual page is derived from the
175.Pa README
176file included in the
177.Nm
178distribution.
179