ieee80211_node.h revision 1.7 1 /* $NetBSD: ieee80211_node.h,v 1.7 2003/10/29 21:50:57 dyoung Exp $ */
2 /*-
3 * Copyright (c) 2001 Atsushi Onoe
4 * Copyright (c) 2002, 2003 Sam Leffler, Errno Consulting
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 * 3. The name of the author may not be used to endorse or promote products
16 * derived from this software without specific prior written permission.
17 *
18 * Alternatively, this software may be distributed under the terms of the
19 * GNU General Public License ("GPL") version 2 as published by the Free
20 * Software Foundation.
21 *
22 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
23 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
24 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
25 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
26 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
27 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
31 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32 *
33 * $FreeBSD: src/sys/net80211/ieee80211_node.h,v 1.5 2003/08/19 22:17:03 sam Exp $
34 */
35 #ifndef _NET80211_IEEE80211_NODE_H_
36 #define _NET80211_IEEE80211_NODE_H_
37
38 #define IEEE80211_PSCAN_WAIT 5 /* passive scan wait */
39 #define IEEE80211_TRANS_WAIT 5 /* transition wait */
40 #define IEEE80211_INACT_WAIT 5 /* inactivity timer interval */
41 #define IEEE80211_INACT_MAX (300/IEEE80211_INACT_WAIT)
42
43 #define IEEE80211_NODE_HASHSIZE 32
44 /* simple hash is enough for variation of macaddr */
45 #define IEEE80211_NODE_HASH(addr) \
46 (((u_int8_t *)(addr))[IEEE80211_ADDR_LEN - 1] % IEEE80211_NODE_HASHSIZE)
47
48 #define IEEE80211_RATE_SIZE 8 /* 802.11 standard */
49 #define IEEE80211_RATE_MAXSIZE 15 /* max rates we'll handle */
50
51 struct ieee80211_rateset {
52 u_int8_t rs_nrates;
53 u_int8_t rs_rates[IEEE80211_RATE_MAXSIZE];
54 };
55
56 /*
57 * Node specific information. Note that drivers are expected
58 * to derive from this structure to add device-specific per-node
59 * state. This is done by overriding the ic_node_* methods in
60 * the ieee80211com structure.
61 */
62 struct ieee80211_node {
63 TAILQ_ENTRY(ieee80211_node) ni_list;
64 LIST_ENTRY(ieee80211_node) ni_hash;
65 u_int ni_refcnt;
66
67 /* hardware */
68 u_int32_t ni_rstamp; /* recv timestamp */
69 u_int8_t ni_rssi; /* recv ssi */
70
71 /* header */
72 u_int8_t ni_macaddr[IEEE80211_ADDR_LEN];
73 u_int8_t ni_bssid[IEEE80211_ADDR_LEN];
74
75 /* beacon, probe response */
76 u_int8_t ni_tstamp[8]; /* from last rcv'd beacon */
77 u_int16_t ni_intval; /* beacon interval */
78 u_int16_t ni_capinfo; /* capabilities */
79 u_int8_t ni_esslen;
80 u_int8_t ni_essid[IEEE80211_NWID_LEN];
81 struct ieee80211_rateset ni_rates; /* negotiated rate set */
82 u_int8_t *ni_country; /* country information XXX */
83 struct ieee80211_channel *ni_chan;
84 u_int16_t ni_fhdwell; /* FH only */
85 u_int8_t ni_fhindex; /* FH only */
86 u_int8_t ni_erp; /* 11g only */
87
88 #ifdef notyet
89 /* DTIM and contention free period (CFP) */
90 u_int8_t ni_dtimperiod;
91 u_int8_t ni_cfpperiod; /* # of DTIMs between CFPs */
92 u_int16_t ni_cfpduremain; /* remaining cfp duration */
93 u_int16_t ni_cfpmaxduration;/* max CFP duration in TU */
94 u_int16_t ni_nextdtim; /* time to next DTIM */
95 u_int16_t ni_timoffset;
96 #endif
97
98 /* power saving mode */
99
100 u_int8_t ni_pwrsave;
101 struct ifqueue ni_savedq; /* packets queued for pspoll */
102
103 /* others */
104 u_int16_t ni_associd; /* assoc response */
105 u_int16_t ni_txseq; /* seq to be transmitted */
106 u_int16_t ni_rxseq; /* seq previous received */
107 int ni_fails; /* failure count to associate */
108 int ni_inact; /* inactivity mark count */
109 int ni_txrate; /* index to ni_rates[] */
110 u_int32_t *ni_challenge; /* shared-key challenge */
111 };
112
113 #ifdef __NetBSD__
114 #define ieee80211_node_incref(ni) \
115 do { \
116 int _s = splnet(); \
117 (ni)->ni_refcnt++; \
118 splx(_s); \
119 } while (0)
120
121 static __inline int
122 ieee80211_node_decref(struct ieee80211_node *ni)
123 {
124 int refcnt, s;
125 s = splnet();
126 refcnt = --ni->ni_refcnt;
127 splx(s);
128 return refcnt;
129 }
130
131 #else
132 #define ieee80211_node_incref(ni) atomic_add_int(&(ni)->ni_refcnt, 1)
133 static __inline int
134 ieee80211_node_decref(struct ieee80211_node *ni)
135 {
136 int orefcnt;
137 do {
138 orefcnt = ni->ni_refcnt;
139 } while (atomic_cmpset_int(&ni->ni_refcnt, orefcnt, orefcnt - 1) == 0);
140 return orefcnt - 1;
141 }
142 #endif
143
144 static __inline struct ieee80211_node *
145 ieee80211_ref_node(struct ieee80211_node *ni)
146 {
147 ieee80211_node_incref(ni);
148 return ni;
149 }
150
151 static __inline void
152 ieee80211_unref_node(struct ieee80211_node **ni)
153 {
154 ieee80211_node_decref(*ni);
155 *ni = NULL; /* guard against use */
156 }
157
158 struct ieee80211com;
159
160 extern void ieee80211_node_attach(struct ifnet *);
161 extern void ieee80211_node_lateattach(struct ifnet *);
162 extern void ieee80211_node_detach(struct ifnet *);
163
164 extern void ieee80211_begin_scan(struct ifnet *);
165 extern void ieee80211_next_scan(struct ifnet *);
166 extern void ieee80211_end_scan(struct ifnet *);
167 extern struct ieee80211_node *ieee80211_alloc_node(struct ieee80211com *,
168 u_int8_t *);
169 extern struct ieee80211_node *ieee80211_dup_bss(struct ieee80211com *,
170 u_int8_t *);
171 extern struct ieee80211_node *ieee80211_find_node(struct ieee80211com *,
172 u_int8_t *);
173 extern struct ieee80211_node *ieee80211_find_rxnode(struct ieee80211com *,
174 struct ieee80211_frame *);
175 extern struct ieee80211_node *ieee80211_find_txnode(struct ieee80211com *,
176 u_int8_t *);
177 extern struct ieee80211_node * ieee80211_lookup_node(struct ieee80211com *,
178 u_int8_t *macaddr, struct ieee80211_channel *);
179 extern void ieee80211_free_node(struct ieee80211com *,
180 struct ieee80211_node *);
181 extern void ieee80211_free_allnodes(struct ieee80211com *);
182 typedef void ieee80211_iter_func(void *, struct ieee80211_node *);
183 extern void ieee80211_iterate_nodes(struct ieee80211com *ic,
184 ieee80211_iter_func *, void *);
185 extern void ieee80211_timeout_nodes(struct ieee80211com *);
186
187 extern int ieee80211_match_bss(struct ieee80211com *,
188 struct ieee80211_node *);
189 extern void ieee80211_create_ibss(struct ieee80211com* ,
190 struct ieee80211_channel *);
191 #endif /* _NET80211_IEEE80211_NODE_H_ */
192