The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/net80211/ieee80211_scan.h

Version: -  FREEBSD  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-2  -  FREEBSD-11-1  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-4  -  FREEBSD-10-3  -  FREEBSD-10-2  -  FREEBSD-10-1  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-3  -  FREEBSD-9-2  -  FREEBSD-9-1  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-4  -  FREEBSD-8-3  -  FREEBSD-8-2  -  FREEBSD-8-1  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-4  -  FREEBSD-7-3  -  FREEBSD-7-2  -  FREEBSD-7-1  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-4  -  FREEBSD-6-3  -  FREEBSD-6-2  -  FREEBSD-6-1  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-5  -  FREEBSD-5-4  -  FREEBSD-5-3  -  FREEBSD-5-2  -  FREEBSD-5-1  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  linux-2.6  -  linux-2.4.22  -  MK83  -  MK84  -  PLAN9  -  DFBSD  -  NETBSD  -  NETBSD5  -  NETBSD4  -  NETBSD3  -  NETBSD20  -  OPENBSD  -  xnu-517  -  xnu-792  -  xnu-792.6.70  -  xnu-1228  -  xnu-1456.1.26  -  xnu-1699.24.8  -  xnu-2050.18.24  -  OPENSOLARIS  -  minix-3-1-1 
SearchContext: -  none  -  3  -  10 

    1 /*-
    2  * Copyright (c) 2005-2007 Sam Leffler, Errno Consulting
    3  * All rights reserved.
    4  *
    5  * Redistribution and use in source and binary forms, with or without
    6  * modification, are permitted provided that the following conditions
    7  * are met:
    8  * 1. Redistributions of source code must retain the above copyright
    9  *    notice, this list of conditions and the following disclaimer.
   10  * 2. Redistributions in binary form must reproduce the above copyright
   11  *    notice, this list of conditions and the following disclaimer in the
   12  *    documentation and/or other materials provided with the distribution.
   13  *
   14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
   15  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
   16  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
   17  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
   18  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
   19  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
   20  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
   21  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
   22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
   23  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
   24  *
   25  * $FreeBSD$
   26  */
   27 #ifndef _NET80211_IEEE80211_SCAN_H_
   28 #define _NET80211_IEEE80211_SCAN_H_
   29 
   30 #define IEEE80211_SCAN_MAX      IEEE80211_CHAN_MAX
   31 
   32 struct ieee80211_scanner;
   33 
   34 struct ieee80211_scan_ssid {
   35         int             len;                            /* length in bytes */
   36         uint8_t         ssid[IEEE80211_NWID_LEN];       /* ssid contents */
   37 };
   38 #define IEEE80211_SCAN_MAX_SSID 1
   39 
   40 struct ieee80211_scan_state {
   41         struct ieee80211com *ss_ic;
   42         const struct ieee80211_scanner *ss_ops; /* policy hookup, see below */
   43         void            *ss_priv;               /* scanner private state */
   44         uint16_t        ss_flags;
   45 #define IEEE80211_SCAN_NOPICK   0x0001          /* scan only, no selection */
   46 #define IEEE80211_SCAN_ACTIVE   0x0002          /* active scan (probe req) */
   47 #define IEEE80211_SCAN_PICK1ST  0x0004          /* ``hey sailor'' mode */
   48 #define IEEE80211_SCAN_BGSCAN   0x0008          /* bg scan, exit ps at end */
   49 #define IEEE80211_SCAN_ONCE     0x0010          /* do one complete pass */
   50 #define IEEE80211_SCAN_GOTPICK  0x1000          /* got candidate, can stop */
   51         uint8_t         ss_nssid;               /* # ssid's to probe/match */
   52         struct ieee80211_scan_ssid ss_ssid[IEEE80211_SCAN_MAX_SSID];
   53                                                 /* ssid's to probe/match */
   54                                                 /* ordered channel set */
   55         struct ieee80211_channel *ss_chans[IEEE80211_SCAN_MAX];
   56         uint16_t        ss_next;                /* ix of next chan to scan */
   57         uint16_t        ss_last;                /* ix+1 of last chan to scan */
   58         unsigned long   ss_mindwell;            /* min dwell on channel */
   59         unsigned long   ss_maxdwell;            /* max dwell on channel */
   60 };
   61 
   62 /*
   63  * The upper 16 bits of the flags word is used to communicate
   64  * information to the scanning code that is NOT recorded in
   65  * ss_flags.  It might be better to split this stuff out into
   66  * a separate variable to avoid confusion.
   67  */
   68 #define IEEE80211_SCAN_FLUSH    0x10000         /* flush candidate table */
   69 #define IEEE80211_SCAN_NOSSID   0x20000         /* don't update ssid list */
   70 
   71 struct ieee80211com;
   72 void    ieee80211_scan_attach(struct ieee80211com *);
   73 void    ieee80211_scan_detach(struct ieee80211com *);
   74 
   75 void    ieee80211_scan_dump_channels(const struct ieee80211_scan_state *);
   76 
   77 int     ieee80211_scan_update(struct ieee80211com *);
   78 #define IEEE80211_SCAN_FOREVER  0x7fffffff
   79 int     ieee80211_start_scan(struct ieee80211com *, int flags, u_int duration,
   80                 u_int nssid, const struct ieee80211_scan_ssid ssids[]);
   81 int     ieee80211_check_scan(struct ieee80211com *, int flags, u_int duration,
   82                 u_int nssid, const struct ieee80211_scan_ssid ssids[]);
   83 int     ieee80211_bg_scan(struct ieee80211com *);
   84 void    ieee80211_cancel_scan(struct ieee80211com *);
   85 void    ieee80211_scan_next(struct ieee80211com *);
   86 void    ieee80211_scan_done(struct ieee80211com *);
   87 
   88 struct ieee80211_scanparams;
   89 void    ieee80211_add_scan(struct ieee80211com *,
   90                 const struct ieee80211_scanparams *,
   91                 const struct ieee80211_frame *,
   92                 int subtype, int rssi, int noise, int rstamp);
   93 void    ieee80211_scan_timeout(struct ieee80211com *);
   94 
   95 void    ieee80211_scan_assoc_success(struct ieee80211com *,
   96                 const uint8_t mac[IEEE80211_ADDR_LEN]);
   97 enum {
   98         IEEE80211_SCAN_FAIL_TIMEOUT     = 1,    /* no response to mgmt frame */
   99         IEEE80211_SCAN_FAIL_STATUS      = 2     /* negative response to " " */
  100 };
  101 void    ieee80211_scan_assoc_fail(struct ieee80211com *,
  102                 const uint8_t mac[IEEE80211_ADDR_LEN], int reason);
  103 void    ieee80211_scan_flush(struct ieee80211com *);
  104 
  105 struct ieee80211_scan_entry;
  106 typedef void ieee80211_scan_iter_func(void *,
  107                 const struct ieee80211_scan_entry *);
  108 void    ieee80211_scan_iterate(struct ieee80211com *,
  109                 ieee80211_scan_iter_func, void *);
  110 
  111 /*
  112  * Parameters supplied when adding/updating an entry in a
  113  * scan cache.  Pointer variables should be set to NULL
  114  * if no data is available.  Pointer references can be to
  115  * local data; any information that is saved will be copied.
  116  * All multi-byte values must be in host byte order.
  117  */
  118 struct ieee80211_scanparams {
  119         uint16_t        capinfo;        /* 802.11 capabilities */
  120         uint16_t        fhdwell;        /* FHSS dwell interval */
  121         struct ieee80211_channel *curchan;
  122         uint8_t         bchan;          /* chan# advertised inside beacon */
  123         uint8_t         fhindex;
  124         uint8_t         erp;
  125         uint16_t        bintval;
  126         uint8_t         timoff;
  127         uint8_t         *tim;
  128         uint8_t         *tstamp;
  129         uint8_t         *country;
  130         uint8_t         *ssid;
  131         uint8_t         *rates;
  132         uint8_t         *xrates;
  133         uint8_t         *doth;
  134         uint8_t         *wpa;
  135         uint8_t         *rsn;
  136         uint8_t         *wme;
  137         uint8_t         *htcap;
  138         uint8_t         *htinfo;
  139         uint8_t         *ath;
  140 };
  141 
  142 /*
  143  * Scan cache entry format used when exporting data from a policy
  144  * module; this data may be represented some other way internally.
  145  */
  146 struct ieee80211_scan_entry {
  147         uint8_t         se_macaddr[IEEE80211_ADDR_LEN];
  148         uint8_t         se_bssid[IEEE80211_ADDR_LEN];
  149         uint8_t         se_ssid[2+IEEE80211_NWID_LEN];
  150         uint8_t         se_rates[2+IEEE80211_RATE_MAXSIZE];
  151         uint8_t         se_xrates[2+IEEE80211_RATE_MAXSIZE];
  152         uint32_t        se_rstamp;      /* recv timestamp */
  153         union {
  154                 uint8_t         data[8];
  155                 uint64_t        tsf;
  156         } se_tstamp;                    /* from last rcv'd beacon */
  157         uint16_t        se_intval;      /* beacon interval (host byte order) */
  158         uint16_t        se_capinfo;     /* capabilities (host byte order) */
  159         struct ieee80211_channel *se_chan;/* channel where sta found */
  160         uint16_t        se_timoff;      /* byte offset to TIM ie */
  161         uint16_t        se_fhdwell;     /* FH only (host byte order) */
  162         uint8_t         se_fhindex;     /* FH only */
  163         uint8_t         se_erp;         /* ERP from beacon/probe resp */
  164         int8_t          se_rssi;        /* avg'd recv ssi */
  165         int8_t          se_noise;       /* noise floor */
  166         uint8_t         se_dtimperiod;  /* DTIM period */
  167         uint8_t         *se_wpa_ie;     /* captured WPA ie */
  168         uint8_t         *se_rsn_ie;     /* captured RSN ie */
  169         uint8_t         *se_wme_ie;     /* captured WME ie */
  170         uint8_t         *se_htcap_ie;   /* captured HTP cap ie */
  171         uint8_t         *se_htinfo_ie;  /* captured HTP info ie */
  172         uint8_t         *se_ath_ie;     /* captured Atheros ie */
  173         u_int           se_age;         /* age of entry (0 on create) */
  174 };
  175 MALLOC_DECLARE(M_80211_SCAN);
  176 
  177 /*
  178  * Template for an in-kernel scan policy module.
  179  * Modules register with the scanning code and are
  180  * typically loaded as needed.
  181  */
  182 struct ieee80211_scanner {
  183         const char *scan_name;          /* printable name */
  184         int     (*scan_attach)(struct ieee80211_scan_state *);
  185         int     (*scan_detach)(struct ieee80211_scan_state *);
  186         int     (*scan_start)(struct ieee80211_scan_state *,
  187                         struct ieee80211com *);
  188         int     (*scan_restart)(struct ieee80211_scan_state *,
  189                         struct ieee80211com *);
  190         int     (*scan_cancel)(struct ieee80211_scan_state *,
  191                         struct ieee80211com *);
  192         int     (*scan_end)(struct ieee80211_scan_state *,
  193                         struct ieee80211com *);
  194         int     (*scan_flush)(struct ieee80211_scan_state *);
  195         /* add an entry to the cache */
  196         int     (*scan_add)(struct ieee80211_scan_state *,
  197                         const struct ieee80211_scanparams *,
  198                         const struct ieee80211_frame *,
  199                         int subtype, int rssi, int noise, int rstamp);
  200         /* age and/or purge entries in the cache */
  201         void    (*scan_age)(struct ieee80211_scan_state *);
  202         /* note that association failed for an entry */
  203         void    (*scan_assoc_fail)(struct ieee80211_scan_state *,
  204                         const uint8_t macaddr[IEEE80211_ADDR_LEN],
  205                         int reason);
  206         /* note that association succeed for an entry */
  207         void    (*scan_assoc_success)(struct ieee80211_scan_state *,
  208                         const uint8_t macaddr[IEEE80211_ADDR_LEN]);
  209         /* iterate over entries in the scan cache */
  210         void    (*scan_iterate)(struct ieee80211_scan_state *,
  211                         ieee80211_scan_iter_func *, void *);
  212 };
  213 void    ieee80211_scanner_register(enum ieee80211_opmode,
  214                 const struct ieee80211_scanner *);
  215 void    ieee80211_scanner_unregister(enum ieee80211_opmode,
  216                 const struct ieee80211_scanner *);
  217 void    ieee80211_scanner_unregister_all(const struct ieee80211_scanner *);
  218 const struct ieee80211_scanner *ieee80211_scanner_get(enum ieee80211_opmode);
  219 #endif /* _NET80211_IEEE80211_SCAN_H_ */

Cache object: 00d212d475aac36e990da550950e9df4


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.