xref: /netbsd-src/share/man/man9/ieee80211_input.9 (revision 6cb10275d08f045e872662c371fe2f2724f2f6e6)
1.\" $NetBSD: ieee80211_input.9,v 1.5 2014/03/18 18:20:40 riastradh Exp $
2.\"
3.\" Copyright (c) 2004 Bruce M. Simpson <bms@spc.org>
4.\" Copyright (c) 2004 Darron Broad <darron@kewl.org>
5.\" All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
28.\" $FreeBSD: src/share/man/man9/ieee80211_input.9,v 1.2 2004/07/07 12:59:39 ru Exp $
29.\"
30.Dd September 12, 2006
31.Dt IEEE80211_INPUT 9
32.Os
33.Sh NAME
34.Nm ieee80211_input , ieee80211_decap , ieee80211_recv_mgmt
35.Nd software 802.11 stack input functions
36.Sh SYNOPSIS
37.In net80211/ieee80211_var.h
38.In net80211/ieee80211_proto.h
39.Ft void
40.Fo ieee80211_input
41.Fa "struct ieee80211com *ic" "struct mbuf *m" "struct ieee80211_node *ni"
42.Fa "int rssi" "u_int32_t rstamp"
43.Fc
44.Ft struct mbuf *
45.Fn ieee80211_decap "struct ieee80211com *ic" "struct mbuf *m"
46.Ft void
47.Fo ieee80211_recv_mgmt
48.Fa "struct ieee80211com *ic" "struct mbuf *m0" "struct ieee80211_node *ni"
49.Fa "int subtype" "int rssi" "u_int32_t rstamp"
50.Fc
51.Sh DESCRIPTION
52These
53functions process received 802.11 frames.
54.Pp
55.\"
56The
57.Fn ieee80211_input
58function takes an mbuf chain
59.Fa m
60containing a complete 802.11 frame from the driver
61.Fa ic
62and passes it to the software 802.11 stack for input processing.
63The
64.Fa ni
65argument specifies an instance of
66.Vt struct ieee80211_node
67(which may be driver-specific) representing the node from which the
68frame was received.
69The arguments
70.Fa rssi
71and
72.Fa stamp
73are typically derived from on-card data structures; they are used for
74recording the signal strength and time received of the frame respectively.
75.Pp
76.\"
77The
78.Fn ieee80211_decap
79function performs decapsulation of the 802.11 frame in the mbuf chain
80.Fa m
81received by the device
82.Fa ic ,
83taking the form of the 802.11 address fields into account;
84the structure of 802.11 addresses vary according to the intended
85source and destination of the frame.
86It is typically called from within
87.Fn ieee80211_input .
88.Pp
89.\"
90The
91.Fn ieee80211_recv_mgmt
92performs input processing for 802.11 management frames.
93It is typically called from within
94.Fn ieee80211_input .
95.\"
96.Sh SEE ALSO
97.Xr ieee80211 9
98.Sh HISTORY
99The
100.Nm ieee80211
101series of functions first appeared in
102.Nx 1.5 ,
103and were later ported to
104.Fx 4.6 .
105.Sh AUTHORS
106.An -nosplit
107This man page was written by
108.An Bruce M. Simpson Aq Mt bms@FreeBSD.org
109and
110.An Darron Broad Aq Mt darron@kewl.org .
111.Sh BUGS
112There is no netisr queue specifically for the software 802.11 stack yet.
113