FreeBSD/Linux Kernel Cross Reference
sys/dev/ath/if_athrate.h

     /*-
      * Copyright (c) 2004-2005 Sam Leffler, Errno Consulting
      * Copyright (c) 2004 Video54 Technologies, Inc.
      * 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,
        without modification.
     * 2. Redistributions in binary form must reproduce at minimum a disclaimer
     *    similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
     *    redistribution must be conditioned upon including a substantially
     *    similar Disclaimer requirement for further binary redistribution.
     * 3. Neither the names of the above-listed copyright holders nor the names
     *    of any contributors may be used to endorse or promote products derived
     *    from this software without specific prior written permission.
     *
     * Alternatively, this software may be distributed under the terms of the
     * GNU General Public License ("GPL") version 2 as published by the Free
     * Software Foundation.
     *
     * NO WARRANTY
     * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     * LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
     * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
     * THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR 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 DAMAGES.
     *
     * $FreeBSD: releng/6.4/sys/dev/ath/if_athrate.h 166276 2007-01-27 07:12:58Z sam $
     */
    #ifndef _ATH_RATECTRL_H_
    #define _ATH_RATECTRL_H_
    
    /*
     * Interface definitions for transmit rate control modules for the
     * Atheros driver.
     *
     * A rate control module is responsible for choosing the transmit rate
     * for each data frame.  Management+control frames are always sent at
     * a fixed rate.
     *
     * Only one module may be present at a time; the driver references
     * rate control interfaces by symbol name.  If multiple modules are
     * to be supported we'll need to switch to a registration-based scheme
     * as is currently done, for example, for authentication modules.
     *
     * An instance of the rate control module is attached to each device
     * at attach time and detached when the device is destroyed.  The module
     * may associate data with each device and each node (station).  Both
     * sets of storage are opaque except for the size of the per-node storage
     * which must be provided when the module is attached.
     *
     * The rate control module is notified for each state transition and
     * station association/reassociation.  Otherwise it is queried for a
     * rate for each outgoing frame and provided status from each transmitted
     * frame.  Any ancillary processing is the responsibility of the module
     * (e.g. if periodic processing is required then the module should setup
     * it's own timer).
     *
     * In addition to the transmit rate for each frame the module must also
     * indicate the number of attempts to make at the specified rate.  If this
     * number is != ATH_TXMAXTRY then an additional callback is made to setup
     * additional transmit state.  The rate control code is assumed to write
     * this additional data directly to the transmit descriptor.
     */
    struct ath_softc;
    struct ath_node;
    struct ath_desc;
    
    struct ath_ratectrl {
            size_t  arc_space;      /* space required for per-node state */
    };
    /*
     * Attach/detach a rate control module.
     */
    struct ath_ratectrl *ath_rate_attach(struct ath_softc *);
    void    ath_rate_detach(struct ath_ratectrl *);
    
    
    /*
     * State storage handling.
     */
    /*
     * Initialize per-node state already allocated for the specified
     * node; this space can be assumed initialized to zero.
     */
    void    ath_rate_node_init(struct ath_softc *, struct ath_node *);
    /*
     * Cleanup any per-node state prior to the node being reclaimed.
     */
    void    ath_rate_node_cleanup(struct ath_softc *, struct ath_node *);
   /*
    * Update rate control state on station associate/reassociate 
    * (when operating as an ap or for nodes discovered when operating
    * in ibss mode).
    */
   void    ath_rate_newassoc(struct ath_softc *, struct ath_node *,
                   int isNewAssociation);
   /*
    * Update/reset rate control state for 802.11 state transitions.
    * Important mostly as the analog to ath_rate_newassoc when operating
    * in station mode.
    */
   void    ath_rate_newstate(struct ath_softc *, enum ieee80211_state);
   
   /*
    * Transmit handling.
    */
   /*
    * Return the transmit info for a data packet.  If multi-rate state
    * is to be setup then try0 should contain a value other than ATH_TXMATRY
    * and ath_rate_setupxtxdesc will be called after deciding if the frame
    * can be transmitted with multi-rate retry.
    */
   void    ath_rate_findrate(struct ath_softc *, struct ath_node *,
                   int shortPreamble, size_t frameLen,
                   u_int8_t *rix, int *try0, u_int8_t *txrate);
   /*
    * Setup any extended (multi-rate) descriptor state for a data packet.
    * The rate index returned by ath_rate_findrate is passed back in.
    */
   void    ath_rate_setupxtxdesc(struct ath_softc *, struct ath_node *,
                   struct ath_desc *, int shortPreamble, u_int8_t rix);
   /*
    * Update rate control state for a packet associated with the
    * supplied transmit descriptor.  The routine is invoked both
    * for packets that were successfully sent and for those that
    * failed (consult the descriptor for details).
    */
   struct ath_buf;
   void    ath_rate_tx_complete(struct ath_softc *, struct ath_node *,
                   const struct ath_buf *);
   #endif /* _ATH_RATECTRL_H_ */

Cache object: ab7603788cf3fb976e0b02db0e5b8b85