Doxygen: add missing module descriptions

doc/doxygen/Doxy.page.h

@@ -30,6 +30,7 @@
  - \ref rrtype    — DNS resource record types
  - \ref knot-tsig — TSIG operations
  - \ref wire      — Packet wire data manipulation
+ - \ref xdp       — XDP interface
  - \ref yparser   — Simple YAML parser
 
 \defgroup ctl        ctl
@@ -40,6 +41,7 @@
 \defgroup rrtype     rrtype
 \defgroup knot-tsig  tsig
 \defgroup wire       wire
+\defgroup xdp        xdp
 \defgroup yparser    yparser
 
 

src/libknot/descriptor.h

-/*  Copyright (C) 2019 CZ.NIC, z.s.p.o. <knot-dns@labs.nic.cz>
+/*  Copyright (C) 2021 CZ.NIC, z.s.p.o. <knot-dns@labs.nic.cz>
 
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
@@ -17,6 +17,8 @@
 /*!
  * \file
  *
+ * \brief DNS resource record descriptions.
+ *
  * \addtogroup rr
  * @{
  */

src/libknot/xdp/bpf-consts.h

@@ -14,6 +14,15 @@
     along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
+/*!
+ * \file
+ *
+ * \brief XDP filter constants.
+ *
+ * \addtogroup xdp
+ * @{
+ */
+
 #pragma once
 
 enum {
@@ -23,3 +32,5 @@ enum {
 	KNOT_XDP_LISTEN_PORT_DROP  = 1 << 18,    /*!< Drop incoming messages to ports >= port value. */
 	KNOT_XDP_LISTEN_PORT_ROUTE = 1 << 19,    /*!< Consider routing information from kernel. */
 };
+
+/*! @} */

src/libknot/xdp/bpf-user.h

@@ -14,6 +14,15 @@
     along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
+/*!
+ * \file
+ *
+ * \brief XDP socket interface.
+ *
+ * \addtogroup xdp
+ * @{
+ */
+
 #pragma once
 
 #include <bpf/xsk.h>
@@ -110,3 +119,5 @@ int kxsk_socket_start(const struct kxsk_iface *iface, uint32_t listen_port,
  * \param iface  Interface context.
  */
 void kxsk_socket_stop(const struct kxsk_iface *iface);
+
+/*! @} */

src/libknot/xdp/eth.h

@@ -14,6 +14,15 @@
     along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
+/*!
+ * \file
+ *
+ * \brief Ethernet device info interface.
+ *
+ * \addtogroup xdp
+ * @{
+ */
+
 #pragma once
 
 #include <stddef.h>
@@ -67,3 +76,5 @@ typedef enum {
  * \return Current XDP mode.
  */
 knot_xdp_mode_t knot_eth_xdp_mode(int if_index);
+
+/*! @} */

src/libknot/xdp/msg.h

@@ -14,6 +14,15 @@
     along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
+/*!
+ * \file
+ *
+ * \brief XDP message description.
+ *
+ * \addtogroup xdp
+ * @{
+ */
+
 #pragma once
 
 #include <stdint.h>
@@ -43,3 +52,5 @@ typedef struct knot_xdp_msg {
 	uint32_t ackno;
 	struct iovec payload;
 } knot_xdp_msg_t;
+
+/*! @} */

src/libknot/xdp/tcp.h

@@ -14,6 +14,15 @@
     along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
+/*!
+ * \file
+ *
+ * \brief TCP over XDP IO interface.
+ *
+ * \addtogroup xdp
+ * @{
+ */
+
 #pragma once
 
 #include "libknot/mm_ctx.h"
@@ -63,3 +72,5 @@ int knot_xdp_tcp_relay(knot_xdp_socket_t *socket, knot_xdp_msg_t msgs[],
  */
 int knot_xdp_tcp_send(knot_xdp_socket_t *socket, knot_tcp_relay_t relays[],
                       uint32_t relay_count);
+
+/*! @} */

src/libknot/xdp/xdp.h

@@ -14,6 +14,15 @@
     along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
+/*!
+ * \file
+ *
+ * \brief XDP IO interface.
+ *
+ * \addtogroup xdp
+ * @{
+ */
+
 #pragma once
 
 #include <stdbool.h>
@@ -176,3 +185,5 @@ void knot_xdp_recv_finish(knot_xdp_socket_t *socket, const knot_xdp_msg_t msgs[]
  * \param file    Output file.
  */
 void knot_xdp_info(const knot_xdp_socket_t *socket, FILE *file);
+
+/*! @} */