From: Simon Wunderlich <sw@simonwunderlich.de>
To: davem@davemloft.net
Cc: netdev@vger.kernel.org, b.a.t.m.a.n@lists.open-mesh.org,
Sven Eckelmann <sven@narfation.org>,
Simon Wunderlich <sw@simonwunderlich.de>
Subject: [PATCH 13/20] batman-adv: Add missing kernel-doc to packet.h
Date: Fri, 15 Dec 2017 12:43:13 +0100 [thread overview]
Message-ID: <20171215114320.13645-14-sw@simonwunderlich.de> (raw)
In-Reply-To: <20171215114320.13645-1-sw@simonwunderlich.de>
From: Sven Eckelmann <sven@narfation.org>
Signed-off-by: Sven Eckelmann <sven@narfation.org>
Signed-off-by: Simon Wunderlich <sw@simonwunderlich.de>
---
net/batman-adv/packet.h | 25 +++++++++++++++++++++++--
1 file changed, 23 insertions(+), 2 deletions(-)
diff --git a/net/batman-adv/packet.h b/net/batman-adv/packet.h
index d58288c3a99d..ebe0605d1505 100644
--- a/net/batman-adv/packet.h
+++ b/net/batman-adv/packet.h
@@ -24,6 +24,12 @@
#include <asm/byteorder.h>
#include <linux/types.h>
+/**
+ * batadv_tp_is_error() - Check throughput meter return code for error
+ * @n: throughput meter return code
+ *
+ * Return: 0 when not error was detected, != 0 otherwise
+ */
#define batadv_tp_is_error(n) ((u8)(n) > 127 ? 1 : 0)
/**
@@ -91,7 +97,15 @@ enum batadv_iv_flags {
BATADV_DIRECTLINK = BIT(2),
};
-/* ICMP message types */
+/**
+ * enum batadv_icmp_packettype - ICMP message types
+ * @BATADV_ECHO_REPLY: success reply to BATADV_ECHO_REQUEST
+ * @BATADV_DESTINATION_UNREACHABLE: failure when route to destination not found
+ * @BATADV_ECHO_REQUEST: request BATADV_ECHO_REPLY from destination
+ * @BATADV_TTL_EXCEEDED: error after BATADV_ECHO_REQUEST traversed too many hops
+ * @BATADV_PARAMETER_PROBLEM: return code for malformed messages
+ * @BATADV_TP: throughput meter packet
+ */
enum batadv_icmp_packettype {
BATADV_ECHO_REPLY = 0,
BATADV_DESTINATION_UNREACHABLE = 3,
@@ -139,7 +153,14 @@ enum batadv_vlan_flags {
BATADV_VLAN_HAS_TAG = BIT(15),
};
-/* claim frame types for the bridge loop avoidance */
+/**
+ * enum batadv_bla_claimframe - claim frame types for the bridge loop avoidance
+ * @BATADV_CLAIM_TYPE_CLAIM: claim of a client mac address
+ * @BATADV_CLAIM_TYPE_UNCLAIM: unclaim of a client mac address
+ * @BATADV_CLAIM_TYPE_ANNOUNCE: announcement of backbone with current crc
+ * @BATADV_CLAIM_TYPE_REQUEST: request of full claim table
+ * @BATADV_CLAIM_TYPE_LOOPDETECT: mesh-traversing loop detect packet
+ */
enum batadv_bla_claimframe {
BATADV_CLAIM_TYPE_CLAIM = 0x00,
BATADV_CLAIM_TYPE_UNCLAIM = 0x01,
--
2.11.0
next prev parent reply other threads:[~2017-12-15 11:43 UTC|newest]
Thread overview: 23+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-12-15 11:43 [PATCH 00/20] pull request for net-next: batman-adv 2017-12-15 Simon Wunderlich
2017-12-15 11:43 ` [PATCH 01/20] batman-adv: Start new development cycle Simon Wunderlich
2017-12-15 11:43 ` [PATCH 02/20] batman-adv: Deinline batadv_orig_hash_find, save 7339 bytes Simon Wunderlich
2017-12-15 11:43 ` [PATCH 03/20] batman-adv: Add License-Filename to GPL-2.0 files Simon Wunderlich
2017-12-15 16:08 ` David Miller
[not found] ` <20171215114320.13645-1-sw-2YrNx6rUIHYiY0qSoAWiAoQuADTiUCJX@public.gmane.org>
2017-12-15 11:43 ` [PATCH 04/20] batman-adv: Add SPDX license identifier above copyright header Simon Wunderlich
2017-12-15 11:43 ` [PATCH 05/20] batman-adv: Add SPDX license identifier to batman-adv.rst Simon Wunderlich
2017-12-15 11:43 ` [PATCH 06/20] batman-adv: Add license header to Kconfig Simon Wunderlich
2017-12-15 11:43 ` [PATCH 07/20] batman-adv: Change batman_adv.h license to MIT Simon Wunderlich
2017-12-15 11:43 ` [PATCH 08/20] batman-adv: include gfp.h for GFP_* defines Simon Wunderlich
2017-12-15 11:43 ` [PATCH 09/20] batman-adv: include build_bug.h for BUILD_BUG_ON define Simon Wunderlich
[not found] ` <20171215114320.13645-10-sw-2YrNx6rUIHYiY0qSoAWiAoQuADTiUCJX@public.gmane.org>
2017-12-15 16:32 ` Sven Eckelmann
2017-12-15 11:43 ` [PATCH 10/20] batman-adv: Include net.h for net_ratelimited_function Simon Wunderlich
2017-12-15 11:43 ` [PATCH 11/20] batman-adv: include kobject.h for kobject_* functions Simon Wunderlich
2017-12-15 11:43 ` [PATCH 12/20] batman-adv: Remove unused sched.h include Simon Wunderlich
2017-12-15 11:43 ` Simon Wunderlich [this message]
2017-12-15 11:43 ` [PATCH 14/20] batman-adv: Use parentheses in function kernel-doc Simon Wunderlich
2017-12-15 11:43 ` [PATCH 15/20] batman-adv: Use inline kernel-doc for enum/struct Simon Wunderlich
2017-12-15 11:43 ` [PATCH 16/20] batman-adv: Fix kernel-doc references to struct members Simon Wunderlich
2017-12-15 11:43 ` [PATCH 17/20] batman-adv: Add kernel-doc to structs in headers Simon Wunderlich
2017-12-15 11:43 ` [PATCH 18/20] batman-adv: Add kernel-doc to enums " Simon Wunderlich
2017-12-15 11:43 ` [PATCH 19/20] batman-adv: Add kernel-doc to functions " Simon Wunderlich
2017-12-15 11:43 ` [PATCH 20/20] batman-adv: Add kernel-doc to externally visible functions Simon Wunderlich
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20171215114320.13645-14-sw@simonwunderlich.de \
--to=sw@simonwunderlich.de \
--cc=b.a.t.m.a.n@lists.open-mesh.org \
--cc=davem@davemloft.net \
--cc=netdev@vger.kernel.org \
--cc=sven@narfation.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).