doc: add decode group and related documentation.

src/decode-ethernet.c

@@ -15,6 +15,13 @@
  * 02110-1301, USA.
  */
 
+/**
+ * \ingroup decode
+ *
+ * @{
+ */
+
+
 /**
  * \file
  *
@@ -133,3 +140,6 @@ void DecodeEthernetRegisterTests(void) {
     UtRegisterTest("DecodeEthernetTest01", DecodeEthernetTest01, 0);
 #endif /* UNITTESTS */
 }
+/**
+ * @}
+ */

src/decode-gre.c

@@ -15,6 +15,13 @@
  * 02110-1301, USA.
  */
 
+/**
+ * \ingroup decode
+ *
+ * @{
+ */
+
+
 /**
  * \file
  *
@@ -385,3 +392,6 @@ void DecodeGRERegisterTests(void) {
     UtRegisterTest("DecodeGREtest03", DecodeGREtest03, 1);
 #endif /* UNITTESTS */
 }
+/**
+ * @}
+ */

src/decode-icmpv4.c

@@ -15,6 +15,13 @@
  * 02110-1301, USA.
  */
 
+/**
+ * \ingroup decode
+ *
+ * @{
+ */
+
+
 /**
  * \file
  *
@@ -769,3 +776,6 @@ void DecodeICMPV4RegisterTests(void) {
     UtRegisterTest("DecodeICMPV4test08", DecodeICMPV4test08, 1);
 #endif /* UNITTESTS */
 }
+/**
+ * @}
+ */

src/decode-icmpv6.c

@@ -15,6 +15,13 @@
  * 02110-1301, USA.
  */
 
+/**
+ * \ingroup decode
+ *
+ * @{
+ */
+
+
 /**
  * \file
  *
@@ -1106,3 +1113,6 @@ void DecodeICMPV6RegisterTests(void)
     UtRegisterTest("ICMPV6PayloadTest01", ICMPV6PayloadTest01, 1);
 #endif /* UNITTESTS */
 }
+/**
+ * @}
+ */

src/decode-ipv4.c

@@ -15,6 +15,13 @@
  * 02110-1301, USA.
  */
 
+/**
+ * \ingroup decode
+ *
+ * @{
+ */
+
+
 /**
  * \file
  *
@@ -1955,3 +1962,6 @@ void DecodeIPV4RegisterTests(void) {
     UtRegisterTest("DecodeIPV4DefragTest03", DecodeIPV4DefragTest03, 1);
 #endif /* UNITTESTS */
 }
+/**
+ * @}
+ */

src/decode-ipv6.c

@@ -15,6 +15,13 @@
  * 02110-1301, USA.
  */
 
+/**
+ * \ingroup decode
+ *
+ * @{
+ */
+
+
 /**
  * \file
  *
@@ -498,3 +505,6 @@ void DecodeIPV6(ThreadVars *tv, DecodeThreadVars *dtv, Packet *p, uint8_t *pkt,
     return;
 }
 
+/**
+ * @}
+ */

src/decode-ppp.c

@@ -15,6 +15,13 @@
  * 02110-1301, USA.
  */
 
+/**
+ * \ingroup decode
+ *
+ * @{
+ */
+
+
 /**
  * \file
  *
@@ -303,3 +310,6 @@ void DecodePPPRegisterTests(void) {
 #endif /* UNITTESTS */
 }
 
+/**
+ * @}
+ */

src/decode-pppoe.c

@@ -15,6 +15,13 @@
  * 02110-1301, USA.
  */
 
+/**
+ * \ingroup decode
+ *
+ * @{
+ */
+
+
 /**
  * \file
  *
@@ -449,3 +456,6 @@ void DecodePPPOERegisterTests(void) {
 #endif /* UNITTESTS */
 }
 
+/**
+ * @}
+ */

src/decode-raw.c

@@ -15,6 +15,13 @@
  * 02110-1301, USA.
  */
 
