Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
freebsd
GitHub Repository: freebsd/freebsd-src
 Path: blob/main/sys/net80211/ieee80211_power.h
39475 views
1
/*-

2
 * SPDX-License-Identifier: BSD-2-Clause

3
 *

4
 * Copyright (c) 2002-2008 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
 *

16
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR

17
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES

18
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.

19
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,

20
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT

21
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,

22
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

23
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

24
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF

25
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

26
 */

27
#ifndef _NET80211_IEEE80211_POWER_H_

28
#define _NET80211_IEEE80211_POWER_H_

29


30
struct ieee80211com;

31
struct ieee80211vap;

32
struct ieee80211_node;

33
struct mbuf;

34


35
/*

36
 * Power save packet queues.  There are two queues, one

37
 * for frames coming from the net80211 layer and the other

38
 * for frames that come from the driver. Frames from the

39
 * driver are expected to have M_ENCAP marked to indicate

40
 * they have already been encapsulated and are treated as

41
 * higher priority: they are sent first when flushing the

42
 * queue on a power save state change or in response to a

43
 * ps-poll frame.

44
 *

45
 * Note that frames sent from the high priority queue are

46
 * fed directly to the driver without going through

47
 * ieee80211_start again; drivers that send up encap'd

48
 * frames are required to handle them when they come back.

49
 */

50
struct ieee80211_psq {

51
	ieee80211_psq_lock_t psq_lock;

52
	int	psq_len;

53
	int	psq_maxlen;

54
	int	psq_drops;

55
	struct ieee80211_psq_head {

56
		struct mbuf *head;

57
		struct mbuf *tail;

58
		int len;

59
	} psq_head[2];			/* 2 priorities */

60
};

61


62
void	ieee80211_psq_init(struct ieee80211_psq *, const char *);

63
void	ieee80211_psq_cleanup(struct ieee80211_psq *);

64


65
void	ieee80211_power_attach(struct ieee80211com *);

66
void	ieee80211_power_detach(struct ieee80211com *);

67
void	ieee80211_power_vattach(struct ieee80211vap *);

68
void	ieee80211_power_vdetach(struct ieee80211vap *);

69
void	ieee80211_power_latevattach(struct ieee80211vap *);

70


71
struct mbuf *ieee80211_node_psq_dequeue(struct ieee80211_node *ni, int *qlen);

72
int	ieee80211_node_psq_drain(struct ieee80211_node *);

73
int	ieee80211_node_psq_age(struct ieee80211_node *);

74


75
/*

76
 * Don't call these directly from the stack; they are vap methods

77
 * that should be overridden.

78
 */

79
int	ieee80211_pwrsave(struct ieee80211_node *, struct mbuf *);

80
void	ieee80211_node_pwrsave(struct ieee80211_node *, int enable);

81
void	ieee80211_sta_pwrsave(struct ieee80211vap *, int enable);

82
void	ieee80211_sta_tim_notify(struct ieee80211vap *vap, int set);

83
void	ieee80211_sta_ps_timer_check(struct ieee80211vap *vap);

84


85
/* XXX what's this? */

86
void	ieee80211_power_poll(struct ieee80211com *);

87
#endif /* _NET80211_IEEE80211_POWER_H_ */

88


89