qcacld-3.0: Cleanup core/dp/txrx/ol_rx_fwd.h

Prototypes ol_rx_fwd_mcast_check_ap() and ol_rx_fwd_mcast_check_sta()
were part of the initial driver snapshot, but there was never an
actual implementation of these functions, so remove the prototypes.

The prototype for ol_rx_fwd_check() uses a legacy documentation
template, and the prototype for ol_get_intra_bss_fwd_pkts_count() has
no documentation, so make sure both of these have proper kernel-doc
documentation.

Change-Id: I80a9c6f61631dd509b9029312b1e35c235ac2aa9
CRs-Fixed: 3428364

core/dp/txrx/ol_rx_fwd.h

@@ -1,5 +1,6 @@
 /*
  * Copyright (c) 2011, 2014-2017, 2019 The Linux Foundation. All rights reserved.
+ * Copyright (c) 2023 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
@@ -23,46 +24,46 @@
 
 #include <ol_txrx_api.h>        /* ol_txrx_peer_t, etc. */
 
-qdf_nbuf_t
-ol_rx_fwd_mcast_check_sta(struct ol_txrx_vdev_t *vdev,
-			  struct ol_txrx_peer_t *peer,
-			  qdf_nbuf_t msdu, void *rx_desc, int is_wlan_mcast);
-
-qdf_nbuf_t
-ol_rx_fwd_mcast_check_ap(struct ol_txrx_vdev_t *vdev,
-			 struct ol_txrx_peer_t *peer,
-			 qdf_nbuf_t msdu, void *rx_desc, int is_wlan_mcast);
-
 /**
- * @brief Check if rx frames should be transmitted over WLAN.
- * @details
- *  Check if rx frames should be transmitted back over WLAN, instead of
- *  or in addition to delivering the rx frames to the OS.
- *  Rx frames will be forwarded to the transmit path under the following
- *  conditions:
- *  1.  If the destination is a STA associated to the same virtual device
- *      within this physical device, the rx frame will be forwarded to the
- *      tx path rather than being sent to the OS.  If the destination is a
- *      STA associated to a different virtual device within this physical
- *      device, then the rx frame will optionally be forwarded to the tx path.
- *  2.  If the frame is received by an AP, but the destination is for another
- *      AP that the current AP is associated with for WDS forwarding, the
- *      intermediate AP will forward the rx frame to the tx path to transmit
- *      to send to the destination AP, rather than sending it to the OS.
- *  3.  If the AP receives a multicast frame, it will retransmit the frame
- *      within the BSS, in addition to sending the frame to the OS.
- *
- * @param vdev - which virtual device the frames were addressed to
- * @param peer - which peer the rx frames belong to
- * @param tid  - which TID within the peer the rx frames belong to
- * @param msdu_list - NULL-terminated list of MSDUs to perform the rx->tx
+ * ol_rx_fwd_check() - Check if rx frames should be transmitted over WLAN.
+ * @vdev: which virtual device the frames were addressed to
+ * @peer: which peer the rx frames belong to
+ * @tid: which TID within the peer the rx frames belong to
+ * @msdu_list: NULL-terminated list of MSDUs to perform the rx->tx
  *      forwarding check on
+ *
+ * Check if rx frames should be transmitted back over WLAN, instead of
+ * or in addition to delivering the rx frames to the OS.
+ * Rx frames will be forwarded to the transmit path under the following
+ * conditions:
+ * 1.  If the destination is a STA associated to the same virtual device
+ *     within this physical device, the rx frame will be forwarded to the
+ *     tx path rather than being sent to the OS.  If the destination is a
+ *     STA associated to a different virtual device within this physical
+ *     device, then the rx frame will optionally be forwarded to the tx path.
+ * 2.  If the frame is received by an AP, but the destination is for another
+ *     AP that the current AP is associated with for WDS forwarding, the
+ *     intermediate AP will forward the rx frame to the tx path to transmit
+ *     to send to the destination AP, rather than sending it to the OS.
+ * 3.  If the AP receives a multicast frame, it will retransmit the frame
+ *     within the BSS, in addition to sending the frame to the OS.
+ *
  */
 void
 ol_rx_fwd_check(struct ol_txrx_vdev_t *vdev,
 		struct ol_txrx_peer_t *peer,
 		unsigned int tid, qdf_nbuf_t msdu_list);
 
+/**
+ * ol_get_intra_bss_fwd_pkts_count() - to get the total tx and rx packets
+ *   that has been forwarded from txrx layer without going to upper layers.
+ * @soc_hdl: Datapath soc handle
+ * @vdev_id: vdev id
+ * @fwd_tx_packets: pointer to forwarded tx packets count parameter
+ * @fwd_rx_packets: pointer to forwarded rx packets count parameter
+ *
+ * Return: status -> A_OK - success, A_ERROR - failure
+ */
 A_STATUS
 ol_get_intra_bss_fwd_pkts_count(struct cdp_soc_t *soc_hdl,
 				uint8_t vdev_id,