nagai/kernel
3
0
Fork 0
forked from mirrors/linux
Code Pull requests Activity

net: reformat kdoc return statements

Browse source 
kernel-doc -Wall warns about missing Return: statement for non-void
functions. We have a number of kdocs in our headers which are missing
the colon, IOW they use
 * Return some value
or
 * Returns some value

Having the colon makes some sense, it should help kdoc parser avoid
false positives. So add them. This is mostly done with a sed script,
and removing the unnecessary cases (mostly the comments which aren't
kdoc).

Acked-by: Johannes Berg <johannes@sipsolutions.net>
Acked-by: Richard Cochran <richardcochran@gmail.com>
Acked-by: Sergey Ryazanov <ryazanov.s.a@gmail.com>
Reviewed-by: Edward Cree <ecree.xilinx@gmail.com>
Acked-by: Alexandra Winter <wintera@linux.ibm.com>
Acked-by: Pablo Neira Ayuso <pablo@netfilter.org>
Link: https://patch.msgid.link/20241205165914.1071102-1-kuba@kernel.org
Signed-off-by: Jakub Kicinski <kuba@kernel.org>
This commit is contained in:
Jakub Kicinski 2024-12-05 08:59:14 -08:00
parent ca78588805
commit 3f330db306
21 changed files with 101 additions and 101 deletions
repo.diff.show_diff_stats Download patch file Download diff file Expand all files Collapse all files

18
include/linux/etherdevice.h
View file

