Add a summary comment in all other printers

Moreover:
Remove some redundant comments
Update some summary comments
Update the specification URL for ATA over Ethernet (AoE) protocol

diff --git a/print-802_15_4.c b/print-802_15_4.c
index 4a1ef49b7fd03da999c43bf50ec03a3d7c43f301..6fe6d35b287f72837ddeaef64c01562709d6b4b8 100644 (file)
--- a/print-802_15_4.c
+++ b/print-802_15_4.c
@@ -20,6 +20,8 @@
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: IEEE 802.15.4 printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-ahcp.c b/print-ahcp.c
index 9f95947db29c96e600835e834b6f21ac8090c154..067b506944423c02b608dc8ac117d2ece0020b89 100644 (file)
--- a/print-ahcp.c
+++ b/print-ahcp.c
@@ -1,8 +1,4 @@
 /*
- * This module implements decoding of AHCP (Ad Hoc Configuration Protocol) based
- * on draft-chroboczek-ahcp-00 and source code of ahcpd-0.53.
- *
- *
  * Copyright (c) 2013 The TCPDUMP project
  * All rights reserved.
  *
@@ -29,6 +25,10 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: Ad Hoc Configuration Protocol (AHCP) printer */
+
+/* Based on draft-chroboczek-ahcp-00 and source code of ahcpd-0.53 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-aoe.c b/print-aoe.c
index d4ac4fb774c04b3b07e67ac4abbb36d5467a5343..97e93df2eab545f04deda9fd32bddce59d92cb4a 100644 (file)
--- a/print-aoe.c
+++ b/print-aoe.c
@@ -1,8 +1,4 @@
 /*
- * This module implements decoding of the ATA over Ethernet (AoE) protocol
- * according to the following specification:
- * http://support.coraid.com/documents/AoEr11.txt
- *
  * Copyright (c) 2014 The TCPDUMP project
  * All rights reserved.
  *
@@ -29,6 +25,10 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: ATA over Ethernet (AoE) protocol printer */
+
+/* specification: http://brantleycoilecompany.com/AoEr11.pdf */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-atalk.c b/print-atalk.c
index cd4812f3f79e2fc0c2cea2968c084d5a7a809e47..2a67499079d081a3bd247e7dbcc49503ea17e47a 100644 (file)
--- a/print-atalk.c
+++ b/print-atalk.c
@@ -17,8 +17,6 @@
  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
  * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
- *
- * Format and print AppleTalk packets.
  */
 
 /* \summary: AppleTalk printer */

diff --git a/print-babel.c b/print-babel.c
index f4e62f343b3b8ef66c7b29410e86b40578a569de..f8741d7bfd19fc314bb34b82a7f28c3bb52937bb 100644 (file)
--- a/print-babel.c
+++ b/print-babel.c
@@ -26,6 +26,8 @@
  * SUCH DAMAGE.
  */
 
+/* \summary: Babel Routing Protocol printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-bfd.c b/print-bfd.c
index 2950d22e68e29590b0551e0b28dc326b0fddb396..8a7afbcc8514dd605a9a7712d2a255b5084f1ce4 100644 (file)
--- a/print-bfd.c
+++ b/print-bfd.c
@@ -13,6 +13,8 @@
  * Original code by Hannes Gredler ([email protected])
  */
 
+/* \summary: Bidirectional Forwarding Detection (BFD) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-bootp.c b/print-bootp.c
index f6d0cbd08e04fe98bac82eaeb57438e0cdc53c9a..d16bd9db854d96bf378b6df9c85aff3d3a469738 100644 (file)
--- a/print-bootp.c
+++ b/print-bootp.c
@@ -17,8 +17,6 @@
  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
  * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
- *
- * Format and print bootp packets.
  */
 
 /* \summary: BOOTP and IPv4 DHCP printer */

diff --git a/print-calm-fast.c b/print-calm-fast.c
index a1690c0a532d9f99b7abe6eb47752e4fe658b8c9..4e4e51af2ab4c8292b45307398f269141f63a83e 100644 (file)
--- a/print-calm-fast.c
+++ b/print-calm-fast.c
@@ -15,6 +15,8 @@
  * Original code by Ola Martin Lykkja ([email protected])
  */
 
