Commit a986967e authored Mar 25, 2019 by Bart Van Assche Committed by David S. Miller Mar 27, 2019

net/core: Fix rtnetlink kernel-doc headers

This patch avoids that the following warnings are reported when building
with W=1:

net/core/rtnetlink.c:3580: warning: Function parameter or member 'ndm' not described in 'ndo_dflt_fdb_add'
net/core/rtnetlink.c:3580: warning: Function parameter or member 'tb' not described in 'ndo_dflt_fdb_add'
net/core/rtnetlink.c:3580: warning: Function parameter or member 'dev' not described in 'ndo_dflt_fdb_add'
net/core/rtnetlink.c:3580: warning: Function parameter or member 'addr' not described in 'ndo_dflt_fdb_add'
net/core/rtnetlink.c:3580: warning: Function parameter or member 'vid' not described in 'ndo_dflt_fdb_add'
net/core/rtnetlink.c:3580: warning: Function parameter or member 'flags' not described in 'ndo_dflt_fdb_add'
net/core/rtnetlink.c:3718: warning: Function parameter or member 'ndm' not described in 'ndo_dflt_fdb_del'
net/core/rtnetlink.c:3718: warning: Function parameter or member 'tb' not described in 'ndo_dflt_fdb_del'
net/core/rtnetlink.c:3718: warning: Function parameter or member 'dev' not described in 'ndo_dflt_fdb_del'
net/core/rtnetlink.c:3718: warning: Function parameter or member 'addr' not described in 'ndo_dflt_fdb_del'
net/core/rtnetlink.c:3718: warning: Function parameter or member 'vid' not described in 'ndo_dflt_fdb_del'
net/core/rtnetlink.c:3861: warning: Function parameter or member 'skb' not described in 'ndo_dflt_fdb_dump'
net/core/rtnetlink.c:3861: warning: Function parameter or member 'cb' not described in 'ndo_dflt_fdb_dump'
net/core/rtnetlink.c:3861: warning: Function parameter or member 'filter_dev' not described in 'ndo_dflt_fdb_dump'
net/core/rtnetlink.c:3861: warning: Function parameter or member 'idx' not described in 'ndo_dflt_fdb_dump'
net/core/rtnetlink.c:3861: warning: Excess function parameter 'nlh' description in 'ndo_dflt_fdb_dump'

Cc: Hubert Sokolowski <hubert.sokolowski@intel.com>
Signed-off-by: Bart Van Assche <bvanassche@acm.org>
Signed-off-by: David S. Miller <davem@davemloft.net>

parent d79b3baf

net/core/rtnetlink.c

+6 −3

Original line number	Diff line number	Diff line
		@@ -3569,7 +3569,7 @@ errout:
		rtnl_set_sk_err(net, RTNLGRP_NEIGH, err);
		}

		/**
		/*
		* ndo_dflt_fdb_add - default netdevice operation to add an FDB entry
		*/
		int ndo_dflt_fdb_add(struct ndmsg *ndm,
		@@ -3708,7 +3708,7 @@ out:
		return err;
		}

		/**
		/*
		* ndo_dflt_fdb_del - default netdevice operation to delete an FDB entry
		*/
		int ndo_dflt_fdb_del(struct ndmsg *ndm,
		@@ -3847,8 +3847,11 @@ skip:

		/**
		* ndo_dflt_fdb_dump - default netdevice operation to dump an FDB table.
		* @nlh: netlink message header
		* @skb: socket buffer to store message in
		* @cb: netlink callback
		* @dev: netdevice
		* @filter_dev: ignored
		* @idx: the number of FDB table entries dumped is added to *@idx
		*
		* Default netdevice operation to dump the existing unicast address list.
		* Returns number of addresses from list put in skb.

Admin message