shithub: riscv

ref: 63f9a4fda36f916e543c8f3ea117b31c194a4db7
dir: /sys/man/8/wpa/

View raw version
.TH WPA 8
.SH NAME
wpa \- Wi-Fi Protected Access setup
.SH SYNOPSIS
.B aux/wpa
[
.B -dp12
] [
.B -s
.I essid
]
.I dev
.SH DESCRIPTION
.I Wpa
handles the authentication and key exchange with WPA
protected wireless networks.
.PP
The
.I dev
parameter specifies the network interface that needs
to be setup with WPA.
The
.I essid
can be set with the
.I -s
option. Otherwise, the previously configured essid
on the interface will be used.
The
.B -p
option will prompt and install the preshared key or
pap/chap credentials into
.IR factotum (4),
otherwise the key has to be already present in
factotum or an interactive key prompter like
.IR fgui (4)
needs to provide it.
.PP
The authentication protocol is initiated by the
wireless access point so
.I wpa
will background itself after the keyprompt and establish
the encryption automatically as needed.
The optional
.B -1
or
.B -2
arguments can be used to select between WPA1/TKIP
(default) or WPA2/CCMP encryption with WPA PSK.
.PP
The
.B -d
option enables debugging and causes
.I wpa
to stay in foreground writing protocol messages to
standard error.
.SH EXAMPLES
Setup wireless encryption:
.EX
% bind -a '#l1' /net
% aux/wpa -s 9HAL -p /net/ether1
!Adding key: proto=wpapsk essid=9HAL
password: *****
!
% ip/ipconfig ether /net/ether1
.EE
.SH SOURCE
.B /sys/src/cmd/aux/wpa.c
.SH SEE ALSO
.IR factotum (4),
.IR ipconfig (8)
.SH HISTORY
.I Wpa
first appeared in 9front (March, 2013).