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

qcacld-3.0: Fix Packet Capture Documentation

Browse Source 
The kernel-doc script identified a multitude of documentation issues
in components/pkt_capture, so fix them.

Change-Id: I9fc7922978cbfacf3f8a733561dd0f94c6cea3b4
CRs-Fixed: 3359684
This commit is contained in:
Jeff Johnson
2022-12-13 13:17:58 -08:00
committed by Madan Koyyalamudi
parent 4ba68cd451
commit 139cf10b44
9 changed files with 79 additions and 109 deletions
Download Patch File Download Diff File Expand all files Collapse all files

42
components/pkt_capture/dispatcher/inc/wlan_pkt_capture_public_structs.h
View File

@@ -1,6 +1,6 @@
/*
* Copyright (c) 2020-2021 The Linux Foundation. All rights reserved.
* Copyright (c) 2021 Qualcomm Innovation Center, Inc. All rights reserved.
* Copyright (c) 2021-2022 Qualcomm Innovation Center, Inc. All rights reserved.
*
* Permission to use, copy, modify, and/or distribute this software for
* any purpose with or without fee is hereby granted, provided that the
@@ -40,12 +40,12 @@ enum pkt_capture_mode {
* enum pkt_capture_config - packet capture config
* @PACKET_CAPTURE_CONFIG_TRIGGER_ENABLE: enable capture for trigger frames only
* @PACKET_CAPTURE_CONFIG_QOS_ENABLE: enable capture for qos frames only
* @PACKET_CAPTURE_CONFIG_CONNECT_NO_BEACON_ENABLE: drop all beacons, when
* device in connected state
* @PACKET_CAPTURE_CONFIG_CONNECT_BEACON_ENABLE: enable only connected BSSID
* @PACKET_CAPTURE_CONFIG_BEACON_ENABLE: enable only connected BSSID
* beacons, when device in connected state
* @PACKET_CAPTURE_CONFIG_CONNECT_OFF_CHANNEL_BEACON_ENABLE: enable off channel
* @PACKET_CAPTURE_CONFIG_OFF_CHANNEL_BEACON_ENABLE: enable off channel
* beacons, when device in connected state
* @PACKET_CAPTURE_CONFIG_NO_BEACON_ENABLE: drop all beacons, when
* device in connected state
*/
enum pkt_capture_config {
PACKET_CAPTURE_CONFIG_TRIGGER_ENABLE = BIT(0),
@@ -99,6 +99,7 @@ struct pkt_capture_callbacks {
* pointers for packet capture component
* @pkt_capture_send_mode: send packet capture mode
* @pkt_capture_send_config: send packet capture config
* @pkt_capture_send_beacon_interval: send beacon interval
*
*/
struct wlan_pkt_capture_tx_ops {
@@ -135,8 +136,26 @@ struct wlan_pkt_capture_rx_ops {
};
/**
* pkt_capture_data_frame_type - Represent the various
* enum pkt_capture_data_frame_type - Represent the various
* data types to be filtered in packet capture.
* @PKT_CAPTURE_DATA_FRAME_TYPE_ALL:
* @PKT_CAPTURE_DATA_FRAME_TYPE_ARP:
* @PKT_CAPTURE_DATA_FRAME_TYPE_DHCPV4:
* @PKT_CAPTURE_DATA_FRAME_TYPE_DHCPV6:
* @PKT_CAPTURE_DATA_FRAME_TYPE_EAPOL:
* @PKT_CAPTURE_DATA_FRAME_TYPE_DNSV4:
* @PKT_CAPTURE_DATA_FRAME_TYPE_DNSV6:
* @PKT_CAPTURE_DATA_FRAME_TYPE_TCP_SYN:
* @PKT_CAPTURE_DATA_FRAME_TYPE_TCP_SYNACK:
* @PKT_CAPTURE_DATA_FRAME_TYPE_TCP_FIN:
* @PKT_CAPTURE_DATA_FRAME_TYPE_TCP_FINACK:
* @PKT_CAPTURE_DATA_FRAME_TYPE_TCP_ACK:
* @PKT_CAPTURE_DATA_FRAME_TYPE_TCP_RST:
* @PKT_CAPTURE_DATA_FRAME_TYPE_ICMPV4:
* @PKT_CAPTURE_DATA_FRAME_TYPE_ICMPV6:
* @PKT_CAPTURE_DATA_FRAME_TYPE_RTP:
* @PKT_CAPTURE_DATA_FRAME_TYPE_SIP:
* @PKT_CAPTURE_DATA_FRAME_QOS_NULL:
*/
enum pkt_capture_data_frame_type {
PKT_CAPTURE_DATA_FRAME_TYPE_ALL = BIT(0),
@@ -161,14 +180,14 @@ enum pkt_capture_data_frame_type {
};
/**
* pkt_capture_mgmt_frame_type - Represent the various
* enum pkt_capture_mgmt_frame_type - Represent the various
* mgmt types to be sent over the monitor interface.
* @PKT_CAPTURE_MGMT_FRAME_TYPE_ALL: All the MGMT Frames.
* @PKT_CAPTURE_MGMT_CONNECT_NO_BEACON: All the MGMT Frames
* except the Beacons. Valid only in the Connect state.
* @PKT_CAPTURE_MGMT_CONNECT_BEACON: Only the connected
* BSSID Beacons. Valid only in the Connect state.
* @PKT_CAPTURE_MONITOR_MGMT_CONNECT_SCAN_BEACON: Represents
* @PKT_CAPTURE_MGMT_CONNECT_SCAN_BEACON: Represents
* the Beacons obtained during the scan (off channel and connected channel)
* when in connected state.
*/
@@ -182,7 +201,7 @@ enum pkt_capture_mgmt_frame_type {
};
/**
* pkt_capture_ctrl_frame_type - Represent the various
* enum pkt_capture_ctrl_frame_type - Represent the various
* ctrl types to be sent over the monitor interface.
* @PKT_CAPTURE_CTRL_FRAME_TYPE_ALL: All the ctrl Frames.
* @PKT_CAPTURE_CTRL_TRIGGER_FRAME: Trigger Frame.
@@ -198,6 +217,8 @@ enum pkt_capture_ctrl_frame_type {
* vendor command QCA_NL80211_VENDOR_SUBCMD_SET_MONITOR_MODE to set the
* monitor mode.
*
* @PKT_CAPTURE_ATTR_SET_MONITOR_MODE_INVALID: Invalid value
*
* @PKT_CAPTURE_ATTR_SET_MONITOR_MODE_DATA_TX_FRAME_TYPE: u32 attribute,
* Represents the tx data packet type to be monitored (u32). These data packets
* are represented by enum pkt_capture_data_frame_type.
@@ -226,6 +247,9 @@ enum pkt_capture_ctrl_frame_type {
* An interval only for the connected beacon interval, which expects that the
* connected BSSID's beacons shall be sent on the monitor interface only on this
* specific interval.
*
* @PKT_CAPTURE_ATTR_SET_MONITOR_MODE_AFTER_LAST: Internal use
* @PKT_CAPTURE_ATTR_SET_MONITOR_MODE_MAX: Value of last valid enumeration
*/
enum pkt_capture_attr_set_monitor_mode {
PKT_CAPTURE_ATTR_SET_MONITOR_MODE_INVALID = 0,

21
components/pkt_capture/dispatcher/inc/wlan_pkt_capture_ucfg_api.h
View File

@@ -1,5 +1,6 @@
/*
* Copyright (c) 2020-2021 The Linux Foundation. All rights reserved.
* Copyright (c) 2022 Qualcomm Innovation Center, Inc. All rights reserved.
*
* Permission to use, copy, modify, and/or distribute this software for
* any purpose with or without fee is hereby granted, provided that the
@@ -63,7 +64,7 @@ ucfg_pkt_capture_get_mode(struct wlan_objmgr_psoc *psoc);
/**
* ucfg_pkt_capture_suspend_mon_thread() - suspend packet capture mon thread
* vdev: pointer to vdev object manager
* @vdev: pointer to vdev object manager
*
* Return: 0 on success, -EINVAL on failure
*/
@@ -71,7 +72,7 @@ int ucfg_pkt_capture_suspend_mon_thread(struct wlan_objmgr_vdev *vdev);
/**
* ucfg_pkt_capture_resume_mon_thread() - resume packet capture mon thread
* vdev: pointer to vdev object manager
* @vdev: pointer to vdev object manager
*
* Resume packet capture MON thread by completing RX thread resume event
*
@@ -82,8 +83,8 @@ void ucfg_pkt_capture_resume_mon_thread(struct wlan_objmgr_vdev *vdev);
/**
* ucfg_pkt_capture_register_callbacks - Register packet capture callbacks
* @vdev: pointer to wlan vdev object manager
* mon_cb: callback to call
* context: callback context
* @mon_cb: callback to call
* @context: callback context
*
* Return: QDF_STATUS
*/
@@ -102,9 +103,9 @@ QDF_STATUS
ucfg_pkt_capture_deregister_callbacks(struct wlan_objmgr_vdev *vdev);
/**
* ucfg_pkt_capturee_set_pktcap_mode - Set packet capture mode
* ucfg_pkt_capture_set_pktcap_mode - Set packet capture mode
* @psoc: pointer to psoc object
* @mode: mode to be set
* @val: mode to be set
*
* Return: None
*/
@@ -121,7 +122,7 @@ enum pkt_capture_mode
ucfg_pkt_capture_get_pktcap_mode(struct wlan_objmgr_psoc *psoc);
/**
* ucfg_pkt_capturee_set_pktcap_config - Set packet capture config
* ucfg_pkt_capture_set_pktcap_config - Set packet capture config
* @vdev: pointer to vdev object
* @config: config to be set
*
@@ -251,7 +252,7 @@ struct htt_tx_data_hdr_information *ucfg_pkt_capture_tx_get_txcomplete_data_hdr(
* @type: data process type
* @tid: tid number
* @status: Tx status
* @pktformat: Frame format
* @pkt_format: Frame format
* @bssid: bssid
* @pdev: pdev handle
* @tx_retry_cnt: tx retry count
@@ -276,7 +277,7 @@ void ucfg_pkt_capture_tx_completion_process(
void ucfg_pkt_capture_record_channel(struct wlan_objmgr_vdev *vdev);
/**
* ucfg_pkt_capture_register_callbacks - ucfg API to register WMA callbacks
* ucfg_pkt_capture_register_wma_callbacks - ucfg API to register WMA callbacks
* @psoc: pointer to psoc object
* @cb_obj: Pointer to packet capture callback structure
*
@@ -287,7 +288,7 @@ ucfg_pkt_capture_register_wma_callbacks(struct wlan_objmgr_psoc *psoc,
struct pkt_capture_callbacks *cb_obj);
/**
* ucfg_pkt_capture_set_filter ucfg API to set frame filter
* ucfg_pkt_capture_set_filter() - ucfg API to set frame filter
* @frame_filter: pkt capture frame filter data
* @vdev: pointer to vdev
*

68
components/pkt_capture/dispatcher/src/wlan_pkt_capture_ucfg_api.c
View File

@@ -1,6 +1,6 @@
/*
* Copyright (c) 2020-2021 The Linux Foundation. All rights reserved.
* Copyright (c) 2021 Qualcomm Innovation Center, Inc. All rights reserved.
* Copyright (c) 2021-2022 Qualcomm Innovation Center, Inc. All rights reserved.
*
* Permission to use, copy, modify, and/or distribute this software for
* any purpose with or without fee is hereby granted, provided that the
@@ -35,14 +35,6 @@ enum pkt_capture_mode ucfg_pkt_capture_get_mode(struct wlan_objmgr_psoc *psoc)
return pkt_capture_get_mode(psoc);
}
/**
* ucfg_pkt_capture_register_callbacks - Register packet capture callbacks
* @vdev: pointer to wlan vdev object manager
* mon_cb: callback to call
* context: callback context
*
* Return: 0 in case of success, invalid in case of failure.
*/
QDF_STATUS
ucfg_pkt_capture_register_callbacks(struct wlan_objmgr_vdev *vdev,
QDF_STATUS (*mon_cb)(void *, qdf_nbuf_t),
@@ -51,74 +43,35 @@ ucfg_pkt_capture_register_callbacks(struct wlan_objmgr_vdev *vdev,
return pkt_capture_register_callbacks(vdev, mon_cb, context);
}
/**
* ucfg_pkt_capture_deregister_callbacks - De-register packet capture callbacks
* @vdev: pointer to wlan vdev object manager
*
* Return: 0 in case of success, invalid in case of failure.
*/
QDF_STATUS ucfg_pkt_capture_deregister_callbacks(struct wlan_objmgr_vdev *vdev)
{
return pkt_capture_deregister_callbacks(vdev);
}
/**
* ucfg_pkt_capture_set_pktcap_mode - Set packet capture mode
* @psoc: pointer to psoc object
* @mode: mode to be set
*
* Return: None
*/
void ucfg_pkt_capture_set_pktcap_mode(struct wlan_objmgr_psoc *psoc,
enum pkt_capture_mode mode)
{
pkt_capture_set_pktcap_mode(psoc, mode);
}
/**
* ucfg_pkt_capture_get_pktcap_mode - Get packet capture mode
* @psoc: pointer to psoc object
*
* Return: enum pkt_capture_mode
*/
enum pkt_capture_mode
ucfg_pkt_capture_get_pktcap_mode(struct wlan_objmgr_psoc *psoc)
{
return pkt_capture_get_pktcap_mode(psoc);
}
/**
* ucfg_pkt_capture_set_pktcap_config - Set packet capture config
* @vdev: pointer to vdev object
* @config: config to be set
*
* Return: None
*/
void ucfg_pkt_capture_set_pktcap_config(struct wlan_objmgr_vdev *vdev,
enum pkt_capture_config config)
{
pkt_capture_set_pktcap_config(vdev, config);
}
/**
* ucfg_pkt_capture_get_pktcap_config - Get packet capture config
* @vdev: pointer to vdev object
*
* Return: config value
*/
enum pkt_capture_config
ucfg_pkt_capture_get_pktcap_config(struct wlan_objmgr_vdev *vdev)
{
return pkt_capture_get_pktcap_config(vdev);
}
/**
* ucfg_pkt_capture_init() - Packet capture component initialization.
*
* This function gets called when packet capture initializing.
*
* Return: QDF_STATUS_SUCCESS - in case of success.
*/
QDF_STATUS ucfg_pkt_capture_init(void)
{
QDF_STATUS status;
@@ -215,15 +168,6 @@ void ucfg_pkt_capture_resume_mon_thread(struct wlan_objmgr_vdev *vdev)
pkt_capture_resume_mon_thread(vdev);
}
/**
* ucfg_process_pktcapture_mgmt_tx_data() - process management tx packets
* @pdev: pointer to pdev object
* @params: management offload event params
* @nbuf: netbuf
* @status: status
*
* Return: QDF_STATUS
*/
QDF_STATUS
ucfg_pkt_capture_process_mgmt_tx_data(struct wlan_objmgr_pdev *pdev,
struct mgmt_offload_event_params *params,
@@ -245,16 +189,6 @@ ucfg_pkt_capture_mgmt_tx(struct wlan_objmgr_pdev *pdev,
pkt_capture_mgmt_tx(pdev, nbuf, chan_freq, preamble_type);
}
/**
* ucfg_process_pktcapture_mgmt_tx_completion(): process mgmt tx completion
* for pkt capture mode
* @pdev: pointer to pdev object
* @desc_id: desc_id
* @status: status
* @params: management offload event params
*
* Return: none
*/
void
ucfg_pkt_capture_mgmt_tx_completion(struct wlan_objmgr_pdev *pdev,
uint32_t desc_id,