Eliminate all kernel-doc and Sphinx warnings in <linux/netdevice.h>. Fixes these warnings: ../include/linux/netdevice.h:2100: warning: Function parameter or member 'gso_partial_features' not described in 'net_device' ../include/linux/netdevice.h:2100: warning: Function parameter or member 'l3mdev_ops' not described in 'net_device' ../include/linux/netdevice.h:2100: warning: Function parameter or member 'xfrmdev_ops' not described in 'net_device' ../include/linux/netdevice.h:2100: warning: Function parameter or member 'tlsdev_ops' not described in 'net_device' ../include/linux/netdevice.h:2100: warning: Function parameter or member 'name_assign_type' not described in 'net_device' ../include/linux/netdevice.h:2100: warning: Function parameter or member 'ieee802154_ptr' not described in 'net_device' ../include/linux/netdevice.h:2100: warning: Function parameter or member 'mpls_ptr' not described in 'net_device' ../include/linux/netdevice.h:2100: warning: Function parameter or member 'xdp_prog' not described in 'net_device' ../include/linux/netdevice.h:2100: warning: Function parameter or member 'gro_flush_timeout' not described in 'net_device' ../include/linux/netdevice.h:2100: warning: Function parameter or member 'xdp_bulkq' not described in 'net_device' ../include/linux/netdevice.h:2100: warning: Function parameter or member 'xps_cpus_map' not described in 'net_device' ../include/linux/netdevice.h:2100: warning: Function parameter or member 'xps_rxqs_map' not described in 'net_device' ../include/linux/netdevice.h:2100: warning: Function parameter or member 'qdisc_hash' not described in 'net_device' ../include/linux/netdevice.h:3552: WARNING: Inline emphasis start-string without end-string. ../include/linux/netdevice.h:3552: WARNING: Inline emphasis start-string without end-string.
Showing the changes to include/linux (1 of 1 file). Show all
Unified · Split
| @@ -1616,6 +1616,7 @@ enum netdev_priv_flags { · 1615 unmodified lines | ||
| 1616 | 1616 | * and drivers will need to set them appropriately. |
| 1617 | 1617 | * |
| 1618 | 1618 | * @mpls_features: Mask of features inheritable by MPLS |
| 1619 | + * @gso_partial_features: value(s) from NETIF_F_GSO\* | |
| 1619 | 1620 | * |
| 1620 | 1621 | * @ifindex: interface index |
| 1621 | 1622 | * @group: The group the device belongs to |
| @@ -1640,8 +1641,11 @@ enum netdev_priv_flags { · 18 unmodified lines | ||
| 1640 | 1641 | * @netdev_ops: Includes several pointers to callbacks, |
| 1641 | 1642 | * if one wants to override the ndo_*() functions |
| 1642 | 1643 | * @ethtool_ops: Management operations |
| 1644 | + * @l3mdev_ops: Layer 3 master device operations | |
| 1643 | 1645 | * @ndisc_ops: Includes callbacks for different IPv6 neighbour |
| 1644 | 1646 | * discovery handling. Necessary for e.g. 6LoWPAN. |
| 1647 | + * @xfrmdev_ops: Transformation offload operations | |
| 1648 | + * @tlsdev_ops: Transport Layer Security offload operations | |
| 1645 | 1649 | * @header_ops: Includes callbacks for creating,parsing,caching,etc |
| 1646 | 1650 | * of Layer 2 headers. |
| 1647 | 1651 | * |
| @@ -1680,6 +1684,7 @@ enum netdev_priv_flags { · 32 unmodified lines | ||
| 1680 | 1684 | * @dev_port: Used to differentiate devices that share |
| 1681 | 1685 | * the same function |
| 1682 | 1686 | * @addr_list_lock: XXX: need comments on this one |
| 1687 | + * @name_assign_type: network interface name assignment type | |
| 1683 | 1688 | * @uc_promisc: Counter that indicates promiscuous mode |
| 1684 | 1689 | * has been enabled due to the need to listen to |
| 1685 | 1690 | * additional unicast addresses in a device that |
| @@ -1702,6 +1707,9 @@ enum netdev_priv_flags { · 16 unmodified lines | ||
| 1702 | 1707 | * @ip6_ptr: IPv6 specific data |
| 1703 | 1708 | * @ax25_ptr: AX.25 specific data |
| 1704 | 1709 | * @ieee80211_ptr: IEEE 802.11 specific data, assign before registering |
| 1710 | + * @ieee802154_ptr: IEEE 802.15.4 low-rate Wireless Personal Area Network | |
| 1711 | + * device struct | |
| 1712 | + * @mpls_ptr: mpls_dev struct pointer | |
| 1705 | 1713 | * |
| 1706 | 1714 | * @dev_addr: Hw address (before bcast, |
| 1707 | 1715 | * because most packets are unicast) |
| @@ -1710,6 +1718,8 @@ enum netdev_priv_flags { · 2 unmodified lines | ||
| 1710 | 1718 | * @num_rx_queues: Number of RX queues |
| 1711 | 1719 | * allocated at register_netdev() time |
| 1712 | 1720 | * @real_num_rx_queues: Number of RX queues currently active in device |
| 1721 | + * @xdp_prog: XDP sockets filter program pointer | |
| 1722 | + * @gro_flush_timeout: timeout for GRO layer in NAPI | |
| 1713 | 1723 | * |
| 1714 | 1724 | * @rx_handler: handler for received packets |
| 1715 | 1725 | * @rx_handler_data: XXX: need comments on this one |
| @@ -1731,10 +1741,14 @@ enum netdev_priv_flags { · 15 unmodified lines | ||
| 1731 | 1741 | * @qdisc: Root qdisc from userspace point of view |
| 1732 | 1742 | * @tx_queue_len: Max frames per queue allowed |
| 1733 | 1743 | * @tx_global_lock: XXX: need comments on this one |
| 1744 | + * @xdp_bulkq: XDP device bulk queue | |
| 1745 | + * @xps_cpus_map: all CPUs map for XPS device | |
| 1746 | + * @xps_rxqs_map: all RXQs map for XPS device | |
| 1734 | 1747 | * |
| 1735 | 1748 | * @xps_maps: XXX: need comments on this one |
| 1736 | 1749 | * @miniq_egress: clsact qdisc specific data for |
| 1737 | 1750 | * egress processing |
| 1751 | + * @qdisc_hash: qdisc hash table | |
| 1738 | 1752 | * @watchdog_timeo: Represents the timeout that is used by |
| 1739 | 1753 | * the watchdog (see dev_watchdog()) |
| 1740 | 1754 | * @watchdog_timer: List of timers |
| @@ -3548,7 +3562,7 @@ static inline unsigned int netif_attrmask_next(int n, const unsigned long *srcp, · 1807 unmodified lines | ||
| 3548 | 3562 | } |
| 3549 | 3563 | |
| 3550 | 3564 | /** |
| 3551 | − * netif_attrmask_next_and - get the next CPU/Rx queue in *src1p & *src2p | |
| 3565 | + * netif_attrmask_next_and - get the next CPU/Rx queue in \*src1p & \*src2p | |
| 3552 | 3566 | * @n: CPU/Rx queue index |
| 3553 | 3567 | * @src1p: the first CPUs/Rx queues mask pointer |
| 3554 | 3568 | * @src2p: the second CPUs/Rx queues mask pointer |