DPDK patches and discussions
 help / color / mirror / Atom feed
* [dpdk-dev] [PATCH] doc: add missing network layers in API reference
@ 2020-11-26 14:26 Olivier Matz
  2020-11-27  0:52 ` Thomas Monjalon
  0 siblings, 1 reply; 2+ messages in thread
From: Olivier Matz @ 2020-11-26 14:26 UTC (permalink / raw)
  To: dev

Add missing files in doxy-api-index.md and add a short description
for files that hadn't one.

Signed-off-by: Olivier Matz <olivier.matz@6wind.com>
---
 doc/api/doxy-api-index.md  |  7 ++++++-
 lib/librte_net/rte_ecpri.h |  9 +++++++++
 lib/librte_net/rte_gre.h   | 11 +++++++++++
 lib/librte_net/rte_higig.h |  8 ++++++++
 4 files changed, 34 insertions(+), 1 deletion(-)

diff --git a/doc/api/doxy-api-index.md b/doc/api/doxy-api-index.md
index bf6edb0276..a6e729de35 100644
--- a/doc/api/doxy-api-index.md
+++ b/doc/api/doxy-api-index.md
@@ -114,7 +114,12 @@ The public API headers are grouped by topics:
   [GRO]                (@ref rte_gro.h),
   [GSO]                (@ref rte_gso.h),
   [frag/reass]         (@ref rte_ip_frag.h),
-  [VXLAN]              (@ref rte_vxlan.h)
+  [VXLAN]              (@ref rte_vxlan.h),
+  [eCPRI]              (@ref rte_ecpri.h),
+  [Geneve]             (@ref rte_geneve.h),
+  [GRE]                (@ref rte_gre.h),
+  [ICMP]               (@ref rte_icmp.h),
+  [MPLS]               (@ref rte_mpls.h)
 
 - **QoS**:
   [metering]           (@ref rte_meter.h),
diff --git a/lib/librte_net/rte_ecpri.h b/lib/librte_net/rte_ecpri.h
index 1cbd6d8133..3f3a90335b 100644
--- a/lib/librte_net/rte_ecpri.h
+++ b/lib/librte_net/rte_ecpri.h
@@ -5,6 +5,15 @@
 #ifndef _RTE_ECPRI_H_
 #define _RTE_ECPRI_H_
 
+/**
+ * @file
+ *
+ * eCPRI headers definition.
+ *
+ * eCPRI (Common Public Radio Interface) is used in internal interfaces of radio
+ * base station in a 5G infrastructure.
+ */
+
 #include <stdint.h>
 #include <rte_byteorder.h>
 
diff --git a/lib/librte_net/rte_gre.h b/lib/librte_net/rte_gre.h
index ac3ddaada3..79f0fa8ff2 100644
--- a/lib/librte_net/rte_gre.h
+++ b/lib/librte_net/rte_gre.h
@@ -8,6 +8,17 @@
 #include <stdint.h>
 #include <rte_byteorder.h>
 
+/**
+ * @file
+ *
+ * GRE headers definition.
+ *
+ * Generic Routing Encapsulation (GRE) is a tunneling protocol that can
+ * encapsulate a wide variety of network layer protocols inside virtual
+ * point-to-point links or point-to-multipoint links over an Internet Protocol
+ * network.
+ */
+
 #ifdef __cplusplus
 extern "C" {
 #endif
diff --git a/lib/librte_net/rte_higig.h b/lib/librte_net/rte_higig.h
index b9cdfefed7..cc51ec021a 100644
--- a/lib/librte_net/rte_higig.h
+++ b/lib/librte_net/rte_higig.h
@@ -6,6 +6,14 @@
 #ifndef _RTE_HIGIG_H_
 #define _RTE_HIGIG_H_
 
+/**
+ * @file
+ *
+ * HIGIG2 headers definition.
+ *
+ * It is a layer 2.5 protocol and used in Broadcom switches.
+ */
+
 #include <stdint.h>
 #include <rte_byteorder.h>
 
-- 
2.25.1


^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2020-11-27  0:52 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-11-26 14:26 [dpdk-dev] [PATCH] doc: add missing network layers in API reference Olivier Matz
2020-11-27  0:52 ` Thomas Monjalon

DPDK patches and discussions

This inbox may be cloned and mirrored by anyone:

	git clone --mirror https://inbox.dpdk.org/dev/0 dev/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 dev dev/ https://inbox.dpdk.org/dev \
		dev@dpdk.org
	public-inbox-index dev

Example config snippet for mirrors.
Newsgroup available over NNTP:
	nntp://inbox.dpdk.org/inbox.dpdk.dev


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git