samsung-sm8650/android_kernel_samsung_sm8650-modules
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

qcacmn: Fix dp/wifi3.0/dp_peer.* documentation

Browse Source 
The kernel-doc script identified a large number of documentation
issues in dp/wifi3.0/dp_peer.[ch], so fix those issues. In addition,
there are a number of instances where public functions have their
implementation documented instead of having their interface
documented, so move that documentation.

Change-Id: I996764f93addfa270ef7aaedd2e23c71be287f77
CRs-Fixed: 3373168
This commit is contained in:
Jeff Johnson
2023-01-04 16:50:54 -08:00
committed by Madan Koyyalamudi
parent 89c50d8df3
commit 1ea7b9f065
2 changed files with 453 additions and 639 deletions
Download Patch File Download Diff File Expand all files Collapse all files

575
dp/wifi3.0/dp_peer.c
View File

File diff suppressed because it is too large Load Diff

517
dp/wifi3.0/dp_peer.h
View File

@@ -69,13 +69,47 @@ struct ast_del_ctxt {
typedef void dp_peer_iter_func(struct dp_soc *soc, struct dp_peer *peer, typedef void dp_peer_iter_func(struct dp_soc *soc, struct dp_peer *peer,
void *arg); void *arg);
/**
* dp_peer_unref_delete() - unref and delete peer
* @peer: Datapath peer handle
* @id: ID of module releasing reference
*
*/
void dp_peer_unref_delete(struct dp_peer *peer, enum dp_mod_id id); void dp_peer_unref_delete(struct dp_peer *peer, enum dp_mod_id id);
/**
* dp_txrx_peer_unref_delete() - unref and delete peer
* @handle: Datapath txrx ref handle
* @id: Module ID of the caller
*
*/
void dp_txrx_peer_unref_delete(dp_txrx_ref_handle handle, enum dp_mod_id id); void dp_txrx_peer_unref_delete(dp_txrx_ref_handle handle, enum dp_mod_id id);
/**
* dp_peer_find_hash_find() - returns legacy or mlo link peer from
* peer_hash_table matching vdev_id and mac_address
* @soc: soc handle
* @peer_mac_addr: peer mac address
* @mac_addr_is_aligned: is mac addr aligned
* @vdev_id: vdev_id
* @mod_id: id of module requesting reference
*
* return: peer in success
* NULL in failure
*/
struct dp_peer *dp_peer_find_hash_find(struct dp_soc *soc, struct dp_peer *dp_peer_find_hash_find(struct dp_soc *soc,
uint8_t *peer_mac_addr, uint8_t *peer_mac_addr,
int mac_addr_is_aligned, int mac_addr_is_aligned,
uint8_t vdev_id, uint8_t vdev_id,
enum dp_mod_id id); enum dp_mod_id mod_id);
/**
* dp_peer_find_by_id_valid - check if peer exists for given id
* @soc: core DP soc context
* @peer_id: peer id from peer object can be retrieved
*
* Return: true if peer exists of false otherwise
*/
bool dp_peer_find_by_id_valid(struct dp_soc *soc, uint16_t peer_id); bool dp_peer_find_by_id_valid(struct dp_soc *soc, uint16_t peer_id);
#ifdef DP_UMAC_HW_RESET_SUPPORT #ifdef DP_UMAC_HW_RESET_SUPPORT
@@ -84,9 +118,9 @@ void dp_reset_tid_q_setup(struct dp_soc *soc);
/** /**
* dp_peer_get_ref() - Returns peer object given the peer id * dp_peer_get_ref() - Returns peer object given the peer id
* *
* @soc : core DP soc context * @soc: core DP soc context
* @peer : DP peer * @peer: DP peer
* @mod_id : id of module requesting the reference * @mod_id: id of module requesting the reference
* *
* Return: QDF_STATUS_SUCCESS if reference held successfully * Return: QDF_STATUS_SUCCESS if reference held successfully
* else QDF_STATUS_E_INVAL * else QDF_STATUS_E_INVAL
@@ -108,9 +142,9 @@ QDF_STATUS dp_peer_get_ref(struct dp_soc *soc,
/** /**
* __dp_peer_get_ref_by_id() - Returns peer object given the peer id * __dp_peer_get_ref_by_id() - Returns peer object given the peer id
* *
* @soc : core DP soc context * @soc: core DP soc context
* @peer_id : peer id from peer object can be retrieved * @peer_id: peer id from peer object can be retrieved
* @mod_id : module id * @mod_id: module id
* *
* Return: struct dp_peer*: Pointer to DP peer object * Return: struct dp_peer*: Pointer to DP peer object
*/ */
@@ -139,9 +173,9 @@ __dp_peer_get_ref_by_id(struct dp_soc *soc,
* dp_peer_get_ref_by_id() - Returns peer object given the peer id * dp_peer_get_ref_by_id() - Returns peer object given the peer id
* if peer state is active * if peer state is active
* *
* @soc : core DP soc context * @soc: core DP soc context
* @peer_id : peer id from peer object can be retrieved * @peer_id: peer id from peer object can be retrieved
* @mod_id : ID of module requesting reference * @mod_id: ID of module requesting reference
* *
* Return: struct dp_peer*: Pointer to DP peer object * Return: struct dp_peer*: Pointer to DP peer object
*/ */
@@ -170,10 +204,10 @@ struct dp_peer *dp_peer_get_ref_by_id(struct dp_soc *soc,
/** /**
* dp_txrx_peer_get_ref_by_id() - Returns txrx peer object given the peer id * dp_txrx_peer_get_ref_by_id() - Returns txrx peer object given the peer id
* *
* @soc : core DP soc context * @soc: core DP soc context
* @peer_id : peer id from peer object can be retrieved * @peer_id: peer id from peer object can be retrieved
* @handle : reference handle * @handle: reference handle
* @mod_id : ID of module requesting reference * @mod_id: ID of module requesting reference
* *
* Return: struct dp_txrx_peer*: Pointer to txrx DP peer object * Return: struct dp_txrx_peer*: Pointer to txrx DP peer object
*/ */
@@ -227,10 +261,10 @@ dp_clear_peer_internal(struct dp_soc *soc, struct dp_peer *peer)
/** /**
* dp_vdev_iterate_peer() - API to iterate through vdev peer list * dp_vdev_iterate_peer() - API to iterate through vdev peer list
* *
* @vdev : DP vdev context * @vdev: DP vdev context
* @func : function to be called for each peer * @func: function to be called for each peer
* @arg : argument need to be passed to func * @arg: argument need to be passed to func
* @mod_id : module_id * @mod_id: module_id
* *
* Return: void * Return: void
*/ */
@@ -263,10 +297,10 @@ dp_vdev_iterate_peer(struct dp_vdev *vdev, dp_peer_iter_func *func, void *arg,
/** /**
* dp_pdev_iterate_peer() - API to iterate through all peers of pdev * dp_pdev_iterate_peer() - API to iterate through all peers of pdev
* *
* @pdev : DP pdev context * @pdev: DP pdev context
* @func : function to be called for each peer * @func: function to be called for each peer
* @arg : argument need to be passed to func * @arg: argument need to be passed to func
* @mod_id : module_id * @mod_id: module_id
* *
* Return: void * Return: void
*/ */
@@ -288,10 +322,10 @@ dp_pdev_iterate_peer(struct dp_pdev *pdev, dp_peer_iter_func *func, void *arg,
/** /**
* dp_soc_iterate_peer() - API to iterate through all peers of soc * dp_soc_iterate_peer() - API to iterate through all peers of soc
* *
* @soc : DP soc context * @soc: DP soc context
* @func : function to be called for each peer * @func: function to be called for each peer
* @arg : argument need to be passed to func * @arg: argument need to be passed to func
* @mod_id : module_id * @mod_id: module_id
* *
* Return: void * Return: void
*/ */
@@ -320,10 +354,10 @@ dp_soc_iterate_peer(struct dp_soc *soc, dp_peer_iter_func *func, void *arg,
* As this API is allocating new memory it is suggested to use this * As this API is allocating new memory it is suggested to use this
* only when lock cannot be held * only when lock cannot be held
* *
* @vdev : DP vdev context * @vdev: DP vdev context
* @func : function to be called for each peer * @func: function to be called for each peer
* @arg : argument need to be passed to func * @arg: argument need to be passed to func
* @mod_id : module_id * @mod_id: module_id
* *
* Return: void * Return: void
*/ */
@@ -387,10 +421,10 @@ dp_vdev_iterate_peer_lock_safe(struct dp_vdev *vdev,
* As this API is allocating new memory it is suggested to use this * As this API is allocating new memory it is suggested to use this
* only when lock cannot be held * only when lock cannot be held
* *
* @pdev : DP pdev context * @pdev: DP pdev context
* @func : function to be called for each peer * @func: function to be called for each peer
* @arg : argument need to be passed to func * @arg: argument need to be passed to func
* @mod_id : module_id * @mod_id: module_id
* *
* Return: void * Return: void
*/ */
@@ -468,10 +502,10 @@ dp_pdev_iterate_peer_lock_safe(struct dp_pdev *pdev,
* As this API is allocating new memory it is suggested to use this * As this API is allocating new memory it is suggested to use this
* only when lock cannot be held * only when lock cannot be held
* *
* @soc : DP soc context * @soc: DP soc context
* @func : function to be called for each peer * @func: function to be called for each peer
* @arg : argument need to be passed to func * @arg: argument need to be passed to func
* @mod_id : module_id * @mod_id: module_id
* *
* Return: void * Return: void
*/ */
@@ -520,8 +554,8 @@ dp_soc_iterate_peer_lock_safe(struct dp_soc *soc,
/** /**
* dp_peer_state_cmp() - compare dp peer state * dp_peer_state_cmp() - compare dp peer state
* *
* @peer : DP peer * @peer: DP peer
* @state : state * @state: state
* *
* Return: true if state matches with peer state * Return: true if state matches with peer state
* false if it does not match * false if it does not match
@@ -539,11 +573,46 @@ dp_peer_state_cmp(struct dp_peer *peer,
return is_status_equal; return is_status_equal;
} }
/**
* dp_print_ast_stats() - Dump AST table contents
* @soc: Datapath soc handle
*
* Return: void
*/
void dp_print_ast_stats(struct dp_soc *soc); void dp_print_ast_stats(struct dp_soc *soc);
/**
* dp_rx_peer_map_handler() - handle peer map event from firmware
* @soc: generic soc handle
* @peer_id: peer_id from firmware
* @hw_peer_id: ast index for this peer
* @vdev_id: vdev ID
* @peer_mac_addr: mac address of the peer
* @ast_hash: ast hash value
* @is_wds: flag to indicate peer map event for WDS ast entry
*
* associate the peer_id that firmware provided with peer entry
* and update the ast table in the host with the hw_peer_id.
*
* Return: QDF_STATUS code
*/
QDF_STATUS dp_rx_peer_map_handler(struct dp_soc *soc, uint16_t peer_id, QDF_STATUS dp_rx_peer_map_handler(struct dp_soc *soc, uint16_t peer_id,
uint16_t hw_peer_id, uint8_t vdev_id, uint16_t hw_peer_id, uint8_t vdev_id,
uint8_t *peer_mac_addr, uint16_t ast_hash, uint8_t *peer_mac_addr, uint16_t ast_hash,
uint8_t is_wds); uint8_t is_wds);
/**
* dp_rx_peer_unmap_handler() - handle peer unmap event from firmware
* @soc: generic soc handle
* @peer_id: peer_id from firmware
* @vdev_id: vdev ID
* @peer_mac_addr: mac address of the peer or wds entry
* @is_wds: flag to indicate peer map event for WDS ast entry
* @free_wds_count: number of wds entries freed by FW with peer delete
*
* Return: none
*/
void dp_rx_peer_unmap_handler(struct dp_soc *soc, uint16_t peer_id, void dp_rx_peer_unmap_handler(struct dp_soc *soc, uint16_t peer_id,
uint8_t vdev_id, uint8_t *peer_mac_addr, uint8_t vdev_id, uint8_t *peer_mac_addr,
uint8_t is_wds, uint32_t free_wds_count); uint8_t is_wds, uint32_t free_wds_count);
@@ -551,9 +620,9 @@ void dp_rx_peer_unmap_handler(struct dp_soc *soc, uint16_t peer_id,
#ifdef DP_RX_UDP_OVER_PEER_ROAM #ifdef DP_RX_UDP_OVER_PEER_ROAM
/** /**
* dp_rx_reset_roaming_peer() - Reset the roamed peer in vdev * dp_rx_reset_roaming_peer() - Reset the roamed peer in vdev
* @soc - dp soc pointer * @soc: dp soc pointer
* @vdev_id - vdev id * @vdev_id: vdev id
* @peer_mac_addr - mac address of the peer * @peer_mac_addr: mac address of the peer
* *
* This function resets the roamed peer auth status and mac address * This function resets the roamed peer auth status and mac address
* after peer map indication of same peer is received from firmware. * after peer map indication of same peer is received from firmware.
@@ -572,11 +641,11 @@ static inline void dp_rx_reset_roaming_peer(struct dp_soc *soc, uint8_t vdev_id,
#ifdef WLAN_FEATURE_11BE_MLO #ifdef WLAN_FEATURE_11BE_MLO
/** /**
* dp_rx_mlo_peer_map_handler() - handle MLO peer map event from firmware * dp_rx_mlo_peer_map_handler() - handle MLO peer map event from firmware
* @soc_handle - generic soc handle * @soc: generic soc handle
* @peer_id - ML peer_id from firmware * @peer_id: ML peer_id from firmware
* @peer_mac_addr - mac address of the peer * @peer_mac_addr: mac address of the peer
* @mlo_ast_flow_info: MLO AST flow info * @mlo_flow_info: MLO AST flow info
* @mlo_link_info - MLO link info * @mlo_link_info: MLO link info
* *
* associate the ML peer_id that firmware provided with peer entry * associate the ML peer_id that firmware provided with peer entry
* and update the ast table in the host with the hw_peer_id. * and update the ast table in the host with the hw_peer_id.
@@ -591,8 +660,8 @@ dp_rx_mlo_peer_map_handler(struct dp_soc *soc, uint16_t peer_id,
/** /**
* dp_rx_mlo_peer_unmap_handler() - handle MLO peer unmap event from firmware * dp_rx_mlo_peer_unmap_handler() - handle MLO peer unmap event from firmware
* @soc_handle - generic soc handle * @soc: generic soc handle
* @peeri_id - peer_id from firmware * @peer_id: peer_id from firmware
* *
* Return: none * Return: none
*/ */
@@ -609,36 +678,134 @@ QDF_STATUS dp_rx_delba_ind_handler(void *soc_handle, uint16_t peer_id,
uint8_t dp_get_peer_mac_addr_frm_id(struct cdp_soc_t *soc_handle, uint8_t dp_get_peer_mac_addr_frm_id(struct cdp_soc_t *soc_handle,
uint16_t peer_id, uint8_t *peer_mac); uint16_t peer_id, uint8_t *peer_mac);
/**
* dp_peer_add_ast() - Allocate and add AST entry into peer list
* @soc: SoC handle
* @peer: peer to which ast node belongs
* @mac_addr: MAC address of ast node
* @type: AST entry type
* @flags: AST configuration flags
*
* This API is used by WDS source port learning function to
* add a new AST entry into peer AST list
*
* Return: QDF_STATUS code
*/
QDF_STATUS dp_peer_add_ast(struct dp_soc *soc, struct dp_peer *peer, QDF_STATUS dp_peer_add_ast(struct dp_soc *soc, struct dp_peer *peer,
uint8_t *mac_addr, enum cdp_txrx_ast_entry_type type, uint8_t *mac_addr, enum cdp_txrx_ast_entry_type type,
uint32_t flags); uint32_t flags);
/**
* dp_peer_del_ast() - Delete and free AST entry
* @soc: SoC handle
* @ast_entry: AST entry of the node
*
* This function removes the AST entry from peer and soc tables
* It assumes caller has taken the ast lock to protect the access to these
* tables
*
* Return: None
*/
void dp_peer_del_ast(struct dp_soc *soc, struct dp_ast_entry *ast_entry); void dp_peer_del_ast(struct dp_soc *soc, struct dp_ast_entry *ast_entry);
void dp_peer_ast_unmap_handler(struct dp_soc *soc, void dp_peer_ast_unmap_handler(struct dp_soc *soc,
struct dp_ast_entry *ast_entry); struct dp_ast_entry *ast_entry);
/**
* dp_peer_update_ast() - Delete and free AST entry
* @soc: SoC handle
* @peer: peer to which ast node belongs
* @ast_entry: AST entry of the node
* @flags: wds or hmwds
*
* This function update the AST entry to the roamed peer and soc tables
* It assumes caller has taken the ast lock to protect the access to these
* tables
*
* Return: 0 if ast entry is updated successfully
* -1 failure
*/
int dp_peer_update_ast(struct dp_soc *soc, struct dp_peer *peer, int dp_peer_update_ast(struct dp_soc *soc, struct dp_peer *peer,
struct dp_ast_entry *ast_entry, uint32_t flags); struct dp_ast_entry *ast_entry, uint32_t flags);
/**
* dp_peer_ast_hash_find_by_pdevid() - Find AST entry by MAC address
* @soc: SoC handle
* @ast_mac_addr: Mac address
* @pdev_id: pdev Id
*
* It assumes caller has taken the ast lock to protect the access to
* AST hash table
*
* Return: AST entry
*/
struct dp_ast_entry *dp_peer_ast_hash_find_by_pdevid(struct dp_soc *soc, struct dp_ast_entry *dp_peer_ast_hash_find_by_pdevid(struct dp_soc *soc,
uint8_t *ast_mac_addr, uint8_t *ast_mac_addr,
uint8_t pdev_id); uint8_t pdev_id);
/**
* dp_peer_ast_hash_find_by_vdevid() - Find AST entry by MAC address
* @soc: SoC handle
* @ast_mac_addr: Mac address
* @vdev_id: vdev Id
*
* It assumes caller has taken the ast lock to protect the access to
* AST hash table
*
* Return: AST entry
*/
struct dp_ast_entry *dp_peer_ast_hash_find_by_vdevid(struct dp_soc *soc, struct dp_ast_entry *dp_peer_ast_hash_find_by_vdevid(struct dp_soc *soc,
uint8_t *ast_mac_addr, uint8_t *ast_mac_addr,
uint8_t vdev_id); uint8_t vdev_id);
/**
* dp_peer_ast_hash_find_soc() - Find AST entry by MAC address
* @soc: SoC handle
* @ast_mac_addr: Mac address
*
* It assumes caller has taken the ast lock to protect the access to
* AST hash table
*
* Return: AST entry
*/
struct dp_ast_entry *dp_peer_ast_hash_find_soc(struct dp_soc *soc, struct dp_ast_entry *dp_peer_ast_hash_find_soc(struct dp_soc *soc,
uint8_t *ast_mac_addr); uint8_t *ast_mac_addr);
/**
* dp_peer_ast_get_pdev_id() - get pdev_id from the ast entry
* @soc: SoC handle
* @ast_entry: AST entry of the node
*
* This function gets the pdev_id from the ast entry.
*
* Return: (uint8_t) pdev_id
*/
uint8_t dp_peer_ast_get_pdev_id(struct dp_soc *soc, uint8_t dp_peer_ast_get_pdev_id(struct dp_soc *soc,
struct dp_ast_entry *ast_entry); struct dp_ast_entry *ast_entry);
/**
* dp_peer_ast_get_next_hop() - get next_hop from the ast entry
* @soc: SoC handle
* @ast_entry: AST entry of the node
*
* This function gets the next hop from the ast entry.
*
* Return: (uint8_t) next_hop
*/
uint8_t dp_peer_ast_get_next_hop(struct dp_soc *soc, uint8_t dp_peer_ast_get_next_hop(struct dp_soc *soc,
struct dp_ast_entry *ast_entry); struct dp_ast_entry *ast_entry);
/**
* dp_peer_ast_set_type() - set type from the ast entry
* @soc: SoC handle
* @ast_entry: AST entry of the node
* @type: AST entry type
*
* This function sets the type in the ast entry.
*
* Return:
*/
void dp_peer_ast_set_type(struct dp_soc *soc, void dp_peer_ast_set_type(struct dp_soc *soc,
struct dp_ast_entry *ast_entry, struct dp_ast_entry *ast_entry,
enum cdp_txrx_ast_entry_type type); enum cdp_txrx_ast_entry_type type);
@@ -658,12 +825,43 @@ void dp_peer_free_hmwds_cb(struct cdp_ctrl_objmgr_psoc *ctrl_psoc,
void *cookie, void *cookie,
enum cdp_ast_free_status status); enum cdp_ast_free_status status);
/**
* dp_peer_ast_hash_remove() - Look up and remove AST entry from hash table
* @soc: SoC handle
* @ase: Address search entry
*
* This function removes the AST entry from soc AST hash table
* It assumes caller has taken the ast lock to protect the access to this table
*
* Return: None
*/
void dp_peer_ast_hash_remove(struct dp_soc *soc, void dp_peer_ast_hash_remove(struct dp_soc *soc,
struct dp_ast_entry *ase); struct dp_ast_entry *ase);
/**
* dp_peer_free_ast_entry() - Free up the ast entry memory
* @soc: SoC handle
* @ast_entry: Address search entry
*
* This API is used to free up the memory associated with
* AST entry.
*
* Return: None
*/
void dp_peer_free_ast_entry(struct dp_soc *soc, void dp_peer_free_ast_entry(struct dp_soc *soc,
struct dp_ast_entry *ast_entry); struct dp_ast_entry *ast_entry);
/**
* dp_peer_unlink_ast_entry() - Free up the ast entry memory
* @soc: SoC handle
* @ast_entry: Address search entry
* @peer: peer
*
* This API is used to remove/unlink AST entry from the peer list
* and hash list.
*
* Return: None
*/
void dp_peer_unlink_ast_entry(struct dp_soc *soc, void dp_peer_unlink_ast_entry(struct dp_soc *soc,
struct dp_ast_entry *ast_entry, struct dp_ast_entry *ast_entry,
struct dp_peer *peer); struct dp_peer *peer);
@@ -708,9 +906,11 @@ QDF_STATUS dp_peer_mec_add_entry(struct dp_soc *soc,
uint8_t *mac_addr); uint8_t *mac_addr);
/** /**
* dp_peer_mec_hash_find_by_pdevid() - Find MEC entry by MAC address * dp_peer_mec_hash_find_by_pdevid() - Find MEC entry by PDEV Id
* within pdev * within pdev
* @soc: SoC handle * @soc: SoC handle
* @pdev_id: pdev Id
* @mec_mac_addr: MAC address of mec node
* *
* It assumes caller has taken the mec_lock to protect the access to * It assumes caller has taken the mec_lock to protect the access to
* MEC hash table * MEC hash table
@@ -730,26 +930,26 @@ struct dp_mec_entry *dp_peer_mec_hash_find_by_pdevid(struct dp_soc *soc,
} while (0) } while (0)
/** /**
* dp_peer_update_inactive_time - Update inactive time for peer * dp_peer_update_inactive_time() - Update inactive time for peer
* @pdev: pdev object * @pdev: pdev object
* @tag_type: htt_tlv_tag type * @tag_type: htt_tlv_tag type
* #tag_buf: buf message * @tag_buf: buf message
*/ */
void void
dp_peer_update_inactive_time(struct dp_pdev *pdev, uint32_t tag_type, dp_peer_update_inactive_time(struct dp_pdev *pdev, uint32_t tag_type,
uint32_t *tag_buf); uint32_t *tag_buf);
#ifndef QCA_MULTIPASS_SUPPORT #ifndef QCA_MULTIPASS_SUPPORT
static inline
/** /**
* dp_peer_set_vlan_id: set vlan_id for this peer * dp_peer_set_vlan_id() - set vlan_id for this peer
* @cdp_soc: soc handle * @cdp_soc: soc handle
* @vdev_id: id of vdev object * @vdev_id: id of vdev object
* @peer_mac: mac address * @peer_mac: mac address
* @vlan_id: vlan id for peer * @vlan_id: vlan id for peer
* *
* return: void * Return: void
*/ */
static inline
void dp_peer_set_vlan_id(struct cdp_soc_t *cdp_soc, void dp_peer_set_vlan_id(struct cdp_soc_t *cdp_soc,
uint8_t vdev_id, uint8_t *peer_mac, uint8_t vdev_id, uint8_t *peer_mac,
uint16_t vlan_id) uint16_t vlan_id)
@@ -757,26 +957,26 @@ void dp_peer_set_vlan_id(struct cdp_soc_t *cdp_soc,
} }
/** /**
* dp_set_vlan_groupkey: set vlan map for vdev * dp_set_vlan_groupkey() - set vlan map for vdev
* @soc: pointer to soc * @soc_hdl: pointer to soc
* @vdev_id: id of vdev handle * @vdev_id: id of vdev handle
* @vlan_id: vlan_id * @vlan_id: vlan_id
* @group_key: group key for vlan * @group_key: group key for vlan
* *
* return: set success/failure * Return: set success/failure
*/ */
static inline static inline
QDF_STATUS dp_set_vlan_groupkey(struct cdp_soc_t *soc, uint8_t vdev_id, QDF_STATUS dp_set_vlan_groupkey(struct cdp_soc_t *soc_hdl, uint8_t vdev_id,
uint16_t vlan_id, uint16_t group_key) uint16_t vlan_id, uint16_t group_key)
{ {
return QDF_STATUS_SUCCESS; return QDF_STATUS_SUCCESS;
} }
/** /**
* dp_peer_multipass_list_init: initialize multipass peer list * dp_peer_multipass_list_init() - initialize multipass peer list
* @vdev: pointer to vdev * @vdev: pointer to vdev
* *
* return: void * Return: void
*/ */
static inline static inline
void dp_peer_multipass_list_init(struct dp_vdev *vdev) void dp_peer_multipass_list_init(struct dp_vdev *vdev)
@@ -784,10 +984,10 @@ void dp_peer_multipass_list_init(struct dp_vdev *vdev)
} }
/** /**
* dp_peer_multipass_list_remove: remove peer from special peer list * dp_peer_multipass_list_remove() - remove peer from special peer list
* @peer: peer handle * @peer: peer handle
* *
* return: void * Return: void
*/ */
static inline static inline
void dp_peer_multipass_list_remove(struct dp_peer *peer) void dp_peer_multipass_list_remove(struct dp_peer *peer)
@@ -807,7 +1007,7 @@ void dp_peer_multipass_list_remove(struct dp_peer *peer);
#ifndef QCA_PEER_MULTIQ_SUPPORT #ifndef QCA_PEER_MULTIQ_SUPPORT
/** /**
* dp_peer_reset_flowq_map() - reset peer flowq map table * dp_peer_reset_flowq_map() - reset peer flowq map table
* @peer - dp peer handle * @peer: dp peer handle
* *
* Return: none * Return: none
*/ */
@@ -818,11 +1018,11 @@ void dp_peer_reset_flowq_map(struct dp_peer *peer)
/** /**
* dp_peer_ast_index_flow_queue_map_create() - create ast index flow queue map * dp_peer_ast_index_flow_queue_map_create() - create ast index flow queue map
* @soc - generic soc handle * @soc_hdl: generic soc handle
* @is_wds - flag to indicate if peer is wds * @is_wds: flag to indicate if peer is wds
* @peer_id - peer_id from htt peer map message * @peer_id: peer_id from htt peer map message
* @peer_mac_addr - mac address of the peer * @peer_mac_addr: mac address of the peer
* @ast_info - ast flow override information from peer map * @ast_info: ast flow override information from peer map
* *
* Return: none * Return: none
*/ */
@@ -834,12 +1034,13 @@ void dp_peer_ast_index_flow_queue_map_create(void *soc_hdl,
} }
#else #else
void dp_peer_reset_flowq_map(struct dp_peer *peer); void dp_peer_reset_flowq_map(struct dp_peer *peer);
void dp_peer_ast_index_flow_queue_map_create(void *soc_hdl, void dp_peer_ast_index_flow_queue_map_create(void *soc_hdl,
bool is_wds, uint16_t peer_id, uint8_t *peer_mac_addr, bool is_wds, uint16_t peer_id, uint8_t *peer_mac_addr,
struct dp_ast_flow_override_info *ast_info); struct dp_ast_flow_override_info *ast_info);
#endif #endif
/* /**
* dp_rx_tid_delete_cb() - Callback to flush reo descriptor HW cache * dp_rx_tid_delete_cb() - Callback to flush reo descriptor HW cache
* after deleting the entries (ie., setting valid=0) * after deleting the entries (ie., setting valid=0)
* *
@@ -852,10 +1053,37 @@ void dp_rx_tid_delete_cb(struct dp_soc *soc,
union hal_reo_status *reo_status); union hal_reo_status *reo_status);
#ifdef QCA_PEER_EXT_STATS #ifdef QCA_PEER_EXT_STATS
/**
* dp_peer_delay_stats_ctx_alloc() - Allocate peer delay stats content
* @soc: DP SoC context
* @txrx_peer: DP txrx peer context
*
* Allocate the peer delay stats context
*
* Return: QDF_STATUS_SUCCESS if allocation is
* successful
*/
QDF_STATUS dp_peer_delay_stats_ctx_alloc(struct dp_soc *soc, QDF_STATUS dp_peer_delay_stats_ctx_alloc(struct dp_soc *soc,
struct dp_txrx_peer *txrx_peer); struct dp_txrx_peer *txrx_peer);
/**
* dp_peer_delay_stats_ctx_dealloc() - Dealloc the peer delay stats context
* @soc: DP SoC context
* @txrx_peer: txrx DP peer context
*
* Free the peer delay stats context
*
* Return: Void
*/
void dp_peer_delay_stats_ctx_dealloc(struct dp_soc *soc, void dp_peer_delay_stats_ctx_dealloc(struct dp_soc *soc,
struct dp_txrx_peer *txrx_peer); struct dp_txrx_peer *txrx_peer);
/**
* dp_peer_delay_stats_ctx_clr() - Clear delay stats context of peer
* @txrx_peer: dp_txrx_peer handle
*
* Return: void
*/
void dp_peer_delay_stats_ctx_clr(struct dp_txrx_peer *txrx_peer); void dp_peer_delay_stats_ctx_clr(struct dp_txrx_peer *txrx_peer);
#else #else
static inline static inline
@@ -878,12 +1106,32 @@ void dp_peer_delay_stats_ctx_clr(struct dp_txrx_peer *txrx_peer)
#endif #endif
#ifdef WLAN_PEER_JITTER #ifdef WLAN_PEER_JITTER
/**
* dp_peer_jitter_stats_ctx_alloc() - Allocate jitter stats context for peer
* @pdev: Datapath pdev handle
* @txrx_peer: dp_txrx_peer handle
*
* Return: QDF_STATUS
*/
QDF_STATUS dp_peer_jitter_stats_ctx_alloc(struct dp_pdev *pdev, QDF_STATUS dp_peer_jitter_stats_ctx_alloc(struct dp_pdev *pdev,
struct dp_txrx_peer *txrx_peer); struct dp_txrx_peer *txrx_peer);
/**
* dp_peer_jitter_stats_ctx_dealloc() - Deallocate jitter stats context
* @pdev: Datapath pdev handle
* @txrx_peer: dp_txrx_peer handle
*
* Return: void
*/
void dp_peer_jitter_stats_ctx_dealloc(struct dp_pdev *pdev, void dp_peer_jitter_stats_ctx_dealloc(struct dp_pdev *pdev,
struct dp_txrx_peer *txrx_peer); struct dp_txrx_peer *txrx_peer);
/**
* dp_peer_jitter_stats_ctx_clr() - Clear jitter stats context of peer
* @txrx_peer: dp_txrx_peer handle
*
* Return: void
*/
void dp_peer_jitter_stats_ctx_clr(struct dp_txrx_peer *txrx_peer); void dp_peer_jitter_stats_ctx_clr(struct dp_txrx_peer *txrx_peer);
#else #else
static inline static inline
@@ -936,28 +1184,82 @@ QDF_STATUS dp_peer_sawf_stats_ctx_free(struct dp_soc *soc,
} }
#endif #endif
/**
* dp_vdev_bss_peer_ref_n_get: Get bss peer of a vdev
* @soc: DP soc
* @vdev: vdev
* @mod_id: id of module requesting reference
*
* Return: VDEV BSS peer
*/
struct dp_peer *dp_vdev_bss_peer_ref_n_get(struct dp_soc *soc, struct dp_peer *dp_vdev_bss_peer_ref_n_get(struct dp_soc *soc,
struct dp_vdev *vdev, struct dp_vdev *vdev,
enum dp_mod_id mod_id); enum dp_mod_id mod_id);
/**
* dp_sta_vdev_self_peer_ref_n_get: Get self peer of sta vdev
* @soc: DP soc
* @vdev: vdev
* @mod_id: id of module requesting reference
*
* Return: VDEV self peer
*/
struct dp_peer *dp_sta_vdev_self_peer_ref_n_get(struct dp_soc *soc, struct dp_peer *dp_sta_vdev_self_peer_ref_n_get(struct dp_soc *soc,
struct dp_vdev *vdev, struct dp_vdev *vdev,
enum dp_mod_id mod_id); enum dp_mod_id mod_id);
void dp_peer_ast_table_detach(struct dp_soc *soc); void dp_peer_ast_table_detach(struct dp_soc *soc);
/**
* dp_peer_find_map_detach() - cleanup memory for peer_id_to_obj_map
* @soc: soc handle
*
* Return: none
*/
void dp_peer_find_map_detach(struct dp_soc *soc); void dp_peer_find_map_detach(struct dp_soc *soc);
void dp_soc_wds_detach(struct dp_soc *soc); void dp_soc_wds_detach(struct dp_soc *soc);
QDF_STATUS dp_peer_ast_table_attach(struct dp_soc *soc); QDF_STATUS dp_peer_ast_table_attach(struct dp_soc *soc);
/**
* dp_peer_ast_hash_attach() - Allocate and initialize AST Hash Table
* @soc: SoC handle
*
* Return: QDF_STATUS
*/
QDF_STATUS dp_peer_ast_hash_attach(struct dp_soc *soc); QDF_STATUS dp_peer_ast_hash_attach(struct dp_soc *soc);
/**
* dp_peer_mec_hash_attach() - Allocate and initialize MEC Hash Table
* @soc: SoC handle
*
* Return: QDF_STATUS
*/
QDF_STATUS dp_peer_mec_hash_attach(struct dp_soc *soc); QDF_STATUS dp_peer_mec_hash_attach(struct dp_soc *soc);
void dp_soc_wds_attach(struct dp_soc *soc); void dp_soc_wds_attach(struct dp_soc *soc);
/**
* dp_peer_mec_hash_detach() - Free MEC Hash table
* @soc: SoC handle
*
* Return: None
*/
void dp_peer_mec_hash_detach(struct dp_soc *soc); void dp_peer_mec_hash_detach(struct dp_soc *soc);
/**
* dp_peer_ast_hash_detach() - Free AST Hash table
* @soc: SoC handle
*
* Return: None
*/
void dp_peer_ast_hash_detach(struct dp_soc *soc); void dp_peer_ast_hash_detach(struct dp_soc *soc);
#ifdef FEATURE_AST #ifdef FEATURE_AST
/* /**
* dp_peer_delete_ast_entries(): Delete all AST entries for a peer * dp_peer_delete_ast_entries(): Delete all AST entries for a peer
* @soc - datapath soc handle * @soc: datapath soc handle
* @peer - datapath peer handle * @peer: datapath peer handle
* *
* Delete the AST entries belonging to a peer * Delete the AST entries belonging to a peer
*/ */
@@ -982,6 +1284,14 @@ static inline void dp_peer_delete_ast_entries(struct dp_soc *soc,
dp_peer_del_ast(soc, ast_entry); dp_peer_del_ast(soc, ast_entry);
} }
/**
* dp_print_peer_ast_entries() - Dump AST entries of peer
* @soc: Datapath soc handle
* @peer: Datapath peer
* @arg: argument to iterate function
*
* Return: void
*/
void dp_print_peer_ast_entries(struct dp_soc *soc, struct dp_peer *peer, void dp_print_peer_ast_entries(struct dp_soc *soc, struct dp_peer *peer,
void *arg); void *arg);
#else #else
@@ -1037,7 +1347,7 @@ static inline void dp_peer_mec_flush_entries(struct dp_soc *soc)
#ifdef DUMP_REO_QUEUE_INFO_IN_DDR #ifdef DUMP_REO_QUEUE_INFO_IN_DDR
/** /**
* dp_send_cache_flush_for_rx_tid() - Send cache flush cmd to REO per tid * dp_send_cache_flush_for_rx_tid() - Send cache flush cmd to REO per tid
* @soc : dp_soc handle * @soc: dp_soc handle
* @peer: peer * @peer: peer
* *
* This function is used to send cache flush cmd to reo and * This function is used to send cache flush cmd to reo and
@@ -1051,7 +1361,7 @@ void dp_send_cache_flush_for_rx_tid(
/** /**
* dp_get_rx_reo_queue_info() - Handler to get rx tid info * dp_get_rx_reo_queue_info() - Handler to get rx tid info
* @soc : cdp_soc_t handle * @soc_hdl: cdp_soc_t handle
* @vdev_id: vdev id * @vdev_id: vdev id
* *
* Handler to get rx tid info from DDR after h/w cache is * Handler to get rx tid info from DDR after h/w cache is
@@ -1064,8 +1374,8 @@ void dp_get_rx_reo_queue_info(
/** /**
* dp_dump_rx_reo_queue_info() - Callback function to dump reo queue stats * dp_dump_rx_reo_queue_info() - Callback function to dump reo queue stats
* @soc : dp_soc handle * @soc: dp_soc handle
* @cb_ctxt - callback context * @cb_ctxt: callback context
* @reo_status: vdev id * @reo_status: vdev id
* *
* This is the callback function registered after sending the reo cmd * This is the callback function registered after sending the reo cmd
@@ -1177,7 +1487,7 @@ dp_link_peer_hash_find_by_chip_id(struct dp_soc *soc,
} }
#endif #endif
/* /**
* dp_mld_peer_find_hash_find() - returns mld peer from mld peer_hash_table * dp_mld_peer_find_hash_find() - returns mld peer from mld peer_hash_table
* matching mac_address * matching mac_address
* @soc: soc handle * @soc: soc handle
@@ -1186,7 +1496,7 @@ dp_link_peer_hash_find_by_chip_id(struct dp_soc *soc,
* @vdev_id: vdev_id * @vdev_id: vdev_id
* @mod_id: id of module requesting reference * @mod_id: id of module requesting reference
* *
* return: peer in sucsess * Return: peer in sucsess
* NULL in failure * NULL in failure
*/ */
static inline static inline
@@ -1206,7 +1516,7 @@ struct dp_peer *dp_mld_peer_find_hash_find(struct dp_soc *soc,
/** /**
* dp_peer_hash_find_wrapper() - find link peer or mld per according to * dp_peer_hash_find_wrapper() - find link peer or mld per according to
peer_type * peer_type
* @soc: DP SOC handle * @soc: DP SOC handle
* @peer_info: peer information for hash find * @peer_info: peer information for hash find
* @mod_id: ID of module requesting reference * @mod_id: ID of module requesting reference
@@ -1241,7 +1551,7 @@ struct dp_peer *dp_peer_hash_find_wrapper(struct dp_soc *soc,
/** /**
* dp_link_peer_add_mld_peer() - add mld peer pointer to link peer, * dp_link_peer_add_mld_peer() - add mld peer pointer to link peer,
increase mld peer ref_cnt * increase mld peer ref_cnt
* @link_peer: link peer pointer * @link_peer: link peer pointer
* @mld_peer: mld peer pointer * @mld_peer: mld peer pointer
* *
@@ -1258,7 +1568,7 @@ void dp_link_peer_add_mld_peer(struct dp_peer *link_peer,
/** /**
* dp_link_peer_del_mld_peer() - delete mld peer pointer from link peer, * dp_link_peer_del_mld_peer() - delete mld peer pointer from link peer,
decrease mld peer ref_cnt * decrease mld peer ref_cnt
* @link_peer: link peer pointer * @link_peer: link peer pointer
* *
* Return: None * Return: None
@@ -1403,7 +1713,7 @@ uint8_t dp_mld_peer_del_link_peer(struct dp_peer *mld_peer,
/** /**
* dp_get_link_peers_ref_from_mld_peer() - get link peers pointer and * dp_get_link_peers_ref_from_mld_peer() - get link peers pointer and
increase link peers ref_cnt * increase link peers ref_cnt
* @soc: dp_soc handle * @soc: dp_soc handle
* @mld_peer: dp mld peer pointer * @mld_peer: dp mld peer pointer
* @mld_link_peers: structure that hold links peers pointer array and number * @mld_link_peers: structure that hold links peers pointer array and number
@@ -1521,7 +1831,7 @@ uint16_t dp_get_link_peer_id_by_lmac_id(struct dp_soc *soc, uint16_t peer_id,
/** /**
* dp_peer_get_tgt_peer_hash_find() - get dp_peer handle * dp_peer_get_tgt_peer_hash_find() - get dp_peer handle
* @soc: soc handle * @soc: soc handle
* @peer_mac_addr: peer mac address * @peer_mac: peer mac address
* @mac_addr_is_aligned: is mac addr aligned * @mac_addr_is_aligned: is mac addr aligned
* @vdev_id: vdev_id * @vdev_id: vdev_id
* @mod_id: id of module requesting reference * @mod_id: id of module requesting reference
@@ -1529,7 +1839,7 @@ uint16_t dp_get_link_peer_id_by_lmac_id(struct dp_soc *soc, uint16_t peer_id,
* for MLO connection, get corresponding MLD peer, * for MLO connection, get corresponding MLD peer,
* otherwise get link peer for non-MLO case. * otherwise get link peer for non-MLO case.
* *
* return: peer in success * Return: peer in success
* NULL in failure * NULL in failure
*/ */
static inline static inline
@@ -1570,14 +1880,14 @@ struct dp_peer *dp_peer_get_tgt_peer_hash_find(struct dp_soc *soc,
/** /**
* dp_peer_get_tgt_peer_by_id() - Returns target peer object given the peer id * dp_peer_get_tgt_peer_by_id() - Returns target peer object given the peer id
* @soc : core DP soc context * @soc: core DP soc context
* @peer_id : peer id from peer object can be retrieved * @peer_id: peer id from peer object can be retrieved
* @mod_id : ID of module requesting reference * @mod_id: ID of module requesting reference
* *
* for MLO connection, get corresponding MLD peer, * for MLO connection, get corresponding MLD peer,
* otherwise get link peer for non-MLO case. * otherwise get link peer for non-MLO case.
* *
* return: peer in success * Return: peer in success
* NULL in failure * NULL in failure
*/ */
static inline static inline
@@ -1637,8 +1947,9 @@ void dp_peer_mlo_delete(struct dp_peer *peer)
/** /**
* dp_peer_mlo_setup() - create MLD peer and MLO related initialization * dp_peer_mlo_setup() - create MLD peer and MLO related initialization
* @soc: Soc handle * @soc: Soc handle
* @peer: DP peer handle
* @vdev_id: Vdev ID * @vdev_id: Vdev ID
* @peer_setup_info: peer setup information for MLO * @setup_info: peer setup information for MLO
*/ */
QDF_STATUS dp_peer_mlo_setup( QDF_STATUS dp_peer_mlo_setup(
struct dp_soc *soc, struct dp_soc *soc,
@@ -1747,10 +2058,10 @@ bool dp_peer_is_primary_link_peer(struct dp_peer *peer)
/** /**
* dp_tgt_txrx_peer_get_ref_by_id() - Gets tgt txrx peer for given the peer id * dp_tgt_txrx_peer_get_ref_by_id() - Gets tgt txrx peer for given the peer id
* *
* @soc : core DP soc context * @soc: core DP soc context
* @peer_id : peer id from peer object can be retrieved * @peer_id: peer id from peer object can be retrieved
* @handle : reference handle * @handle: reference handle
* @mod_id : ID of module requesting reference * @mod_id: ID of module requesting reference
* *
* Return: struct dp_txrx_peer*: Pointer to txrx DP peer object * Return: struct dp_txrx_peer*: Pointer to txrx DP peer object
*/ */
@@ -1781,7 +2092,7 @@ dp_tgt_txrx_peer_get_ref_by_id(struct dp_soc *soc,
/** /**
* dp_print_mlo_ast_stats_be() - Print AST stats for MLO peers * dp_print_mlo_ast_stats_be() - Print AST stats for MLO peers
* *
* @soc : core DP soc context * @soc: core DP soc context
* *
* Return: void * Return: void
*/ */
@@ -1912,10 +2223,10 @@ bool dp_peer_is_primary_link_peer(struct dp_peer *peer)
/** /**
* dp_tgt_txrx_peer_get_ref_by_id() - Gets tgt txrx peer for given the peer id * dp_tgt_txrx_peer_get_ref_by_id() - Gets tgt txrx peer for given the peer id
* *
* @soc : core DP soc context * @soc: core DP soc context
* @peer_id : peer id from peer object can be retrieved * @peer_id: peer id from peer object can be retrieved
* @handle : reference handle * @handle: reference handle
* @mod_id : ID of module requesting reference * @mod_id: ID of module requesting reference
* *
* Return: struct dp_txrx_peer*: Pointer to txrx DP peer object * Return: struct dp_txrx_peer*: Pointer to txrx DP peer object
*/ */
@@ -2041,9 +2352,9 @@ void dp_peer_rx_bufq_resources_deinit(struct dp_txrx_peer *txrx_peer)
/** /**
* dp_peer_update_state() - update dp peer state * dp_peer_update_state() - update dp peer state
* *
* @soc : core DP soc context * @soc: core DP soc context
* @peer : DP peer * @peer: DP peer
* @state : new state * @state: new state
* *
* Return: None * Return: None
*/ */