]> git.lizzy.rs Git - plan9front.git/blob - sys/man/8/wpa
provide wpa(8) manual page
[plan9front.git] / sys / man / 8 / wpa
1 .TH WPA 8
2 .SH NAME
3 wpa \- Wi-Fi Protected Access setup
4 .SH SYNOPSIS
5 .B aux/wpa
6 [
7 .B -dp
8 ] [
9 .B -s
10 .I essid
11 ]
12 .I dev
13 .SH DESCRIPTION
14 .I Wpa
15 handles the authentication and key exchnage with WPA
16 protected wireless networks.
17 .PP
18 The
19 .I dev
20 parameter specifies the network interface that needs
21 to be setup with WPA.
22 The
23 .I essid
24 can be set with the
25 .I -s
26 option. Otherwise, the previously configured essid
27 on the interface will be used.
28 The
29 .B -p
30 option will prompt and install the preshared key into
31 .IR factotum (4),
32 otherwise the key has to be already present in
33 factotum or an interacrive key prompter like
34 .IR fgui (4)
35 needs to provide it.
36 .PP
37 The authentification protocol is initiated by the
38 wireless access point so
39 .I wpa
40 will background itself after the keyprompt and establish
41 the encryption automatically as needed.
42 .PP
43 The
44 .B -d
45 option enableds debugging and causes
46 .I wpa
47 to say in foreground writing protocol messages to
48 standard error.
49 .SH EXAMPLES
50 Setup wireless encryption:
51 .EX
52 % bind -a '#l1' /net
53 % aux/wpa -s 9HAL -p /net/ether1
54 !Adding key: proto=wpapsk essid=9HAL
55 password: *****
56 !
57 % ip/ipconfig ether /net/ether1
58 .EE
59 .SH SOURCE
60 .B /sys/src/cmd/aux/wpa.c
61 .SH SEE ALSO
62 .IR factotum (4),
63 .IR ipconfig (8)