@ -81,7 +81,7 @@ static const u8 eth_ipv6_mcast_addr_base[ETH_ALEN] __aligned(2) =
* is_link_local_ether_addr - Determine if given Ethernet address is link-local * is_link_local_ether_addr - Determine if given Ethernet address is link-local
* @addr: Pointer to a six-byte array containing the Ethernet address * @addr: Pointer to a six-byte array containing the Ethernet address
* *
* Return true if address is link local reserved addr (01:80:c2:00:00:0X) per * Return: true if address is link local reserved addr (01:80:c2:00:00:0X) per
* IEEE 802.1Q 8.6.3 Frame filtering. * IEEE 802.1Q 8.6.3 Frame filtering.
* *
* Please note: addr must be aligned to u16. * Please note: addr must be aligned to u16.
@ -104,7 +104,7 @@ static inline bool is_link_local_ether_addr(const u8 *addr)
* is_zero_ether_addr - Determine if give Ethernet address is all zeros. * is_zero_ether_addr - Determine if give Ethernet address is all zeros.
* @addr: Pointer to a six-byte array containing the Ethernet address * @addr: Pointer to a six-byte array containing the Ethernet address
* *
* Return true if the address is all zeroes. * Return: true if the address is all zeroes.
* *
* Please note: addr must be aligned to u16. * Please note: addr must be aligned to u16.
*/ */
@ -123,7 +123,7 @@ static inline bool is_zero_ether_addr(const u8 *addr)
* is_multicast_ether_addr - Determine if the Ethernet address is a multicast. * is_multicast_ether_addr - Determine if the Ethernet address is a multicast.
* @addr: Pointer to a six-byte array containing the Ethernet address * @addr: Pointer to a six-byte array containing the Ethernet address
* *
* Return true if the address is a multicast address. * Return: true if the address is a multicast address.
* By definition the broadcast address is also a multicast address. * By definition the broadcast address is also a multicast address.
*/ */
static inline bool is_multicast_ether_addr(const u8 *addr) static inline bool is_multicast_ether_addr(const u8 *addr)
@ -157,7 +157,7 @@ static inline bool is_multicast_ether_addr_64bits(const u8 *addr)
* is_local_ether_addr - Determine if the Ethernet address is locally-assigned one (IEEE 802). * is_local_ether_addr - Determine if the Ethernet address is locally-assigned one (IEEE 802).
* @addr: Pointer to a six-byte array containing the Ethernet address * @addr: Pointer to a six-byte array containing the Ethernet address
* *
* Return true if the address is a local address. * Return: true if the address is a local address.
*/ */
static inline bool is_local_ether_addr(const u8 *addr) static inline bool is_local_ether_addr(const u8 *addr)
{ {
@ -168,7 +168,7 @@ static inline bool is_local_ether_addr(const u8 *addr)
* is_broadcast_ether_addr - Determine if the Ethernet address is broadcast * is_broadcast_ether_addr - Determine if the Ethernet address is broadcast
* @addr: Pointer to a six-byte array containing the Ethernet address * @addr: Pointer to a six-byte array containing the Ethernet address
* *
* Return true if the address is the broadcast address. * Return: true if the address is the broadcast address.
* *
* Please note: addr must be aligned to u16. * Please note: addr must be aligned to u16.
*/ */
@ -183,7 +183,7 @@ static inline bool is_broadcast_ether_addr(const u8 *addr)
* is_unicast_ether_addr - Determine if the Ethernet address is unicast * is_unicast_ether_addr - Determine if the Ethernet address is unicast
* @addr: Pointer to a six-byte array containing the Ethernet address * @addr: Pointer to a six-byte array containing the Ethernet address
* *
* Return true if the address is a unicast address. * Return: true if the address is a unicast address.
*/ */
static inline bool is_unicast_ether_addr(const u8 *addr) static inline bool is_unicast_ether_addr(const u8 *addr)
{ {
@ -197,7 +197,7 @@ static inline bool is_unicast_ether_addr(const u8 *addr)
* Check that the Ethernet address (MAC) is not 00:00:00:00:00:00, is not * Check that the Ethernet address (MAC) is not 00:00:00:00:00:00, is not
* a multicast address, and is not FF:FF:FF:FF:FF:FF. * a multicast address, and is not FF:FF:FF:FF:FF:FF.
* *
* Return true if the address is valid. * Return: true if the address is valid.
* *
* Please note: addr must be aligned to u16. * Please note: addr must be aligned to u16.
*/ */
@ -214,7 +214,7 @@ static inline bool is_valid_ether_addr(const u8 *addr)
* *
* Check that the value from the Ethertype/length field is a valid Ethertype. * Check that the value from the Ethertype/length field is a valid Ethertype.
* *
* Return true if the valid is an 802.3 supported Ethertype. * Return: true if the valid is an 802.3 supported Ethertype.
*/ */
static inline bool eth_proto_is_802_3(__be16 proto) static inline bool eth_proto_is_802_3(__be16 proto)
{ {
@ -458,7 +458,7 @@ static inline bool ether_addr_is_ip_mcast(const u8 *addr)
* ether_addr_to_u64 - Convert an Ethernet address into a u64 value. * ether_addr_to_u64 - Convert an Ethernet address into a u64 value.
* @addr: Pointer to a six-byte array containing the Ethernet address * @addr: Pointer to a six-byte array containing the Ethernet address
* *
* Return a u64 value of the address * Return: a u64 value of the address
*/ */
static inline u64 ether_addr_to_u64(const u8 *addr) static inline u64 ether_addr_to_u64(const u8 *addr)
{ {

6
include/linux/ethtool.h
View file

@ -257,7 +257,7 @@ struct ethtool_link_ksettings {
* @mode : one of the ETHTOOL_LINK_MODE_*_BIT * @mode : one of the ETHTOOL_LINK_MODE_*_BIT
* (not atomic, no bound checking) * (not atomic, no bound checking)
* *
* Returns true/false. * Returns: true/false.
*/ */
#define ethtool_link_ksettings_test_link_mode(ptr, name, mode) \ #define ethtool_link_ksettings_test_link_mode(ptr, name, mode) \
test_bit(ETHTOOL_LINK_MODE_ ## mode ## _BIT, (ptr)->link_modes.name) test_bit(ETHTOOL_LINK_MODE_ ## mode ## _BIT, (ptr)->link_modes.name)
@ -1199,7 +1199,7 @@ ethtool_params_from_link_mode(struct ethtool_link_ksettings *link_ksettings,
* @dev: pointer to net_device structure * @dev: pointer to net_device structure
* @vclock_index: pointer to pointer of vclock index * @vclock_index: pointer to pointer of vclock index
* *
* Return number of phc vclocks * Return: number of phc vclocks
*/ */
int ethtool_get_phc_vclocks(struct net_device *dev, int **vclock_index); int ethtool_get_phc_vclocks(struct net_device *dev, int **vclock_index);
@ -1253,7 +1253,7 @@ static inline int ethtool_mm_frag_size_min_to_add(u32 val_min, u32 *val_add,
* ethtool_get_ts_info_by_layer - Obtains time stamping capabilities from the MAC or PHY layer. * ethtool_get_ts_info_by_layer - Obtains time stamping capabilities from the MAC or PHY layer.
* @dev: pointer to net_device structure * @dev: pointer to net_device structure
* @info: buffer to hold the result * @info: buffer to hold the result
* Returns zero on success, non-zero otherwise. * Returns: zero on success, non-zero otherwise.
*/ */
int ethtool_get_ts_info_by_layer(struct net_device *dev, int ethtool_get_ts_info_by_layer(struct net_device *dev,
struct kernel_ethtool_ts_info *info); struct kernel_ethtool_ts_info *info);

28
include/linux/if_vlan.h
View file

@ -310,7 +310,7 @@ static inline bool vlan_uses_dev(const struct net_device *dev)
* eth_type_vlan - check for valid vlan ether type. * eth_type_vlan - check for valid vlan ether type.
* @ethertype: ether type to check * @ethertype: ether type to check
* *
* Returns true if the ether type is a vlan ether type. * Returns: true if the ether type is a vlan ether type.
*/ */
static inline bool eth_type_vlan(__be16 ethertype) static inline bool eth_type_vlan(__be16 ethertype)
{ {
@ -341,9 +341,9 @@ static inline bool vlan_hw_offload_capable(netdev_features_t features,
* @mac_len: MAC header length including outer vlan headers * @mac_len: MAC header length including outer vlan headers
* *
* Inserts the VLAN tag into @skb as part of the payload at offset mac_len * Inserts the VLAN tag into @skb as part of the payload at offset mac_len
* Returns error if skb_cow_head fails.
*
* Does not change skb->protocol so this function can be used during receive. * Does not change skb->protocol so this function can be used during receive.
*
* Returns: error if skb_cow_head fails.
*/ */
static inline int __vlan_insert_inner_tag(struct sk_buff *skb, static inline int __vlan_insert_inner_tag(struct sk_buff *skb,
__be16 vlan_proto, u16 vlan_tci, __be16 vlan_proto, u16 vlan_tci,
@ -390,9 +390,9 @@ static inline int __vlan_insert_inner_tag(struct sk_buff *skb,
* @vlan_tci: VLAN TCI to insert * @vlan_tci: VLAN TCI to insert
* *
* Inserts the VLAN tag into @skb as part of the payload * Inserts the VLAN tag into @skb as part of the payload
* Returns error if skb_cow_head fails.
*
* Does not change skb->protocol so this function can be used during receive. * Does not change skb->protocol so this function can be used during receive.
*
* Returns: error if skb_cow_head fails.
*/ */
static inline int __vlan_insert_tag(struct sk_buff *skb, static inline int __vlan_insert_tag(struct sk_buff *skb,
__be16 vlan_proto, u16 vlan_tci) __be16 vlan_proto, u16 vlan_tci)
@ -533,7 +533,7 @@ static inline void __vlan_hwaccel_put_tag(struct sk_buff *skb,
* @skb: skbuff to query * @skb: skbuff to query
* @vlan_tci: buffer to store value * @vlan_tci: buffer to store value
* *
* Returns error if the skb is not of VLAN type * Returns: error if the skb is not of VLAN type
*/ */
static inline int __vlan_get_tag(const struct sk_buff *skb, u16 *vlan_tci) static inline int __vlan_get_tag(const struct sk_buff *skb, u16 *vlan_tci)
{ {
@ -551,7 +551,7 @@ static inline int __vlan_get_tag(const struct sk_buff *skb, u16 *vlan_tci)
* @skb: skbuff to query * @skb: skbuff to query
* @vlan_tci: buffer to store value * @vlan_tci: buffer to store value
* *
* Returns error if @skb->vlan_tci is not set correctly * Returns: error if @skb->vlan_tci is not set correctly
*/ */
static inline int __vlan_hwaccel_get_tag(const struct sk_buff *skb, static inline int __vlan_hwaccel_get_tag(const struct sk_buff *skb,
u16 *vlan_tci) u16 *vlan_tci)
@ -570,7 +570,7 @@ static inline int __vlan_hwaccel_get_tag(const struct sk_buff *skb,
* @skb: skbuff to query * @skb: skbuff to query
* @vlan_tci: buffer to store value * @vlan_tci: buffer to store value
* *
* Returns error if the skb is not VLAN tagged * Returns: error if the skb is not VLAN tagged
*/ */
static inline int vlan_get_tag(const struct sk_buff *skb, u16 *vlan_tci) static inline int vlan_get_tag(const struct sk_buff *skb, u16 *vlan_tci)
{ {
@ -587,7 +587,7 @@ static inline int vlan_get_tag(const struct sk_buff *skb, u16 *vlan_tci)
* @type: first vlan protocol * @type: first vlan protocol
* @depth: buffer to store length of eth and vlan tags in bytes * @depth: buffer to store length of eth and vlan tags in bytes
* *
* Returns the EtherType of the packet, regardless of whether it is * Returns: the EtherType of the packet, regardless of whether it is
* vlan encapsulated (normal or hardware accelerated) or not. * vlan encapsulated (normal or hardware accelerated) or not.
*/ */
static inline __be16 __vlan_get_protocol(const struct sk_buff *skb, __be16 type, static inline __be16 __vlan_get_protocol(const struct sk_buff *skb, __be16 type,
@ -629,7 +629,7 @@ static inline __be16 __vlan_get_protocol(const struct sk_buff *skb, __be16 type,
* vlan_get_protocol - get protocol EtherType. * vlan_get_protocol - get protocol EtherType.
* @skb: skbuff to query * @skb: skbuff to query
* *
* Returns the EtherType of the packet, regardless of whether it is * Returns: the EtherType of the packet, regardless of whether it is
* vlan encapsulated (normal or hardware accelerated) or not. * vlan encapsulated (normal or hardware accelerated) or not.
*/ */
static inline __be16 vlan_get_protocol(const struct sk_buff *skb) static inline __be16 vlan_get_protocol(const struct sk_buff *skb)
@ -710,7 +710,7 @@ static inline void vlan_set_encap_proto(struct sk_buff *skb,
* Expects the skb to contain a VLAN tag in the payload, and to have skb->data * Expects the skb to contain a VLAN tag in the payload, and to have skb->data
* pointing at the MAC header. * pointing at the MAC header.
* *
* Returns a new pointer to skb->data, or NULL on failure to pull. * Returns: a new pointer to skb->data, or NULL on failure to pull.
*/ */
static inline void *vlan_remove_tag(struct sk_buff *skb, u16 *vlan_tci) static inline void *vlan_remove_tag(struct sk_buff *skb, u16 *vlan_tci)
{ {
@ -727,7 +727,7 @@ static inline void *vlan_remove_tag(struct sk_buff *skb, u16 *vlan_tci)
* skb_vlan_tagged - check if skb is vlan tagged. * skb_vlan_tagged - check if skb is vlan tagged.
* @skb: skbuff to query * @skb: skbuff to query
* *
* Returns true if the skb is tagged, regardless of whether it is hardware * Returns: true if the skb is tagged, regardless of whether it is hardware
* accelerated or not. * accelerated or not.
*/ */
static inline bool skb_vlan_tagged(const struct sk_buff *skb) static inline bool skb_vlan_tagged(const struct sk_buff *skb)
@ -743,7 +743,7 @@ static inline bool skb_vlan_tagged(const struct sk_buff *skb)
* skb_vlan_tagged_multi - check if skb is vlan tagged with multiple headers. * skb_vlan_tagged_multi - check if skb is vlan tagged with multiple headers.
* @skb: skbuff to query * @skb: skbuff to query
* *
* Returns true if the skb is tagged with multiple vlan headers, regardless * Returns: true if the skb is tagged with multiple vlan headers, regardless
* of whether it is hardware accelerated or not. * of whether it is hardware accelerated or not.
*/ */
static inline bool skb_vlan_tagged_multi(struct sk_buff *skb) static inline bool skb_vlan_tagged_multi(struct sk_buff *skb)
@ -774,7 +774,7 @@ static inline bool skb_vlan_tagged_multi(struct sk_buff *skb)
* @skb: skbuff to query * @skb: skbuff to query
* @features: features to be checked * @features: features to be checked
* *
* Returns features without unsafe ones if the skb has multiple tags. * Returns: features without unsafe ones if the skb has multiple tags.
*/ */
static inline netdev_features_t vlan_features_check(struct sk_buff *skb, static inline netdev_features_t vlan_features_check(struct sk_buff *skb,
netdev_features_t features) netdev_features_t features)

14
include/linux/netdevice.h
View file

@ -509,7 +509,7 @@ static inline bool napi_prefer_busy_poll(struct napi_struct *n)
* is scheduled for example in the context of delayed timer * is scheduled for example in the context of delayed timer
* that can be skipped if a NAPI is already scheduled. * that can be skipped if a NAPI is already scheduled.
* *
* Return True if NAPI is scheduled, False otherwise. * Return: True if NAPI is scheduled, False otherwise.
*/ */
static inline bool napi_is_scheduled(struct napi_struct *n) static inline bool napi_is_scheduled(struct napi_struct *n)
{ {
@ -524,7 +524,7 @@ bool napi_schedule_prep(struct napi_struct *n);
* *
* Schedule NAPI poll routine to be called if it is not already * Schedule NAPI poll routine to be called if it is not already
* running. * running.
* Return true if we schedule a NAPI or false if not. * Return: true if we schedule a NAPI or false if not.
* Refer to napi_schedule_prep() for additional reason on why * Refer to napi_schedule_prep() for additional reason on why
* a NAPI might not be scheduled. * a NAPI might not be scheduled.
*/ */
@ -558,7 +558,7 @@ static inline void napi_schedule_irqoff(struct napi_struct *n)
* Mark NAPI processing as complete. Should only be called if poll budget * Mark NAPI processing as complete. Should only be called if poll budget
* has not been completely consumed. * has not been completely consumed.
* Prefer over napi_complete(). * Prefer over napi_complete().
* Return false if device should avoid rearming interrupts. * Return: false if device should avoid rearming interrupts.
*/ */
bool napi_complete_done(struct napi_struct *n, int work_done); bool napi_complete_done(struct napi_struct *n, int work_done);
@ -3851,7 +3851,7 @@ static inline bool netif_attr_test_mask(unsigned long j,
* @online_mask: bitmask for CPUs/Rx queues that are online * @online_mask: bitmask for CPUs/Rx queues that are online
* @nr_bits: number of bits in the bitmask * @nr_bits: number of bits in the bitmask
* *
* Returns true if a CPU/Rx queue is online. * Returns: true if a CPU/Rx queue is online.
*/ */
static inline bool netif_attr_test_online(unsigned long j, static inline bool netif_attr_test_online(unsigned long j,
const unsigned long *online_mask, const unsigned long *online_mask,
@ -3871,7 +3871,8 @@ static inline bool netif_attr_test_online(unsigned long j,
* @srcp: the cpumask/Rx queue mask pointer * @srcp: the cpumask/Rx queue mask pointer
* @nr_bits: number of bits in the bitmask * @nr_bits: number of bits in the bitmask
* *
* Returns >= nr_bits if no further CPUs/Rx queues set. * Returns: next (after n) CPU/Rx queue index in the mask;
* >= nr_bits if no further CPUs/Rx queues set.
*/ */
static inline unsigned int netif_attrmask_next(int n, const unsigned long *srcp, static inline unsigned int netif_attrmask_next(int n, const unsigned long *srcp,
unsigned int nr_bits) unsigned int nr_bits)
@ -3893,7 +3894,8 @@ static inline unsigned int netif_attrmask_next(int n, const unsigned long *srcp,
* @src2p: the second CPUs/Rx queues mask pointer * @src2p: the second CPUs/Rx queues mask pointer
* @nr_bits: number of bits in the bitmask * @nr_bits: number of bits in the bitmask
* *
* Returns >= nr_bits if no further CPUs/Rx queues set in both. * Returns: next (after n) CPU/Rx queue index set in both masks;
* >= nr_bits if no further CPUs/Rx queues set in both.
*/ */
static inline int netif_attrmask_next_and(int n, const unsigned long *src1p, static inline int netif_attrmask_next_and(int n, const unsigned long *src1p,
const unsigned long *src2p, const unsigned long *src2p,

2
include/linux/netfilter/x_tables.h
View file

@ -357,7 +357,7 @@ extern struct static_key xt_tee_enabled;
* Begin packet processing : all readers must wait the end * Begin packet processing : all readers must wait the end
* 1) Must be called with preemption disabled * 1) Must be called with preemption disabled
* 2) softirqs must be disabled too (or we should use this_cpu_add()) * 2) softirqs must be disabled too (or we should use this_cpu_add())
* Returns : * Returns:
* 1 if no recursion on this cpu * 1 if no recursion on this cpu
* 0 if recursion detected * 0 if recursion detected
*/ */

3
include/linux/netfilter_netdev.h
View file

@ -66,7 +66,6 @@ static inline bool nf_hook_egress_active(void)
* @rc: result code which shall be returned by __dev_queue_xmit() on failure * @rc: result code which shall be returned by __dev_queue_xmit() on failure
* @dev: netdev whose egress hooks shall be applied to @skb * @dev: netdev whose egress hooks shall be applied to @skb
* *
* Returns @skb on success or %NULL if the packet was consumed or filtered.
* Caller must hold rcu_read_lock. * Caller must hold rcu_read_lock.
* *
* On ingress, packets are classified first by tc, then by netfilter. * On ingress, packets are classified first by tc, then by netfilter.
@ -81,6 +80,8 @@ static inline bool nf_hook_egress_active(void)
* called recursively by tunnel drivers such as vxlan, the flag is reverted to * called recursively by tunnel drivers such as vxlan, the flag is reverted to
* false after sch_handle_egress(). This ensures that netfilter is applied * false after sch_handle_egress(). This ensures that netfilter is applied
* both on the overlay and underlying network. * both on the overlay and underlying network.
*
* Returns: @skb on success or %NULL if the packet was consumed or filtered.
*/ */
static inline struct sk_buff *nf_hook_egress(struct sk_buff *skb, int *rc, static inline struct sk_buff *nf_hook_egress(struct sk_buff *skb, int *rc,
struct net_device *dev) struct net_device *dev)

4
include/linux/ptp_clock_kernel.h
View file

@ -307,7 +307,7 @@ static inline u64 adjust_by_scaled_ppm(u64 base, long scaled_ppm)
* @info: Structure describing the new clock. * @info: Structure describing the new clock.
* @parent: Pointer to the parent device of the new clock. * @parent: Pointer to the parent device of the new clock.
* *
* Returns a valid pointer on success or PTR_ERR on failure. If PHC * Returns: a valid pointer on success or PTR_ERR on failure. If PHC
* support is missing at the configuration level, this function * support is missing at the configuration level, this function
* returns NULL, and drivers are expected to gracefully handle that * returns NULL, and drivers are expected to gracefully handle that
* case separately. * case separately.
@ -445,7 +445,7 @@ int ptp_get_vclocks_index(int pclock_index, int **vclock_index);
* @hwtstamp: timestamp * @hwtstamp: timestamp
* @vclock_index: phc index of ptp vclock. * @vclock_index: phc index of ptp vclock.
* *
* Returns converted timestamp, or 0 on error. * Returns: converted timestamp, or 0 on error.
*/ */
ktime_t ptp_convert_timestamp(const ktime_t *hwtstamp, int vclock_index); ktime_t ptp_convert_timestamp(const ktime_t *hwtstamp, int vclock_index);
#else #else

2
include/linux/rfkill.h
View file

@ -241,7 +241,7 @@ bool rfkill_soft_blocked(struct rfkill *rfkill);
* rfkill_find_type - Helper for finding rfkill type by name * rfkill_find_type - Helper for finding rfkill type by name
* @name: the name of the type * @name: the name of the type
* *
* Returns enum rfkill_type that corresponds to the name. * Returns: enum rfkill_type that corresponds to the name.
*/ */
enum rfkill_type rfkill_find_type(const char *name); enum rfkill_type rfkill_find_type(const char *name);

2
include/linux/rtnetlink.h
View file

@ -78,7 +78,7 @@ static inline bool lockdep_rtnl_is_held(void)
* rtnl_dereference - fetch RCU pointer when updates are prevented by RTNL * rtnl_dereference - fetch RCU pointer when updates are prevented by RTNL
* @p: The pointer to read, prior to dereferencing * @p: The pointer to read, prior to dereferencing
* *
* Return the value of the specified RCU-protected pointer, but omit * Return: the value of the specified RCU-protected pointer, but omit
* the READ_ONCE(), because caller holds RTNL. * the READ_ONCE(), because caller holds RTNL.
*/ */
#define rtnl_dereference(p) \ #define rtnl_dereference(p) \

16
include/linux/skbuff.h
View file

@ -1134,7 +1134,7 @@ static inline bool skb_pfmemalloc(const struct sk_buff *skb)
* skb_dst - returns skb dst_entry * skb_dst - returns skb dst_entry
* @skb: buffer * @skb: buffer
* *
* Returns skb dst_entry, regardless of reference taken or not. * Returns: skb dst_entry, regardless of reference taken or not.
*/ */
static inline struct dst_entry *skb_dst(const struct sk_buff *skb) static inline struct dst_entry *skb_dst(const struct sk_buff *skb)
{ {
@ -1222,7 +1222,7 @@ static inline bool skb_wifi_acked_valid(const struct sk_buff *skb)
* skb_unref - decrement the skb's reference count * skb_unref - decrement the skb's reference count
* @skb: buffer * @skb: buffer
* *
* Returns true if we can free the skb. * Returns: true if we can free the skb.
*/ */
static inline bool skb_unref(struct sk_buff *skb) static inline bool skb_unref(struct sk_buff *skb)
{ {
@ -1344,7 +1344,7 @@ struct sk_buff_fclones {
* @sk: socket * @sk: socket
* @skb: buffer * @skb: buffer
* *
* Returns true if skb is a fast clone, and its clone is not freed. * Returns: true if skb is a fast clone, and its clone is not freed.
* Some drivers call skb_orphan() in their ndo_start_xmit(), * Some drivers call skb_orphan() in their ndo_start_xmit(),
* so we also check that didn't happen. * so we also check that didn't happen.
*/ */
@ -3516,7 +3516,7 @@ static inline struct page *__dev_alloc_page_noprof(gfp_t gfp_mask)
* A page shouldn't be considered for reusing/recycling if it was allocated * A page shouldn't be considered for reusing/recycling if it was allocated
* under memory pressure or at a distant memory node. * under memory pressure or at a distant memory node.
* *
* Returns false if this page should be returned to page allocator, true * Returns: false if this page should be returned to page allocator, true
* otherwise. * otherwise.
*/ */
static inline bool dev_page_is_reusable(const struct page *page) static inline bool dev_page_is_reusable(const struct page *page)
@ -3633,7 +3633,7 @@ int skb_cow_data_for_xdp(struct page_pool *pool, struct sk_buff **pskb,
* skb_frag_address - gets the address of the data contained in a paged fragment * skb_frag_address - gets the address of the data contained in a paged fragment
* @frag: the paged fragment buffer * @frag: the paged fragment buffer
* *
* Returns the address of the data within @frag. The page must already * Returns: the address of the data within @frag. The page must already
* be mapped. * be mapped.
*/ */
static inline void *skb_frag_address(const skb_frag_t *frag) static inline void *skb_frag_address(const skb_frag_t *frag)
@ -3648,7 +3648,7 @@ static inline void *skb_frag_address(const skb_frag_t *frag)
* skb_frag_address_safe - gets the address of the data contained in a paged fragment * skb_frag_address_safe - gets the address of the data contained in a paged fragment
* @frag: the paged fragment buffer * @frag: the paged fragment buffer
* *
* Returns the address of the data within @frag. Checks that the page * Returns: the address of the data within @frag. Checks that the page
* is mapped and returns %NULL otherwise. * is mapped and returns %NULL otherwise.
*/ */
static inline void *skb_frag_address_safe(const skb_frag_t *frag) static inline void *skb_frag_address_safe(const skb_frag_t *frag)
@ -3890,7 +3890,7 @@ static inline int skb_linearize(struct sk_buff *skb)
* skb_has_shared_frag - can any frag be overwritten * skb_has_shared_frag - can any frag be overwritten
* @skb: buffer to test * @skb: buffer to test
* *
* Return true if the skb has at least one frag that might be modified * Return: true if the skb has at least one frag that might be modified
* by an external entity (as in vmsplice()/sendfile()) * by an external entity (as in vmsplice()/sendfile())
*/ */
static inline bool skb_has_shared_frag(const struct sk_buff *skb) static inline bool skb_has_shared_frag(const struct sk_buff *skb)
@ -4612,7 +4612,7 @@ static inline void __skb_reset_checksum_unnecessary(struct sk_buff *skb)
/* Check if we need to perform checksum complete validation. /* Check if we need to perform checksum complete validation.
* *
* Returns true if checksum complete is needed, false otherwise * Returns: true if checksum complete is needed, false otherwise
* (either checksum is unnecessary or zero checksum is allowed). * (either checksum is unnecessary or zero checksum is allowed).
*/ */
static inline bool __skb_checksum_validate_needed(struct sk_buff *skb, static inline bool __skb_checksum_validate_needed(struct sk_buff *skb,

2
include/linux/wwan.h
View file

@ -97,7 +97,7 @@ struct wwan_port_caps {
* *
* This function must be balanced with a call to wwan_remove_port(). * This function must be balanced with a call to wwan_remove_port().
* *
* Returns a valid pointer to wwan_port on success or PTR_ERR on failure * Returns: a valid pointer to wwan_port on success or PTR_ERR on failure
*/ */
struct wwan_port *wwan_create_port(struct device *parent, struct wwan_port *wwan_create_port(struct device *parent,
enum wwan_port_type type, enum wwan_port_type type,

2
include/net/cfg80211.h
View file

@ -5957,7 +5957,7 @@ int wiphy_register(struct wiphy *wiphy);
* @wiphy: the wiphy to check the locking on * @wiphy: the wiphy to check the locking on
* @p: The pointer to read, prior to dereferencing * @p: The pointer to read, prior to dereferencing
* *
* Return the value of the specified RCU-protected pointer, but omit the * Return: the value of the specified RCU-protected pointer, but omit the
* READ_ONCE(), because caller holds the wiphy mutex used for updates. * READ_ONCE(), because caller holds the wiphy mutex used for updates.
*/ */
#define wiphy_dereference(wiphy, p) \ #define wiphy_dereference(wiphy, p) \

2
include/net/dst.h
View file

@ -307,7 +307,7 @@ static inline bool dst_hold_safe(struct dst_entry *dst)
* @skb: buffer * @skb: buffer
* *
* If dst is not yet refcounted and not destroyed, grab a ref on it. * If dst is not yet refcounted and not destroyed, grab a ref on it.
* Returns true if dst is refcounted. * Returns: true if dst is refcounted.
*/ */
static inline bool skb_dst_force(struct sk_buff *skb) static inline bool skb_dst_force(struct sk_buff *skb)
{ {

6
include/net/genetlink.h
View file

@ -354,7 +354,7 @@ __genlmsg_iput(struct sk_buff *skb, const struct genl_info *info, int flags)
* such requests) or a struct initialized by genl_info_init_ntf() * such requests) or a struct initialized by genl_info_init_ntf()
* when constructing notifications. * when constructing notifications.
* *
* Returns pointer to new genetlink header. * Returns: pointer to new genetlink header.
*/ */
static inline void * static inline void *
genlmsg_iput(struct sk_buff *skb, const struct genl_info *info) genlmsg_iput(struct sk_buff *skb, const struct genl_info *info)
@ -366,7 +366,7 @@ genlmsg_iput(struct sk_buff *skb, const struct genl_info *info)
* genlmsg_nlhdr - Obtain netlink header from user specified header * genlmsg_nlhdr - Obtain netlink header from user specified header
* @user_hdr: user header as returned from genlmsg_put() * @user_hdr: user header as returned from genlmsg_put()
* *
* Returns pointer to netlink header. * Returns: pointer to netlink header.
*/ */
static inline struct nlmsghdr *genlmsg_nlhdr(void *user_hdr) static inline struct nlmsghdr *genlmsg_nlhdr(void *user_hdr)
{ {
@ -435,7 +435,7 @@ static inline void genl_dump_check_consistent(struct netlink_callback *cb,
* @flags: netlink message flags * @flags: netlink message flags
* @cmd: generic netlink command * @cmd: generic netlink command
* *
* Returns pointer to user specific header * Returns: pointer to user specific header
*/ */
static inline void *genlmsg_put_reply(struct sk_buff *skb, static inline void *genlmsg_put_reply(struct sk_buff *skb,
struct genl_info *info, struct genl_info *info,

2
include/net/ipv6.h
View file

@ -471,7 +471,7 @@ struct ipv6_txoptions *ipv6_update_options(struct sock *sk,
/* This helper is specialized for BIG TCP needs. /* This helper is specialized for BIG TCP needs.
* It assumes the hop_jumbo_hdr will immediately follow the IPV6 header. * It assumes the hop_jumbo_hdr will immediately follow the IPV6 header.
* It assumes headers are already in skb->head. * It assumes headers are already in skb->head.
* Returns 0, or IPPROTO_TCP if a BIG TCP packet is there. * Returns: 0, or IPPROTO_TCP if a BIG TCP packet is there.
*/ */
static inline int ipv6_has_hopopt_jumbo(const struct sk_buff *skb) static inline int ipv6_has_hopopt_jumbo(const struct sk_buff *skb)
{ {

30
include/net/iucv/iucv.h
View file

@ -202,7 +202,7 @@ struct iucv_handler {
* *
* Registers a driver with IUCV. * Registers a driver with IUCV.
* *
* Returns 0 on success, -ENOMEM if the memory allocation for the pathid * Returns: 0 on success, -ENOMEM if the memory allocation for the pathid
* table failed, or -EIO if IUCV_DECLARE_BUFFER failed on all cpus. * table failed, or -EIO if IUCV_DECLARE_BUFFER failed on all cpus.
*/ */
int iucv_register(struct iucv_handler *handler, int smp); int iucv_register(struct iucv_handler *handler, int smp);
@ -224,7 +224,7 @@ void iucv_unregister(struct iucv_handler *handle, int smp);
* *
* Allocate a new path structure for use with iucv_connect. * Allocate a new path structure for use with iucv_connect.
* *
* Returns NULL if the memory allocation failed or a pointer to the * Returns: NULL if the memory allocation failed or a pointer to the
* path structure. * path structure.
*/ */
static inline struct iucv_path *iucv_path_alloc(u16 msglim, u8 flags, gfp_t gfp) static inline struct iucv_path *iucv_path_alloc(u16 msglim, u8 flags, gfp_t gfp)
@ -260,7 +260,7 @@ static inline void iucv_path_free(struct iucv_path *path)
* This function is issued after the user received a connection pending * This function is issued after the user received a connection pending
* external interrupt and now wishes to complete the IUCV communication path. * external interrupt and now wishes to complete the IUCV communication path.
* *
* Returns the result of the CP IUCV call. * Returns: the result of the CP IUCV call.
*/ */
int iucv_path_accept(struct iucv_path *path, struct iucv_handler *handler, int iucv_path_accept(struct iucv_path *path, struct iucv_handler *handler,
u8 *userdata, void *private); u8 *userdata, void *private);
@ -278,7 +278,7 @@ int iucv_path_accept(struct iucv_path *path, struct iucv_handler *handler,
* successfully, you are not able to use the path until you receive an IUCV * successfully, you are not able to use the path until you receive an IUCV
* Connection Complete external interrupt. * Connection Complete external interrupt.
* *
* Returns the result of the CP IUCV call. * Returns: the result of the CP IUCV call.
*/ */
int iucv_path_connect(struct iucv_path *path, struct iucv_handler *handler, int iucv_path_connect(struct iucv_path *path, struct iucv_handler *handler,
u8 *userid, u8 *system, u8 *userdata, u8 *userid, u8 *system, u8 *userdata,
@ -292,7 +292,7 @@ int iucv_path_connect(struct iucv_path *path, struct iucv_handler *handler,
* This function temporarily suspends incoming messages on an IUCV path. * This function temporarily suspends incoming messages on an IUCV path.
* You can later reactivate the path by invoking the iucv_resume function. * You can later reactivate the path by invoking the iucv_resume function.
* *
* Returns the result from the CP IUCV call. * Returns: the result from the CP IUCV call.
*/ */
int iucv_path_quiesce(struct iucv_path *path, u8 *userdata); int iucv_path_quiesce(struct iucv_path *path, u8 *userdata);
@ -304,7 +304,7 @@ int iucv_path_quiesce(struct iucv_path *path, u8 *userdata);
* This function resumes incoming messages on an IUCV path that has * This function resumes incoming messages on an IUCV path that has
* been stopped with iucv_path_quiesce. * been stopped with iucv_path_quiesce.
* *
* Returns the result from the CP IUCV call. * Returns: the result from the CP IUCV call.
*/ */
int iucv_path_resume(struct iucv_path *path, u8 *userdata); int iucv_path_resume(struct iucv_path *path, u8 *userdata);
@ -315,7 +315,7 @@ int iucv_path_resume(struct iucv_path *path, u8 *userdata);
* *
* This function terminates an IUCV path. * This function terminates an IUCV path.
* *
* Returns the result from the CP IUCV call. * Returns: the result from the CP IUCV call.
*/ */
int iucv_path_sever(struct iucv_path *path, u8 *userdata); int iucv_path_sever(struct iucv_path *path, u8 *userdata);
@ -327,7 +327,7 @@ int iucv_path_sever(struct iucv_path *path, u8 *userdata);
* *
* Cancels a message you have sent. * Cancels a message you have sent.
* *
* Returns the result from the CP IUCV call. * Returns: the result from the CP IUCV call.
*/ */
int iucv_message_purge(struct iucv_path *path, struct iucv_message *msg, int iucv_message_purge(struct iucv_path *path, struct iucv_message *msg,
u32 srccls); u32 srccls);
@ -347,7 +347,7 @@ int iucv_message_purge(struct iucv_path *path, struct iucv_message *msg,
* *
* Locking: local_bh_enable/local_bh_disable * Locking: local_bh_enable/local_bh_disable
* *
* Returns the result from the CP IUCV call. * Returns: the result from the CP IUCV call.
*/ */
int iucv_message_receive(struct iucv_path *path, struct iucv_message *msg, int iucv_message_receive(struct iucv_path *path, struct iucv_message *msg,
u8 flags, void *buffer, size_t size, size_t *residual); u8 flags, void *buffer, size_t size, size_t *residual);
@ -367,7 +367,7 @@ int iucv_message_receive(struct iucv_path *path, struct iucv_message *msg,
* *
* Locking: no locking. * Locking: no locking.
* *
* Returns the result from the CP IUCV call. * Returns: the result from the CP IUCV call.
*/ */
int __iucv_message_receive(struct iucv_path *path, struct iucv_message *msg, int __iucv_message_receive(struct iucv_path *path, struct iucv_message *msg,
u8 flags, void *buffer, size_t size, u8 flags, void *buffer, size_t size,
@ -382,7 +382,7 @@ int __iucv_message_receive(struct iucv_path *path, struct iucv_message *msg,
* are notified of a message and the time that you complete the message, * are notified of a message and the time that you complete the message,
* the message may be rejected. * the message may be rejected.
* *
* Returns the result from the CP IUCV call. * Returns: the result from the CP IUCV call.
*/ */
int iucv_message_reject(struct iucv_path *path, struct iucv_message *msg); int iucv_message_reject(struct iucv_path *path, struct iucv_message *msg);
@ -399,7 +399,7 @@ int iucv_message_reject(struct iucv_path *path, struct iucv_message *msg);
* pathid, msgid, and trgcls. Prmmsg signifies the data is moved into * pathid, msgid, and trgcls. Prmmsg signifies the data is moved into
* the parameter list. * the parameter list.
* *
* Returns the result from the CP IUCV call. * Returns: the result from the CP IUCV call.
*/ */
int iucv_message_reply(struct iucv_path *path, struct iucv_message *msg, int iucv_message_reply(struct iucv_path *path, struct iucv_message *msg,
u8 flags, void *reply, size_t size); u8 flags, void *reply, size_t size);
@ -419,7 +419,7 @@ int iucv_message_reply(struct iucv_path *path, struct iucv_message *msg,
* *
* Locking: local_bh_enable/local_bh_disable * Locking: local_bh_enable/local_bh_disable
* *
* Returns the result from the CP IUCV call. * Returns: the result from the CP IUCV call.
*/ */
int iucv_message_send(struct iucv_path *path, struct iucv_message *msg, int iucv_message_send(struct iucv_path *path, struct iucv_message *msg,
u8 flags, u32 srccls, void *buffer, size_t size); u8 flags, u32 srccls, void *buffer, size_t size);
@ -439,7 +439,7 @@ int iucv_message_send(struct iucv_path *path, struct iucv_message *msg,
* *
* Locking: no locking. * Locking: no locking.
* *
* Returns the result from the CP IUCV call. * Returns: the result from the CP IUCV call.
*/ */
int __iucv_message_send(struct iucv_path *path, struct iucv_message *msg, int __iucv_message_send(struct iucv_path *path, struct iucv_message *msg,
u8 flags, u32 srccls, void *buffer, size_t size); u8 flags, u32 srccls, void *buffer, size_t size);
@ -461,7 +461,7 @@ int __iucv_message_send(struct iucv_path *path, struct iucv_message *msg,
* reply to the message and a buffer is provided into which IUCV moves * reply to the message and a buffer is provided into which IUCV moves
* the reply to this message. * the reply to this message.
* *
* Returns the result from the CP IUCV call. * Returns: the result from the CP IUCV call.
*/ */
int iucv_message_send2way(struct iucv_path *path, struct iucv_message *msg, int iucv_message_send2way(struct iucv_path *path, struct iucv_message *msg,
u8 flags, u32 srccls, void *buffer, size_t size, u8 flags, u32 srccls, void *buffer, size_t size,

4
include/net/netfilter/nf_tproxy.h
View file

@ -49,7 +49,7 @@ __be32 nf_tproxy_laddr4(struct sk_buff *skb, __be32 user_laddr, __be32 daddr);
* *
* nf_tproxy_handle_time_wait4() consumes the socket reference passed in. * nf_tproxy_handle_time_wait4() consumes the socket reference passed in.
* *
* Returns the listener socket if there's one, the TIME_WAIT socket if * Returns: the listener socket if there's one, the TIME_WAIT socket if
* no such listener is found, or NULL if the TCP header is incomplete. * no such listener is found, or NULL if the TCP header is incomplete.
*/ */
struct sock * struct sock *
@ -108,7 +108,7 @@ nf_tproxy_laddr6(struct sk_buff *skb, const struct in6_addr *user_laddr,
* *
* nf_tproxy_handle_time_wait6() consumes the socket reference passed in. * nf_tproxy_handle_time_wait6() consumes the socket reference passed in.
* *
* Returns the listener socket if there's one, the TIME_WAIT socket if * Returns: the listener socket if there's one, the TIME_WAIT socket if
* no such listener is found, or NULL if the TCP header is incomplete. * no such listener is found, or NULL if the TCP header is incomplete.
*/ */
struct sock * struct sock *

44
include/net/netlink.h
View file

@ -649,7 +649,7 @@ static inline int nlmsg_ok(const struct nlmsghdr *nlh, int remaining)
* @nlh: netlink message header * @nlh: netlink message header
* @remaining: number of bytes remaining in message stream * @remaining: number of bytes remaining in message stream
* *
* Returns the next netlink message in the message stream and * Returns: the next netlink message in the message stream and
* decrements remaining by the size of the current message. * decrements remaining by the size of the current message.
*/ */
static inline struct nlmsghdr * static inline struct nlmsghdr *
@ -676,7 +676,7 @@ nlmsg_next(const struct nlmsghdr *nlh, int *remaining)
* exceeding maxtype will be rejected, policy must be specified, attributes * exceeding maxtype will be rejected, policy must be specified, attributes
* will be validated in the strictest way possible. * will be validated in the strictest way possible.
* *
* Returns 0 on success or a negative error code. * Returns: 0 on success or a negative error code.
*/ */
static inline int nla_parse(struct nlattr **tb, int maxtype, static inline int nla_parse(struct nlattr **tb, int maxtype,
const struct nlattr *head, int len, const struct nlattr *head, int len,
@ -701,7 +701,7 @@ static inline int nla_parse(struct nlattr **tb, int maxtype,
* exceeding maxtype will be ignored and attributes from the policy are not * exceeding maxtype will be ignored and attributes from the policy are not
* always strictly validated (only for new attributes). * always strictly validated (only for new attributes).
* *
* Returns 0 on success or a negative error code. * Returns: 0 on success or a negative error code.
*/ */
static inline int nla_parse_deprecated(struct nlattr **tb, int maxtype, static inline int nla_parse_deprecated(struct nlattr **tb, int maxtype,
const struct nlattr *head, int len, const struct nlattr *head, int len,
@ -726,7 +726,7 @@ static inline int nla_parse_deprecated(struct nlattr **tb, int maxtype,
* exceeding maxtype will be rejected as well as trailing data, but the * exceeding maxtype will be rejected as well as trailing data, but the
* policy is not completely strictly validated (only for new attributes). * policy is not completely strictly validated (only for new attributes).
* *
* Returns 0 on success or a negative error code. * Returns: 0 on success or a negative error code.
*/ */
static inline int nla_parse_deprecated_strict(struct nlattr **tb, int maxtype, static inline int nla_parse_deprecated_strict(struct nlattr **tb, int maxtype,
const struct nlattr *head, const struct nlattr *head,
@ -833,7 +833,7 @@ nlmsg_parse_deprecated_strict(const struct nlmsghdr *nlh, int hdrlen,
* @hdrlen: length of family specific header * @hdrlen: length of family specific header
* @attrtype: type of attribute to look for * @attrtype: type of attribute to look for
* *
* Returns the first attribute which matches the specified type. * Returns: the first attribute which matches the specified type.
*/ */
static inline struct nlattr *nlmsg_find_attr(const struct nlmsghdr *nlh, static inline struct nlattr *nlmsg_find_attr(const struct nlmsghdr *nlh,
int hdrlen, int attrtype) int hdrlen, int attrtype)
@ -854,7 +854,7 @@ static inline struct nlattr *nlmsg_find_attr(const struct nlmsghdr *nlh,
* specified policy. Validation is done in liberal mode. * specified policy. Validation is done in liberal mode.
* See documentation of struct nla_policy for more details. * See documentation of struct nla_policy for more details.
* *
* Returns 0 on success or a negative error code. * Returns: 0 on success or a negative error code.
*/ */
static inline int nla_validate_deprecated(const struct nlattr *head, int len, static inline int nla_validate_deprecated(const struct nlattr *head, int len,
int maxtype, int maxtype,
@ -877,7 +877,7 @@ static inline int nla_validate_deprecated(const struct nlattr *head, int len,
* specified policy. Validation is done in strict mode. * specified policy. Validation is done in strict mode.
* See documentation of struct nla_policy for more details. * See documentation of struct nla_policy for more details.
* *
* Returns 0 on success or a negative error code. * Returns: 0 on success or a negative error code.
*/ */
static inline int nla_validate(const struct nlattr *head, int len, int maxtype, static inline int nla_validate(const struct nlattr *head, int len, int maxtype,
const struct nla_policy *policy, const struct nla_policy *policy,
@ -914,7 +914,7 @@ static inline int nlmsg_validate_deprecated(const struct nlmsghdr *nlh,
* nlmsg_report - need to report back to application? * nlmsg_report - need to report back to application?
* @nlh: netlink message header * @nlh: netlink message header
* *
* Returns 1 if a report back to the application is requested. * Returns: 1 if a report back to the application is requested.
*/ */
static inline int nlmsg_report(const struct nlmsghdr *nlh) static inline int nlmsg_report(const struct nlmsghdr *nlh)
{ {
@ -925,7 +925,7 @@ static inline int nlmsg_report(const struct nlmsghdr *nlh)
* nlmsg_seq - return the seq number of netlink message * nlmsg_seq - return the seq number of netlink message
* @nlh: netlink message header * @nlh: netlink message header
* *
* Returns 0 if netlink message is NULL * Returns: 0 if netlink message is NULL
*/ */
static inline u32 nlmsg_seq(const struct nlmsghdr *nlh) static inline u32 nlmsg_seq(const struct nlmsghdr *nlh)
{ {
@ -952,7 +952,7 @@ static inline u32 nlmsg_seq(const struct nlmsghdr *nlh)
* @payload: length of message payload * @payload: length of message payload
* @flags: message flags * @flags: message flags
* *
* Returns NULL if the tailroom of the skb is insufficient to store * Returns: NULL if the tailroom of the skb is insufficient to store
* the message header and payload. * the message header and payload.
*/ */
static inline struct nlmsghdr *nlmsg_put(struct sk_buff *skb, u32 portid, u32 seq, static inline struct nlmsghdr *nlmsg_put(struct sk_buff *skb, u32 portid, u32 seq,
@ -971,7 +971,7 @@ static inline struct nlmsghdr *nlmsg_put(struct sk_buff *skb, u32 portid, u32 se
* *
* Append data to an existing nlmsg, used when constructing a message * Append data to an existing nlmsg, used when constructing a message
* with multiple fixed-format headers (which is rare). * with multiple fixed-format headers (which is rare).
* Returns NULL if the tailroom of the skb is insufficient to store * Returns: NULL if the tailroom of the skb is insufficient to store
* the extra payload. * the extra payload.
*/ */
static inline void *nlmsg_append(struct sk_buff *skb, u32 size) static inline void *nlmsg_append(struct sk_buff *skb, u32 size)
@ -993,7 +993,7 @@ static inline void *nlmsg_append(struct sk_buff *skb, u32 size)
* @payload: length of message payload * @payload: length of message payload
* @flags: message flags * @flags: message flags
* *
* Returns NULL if the tailroom of the skb is insufficient to store * Returns: NULL if the tailroom of the skb is insufficient to store
* the message header and payload. * the message header and payload.
*/ */
static inline struct nlmsghdr *nlmsg_put_answer(struct sk_buff *skb, static inline struct nlmsghdr *nlmsg_put_answer(struct sk_buff *skb,
@ -1050,7 +1050,7 @@ static inline void nlmsg_end(struct sk_buff *skb, struct nlmsghdr *nlh)
* nlmsg_get_pos - return current position in netlink message * nlmsg_get_pos - return current position in netlink message
* @skb: socket buffer the message is stored in * @skb: socket buffer the message is stored in
* *
* Returns a pointer to the current tail of the message. * Returns: a pointer to the current tail of the message.
*/ */
static inline void *nlmsg_get_pos(struct sk_buff *skb) static inline void *nlmsg_get_pos(struct sk_buff *skb)
{ {
@ -1276,7 +1276,7 @@ static inline int nla_ok(const struct nlattr *nla, int remaining)
* @nla: netlink attribute * @nla: netlink attribute
* @remaining: number of bytes remaining in attribute stream * @remaining: number of bytes remaining in attribute stream
* *
* Returns the next netlink attribute in the attribute stream and * Returns: the next netlink attribute in the attribute stream and
* decrements remaining by the size of the current attribute. * decrements remaining by the size of the current attribute.
*/ */
static inline struct nlattr *nla_next(const struct nlattr *nla, int *remaining) static inline struct nlattr *nla_next(const struct nlattr *nla, int *remaining)
@ -1292,7 +1292,7 @@ static inline struct nlattr *nla_next(const struct nlattr *nla, int *remaining)
* @nla: attribute containing the nested attributes * @nla: attribute containing the nested attributes
* @attrtype: type of attribute to look for * @attrtype: type of attribute to look for
* *
* Returns the first attribute which matches the specified type. * Returns: the first attribute which matches the specified type.
*/ */
static inline struct nlattr * static inline struct nlattr *
nla_find_nested(const struct nlattr *nla, int attrtype) nla_find_nested(const struct nlattr *nla, int attrtype)
@ -2091,7 +2091,7 @@ static inline int nla_get_flag(const struct nlattr *nla)
* nla_get_msecs - return payload of msecs attribute * nla_get_msecs - return payload of msecs attribute
* @nla: msecs netlink attribute * @nla: msecs netlink attribute
* *
* Returns the number of milliseconds in jiffies. * Returns: the number of milliseconds in jiffies.
*/ */
static inline unsigned long nla_get_msecs(const struct nlattr *nla) static inline unsigned long nla_get_msecs(const struct nlattr *nla)
{ {
@ -2183,7 +2183,7 @@ static inline void *nla_memdup_noprof(const struct nlattr *src, gfp_t gfp)
* marked their nest attributes with NLA_F_NESTED flag. New APIs should use * marked their nest attributes with NLA_F_NESTED flag. New APIs should use
* nla_nest_start() which sets the flag. * nla_nest_start() which sets the flag.
* *
* Returns the container attribute or NULL on error * Returns: the container attribute or NULL on error
*/ */
static inline struct nlattr *nla_nest_start_noflag(struct sk_buff *skb, static inline struct nlattr *nla_nest_start_noflag(struct sk_buff *skb,
int attrtype) int attrtype)
@ -2204,7 +2204,7 @@ static inline struct nlattr *nla_nest_start_noflag(struct sk_buff *skb,
* Unlike nla_nest_start_noflag(), mark the nest attribute with NLA_F_NESTED * Unlike nla_nest_start_noflag(), mark the nest attribute with NLA_F_NESTED
* flag. This is the preferred function to use in new code. * flag. This is the preferred function to use in new code.
* *
* Returns the container attribute or NULL on error * Returns: the container attribute or NULL on error
*/ */
static inline struct nlattr *nla_nest_start(struct sk_buff *skb, int attrtype) static inline struct nlattr *nla_nest_start(struct sk_buff *skb, int attrtype)
{ {
@ -2219,7 +2219,7 @@ static inline struct nlattr *nla_nest_start(struct sk_buff *skb, int attrtype)
* Corrects the container attribute header to include the all * Corrects the container attribute header to include the all
* appended attributes. * appended attributes.
* *
* Returns the total data length of the skb. * Returns: the total data length of the skb.
*/ */
static inline int nla_nest_end(struct sk_buff *skb, struct nlattr *start) static inline int nla_nest_end(struct sk_buff *skb, struct nlattr *start)
{ {
@ -2252,7 +2252,7 @@ static inline void nla_nest_cancel(struct sk_buff *skb, struct nlattr *start)
* specified policy. Attributes with a type exceeding maxtype will be * specified policy. Attributes with a type exceeding maxtype will be
* ignored. See documentation of struct nla_policy for more details. * ignored. See documentation of struct nla_policy for more details.
* *
* Returns 0 on success or a negative error code. * Returns: 0 on success or a negative error code.
*/ */
static inline int __nla_validate_nested(const struct nlattr *start, int maxtype, static inline int __nla_validate_nested(const struct nlattr *start, int maxtype,
const struct nla_policy *policy, const struct nla_policy *policy,
@ -2285,7 +2285,7 @@ nla_validate_nested_deprecated(const struct nlattr *start, int maxtype,
* nla_need_padding_for_64bit - test 64-bit alignment of the next attribute * nla_need_padding_for_64bit - test 64-bit alignment of the next attribute
* @skb: socket buffer the message is stored in * @skb: socket buffer the message is stored in
* *
* Return true if padding is needed to align the next attribute (nla_data()) to * Return: true if padding is needed to align the next attribute (nla_data()) to
* a 64-bit aligned area. * a 64-bit aligned area.
*/ */
static inline bool nla_need_padding_for_64bit(struct sk_buff *skb) static inline bool nla_need_padding_for_64bit(struct sk_buff *skb)
@ -2312,7 +2312,7 @@ static inline bool nla_need_padding_for_64bit(struct sk_buff *skb)
* This will only be done in architectures which do not have * This will only be done in architectures which do not have
* CONFIG_HAVE_EFFICIENT_UNALIGNED_ACCESS defined. * CONFIG_HAVE_EFFICIENT_UNALIGNED_ACCESS defined.
* *
* Returns zero on success or a negative error code. * Returns: zero on success or a negative error code.
*/ */
static inline int nla_align_64bit(struct sk_buff *skb, int padattr) static inline int nla_align_64bit(struct sk_buff *skb, int padattr)
{ {

9
include/net/page_pool/helpers.h
View file

@ -104,8 +104,7 @@ static inline struct page *page_pool_dev_alloc_pages(struct page_pool *pool)
* *
* Get a page fragment from the page allocator or page_pool caches. * Get a page fragment from the page allocator or page_pool caches.
* *
* Return: * Return: allocated page fragment, otherwise return NULL.
* Return allocated page fragment, otherwise return NULL.
*/ */
static inline struct page *page_pool_dev_alloc_frag(struct page_pool *pool, static inline struct page *page_pool_dev_alloc_frag(struct page_pool *pool,
unsigned int *offset, unsigned int *offset,
@ -155,8 +154,7 @@ static inline struct page *page_pool_alloc(struct page_pool *pool,
* depending on the requested size in order to allocate memory with least memory * depending on the requested size in order to allocate memory with least memory
* utilization and performance penalty. * utilization and performance penalty.
* *
* Return: * Return: allocated page or page fragment, otherwise return NULL.
* Return allocated page or page fragment, otherwise return NULL.
*/ */
static inline struct page *page_pool_dev_alloc(struct page_pool *pool, static inline struct page *page_pool_dev_alloc(struct page_pool *pool,
unsigned int *offset, unsigned int *offset,
@ -190,8 +188,7 @@ static inline void *page_pool_alloc_va(struct page_pool *pool,
* This is just a thin wrapper around the page_pool_alloc() API, and * This is just a thin wrapper around the page_pool_alloc() API, and
* it returns va of the allocated page or page fragment. * it returns va of the allocated page or page fragment.
* *
* Return: * Return: the va for the allocated page or page fragment, otherwise return NULL.
* Return the va for the allocated page or page fragment, otherwise return NULL.
*/ */
static inline void *page_pool_dev_alloc_va(struct page_pool *pool, static inline void *page_pool_dev_alloc_va(struct page_pool *pool,
unsigned int *size) unsigned int *size)

4
include/net/pkt_cls.h
View file

@ -319,7 +319,7 @@ tcf_exts_hw_stats_update(const struct tcf_exts *exts,
* tcf_exts_has_actions - check if at least one action is present * tcf_exts_has_actions - check if at least one action is present
* @exts: tc filter extensions handle * @exts: tc filter extensions handle
* *
* Returns true if at least one action is present. * Returns: true if at least one action is present.
*/ */
static inline bool tcf_exts_has_actions(struct tcf_exts *exts) static inline bool tcf_exts_has_actions(struct tcf_exts *exts)
{ {
@ -501,7 +501,7 @@ int __tcf_em_tree_match(struct sk_buff *, struct tcf_ematch_tree *,
* through all ematches respecting their logic relations returning * through all ematches respecting their logic relations returning
* as soon as the result is obvious. * as soon as the result is obvious.
* *
* Returns 1 if the ematch tree as-one matches, no ematches are configured * Returns: 1 if the ematch tree as-one matches, no ematches are configured
* or ematch is not enabled in the kernel, otherwise 0 is returned. * or ematch is not enabled in the kernel, otherwise 0 is returned.
*/ */
static inline int tcf_em_tree_match(struct sk_buff *skb, static inline int tcf_em_tree_match(struct sk_buff *skb,

2
include/net/tcp.h
View file

@ -1817,7 +1817,7 @@ int tcp_sigpool_hash_skb_data(struct tcp_sigpool *hp,
* @id: tcp_sigpool that was previously allocated by tcp_sigpool_alloc_ahash() * @id: tcp_sigpool that was previously allocated by tcp_sigpool_alloc_ahash()
* @c: returned tcp_sigpool for usage (uninitialized on failure) * @c: returned tcp_sigpool for usage (uninitialized on failure)
* *
* Returns 0 on success, error otherwise. * Returns: 0 on success, error otherwise.
*/ */
int tcp_sigpool_start(unsigned int id, struct tcp_sigpool *c); int tcp_sigpool_start(unsigned int id, struct tcp_sigpool *c);
/** /**