xref: /freebsd/share/man/man4/wlan_tkip.4 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
1014be7fbSSam Leffler.\"
2014be7fbSSam Leffler.\" Copyright (c) 2004 Sam Leffler
3014be7fbSSam Leffler.\" All rights reserved.
4014be7fbSSam Leffler.\"
5014be7fbSSam Leffler.\" Redistribution and use in source and binary forms, with or without
6014be7fbSSam Leffler.\" modification, are permitted provided that the following conditions
7014be7fbSSam Leffler.\" are met:
8014be7fbSSam Leffler.\" 1. Redistributions of source code must retain the above copyright
9014be7fbSSam Leffler.\"    notice, this list of conditions and the following disclaimer.
10014be7fbSSam Leffler.\" 2. Redistributions in binary form must reproduce the above copyright
11014be7fbSSam Leffler.\"    notice, this list of conditions and the following disclaimer in the
12014be7fbSSam Leffler.\"    documentation and/or other materials provided with the distribution.
13014be7fbSSam Leffler.\"
14014be7fbSSam Leffler.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15014be7fbSSam Leffler.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16014be7fbSSam Leffler.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17014be7fbSSam Leffler.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18014be7fbSSam Leffler.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19014be7fbSSam Leffler.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20014be7fbSSam Leffler.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21014be7fbSSam Leffler.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22014be7fbSSam Leffler.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23014be7fbSSam Leffler.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24014be7fbSSam Leffler.\" SUCH DAMAGE.
25014be7fbSSam Leffler.\"
26014be7fbSSam Leffler.Dd December 7, 2004
27014be7fbSSam Leffler.Dt WLAN_TKIP 4
28014be7fbSSam Leffler.Os
29014be7fbSSam Leffler.Sh NAME
30014be7fbSSam Leffler.Nm wlan_tkip
31014be7fbSSam Leffler.Nd TKIP and Michael crypto support for 802.11 devices
32014be7fbSSam Leffler.Sh SYNOPSIS
33014be7fbSSam Leffler.Cd "device wlan_tkip"
34014be7fbSSam Leffler.Sh DESCRIPTION
35014be7fbSSam LefflerThe
36014be7fbSSam Leffler.Nm
37014be7fbSSam Lefflermodule handles the TKIP and Michael cryptographic requirements of the
38014be7fbSSam LefflerWPA and 802.11i protocols.
39b19e4a75SRuslan ErmilovIt does encapsulation and decapsulation of TKIP-encoded 802.11 frames
4091c284dbSWilko Bulteand optionally calculates the TKIP cipher and Michael MIC.
41b19e4a75SRuslan ErmilovThe
42014be7fbSSam Leffler.Nm
43b19e4a75SRuslan Ermilovmodule is an 802.11 cryptographic plugin module for use by the
44014be7fbSSam Leffler.Xr wlan 4
45014be7fbSSam Lefflermodule.
46014be7fbSSam LefflerThis module is automatically loaded if a TKIP key is configured;
477c8c014aSChristian Brueffertypically by a WPA supplicant program such as wpa_supplicant,
48b19e4a75SRuslan Ermilovor a WPA authenticator program such as
49b19e4a75SRuslan Ermilov.Nm hostapd .
50014be7fbSSam LefflerShould the underlying network device not be capable of doing the TKIP
51014be7fbSSam Lefflerand/or Michael calculations in hardware, the
52014be7fbSSam Leffler.Nm
53014be7fbSSam Lefflermodule will do the work.
54014be7fbSSam Leffler.Sh SEE ALSO
55014be7fbSSam Leffler.Xr wlan 4 ,
56b19e4a75SRuslan Ermilov.Xr wlan_ccmp 4 ,
57b19e4a75SRuslan Ermilov.Xr wlan_wep 4
58014be7fbSSam Leffler.Sh STANDARDS
59014be7fbSSam LefflerMore information can be found in the IEEE 802.11, WPA, and 802.11i Standards.
60014be7fbSSam Leffler.Sh HISTORY
61014be7fbSSam LefflerThe
62014be7fbSSam Leffler.Nm
63014be7fbSSam Lefflerdriver first appeared in
64014be7fbSSam Leffler.Fx 6.0 .
65