d/freebsd-nq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
7ac139a904
freebsd-nq/share/man/man9/ieee80211.9

261 lines
7.0 KiB
Groff
Raw Normal View History

Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
.\"
.\" Copyright (c) 2004 Bruce M. Simpson <bms@spc.org>
.\" Copyright (c) 2004 Darron Broad <darron@kewl.org>
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" $FreeBSD$
.\" $Id: ieee80211.9,v 1.5 2004/03/04 12:33:27 bruce Exp $
.\"
.Dd March 2, 2004
Fixed document title (should be in all uppercase). List all functions in the NAME section so they appear in whatis(1). Assorted fixes (mostly markup).
2004-07-07 12:59:39 +00:00
.Dt IEEE80211 9
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
.Os
.Sh NAME
Fixed document title (should be in all uppercase). List all functions in the NAME section so they appear in whatis(1). Assorted fixes (mostly markup).
2004-07-07 12:59:39 +00:00
.Nm ieee80211_ifattach , ieee80211_ifdetach ,
.Nm ieee80211_mhz2ieee , ieee80211_chan2ieee , ieee80211_ieee2mhz ,
.Nm ieee80211_media_init , ieee80211_media_change , ieee80211_media_status ,
.Nm ieee80211_watchdog ,
.Nm ieee80211_setmode , ieee80211_chan2mode ,
.Nm ieee80211_rate2media , ieee80211_media2rate
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
.Nd core 802.11 network stack functions
.Sh SYNOPSIS
.In net80211/ieee80211_var.h
.In net80211/ieee80211_proto.h
.Ft void
.Fn ieee80211_ifattach "struct ifnet *ifp"
.Ft void
.Fn ieee80211_ifdetach "struct ifnet *ifp"
.Ft u_int
.Fn ieee80211_mhz2ieee "u_int freq" "u_int flags"
.Ft u_int
.Fn ieee80211_chan2ieee "struct ieee80211com *ic" "struct ieee80211_channel *c"
.Ft u_int
.Fn ieee80211_ieee2mhz "u_int chan" "u_int flags"
Fixed document title (should be in all uppercase). List all functions in the NAME section so they appear in whatis(1). Assorted fixes (mostly markup).
2004-07-07 12:59:39 +00:00
.Ft void
.Fo ieee80211_media_init
.Fa "struct ifnet *ifp" "ifm_change_cb_t media_change"
.Fa "ifm_stat_cb_t media_stat"
.Fc
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
.Fa int
.Fn ieee80211_media_change "struct ifnet *ifp"
.Fa void
.Fn ieee80211_media_status "struct ifnet *ifp" "struct ifmediareq *imr"
.Ft void
.Fn ieee80211_watchdog "struct ifnet *ifp"
.Ft int
.Fn ieee80211_setmode "struct ieee80211com *ic" "enum ieee80211_phymode mode"
.Ft enum ieee80211_phymode
Fixed document title (should be in all uppercase). List all functions in the NAME section so they appear in whatis(1). Assorted fixes (mostly markup).
2004-07-07 12:59:39 +00:00
.Fo ieee80211_chan2mode
.Fa "struct ieee80211com *ic" "struct ieee80211_channel *chan"
.Fc
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
.Ft int
Fixed document title (should be in all uppercase). List all functions in the NAME section so they appear in whatis(1). Assorted fixes (mostly markup).
2004-07-07 12:59:39 +00:00
.Fo ieee80211_rate2media
.Fa "struct ieee80211com *ic" "int rate" "enum ieee80211_phymode mode"
.Fc
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
.Ft int
.Fn ieee80211_media2rate "int mword"
.Sh DESCRIPTION
The
Fixed document title (should be in all uppercase). List all functions in the NAME section so they appear in whatis(1). Assorted fixes (mostly markup).
2004-07-07 12:59:39 +00:00
.Nm ieee80211
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
collection of functions are used to manage wireless network interfaces in the
system which use the system's software 802.11 network stack.
Most of these functions require that attachment to the stack is performed
before calling.
Several utility functions are also provided; these are safe to call from
any driver without prior initialization.
.Pp
.\"
The
.Fn ieee80211_ifattach
function attaches the network interface
.Fa ifp
to the 802.11 network stack layer.
This function must be called before using any of the
Fixed document title (should be in all uppercase). List all functions in the NAME section so they appear in whatis(1). Assorted fixes (mostly markup).
2004-07-07 12:59:39 +00:00
.Nm ieee80211
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
functions which need to store driver state across invocations;
The
.Vt struct ifnet
instance pointed to by
.Fa ifp
MUST be an instance of
.Vt struct ieee80211com ,
with various fields initialized to tell
Fixed document title (should be in all uppercase). List all functions in the NAME section so they appear in whatis(1). Assorted fixes (mostly markup).
2004-07-07 12:59:39 +00:00
.Nm ieee80211
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
about its capabilities.
This function performs Ethernet and BPF attachment (by calling
.Fn ether_ifattach
and
.Fn bpfattach2 )
on behalf of the caller.
It also implements the
.Vt ifmedia
interface.
.Pp
.\"
The
.Fn ieee80211_ifdetach
function frees any
Fixed document title (should be in all uppercase). List all functions in the NAME section so they appear in whatis(1). Assorted fixes (mostly markup).
2004-07-07 12:59:39 +00:00
.Nm ieee80211
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
structures associated with the driver, and performs Ethernet and BPF
detachment on behalf of the caller.
.Pp
.\"
The
.Fn ieee80211_mhz2ieee
utility function converts the frequency
.Fa freq
(specified in MHz) to an IEEE 802.11 channel number.
The
.Fa flags
argument is a hint which specifies whether the frequency is in
Fixed document title (should be in all uppercase). List all functions in the NAME section so they appear in whatis(1). Assorted fixes (mostly markup).
2004-07-07 12:59:39 +00:00
the 2GHz ISM band
.Pq Vt IEEE80211_CHAN_2GHZ
or the 5GHz band
.Pq Vt IEEE80211_CHAN_5GHZ ;
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
appropriate clipping of the result is then performed.
.Pp
.\"
The
.Fn ieee80211_chan2ieee
function converts the channel specified in
.Fa *c
to an IEEE channel number for the driver
.Fa ic .
If the conversion would be invalid, an error message is printed to the
system console.
This function REQUIRES that the driver is hooked up to the
Fixed document title (should be in all uppercase). List all functions in the NAME section so they appear in whatis(1). Assorted fixes (mostly markup).
2004-07-07 12:59:39 +00:00
.Nm ieee80211
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
subsystem.
.Pp
.\"
The
.Fn ieee80211_ieee2mhz
utility function converts the IEEE channel number
.Ft chan
to a frequency (in MHz).
The
.Fa flags
argument is a hint which specifies whether the frequency is in
Fixed document title (should be in all uppercase). List all functions in the NAME section so they appear in whatis(1). Assorted fixes (mostly markup).
2004-07-07 12:59:39 +00:00
the 2GHz ISM band
.Pq Vt IEEE80211_CHAN_2GHZ
or the 5GHz band
.Pq Vt IEEE80211_CHAN_5GHZ ;
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
appropriate clipping of the result is then performed.
.Pp
.\"
The
.Fn ieee80211_media_init
function initializes media data structures used by the
.Vt ifmedia
interface, for the driver
.Fa ifp .
It must be called by the driver after calling
.Fn ieee80211_attach
and before calling most
Fixed document title (should be in all uppercase). List all functions in the NAME section so they appear in whatis(1). Assorted fixes (mostly markup).
2004-07-07 12:59:39 +00:00
.Nm ieee80211
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
functions.
The
.Fa media_change
and
.Fa media_stat
arguments specify helper functions which will be invoked by the
.Vt ifmedia
framework when the user changes or queries media options,
using a command such as
.Xr ifconfig 8 .
.Pp
.\"
The
.Fn ieee80211_media_status
and
.Fn ieee80211_media_change
functions are device-independent handlers for
.Vt ifmedia
commands and are not intended to be called directly.
.Pp
.\"
The
.Fn ieee80211_watchdog
function is intended to be called from a driver's
Fixed document title (should be in all uppercase). List all functions in the NAME section so they appear in whatis(1). Assorted fixes (mostly markup).
2004-07-07 12:59:39 +00:00
.Va if_watchdog
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
routine.
It is used to perform periodic cleanup of state within the software 802.11
stack, as well as timing out scans.
.Pp
.\"
The
.Fn ieee80211_setmode
function is called from within the 802.11 stack to change the mode
of the driver's PHY; it is not intended to be called directly.
.Pp
.\"
The
.Fn ieee80211_chan2mode
function returns the PHY mode required for use with the channel
.Fa chan
on the device
.Fa ic .
This is typically used when selecting a rate set, to be advertised in
beacons, for example.
.Pp
.\"
The
.Fn ieee80211_rate2media
function converts the bit rate
Fixed document title (should be in all uppercase). List all functions in the NAME section so they appear in whatis(1). Assorted fixes (mostly markup).
2004-07-07 12:59:39 +00:00
.Fa rate
(measured in units of 0.5Mbps) to an
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
.Vt ifmedia
sub-type, for the device
.Fa ic
running in PHY mode
.Fa mode .
The
.Fn ieee80211_media2rate
performs the reverse of this conversion, returning the bit rate (in 0.5Mbps
units) corresponding to an
.Vt ifmedia
sub-type.
.\"
.Sh SEE ALSO
.Xr ieee80211_crypto 9 ,
.Xr ieee80211_input 9 ,
.Xr ieee80211_ioctl 9 ,
.Xr ieee80211_node 9 ,
.Xr ieee80211_output 9 ,
.Xr ieee80211_proto 9 ,
Sort SEE ALSO references (in dictionary order, ignoring case).
2004-07-04 20:55:50 +00:00
.Xr ieee80211_radiotap 9 ,
.Xr ifnet 9
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
.Sh HISTORY
The
Fixed document title (should be in all uppercase). List all functions in the NAME section so they appear in whatis(1). Assorted fixes (mostly markup).
2004-07-07 12:59:39 +00:00
.Nm ieee80211
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
series of functions first appeared in
.Nx 1.5 ,
and were later ported to
.Fx 4.6 .
.Sh AUTHORS
Fixed document title (should be in all uppercase). List all functions in the NAME section so they appear in whatis(1). Assorted fixes (mostly markup).
2004-07-07 12:59:39 +00:00
.An -nosplit
Initial import of documentation for net80211 interface code. Of particular interest here is the ieee80211_radiotap(9) man page. TODO: Flesh out ieee80211_node.9, ieee80211_proto.9. Submitted by: bms (with help from Darron Broad)
2004-03-04 12:52:10 +00:00
This man page was written by
.An Bruce M. Simpson Aq bms@FreeBSD.org
and
.An Darron Broad Aq darron@kewl.org .
Reference in New Issue Copy Permalink