+/* \summary: Communication access for land mobiles (CALM) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-carp.c b/print-carp.c
index eb893e2af2b7d18314c331ebe5cecca1d37169f9..c650d181b08a768117389c7dea9738365ae4e2b3 100644 (file)
--- a/print-carp.c
+++ b/print-carp.c
@@ -34,6 +34,8 @@
  *
  */
 
+/* \summary: Common Address Redundancy Protocol (CARP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-cfm.c b/print-cfm.c
index 2d67e84c7000ebf8b8b3b1cb47e1e95ce5bf426c..745492bd040e60e5046260f1ec6d1f2ce8b167a9 100644 (file)
--- a/print-cfm.c
+++ b/print-cfm.c
@@ -12,11 +12,11 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * Support for the IEEE Connectivity Fault Management Protocols as per 802.1ag.
- *
  * Original code by Hannes Gredler ([email protected])
  */
 
+/* \summary: IEEE 802.1ag Connectivity Fault Management (CFM) protocols printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-dtp.c b/print-dtp.c
index 63bde45b8637cf1159b52bda381ba5c1f20fb73a..1d8c66a0004634e06206350eaad49a462ba222c9 100644 (file)
--- a/print-dtp.c
+++ b/print-dtp.c
@@ -12,11 +12,11 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * Dynamic Trunk Protocol (DTP)
- *
  * Original code by Carles Kishimoto <[email protected]>
  */
 
+/* \summary: Dynamic Trunking Protocol (DTP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-eap.c b/print-eap.c
index d9ce2958096b8f894560a0b3875b8547dc31cda0..ea081d1932ef89034e8374e75e418cec8300e6e9 100644 (file)
--- a/print-eap.c
+++ b/print-eap.c
@@ -16,9 +16,6 @@
  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
  * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
- *
- * Format and print EAP packets.
- *
  */
 
 /* \summary: Extensible Authentication Protocol (EAP) printer */

