share/man/man8/wpad.8

   1 '\" te
   2 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH WPAD 8 "Mar 11, 2008"
   7 .SH NAME
   8 wpad \- WPA and WPA2 protocol daemon
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/lib/inet/wpad\fR [\fB-i\fR \fIinterface\fR] [\fB-k\fR \fIpre_shared_key_name\fR]
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBwpad\fR daemon provides common client functionality for the WiFi
  19 Protected Access (WPA) versions 1 and 2, as defined by IEEE802.11i standard.
  20 WPA was created by the WiFi Alliance, an industry trade group. WPA implements
  21 the majority of the IEEE 802.11i standard, and was intended as an intermediate
  22 measure to take the place of Wired Equivalent Privacy (WEP) while 802.11i was
  23 prepared. WPA2 implements the full standard.
  24 .sp
  25 .LP
  26 \fBwpad\fR provides the following WPA/IEEE 802.11i features:
  27 .RS +4
  28 .TP
  29 .ie t \(bu
  30 .el o
  31 WPA-PSK ("WPA-Personal")
  32 .RE
  33 .RS +4
  34 .TP
  35 .ie t \(bu
  36 .el o
  37 Key management for CCMP, TKIP, WEP104, WEP40
  38 .RE
  39 .sp
  40 .LP
  41 Stop and start the \fBwpad\fR daemon using \fBdladm\fR(8). Use:
  42 .sp
  43 .in +2
  44 .nf
  45 # \fBdladm connect-wifi\fR
  46 .fi
  47 .in -2
  48 .sp
  49
  50 .sp
  51 .LP
  52 \&...to start the \fBwpad\fR daemon. Use:
  53 .sp
  54 .in +2
  55 .nf
  56 # \fBdladm disconnect-wifi\fR
  57 .fi
  58 .in -2
  59 .sp
  60
  61 .sp
  62 .LP
  63 \&...to stop the daemon.
  64 .SH OPTIONS
  65 .sp
  66 .LP
  67 The following options are supported:
  68 .sp
  69 .ne 2
  70 .na
  71 \fB\fB-i\fR \fIinterface\fR\fR
  72 .ad
  73 .sp .6
  74 .RS 4n
  75 Specify a WiFi Link interface to start the \fBwpad\fR daemon.
  76 .RE
  77
  78 .sp
  79 .ne 2
  80 .na
  81 \fB\fB-k\fR \fIpre_shared_key_name\fR\fR
  82 .ad
  83 .sp .6
  84 .RS 4n
  85 Specify the pre-shared key used for the WiFi Link.
  86 .RE
  87
  88 .SH EXAMPLES
  89 .LP
  90 \fBExample 1 \fRStarting the \fBwpad\fR Daemon on Specific WiFi Link
  91 .sp
  92 .LP
  93 To create the WPA key \fBpsk\fR, enter the  following command:
  94
  95 .sp
  96 .in +2
  97 .nf
  98 # \fBdladm create-secobj -c wpa psk\fR
  99 .fi
 100 .in -2
 101 .sp
 102
 103 .sp
 104 .LP
 105 To use key \fBpsk\fR to connect to ESSID \fBwlan\fR on link \fBath0\fR, enter
 106 the following command:
 107
 108 .sp
 109 .in +2
 110 .nf
 111 # \fBdladm connect-wifi -k psk -e wlan ath0\fR
 112 .fi
 113 .in -2
 114 .sp
 115
 116 .LP
 117 \fBExample 2 \fRStopping the \fBwpad\fR Daemon on Specific WiFi Link
 118 .sp
 119 .LP
 120 To stop the daemon on the link \fBath0\fR, enter:
 121
 122 .sp
 123 .in +2
 124 .nf
 125 # \fBdladm disconnect-wifi ath0\fR
 126 .fi
 127 .in -2
 128 .sp
 129
 130 .SH ATTRIBUTES
 131 .sp
 132 .LP
 133 See \fBattributes\fR(5) for descriptions of the following attributes:
 134 .sp
 135
 136 .sp
 137 .TS
 138 box;
 139 c | c
 140 l | l .
 141 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 142 _
 143 Interface Stability     Uncommitted
 144 .TE
 145
 146 .SH SEE ALSO
 147 .sp
 148 .LP
 149 \fBsvcs\fR(1), \fBdladm\fR(8), \fBsvcadm\fR(8), \fBattributes\fR(5),
 150 \fBsmf\fR(5)
 151 .SH NOTES
 152 .sp
 153 .LP
 154 The \fBwpad\fR service is managed by the service management facility,
 155 \fBsmf\fR(5), under the service identifier:
 156 .sp
 157 .in +2
 158 .nf
 159 svc:/network/wpa:\fI<link>\fR
 160 .fi
 161 .in -2
 162 .sp
 163
 164 .sp
 165 .LP
 166 Administrative actions on this service, such as enabling, disabling, or
 167 requesting restart, can be performed using \fBsvcadm\fR(8). The service's
 168 status can be queried using the \fBsvcs\fR(1) command.