Debian Codegraph @

drivers/net/wireless/intel/iwlwifi/mld/agg.h

raw
1 /* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
2 /*
3 * Copyright (C) 2024 Intel Corporation
4 */
5 #ifndef __iwl_agg_h__
6 #define __iwl_agg_h__
7
8 #include "mld.h"
9 #include "fw/api/rx.h"
10
11 /**
12 * struct iwl_mld_reorder_buffer - per ra/tid/queue reorder buffer
13 * @head_sn: reorder window head sequence number
14 * @num_stored: number of MPDUs stored in the buffer
15 * @queue: queue of this reorder buffer
16 * @valid: true if reordering is valid for this queue
17 */
18 struct iwl_mld_reorder_buffer {
19 u16 head_sn;
20 u16 num_stored;
21 int queue;
22 bool valid;
23 } ____cacheline_aligned_in_smp;
24
25 /**
26 * struct iwl_mld_reorder_buf_entry - reorder buffer entry per-queue/per-seqno
27 * @frames: list of skbs stored. a list is necessary because in an A-MSDU,
28 * all sub-frames share the same sequence number, so they are stored
29 * together in the same list.
30 */
31 struct iwl_mld_reorder_buf_entry {
32 struct sk_buff_head frames;
33 }
34 #ifndef __CHECKER__
35 /* sparse doesn't like this construct: "bad integer constant expression" */
36 __aligned(roundup_pow_of_two(sizeof(struct sk_buff_head)))
37 #endif
38 ;
39
40 /**
41 * struct iwl_mld_baid_data - Block Ack session data
42 * @rcu_head: RCU head for freeing this data
43 * @sta_mask: station mask for the BAID
44 * @tid: tid of the session
45 * @baid: baid of the session
46 * @buf_size: the reorder buffer size as set by the last ADDBA request
47 * @entries_per_queue: number of buffers per queue, this actually gets
48 * aligned up to avoid cache line sharing between queues
49 * @timeout: the timeout value specified in the ADDBA request.
50 * @last_rx_timestamp: timestamp of the last received packet (in jiffies). This
51 * value is updated only when the configured @timeout has passed since
52 * the last update to minimize cache bouncing between RX queues.
53 * @session_timer: timer is set to expire after 2 * @timeout (since we want
54 * to minimize the cache bouncing by updating @last_rx_timestamp only once
55 * after @timeout has passed). If no packets are received within this
56 * period, it informs mac80211 to initiate delBA flow, terminating the
57 * BA session.
58 * @rcu_ptr: BA data RCU protected access
59 * @mld: mld pointer, needed for timer context
60 * @reorder_buf: reorder buffer, allocated per queue
61 * @entries: data
62 */
63 struct iwl_mld_baid_data {
64 struct rcu_head rcu_head;
65 u32 sta_mask;
66 u8 tid;
67 u8 baid;
68 u16 buf_size;
69 u16 entries_per_queue;
70 u16 timeout;
71 struct timer_list session_timer;
72 unsigned long last_rx_timestamp;
73 struct iwl_mld_baid_data __rcu **rcu_ptr;
74 struct iwl_mld *mld;
75 struct iwl_mld_reorder_buffer reorder_buf[IWL_MAX_RX_HW_QUEUES];
76 struct iwl_mld_reorder_buf_entry entries[] ____cacheline_aligned_in_smp;
77 };
78
79 /**
80 * struct iwl_mld_delba_data - RX queue sync data for %IWL_MLD_RXQ_NOTIF_DEL_BA
81 *
82 * @baid: Block Ack id, used to identify the BA session to be removed
83 */
84 struct iwl_mld_delba_data {
85 u32 baid;
86 } __packed;
87
88 /**
89 * enum iwl_mld_reorder_result - Possible return values for iwl_mld_reorder()
90 * indicating how the caller should handle the skb based on the result.
91 *
92 * @IWL_MLD_PASS_SKB: skb should be passed to upper layer.
93 * @IWL_MLD_BUFFERED_SKB: skb has been buffered, don't pass it to upper layer.
94 * @IWL_MLD_DROP_SKB: skb should be dropped and freed by the caller.
95 */
96 enum iwl_mld_reorder_result {
97 IWL_MLD_PASS_SKB,
98 IWL_MLD_BUFFERED_SKB,
99 IWL_MLD_DROP_SKB
100 };
101
102 int iwl_mld_ampdu_rx_start(struct iwl_mld *mld, struct ieee80211_sta *sta,
103 int tid, u16 ssn, u16 buf_size, u16 timeout);
104 int iwl_mld_ampdu_rx_stop(struct iwl_mld *mld, struct ieee80211_sta *sta,
105 int tid);
106
107 enum iwl_mld_reorder_result
108 iwl_mld_reorder(struct iwl_mld *mld, struct napi_struct *napi,
109 int queue, struct ieee80211_sta *sta,
110 struct sk_buff *skb, struct iwl_rx_mpdu_desc *desc);
111
112 void iwl_mld_handle_frame_release_notif(struct iwl_mld *mld,
113 struct napi_struct *napi,
114 struct iwl_rx_packet *pkt, int queue);
115 void iwl_mld_handle_bar_frame_release_notif(struct iwl_mld *mld,
116 struct napi_struct *napi,
117 struct iwl_rx_packet *pkt,
118 int queue);
119
120 void iwl_mld_del_ba(struct iwl_mld *mld, int queue,
121 struct iwl_mld_delba_data *data);
122
123 int iwl_mld_update_sta_baids(struct iwl_mld *mld,
124 u32 old_sta_mask,
125 u32 new_sta_mask);
126
127 #endif /* __iwl_agg_h__ */