On Mon, Dec 15, 2025 at 06:39:02PM +0700, Bagas Sanjaya wrote:
Sphinx reports kernel-doc warning:
WARNING: ./net/bridge/br_private.h:267 struct member 'tunnel_hash' not described in 'net_bridge_vlan_group'
Fix it by describing @tunnel_hash member.
Fixes: efa5356b0d9753 ("bridge: per vlan dst_metadata netlink support") Signed-off-by: Bagas Sanjaya bagasdotme@gmail.com
net/bridge/br_private.h | 1 + 1 file changed, 1 insertion(+)
diff --git a/net/bridge/br_private.h b/net/bridge/br_private.h index 7280c4e9305f36..bf441ac1c4d38a 100644 --- a/net/bridge/br_private.h +++ b/net/bridge/br_private.h @@ -247,6 +247,7 @@ struct net_bridge_vlan {
- struct net_bridge_vlan_group
- @vlan_hash: VLAN entry rhashtable
- @tunnel_hash: tunnel rhashtable
While you are at it, I suggest making the comment a bit more useful. Something like:
@tunnel_hash: Hash table to map from tunnel key ID (e.g., VXLAN VNI) to VLAN
- @vlan_list: sorted VLAN entry list
- @num_vlans: number of total VLAN entries
- @pvid: PVID VLAN id
-- An old man doll... just what I always wanted! - Clara