diff mbox

[PATCHv2] make odp_icmp comments doxygen friendly

Message ID 1398421715-7875-1-git-send-email-maxim.uvarov@linaro.org
State Superseded
Headers show

Commit Message

Maxim Uvarov April 25, 2014, 10:28 a.m. UTC
Signed-off-by: Maxim Uvarov <maxim.uvarov@linaro.org>
---

 v2: align comments to the same column

 include/helper/odp_icmp.h | 90 ++++++++++++++++++++++++-----------------------
 1 file changed, 46 insertions(+), 44 deletions(-)
diff mbox

Patch

diff --git a/include/helper/odp_icmp.h b/include/helper/odp_icmp.h
index bfa356d..f34b68e 100644
--- a/include/helper/odp_icmp.h
+++ b/include/helper/odp_icmp.h
@@ -27,65 +27,67 @@  extern "C" {
 
 /** ICMP header */
 typedef struct ODP_PACKED {
-	uint8_t type;		/** message type */
-	uint8_t code;		/** type sub-code */
-	uint16be_t chksum;
+	uint8_t type;		/**< message type */
+	uint8_t code;		/**< type sub-code */
+	uint16be_t chksum;	/**< checksum of icmp header */
 	union {
 		struct {
 			uint16be_t id;
 			uint16be_t sequence;
-		} echo;			/** echo datagram */
-		uint32be_t gateway;	/** gateway address */
+		} echo;			/**< echo datagram */
+		uint32be_t gateway;	/**< gateway address */
 		struct {
 			uint16be_t __unused;
 			uint16be_t mtu;
-		} frag;			/** path mtu discovery */
-	} un;
+		} frag;			/**< path mtu discovery */
+	} un;			/**< icmp sub header */
 } odp_icmphdr_t;
 
-#define ICMP_ECHOREPLY		0	/** Echo Reply			*/
-#define ICMP_DEST_UNREACH	3	/** Destination Unreachable	*/
-#define ICMP_SOURCE_QUENCH	4	/** Source Quench		*/
-#define ICMP_REDIRECT		5	/** Redirect (change route)	*/
-#define ICMP_ECHO		8	/** Echo Request		*/
-#define ICMP_TIME_EXCEEDED	11	/** Time Exceeded		*/
-#define ICMP_PARAMETERPROB	12	/** Parameter Problem		*/
-#define ICMP_TIMESTAMP		13	/** Timestamp Request		*/
-#define ICMP_TIMESTAMPREPLY	14	/** Timestamp Reply		*/
-#define ICMP_INFO_REQUEST	15	/** Information Request		*/
-#define ICMP_INFO_REPLY		16	/** Information Reply		*/
-#define ICMP_ADDRESS		17	/** Address Mask Request	*/
-#define ICMP_ADDRESSREPLY	18	/** Address Mask Reply		*/
-#define NR_ICMP_TYPES		18
+#define ICMP_ECHOREPLY		0	/**< Echo Reply			*/
+#define ICMP_DEST_UNREACH	3	/**< Destination Unreachable	*/
+#define ICMP_SOURCE_QUENCH	4	/**< Source Quench		*/
+#define ICMP_REDIRECT		5	/**< Redirect (change route)	*/
+#define ICMP_ECHO		8	/**< Echo Request		*/
+#define ICMP_TIME_EXCEEDED	11	/**< Time Exceeded		*/
+#define ICMP_PARAMETERPROB	12	/**< Parameter Problem		*/
+#define ICMP_TIMESTAMP		13	/**< Timestamp Request		*/
+#define ICMP_TIMESTAMPREPLY	14	/**< Timestamp Reply		*/
+#define ICMP_INFO_REQUEST	15	/**< Information Request	*/
+#define ICMP_INFO_REPLY		16	/**< Information Reply		*/
+#define ICMP_ADDRESS		17	/**< Address Mask Request	*/
+#define ICMP_ADDRESSREPLY	18	/**< Address Mask Reply		*/
+#define NR_ICMP_TYPES		18	/**< Number of icmp types	*/
 
 /** Codes for UNREACH. */
-#define ICMP_NET_UNREACH	0	/** Network Unreachable		*/
-#define ICMP_HOST_UNREACH	1	/** Host Unreachable		*/
-#define ICMP_PROT_UNREACH	2	/** Protocol Unreachable	*/
-#define ICMP_PORT_UNREACH	3	/** Port Unreachable		*/
-#define ICMP_FRAG_NEEDED	4	/** Fragmentation Needed/DF set	*/
-#define ICMP_SR_FAILED		5	/** Source Route failed		*/
-#define ICMP_NET_UNKNOWN	6
-#define ICMP_HOST_UNKNOWN	7
-#define ICMP_HOST_ISOLATED	8
-#define ICMP_NET_ANO		9
-#define ICMP_HOST_ANO		10
-#define ICMP_NET_UNR_TOS	11
-#define ICMP_HOST_UNR_TOS	12
-#define ICMP_PKT_FILTERED	13	/** Packet filtered	 */
-#define ICMP_PREC_VIOLATION	14	/** Precedence violation */
-#define ICMP_PREC_CUTOFF	15	/** Precedence cut off   */
-#define NR_ICMP_UNREACH		15	/** instead of hardcoding immediate value */
+#define ICMP_NET_UNREACH	0	/**< Network Unreachable	*/
+#define ICMP_HOST_UNREACH	1	/**< Host Unreachable		*/
+#define ICMP_PROT_UNREACH	2	/**< Protocol Unreachable	*/
+#define ICMP_PORT_UNREACH	3	/**< Port Unreachable		*/
+#define ICMP_FRAG_NEEDED	4	/**< Fragmentation Needed/DF set*/
+#define ICMP_SR_FAILED		5	/**< Source Route failed	*/
+#define ICMP_NET_UNKNOWN	6	/**< Network Unknown		*/
+#define ICMP_HOST_UNKNOWN	7	/**< Host Unknown		*/
+#define ICMP_HOST_ISOLATED	8	/**< Host Isolated		*/
+#define ICMP_NET_ANO		9	/**< ICMP_NET_ANO		*/
+#define ICMP_HOST_ANO		10	/**< ICMP_HOST_ANO		*/
+#define ICMP_NET_UNR_TOS	11	/**< ICMP_NET_UNR_TOS		*/
+#define ICMP_HOST_UNR_TOS	12	/**< ICMP_HOST_UNR_TOS		*/
+#define ICMP_PKT_FILTERED	13	/**< Packet filtered		*/
+#define ICMP_PREC_VIOLATION	14	/**< Precedence violation	*/
+#define ICMP_PREC_CUTOFF	15	/**< Precedence cut off		*/
+#define NR_ICMP_UNREACH		15	/**< instead of hardcoding
+							immediate value */
 
 /** Codes for REDIRECT. */
-#define ICMP_REDIR_NET		0	/** Redirect Net		*/
-#define ICMP_REDIR_HOST		1	/** Redirect Host		*/
-#define ICMP_REDIR_NETTOS	2	/** Redirect Net for TOS	*/
-#define ICMP_REDIR_HOSTTOS	3	/** Redirect Host for TOS	*/
+#define ICMP_REDIR_NET		0	/**< Redirect Net		*/
+#define ICMP_REDIR_HOST		1	/**< Redirect Host		*/
+#define ICMP_REDIR_NETTOS	2	/**< Redirect Net for TOS	*/
+#define ICMP_REDIR_HOSTTOS	3	/**< Redirect Host for TOS	*/
 
 /** Codes for TIME_EXCEEDED. */
-#define ICMP_EXC_TTL		0	/** TTL count exceeded		*/
-#define ICMP_EXC_FRAGTIME	1	/** Fragment Reass time exceeded	*/
+#define ICMP_EXC_TTL		0	/**< TTL count exceeded		*/
+#define ICMP_EXC_FRAGTIME	1	/**< Fragment Reass time
+								exceeded*/
 
 /** @internal Compile time assert */
 ODP_ASSERT(sizeof(odp_icmphdr_t) == ODP_ICMPHDR_LEN, ODP_ICMPHDR_T__SIZE_ERROR);