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 -dp12
   8 ] [
   9 .B -s
  10 .I essid
  11 ]
  12 .I dev
  13 .SH DESCRIPTION
  14 .I Wpa
  15 handles the authentication and key exchange 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 or
  31 pap/chap credentials into factotum, otherwise the key has to be
  32 already present in factotum or an interactive key prompter like
  33 auth/fgui (see
  34 .IR factotum (4))
  35 needs to provide it.
  36 .PP
  37 The authentication 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 The optional
  43 .B -1
  44 or
  45 .B -2
  46 arguments can be used to select between WPA1/TKIP
  47 (default) or WPA2/CCMP encryption with WPA PSK.
  48 .PP
  49 The
  50 .B -d
  51 option enables debugging and causes
  52 .I wpa
  53 to stay in foreground writing protocol messages to
  54 standard error.
  55 .SH EXAMPLES
  56 Setup wireless encryption:
  57 .EX
  58 % bind -a '#l1' /net
  59 % aux/wpa -s 9HAL -p /net/ether1
  60 !Adding key: proto=wpapsk essid=9HAL
  61 password: *****
  62 !
  63 % ip/ipconfig ether /net/ether1
  64 .EE
  65 .SH SOURCE
  66 .B /sys/src/cmd/aux/wpa.c
  67 .SH SEE ALSO
  68 .IR factotum (4),
  69 .IR ipconfig (8)
  70 .SH HISTORY
  71 .I Wpa
  72 first appeared in 9front (March, 2013).