+/**
+ * \ingroup decode
+ *
+ * @{
+ */
+
+
 /**
  * \file
  *
@@ -212,3 +219,6 @@ void DecodeRawRegisterTests(void) {
     UtRegisterTest("DecodeRawTest03", DecodeRawTest03, 0);
 #endif /* UNITTESTS */
 }
+/**
+ * @}
+ */

src/decode-sctp.c

@@ -15,6 +15,13 @@
  * 02110-1301, USA.
  */
 
+/**
+ * \ingroup decode
+ *
+ * @{
+ */
+
+
 /**
  * \file
  *
@@ -71,3 +78,6 @@ void DecodeSCTP(ThreadVars *tv, DecodeThreadVars *dtv, Packet *p, uint8_t *pkt,
 
     return;
 }
+/**
+ * @}
+ */

src/decode-sll.c

@@ -15,6 +15,13 @@
  * 02110-1301, USA.
  */
 
+/**
+ * \ingroup decode
+ *
+ * @{
+ */
+
+
 /**
  * \file
  *
@@ -62,3 +69,6 @@ void DecodeSll(ThreadVars *tv, DecodeThreadVars *dtv, Packet *p, uint8_t *pkt, u
                        pkt, ntohs(sllh->sll_protocol));
     }
 }
+/**
+ * @}
+ */

src/decode-tcp.c

@@ -15,6 +15,13 @@
  * 02110-1301, USA.
  */
 
+/**
+ * \ingroup decode
+ *
+ * @{
+ */
+
+
 /**
  * \file
  *
@@ -510,3 +517,6 @@ void DecodeTCPRegisterTests(void)
     UtRegisterTest("TCPGetSackTest01", TCPGetSackTest01, 1);
 #endif /* UNITTESTS */
 }
+/**
+ * @}
+ */

src/decode-udp.c

@@ -15,6 +15,13 @@
  * 02110-1301, USA.
  */
 
+/**
+ * \ingroup decode
+ *
+ * @{
+ */
+
+
 /**
  * \file
  *
@@ -198,3 +205,6 @@ void DecodeUDPV4RegisterTests(void)
                    UDPV6CalculateInvalidChecksumtest04, 0);
 #endif /* UNITTESTS */
 }
+/**
+ * @}
+ */

src/decode-vlan.c

@@ -15,6 +15,13 @@
  * 02110-1301, USA.
  */
 
+/**
+ * \ingroup decode
+ *
+ * @{
+ */
+
+
 /**
  * \file
  *
@@ -224,3 +231,6 @@ void DecodeVLANRegisterTests(void) {
 #endif /* UNITTESTS */
 }
 
+/**
+ * @}
+ */

src/decode.c

@@ -15,6 +15,30 @@
  * 02110-1301, USA.
  */
 
+/**
+ * \defgroup decode Packet decoding
+ *
+ * \brief Code in charge of protocol decoding
+ *
+ * The task of decoding packets is made in different files and
+ * as Suricata is supporting encapsulation there is a potential
+ * recursivity in the call.
+ *
+ * For each protocol a DecodePROTO function is provided. For
+ * example we have DecodeIPV4() for IPv4 and DecodePPP() for
+ * PPP.
+ *
+ * These functions have all a pkt and and a len argument which
+ * are respectively a pointer to the protocol data and the length
+ * of this protocol data.
+ *
+ * \attention The pkt parameter must point to the effective data because
+ * it will be used later to set per protocol pointer like Packet::tcph
+ *
+ * @{
+ */
+
+
 /**
  * \file
  *
@@ -321,3 +345,6 @@ inline int PacketCopyData(Packet *p, uint8_t *pktdata, int pktlen)
     SET_PKT_LEN(p, (size_t)pktlen);
     return PacketCopyDataOffset(p, 0, pktdata, pktlen);
 }
+/**
+ * @}
+ */

src/suricata.h

@@ -34,6 +34,7 @@
  *
  * Documentation is generate from comments placed in all parts of the code.
  * But you will also find some groups describing specific functional parts:
+ *  - \ref decode
  *  - \ref httplayer
  *  - \ref sigstate
  *  - \ref threshold