diff --git a/print-eigrp.c b/print-eigrp.c
index a56aae7186dfbb38eda2c91ad79ea2d3f95716d5..7e1ffb78cbf9398ad5296689d4a76f82f18eed34 100644 (file)
--- a/print-eigrp.c
+++ b/print-eigrp.c
@@ -14,6 +14,8 @@
  * FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: Enhanced Interior Gateway Routing Protocol (EIGRP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-forces.c b/print-forces.c
index 40789611ed12d30703b55d26269d6a3c74097400..f98bd0618e454f8dcad365e7f2c9d854a0e0df5b 100644 (file)
--- a/print-forces.c
+++ b/print-forces.c
@@ -14,6 +14,10 @@
  *
  */
 
+/* \summary: Forwarding and Control Element Separation (ForCES) Protocol printer */
+
+/* specification: RFC 5810 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
@@ -25,9 +29,6 @@
 
 static const char tstr[] = "[|forces]";
 
-/*
- * RFC5810: Forwarding and Control Element Separation (ForCES) Protocol
- */
 #define        ForCES_VERS     1
 #define        ForCES_HDRL     24
 #define        ForCES_ALNL     4U

diff --git a/print-ftp.c b/print-ftp.c
index 9359139557b339af7fa0326d5a79cf84a8606a1f..a1dd60709a20b6e96784239fafea5b8ba66ac2c0 100644 (file)
--- a/print-ftp.c
+++ b/print-ftp.c
@@ -11,10 +11,7 @@
  * FOR A PARTICULAR PURPOSE.
  */
 
-#ifndef lint
-static const char rcsid[] _U_ =
-    "@(#) $Header$";
-#endif
+/* \summary: File Transfer Protocol (FTP) printer */
 
 #ifdef HAVE_CONFIG_H
 #include "config.h"

diff --git a/print-geneve.c b/print-geneve.c
index c4645dbee09dfb4b4b56b05630d697dded7e966f..d565103d48aa90374e7f2ee93dc031dc86c44556 100644 (file)
--- a/print-geneve.c
+++ b/print-geneve.c
@@ -15,6 +15,8 @@
  * FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: Generic Network Virtualization Encapsulation (Geneve) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-geonet.c b/print-geonet.c
index 420ec5f710e356b8a84342afe95fa414bedf45ff..61441a0bf3b484961ec62f1562441cd75f5e9d98 100644 (file)
--- a/print-geonet.c
+++ b/print-geonet.c
@@ -15,6 +15,8 @@
  * Original code by Ola Martin Lykkja ([email protected])
  */
 
+/* \summary: ISO CALM FAST and ETSI GeoNetworking printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-hncp.c b/print-hncp.c
index 776675ba3d3246d41b2aca16413e77d18e3dd427..89ece160feb93603f7d7ad52705fb5de4d3b1385 100644 (file)
--- a/print-hncp.c
+++ b/print-hncp.c
@@ -26,6 +26,8 @@
  * SUCH DAMAGE.
  */
 
+/* \summary: Home Networking Control Protocol (HNCP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-http.c b/print-http.c
index b18b8861749b4680b593913604c71e65de8de6e3..0aec75818263c4d6dc90ca8288f273ee3567b496 100644 (file)
--- a/print-http.c
+++ b/print-http.c
@@ -11,10 +11,7 @@
  * FOR A PARTICULAR PURPOSE.
  */
 
-#ifndef lint
-static const char rcsid[] _U_ =
-    "@(#) $Header$";
-#endif
+/* \summary: Hypertext Transfer Protocol (HTTP) printer */
 
 #ifdef HAVE_CONFIG_H
 #include "config.h"

diff --git a/print-ipfc.c b/print-ipfc.c
index 6907ba3ed10e222ddca3f91d0b57747590776529..fc204652cc7657697bcfb5c3129cf7cb0ac78f7c 100644 (file)
--- a/print-ipfc.c
+++ b/print-ipfc.c
@@ -19,6 +19,10 @@
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: IP over Fibre Channel printer */
+
+/* specification: RFC 2625 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
@@ -32,10 +36,6 @@
 
 #include "ether.h"
 
-/*
- * RFC 2625 IP-over-Fibre Channel.
- */
-
 struct ipfc_header {
        u_char  ipfc_dhost[8];
        u_char  ipfc_shost[8];

diff --git a/print-ipnet.c b/print-ipnet.c
index 7fb2e77ae5fe8481ac26cc53665471403a25cefb..f71c145550b0463dd5df2cea7e7551219417298a 100644 (file)
--- a/print-ipnet.c
+++ b/print-ipnet.c
@@ -1,3 +1,5 @@
+/* \summary: Solaris DLT_IPNET printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-ipx.c b/print-ipx.c
index e7d7046aff9a7d20d4d54bb6c1b0476975cb4d91..d807a66ea546af611cd1df2ba79c0d77f33f1589 100644 (file)
--- a/print-ipx.c
+++ b/print-ipx.c
@@ -18,7 +18,6 @@
  * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  *
- * Format and print Novell IPX packets.
  * Contributed by Brad Parker ([email protected]).
  */
 

diff --git a/print-juniper.c b/print-juniper.c
index 94151c812fe967694abc76e965f51d4be0fcc122..a9a9339a722c0344ed1fb578e48a9c842fc2a49e 100644 (file)
--- a/print-juniper.c
+++ b/print-juniper.c
@@ -15,6 +15,8 @@
  * Original code by Hannes Gredler ([email protected])
  */
 
+/* \summary: DLT_JUNIPER_* printers */
+
 #ifndef lint
 #else
 __RCSID("NetBSD: print-juniper.c,v 1.3 2007/07/25 06:31:32 dogcow Exp ");

diff --git a/print-ldp.c b/print-ldp.c
index 45a23fe0c79976bcde813d4886b4c0038a0bb175..68149bba2447f988dc3ef94f9da2c30465649e2f 100644 (file)
--- a/print-ldp.c
+++ b/print-ldp.c
@@ -14,6 +14,8 @@
  *  and Steinar Haug ([email protected])
  */
 
+/* \summary: Label Distribution Protocol (LDP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-lisp.c b/print-lisp.c
index e9a2bc136df83de043a84d8aaecd8561395ec79c..47afe503596c5a06a630ab7b103856839a1e13ce 100644 (file)
--- a/print-lisp.c
+++ b/print-lisp.c
@@ -26,9 +26,10 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: - Locator/Identifier Separation Protocol (LISP) printer */
+
 /*
- * netdissect printer for LISP - Locator/Identifier Separation Protocol
- * RFC 6830
+ * specification: RFC 6830
  *
  *
  * The Map-Register message format is:

diff --git a/print-lldp.c b/print-lldp.c
index a0ca70092e4e3855b3fc62e4aebe2c4e1e20e310..e05394626e2d759ef27cd98163a682d72986dcaa 100644 (file)
--- a/print-lldp.c
+++ b/print-lldp.c
@@ -12,13 +12,13 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * support for the IEEE Link Discovery Protocol as per 802.1AB
- *
  * Original code by Hannes Gredler ([email protected])
  * IEEE and TIA extensions by Carles Kishimoto <[email protected]>
  * DCBX extensions by Kaladhar Musunuru <[email protected]>
  */
 
+/* \summary: IEEE 802.1ab Link Layer Discovery Protocol (LLDP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-lmp.c b/print-lmp.c
index 30edfc7437d222cb0f1298b767786ec5faba3486..f7093374e324577fabe20cb88213fc0fec70f38d 100644 (file)
--- a/print-lmp.c
+++ b/print-lmp.c
@@ -10,13 +10,15 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * Support for the Link Management Protocol as per rfc 4204.
- *
  * Original code by Hannes Gredler ([email protected])
  * Support for LMP service discovery extensions (defined by UNI 1.0) added
  * by Manu Pathak ([email protected]), May 2005
  */
 
+/* \summary: Link Management Protocol (LMP) printer */
+
+/* specification: RFC 4204 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-loopback.c b/print-loopback.c
index 2d5fca5d5f50dba052b718960ce7563308982f27..10f69310c5521a850376381128c1af5a8ada5f9e 100644 (file)
--- a/print-loopback.c
+++ b/print-loopback.c
@@ -1,9 +1,4 @@
 /*
- * This module implements decoding of the Loopback Protocol, originally
- * defined as the Configuration Testing Protocol. It is based on the following
- * specification:
- * http://www.mit.edu/people/jhawk/ctp.pdf
- *
  * Copyright (c) 2014 The TCPDUMP project
  * All rights reserved.
  *
@@ -30,6 +25,13 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: Loopback Protocol printer */
+
+/*
+ * originally defined as the Ethernet Configuration Testing Protocol.
+ * specification: http://www.mit.edu/people/jhawk/ctp.pdf
+ */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-lwapp.c b/print-lwapp.c
index 447ca60a0341e7ca9b041de90aad8d3e51533af9..bab3219f10ec4e6e3fe788bdfd3edc943524c28c 100644 (file)
--- a/print-lwapp.c
+++ b/print-lwapp.c
@@ -12,11 +12,13 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * Support for the Light Weight Access Point Protocol as per RFC 5412
- *
  * Original code by Carles Kishimoto <[email protected]>
  */
 
+/* \summary: Light Weight Access Point Protocol (LWAPP) printer */
+
+/* specification: RFC 5412 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-m3ua.c b/print-m3ua.c
index e4de71317d6f94a4c2f5b2b79dcedaae128490ee..1f974b2f43d2a75c56fa912690711bd8d7625ae7 100644 (file)
--- a/print-m3ua.c
+++ b/print-m3ua.c
@@ -22,6 +22,10 @@
  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: Message Transfer Part 3 (MTP3) User Adaptation Layer (M3UA) printer */
+
+/* RFC 4666 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
@@ -33,8 +37,6 @@
 
 static const char tstr[] = " [|m3ua]";
 
-/* RFC 4666 */
-
 #define M3UA_REL_1_0 1
 
 struct m3ua_common_header {

diff --git a/print-medsa.c b/print-medsa.c
index a29bf4a056b7e71009aef2e6b89892a172e16c93..1266c9c89613d5fbdc262dab2791597dc2f32312 100644 (file)
--- a/print-medsa.c
+++ b/print-medsa.c
@@ -19,6 +19,8 @@
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: Marvell Extended Distributed Switch Architecture (MEDSA) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-mpcp.c b/print-mpcp.c
index 5bd046698f0597d7e1d8a76432cf44fc1071bf65..1b9a5d7e15eb96bc966a7753b8ac6c918c48de87 100644 (file)
--- a/print-mpcp.c
+++ b/print-mpcp.c
@@ -12,11 +12,11 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * support for the IEEE MPCP protocol as per 802.3ah
- *
  * Original code by Hannes Gredler ([email protected])
  */
 
+/* \summary: IEEE 802.3ah Multi-Point Control Protocol (MPCP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-mptcp.c b/print-mptcp.c
index c711754f714bc0147dea9986404a04754b2c6acb..e757ea48f3a0a6025b77eac7f25081dbb6768d1e 100644 (file)
--- a/print-mptcp.c
+++ b/print-mptcp.c
@@ -32,6 +32,10 @@
  * SUCH DAMAGE.
  */
 
+/* \summary: Multipath TCP (MPTCP) printer */
+
+/* specification: RFC 6824 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-msnlb.c b/print-msnlb.c
index d4f66037e9af62676393c936999312a1d028db47..5264da496c9de753874c503bbc4c40c7aea8ac91 100644 (file)
--- a/print-msnlb.c
+++ b/print-msnlb.c
@@ -26,6 +26,8 @@
  * SUCH DAMAGE.
  */
 
+/* \summary: MS Network Load Balancing's (NLB) heartbeat printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-nflog.c b/print-nflog.c
index 0eefd342a45c7b1035005f0c1b58b583c1b61d26..41cbf788fd9c00437e624fa13552c7c8f2272dc2 100644 (file)
--- a/print-nflog.c
+++ b/print-nflog.c
@@ -25,6 +25,8 @@
  * DAMAGE.
  */
 
+/* \summary: DLT_NFLOG printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-nsh.c b/print-nsh.c
index 0130e6dd1c96f9a1c88ea4b4ad5c4e4767f8ea59..82976a03a029fa4e3fe84c1009454ec1676b9b03 100644 (file)
--- a/print-nsh.c
+++ b/print-nsh.c
@@ -21,6 +21,10 @@
  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: Network Service Header (NSH) printer */
+
+/* specification: draft-ietf-sfc-nsh-01 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
@@ -41,10 +45,6 @@ static const struct tok nsh_flags [] = {
 #define NSH_SERVICE_PATH_HDR_LEN 4
 #define NSH_HDR_WORD_SIZE 4U
 
-/*
- * NSH, draft-ietf-sfc-nsh-01 Network Service Header
- */
-
 void
 nsh_print(netdissect_options *ndo, const u_char *bp, u_int len)
 {

diff --git a/print-ntp.c b/print-ntp.c
index 76ae0d1109bb4be8b6eda9351e5502c356234e5b..0689264ff74bbe8fb31ce051a3bab99612394a11 100644 (file)
--- a/print-ntp.c
+++ b/print-ntp.c
@@ -18,7 +18,6 @@
  * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  *
- * Format and print ntp packets.
  *     By Jeffrey Mogul/DECWRL
  *     loosely based on print-bootp.c
  */

diff --git a/print-olsr.c b/print-olsr.c
index 2473dfed3f355b640651748a00f949b54b0be302..e095ef71262eaf36888c9f2b8f47cd487d6ab3bd 100644 (file)
--- a/print-olsr.c
+++ b/print-olsr.c
@@ -13,12 +13,14 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * Optimized Link State Protocl (OLSR) as per rfc3626
- *
  * Original code by Hannes Gredler <[email protected]>
  * IPv6 additions by Florian Forster <octo at verplant.org>
  */
 
+/* \summary: Optimized Link State Routing Protocol (OLSR) printer */
+
+/* specification: RFC 3626 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-openflow-1.0.c b/print-openflow-1.0.c
index a1b9f1e063033749adf547178cad1773bd31416b..ce9584305f9dd0eecc263a55dbff3c4d293e8f24 100644 (file)
--- a/print-openflow-1.0.c
+++ b/print-openflow-1.0.c
@@ -56,6 +56,8 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: OpenFlow protocol version 1.0 printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-openflow.c b/print-openflow.c
index 07f15de6cea48743421abb65c22a18f2f5fbd738..043adc2e857351a899fd9a21dd043462fa91716c 100644 (file)
--- a/print-openflow.c
+++ b/print-openflow.c
@@ -30,6 +30,8 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: version-independent OpenFlow printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-otv.c b/print-otv.c
index 3490d06622ad9531b96003fa25c98a8f1e0814ba..1b051072fd7cdd70985b99105e3bbd0b2116f54d 100644 (file)
--- a/print-otv.c
+++ b/print-otv.c
@@ -13,6 +13,10 @@
  * Original code by Francesco Fondelli (francesco dot fondelli, gmail dot com)
  */
 
+/* \summary: Overlay Transport Virtualization (OTV) printer */
+
+/* specification: draft-hasmit-otv-04 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-pktap.c b/print-pktap.c
index a49421bb399ecab98a63f0ea07b6a86b9a341349..0680f9e011b4dc335655a3fd0138a233e5627335 100644 (file)
--- a/print-pktap.c
+++ b/print-pktap.c
@@ -19,6 +19,8 @@
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: Apple's DLT_PKTAP printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-ppi.c b/print-ppi.c
index 3957154007e9f3fdaabd404109126c63c9c1cc30..cb8f3b95100b9e16c4bad3e834fbbb5dc0bf05a9 100644 (file)
--- a/print-ppi.c
+++ b/print-ppi.c
@@ -2,6 +2,8 @@
  * Oracle
  */
 
+/* \summary: Oracle DLT_PPI printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-resp.c b/print-resp.c
index 5e36edafdae5398e69f48292238d42c8ef77674e..2fed3aee7ae25f7c998018363cca56ffff8daf45 100644 (file)
--- a/print-resp.c
+++ b/print-resp.c
@@ -1,7 +1,4 @@
 /*
- * This file implements decoding of the REdis Serialization Protocol.
- *
- *
  * Copyright (c) 2015 The TCPDUMP project
  * All rights reserved.
  *
@@ -30,6 +27,8 @@
  * Initial contribution by Andrew Darqui ([email protected]).
  */
 
+/* \summary: REdis Serialization Protocol (RESP) printer */
+
 #define NETDISSECT_REWORKED
 #ifdef HAVE_CONFIG_H
 #include "config.h"

diff --git a/print-rpki-rtr.c b/print-rpki-rtr.c
index 569bc4ea7f65a4e2fabc0eac8e8ade2ee62e14e4..24ee32678f863fdf3c142f8ef4d1aa73cf24f34e 100644 (file)
--- a/print-rpki-rtr.c
+++ b/print-rpki-rtr.c
@@ -12,11 +12,13 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * support for the The RPKI/Router Protocol as RFC6810
- *
  * Original code by Hannes Gredler ([email protected])
  */
 
+/* \summary: Resource Public Key Infrastructure (RPKI) to Router Protocol printer */
+
+/* specification: RFC 6810 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-rtsp.c b/print-rtsp.c
index 7b6edb63be07e6a9a6552fbd042a71e58baeb46c..54cc930ed08d2a9da937b7dbf1912bb2fc6125aa 100644 (file)
--- a/print-rtsp.c
+++ b/print-rtsp.c
@@ -11,10 +11,7 @@
  * FOR A PARTICULAR PURPOSE.
  */
 
-#ifndef lint
-static const char rcsid[] _U_ =
-    "@(#) $Header$";
-#endif
+/* \summary: Real Time Streaming Protocol (RTSP) printer */
 
 #ifdef HAVE_CONFIG_H
 #include "config.h"

diff --git a/print-sflow.c b/print-sflow.c
index 7eecf0a051339c8a8f73e9e206e6de265380e5b3..37a41b529cd322194505772ec1e3afdec0d2b7d6 100644 (file)
--- a/print-sflow.c
+++ b/print-sflow.c
@@ -12,13 +12,15 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * The SFLOW protocol as per http://www.sflow.org/developers/specifications.php
- *
  * Original code by Carles Kishimoto <[email protected]>
  *
  * Expansion and refactoring by Rick Jones <[email protected]>
  */
 
+/* \summary: sFlow protocol printer */
+
+/* specification: http://www.sflow.org/developers/specifications.php */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-smtp.c b/print-smtp.c
index 56109bdf77e21757de8f9bda11f4fae991c0c0f1..0cdcf1d92c35489dabf856ab1ac941d8f2ed948e 100644 (file)
--- a/print-smtp.c
+++ b/print-smtp.c
@@ -11,6 +11,8 @@
  * FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: Simple Mail Transfer Protocol (SMTP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-stp.c b/print-stp.c
index e8c733289571e036502122673037c2f5c3fa783b..f0830293d51fe077778984cbbd7300628db3a351 100644 (file)
--- a/print-stp.c
+++ b/print-stp.c
@@ -5,7 +5,6 @@
  * BSD-style license that accompanies tcpdump or the GNU General
  * Public License
  *
- * Format and print IEEE 802.1d spanning tree protocol packets.
  * Contributed by Lennert Buytenhek <[email protected]>
  */
 

diff --git a/print-syslog.c b/print-syslog.c
index 08407d53596559ffd1317c9339b7399834fd9056..ff86676296dad2c6bb7fb97300a503b6b13477c4 100644 (file)
--- a/print-syslog.c
+++ b/print-syslog.c
@@ -14,6 +14,8 @@
  * FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: Syslog protocol printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-tftp.c b/print-tftp.c
index e635e0c78d9ec989e9439db2f8d187878de0c623..5519c686a416daf3bbc94243443cd8f3f74b01d8 100644 (file)
--- a/print-tftp.c
+++ b/print-tftp.c
@@ -17,8 +17,6 @@
  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
  * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
- *
- * Format and print trivial file transfer protocol packets.
  */
 
 /* \summary: Trivial File Transfer Protocol (TFTP) printer */

diff --git a/print-tipc.c b/print-tipc.c
index 2809d072e86b028666a6ba746e11daab3ada9c2b..4d8848fc0634a06106a1336564e9135da6d52650 100644 (file)
--- a/print-tipc.c
+++ b/print-tipc.c
@@ -19,6 +19,14 @@
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  */
 
+/* \summary: Transparent Inter-Process Communication (TIPC) protocol printer */
+
+/*
+ * specification:
+ *     http://tipc.sourceforge.net/doc/draft-spec-tipc-07.html
+ *     http://tipc.sourceforge.net/doc/tipc_message_formats.html
+ */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
@@ -32,13 +40,6 @@
 
 static const char tstr[] = "[|TIPC]";
 
-/*
- * Transparent Inter-Process Communication (TIPC) protocol.
- *
- *     http://tipc.sourceforge.net/doc/draft-spec-tipc-07.html
- *     http://tipc.sourceforge.net/doc/tipc_message_formats.html
- */
-
 #define TIPC_USER_LOW_IMPORTANCE       0
 #define TIPC_USER_MEDIUM_IMPORTANCE    1
 #define TIPC_USER_HIGH_IMPORTANCE      2

diff --git a/print-udld.c b/print-udld.c
index 22ae338d27346e7040567d9e3c45a219a7dd605f..02921d0e449834dbd921e4ba80f4594fa10d3a07 100644 (file)
--- a/print-udld.c
+++ b/print-udld.c
@@ -12,11 +12,13 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * UNIDIRECTIONAL LINK DETECTION (UDLD) as per RFC5171
- *
  * Original code by Carles Kishimoto <[email protected]>
  */
 
+/* \summary: Cisco UniDirectional Link Detection (UDLD) protocol printer */
+
+/* specification: RFC 5171 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-vjc.c b/print-vjc.c
index b213205106b7b70ed6dcda8c38bd7955205325c2..3287b9bcf789889d42dc47854d2ccd08f65606bb 100644 (file)
--- a/print-vjc.c
+++ b/print-vjc.c
@@ -19,7 +19,9 @@
  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  */
 
-/* \summary: PPP Van Jacobson compression (RFC1144) printer */
+/* \summary: PPP Van Jacobson compression printer */
+
+/* specification: RFC 1144 */
 
 #ifdef HAVE_CONFIG_H
 #include "config.h"

diff --git a/print-vqp.c b/print-vqp.c
index 7614011314c06ef44d4bf106edbf19e099344a1f..44a21935232bb86e14888677a901cbe25bb87296 100644 (file)
--- a/print-vqp.c
+++ b/print-vqp.c
@@ -12,11 +12,11 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * support for the Cisco prop. VQP Protocol
- *
  * Original code by Carles Kishimoto <[email protected]>
  */
 
+/* \summary: Cisco VLAN Query Protocol (VQP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-vtp.c b/print-vtp.c
index 854bc49d3d297ed78b4371f658750fcc4ed105eb..a96eeb08d15e09f13b5837178ea266e945fad47b 100644 (file)
--- a/print-vtp.c
+++ b/print-vtp.c
@@ -12,8 +12,6 @@
  * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  * FOR A PARTICULAR PURPOSE.
  *
- * VLAN TRUNKING PROTOCOL (VTP)
- *
  * Reference documentation:
  *  http://www.cisco.com/en/US/tech/tk389/tk689/technologies_tech_note09186a0080094c52.shtml
  *  http://www.cisco.com/warp/public/473/21.html
@@ -22,6 +20,8 @@
  * Original code ode by Carles Kishimoto <[email protected]>
  */
 
+/* \summary: Cisco VLAN Trunking Protocol (VTP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-vxlan-gpe.c b/print-vxlan-gpe.c
index 92be1e25c5857e0606194205927aa512a2c56d21..a3c214d3ef5b34e0bb225cff82ede5407fe20055 100644 (file)
--- a/print-vxlan-gpe.c
+++ b/print-vxlan-gpe.c
@@ -21,6 +21,10 @@
  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: Generic Protocol Extension for VXLAN (VXLAN GPE) printer */
+
+/* specification: draft-ietf-nvo3-vxlan-gpe-01 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-vxlan.c b/print-vxlan.c
index 8314aa78468ae52c5c869cf61157e8e5a248dfa7..052cbe3d45f7cd6b527e8dd9328b266a7dd9881a 100644 (file)
--- a/print-vxlan.c
+++ b/print-vxlan.c
@@ -13,6 +13,10 @@
  * Original code by Francesco Fondelli (francesco dot fondelli, gmail dot com)
  */
 
+/* \summary: Virtual eXtensible Local Area Network (VXLAN) printer */
+
+/* specification: RFC 7348 */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/print-zeromq.c b/print-zeromq.c
index 661b9737cb3fc58b9e70b178ae876ed20463748b..e07f8c6904f5b890e5c03644fced36d96d289f28 100644 (file)
--- a/print-zeromq.c
+++ b/print-zeromq.c
@@ -1,7 +1,4 @@
 /*
- * This file implements decoding of ZeroMQ network protocol(s).
- *
- *
  * Copyright (c) 2013 The TCPDUMP project
  * All rights reserved.
  *
@@ -28,6 +25,8 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+/* \summary: ZeroMQ Message Transport Protocol (ZMTP) printer */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif