mirror of
https://github.com/torvalds/linux.git
synced 2024-11-27 22:51:35 +00:00
2703bc8513
make htmldocs warns: Documentation/driver-api/80211/mac80211:109: ./include/net/mac80211.h:5170: WARNING: Duplicate C declaration, also defined at mac80211:1117. Declaration is '.. c:function:: void ieee80211_tx_status (struct ieee80211_hw *hw, struct sk_buff *skb)'. This is because there's a function named ieee80211_tx_status() and a struct named ieee80211_tx_status. This has been discussed previously but no solution found: https://lore.kernel.org/all/20220521114629.6ee9fc06@coco.lan/ There's also a bug open for three years with no solution in sight: https://github.com/sphinx-doc/sphinx/pull/8313 So I guess we have no other solution than to a workaround this in the code, for example to rename the function to ieee80211_tx_status_skb() to avoid the name conflict. I got the idea for the name from ieee80211_tx_status_noskb() in which the skb is not provided as an argument, instead with ieee80211_tx_status_skb() the skb is provided. Compile tested only. Signed-off-by: Kalle Valo <quic_kvalo@quicinc.com> Link: https://lore.kernel.org/r/20231012114229.2931808-2-kvalo@kernel.org Signed-off-by: Johannes Berg <johannes.berg@intel.com>
156 lines
3.7 KiB
ReStructuredText
156 lines
3.7 KiB
ReStructuredText
===========================
|
|
mac80211 subsystem (basics)
|
|
===========================
|
|
|
|
You should read and understand the information contained within this
|
|
part of the book while implementing a mac80211 driver. In some chapters,
|
|
advanced usage is noted, those may be skipped if this isn't needed.
|
|
|
|
This part of the book only covers station and monitor mode
|
|
functionality, additional information required to implement the other
|
|
modes is covered in the second part of the book.
|
|
|
|
Basic hardware handling
|
|
=======================
|
|
|
|
TBD
|
|
|
|
This chapter shall contain information on getting a hw struct allocated
|
|
and registered with mac80211.
|
|
|
|
Since it is required to allocate rates/modes before registering a hw
|
|
struct, this chapter shall also contain information on setting up the
|
|
rate/mode structs.
|
|
|
|
Additionally, some discussion about the callbacks and the general
|
|
programming model should be in here, including the definition of
|
|
ieee80211_ops which will be referred to a lot.
|
|
|
|
Finally, a discussion of hardware capabilities should be done with
|
|
references to other parts of the book.
|
|
|
|
.. kernel-doc:: include/net/mac80211.h
|
|
:functions:
|
|
ieee80211_hw
|
|
ieee80211_hw_flags
|
|
SET_IEEE80211_DEV
|
|
SET_IEEE80211_PERM_ADDR
|
|
ieee80211_ops
|
|
ieee80211_alloc_hw
|
|
ieee80211_register_hw
|
|
ieee80211_unregister_hw
|
|
ieee80211_free_hw
|
|
|
|
PHY configuration
|
|
=================
|
|
|
|
TBD
|
|
|
|
This chapter should describe PHY handling including start/stop callbacks
|
|
and the various structures used.
|
|
|
|
.. kernel-doc:: include/net/mac80211.h
|
|
:functions:
|
|
ieee80211_conf
|
|
ieee80211_conf_flags
|
|
|
|
Virtual interfaces
|
|
==================
|
|
|
|
TBD
|
|
|
|
This chapter should describe virtual interface basics that are relevant
|
|
to the driver (VLANs, MGMT etc are not.) It should explain the use of
|
|
the add_iface/remove_iface callbacks as well as the interface
|
|
configuration callbacks.
|
|
|
|
Things related to AP mode should be discussed there.
|
|
|
|
Things related to supporting multiple interfaces should be in the
|
|
appropriate chapter, a BIG FAT note should be here about this though and
|
|
the recommendation to allow only a single interface in STA mode at
|
|
first!
|
|
|
|
.. kernel-doc:: include/net/mac80211.h
|
|
:functions: ieee80211_vif
|
|
|
|
Receive and transmit processing
|
|
===============================
|
|
|
|
what should be here
|
|
-------------------
|
|
|
|
TBD
|
|
|
|
This should describe the receive and transmit paths in mac80211/the
|
|
drivers as well as transmit status handling.
|
|
|
|
Frame format
|
|
------------
|
|
|
|
.. kernel-doc:: include/net/mac80211.h
|
|
:doc: Frame format
|
|
|
|
Packet alignment
|
|
----------------
|
|
|
|
.. kernel-doc:: net/mac80211/rx.c
|
|
:doc: Packet alignment
|
|
|
|
Calling into mac80211 from interrupts
|
|
-------------------------------------
|
|
|
|
.. kernel-doc:: include/net/mac80211.h
|
|
:doc: Calling mac80211 from interrupts
|
|
|
|
functions/definitions
|
|
---------------------
|
|
|
|
.. kernel-doc:: include/net/mac80211.h
|
|
:functions:
|
|
ieee80211_rx_status
|
|
mac80211_rx_encoding_flags
|
|
mac80211_rx_flags
|
|
mac80211_tx_info_flags
|
|
mac80211_tx_control_flags
|
|
mac80211_rate_control_flags
|
|
ieee80211_tx_rate
|
|
ieee80211_tx_info
|
|
ieee80211_tx_info_clear_status
|
|
ieee80211_rx
|
|
ieee80211_rx_ni
|
|
ieee80211_rx_irqsafe
|
|
ieee80211_tx_status_skb
|
|
ieee80211_tx_status_ni
|
|
ieee80211_tx_status_irqsafe
|
|
ieee80211_rts_get
|
|
ieee80211_rts_duration
|
|
ieee80211_ctstoself_get
|
|
ieee80211_ctstoself_duration
|
|
ieee80211_generic_frame_duration
|
|
ieee80211_wake_queue
|
|
ieee80211_stop_queue
|
|
ieee80211_wake_queues
|
|
ieee80211_stop_queues
|
|
ieee80211_queue_stopped
|
|
|
|
Frame filtering
|
|
===============
|
|
|
|
.. kernel-doc:: include/net/mac80211.h
|
|
:doc: Frame filtering
|
|
|
|
.. kernel-doc:: include/net/mac80211.h
|
|
:functions: ieee80211_filter_flags
|
|
|
|
The mac80211 workqueue
|
|
======================
|
|
|
|
.. kernel-doc:: include/net/mac80211.h
|
|
:doc: mac80211 workqueue
|
|
|
|
.. kernel-doc:: include/net/mac80211.h
|
|
:functions:
|
|
ieee80211_queue_work
|
|
ieee80211_queue_delayed_work
|