logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

Author

       Generated automatically by Doxygen for DPDK from the source code.

DPDK                                             Version 24.11.2                                    rte_ip4.h(3)

Detailed Description

       IPv4-related defines

       Definition in file rte_ip4.h.

Function Documentation

struct__rte_aligned(2)
       IPv4 Header < version and header length

       < header length

       < version

       < type of service

       < length of packet

       < packet ID

       < fragmentation offset

       < time to live

       < protocol ID

       < header checksum

       < source address

       < destination address

       Definition at line 1 of file rte_ip4.h.

   staticuint8_trte_ipv4_hdr_len(conststructrte_ipv4_hdr*ipv4_hdr)[inline],[static]
       Get the length of an IPv4 header.

       Parametersipv4_hdr Pointer to the IPv4 header.

       Returns
           The length of the IPv4 header (with options if present) in bytes.

       Definition at line 142 of file rte_ip4.h.

   staticuint16_trte_ipv4_cksum(conststructrte_ipv4_hdr*ipv4_hdr)[inline],[static]
       Process the IPv4 checksum of an IPv4 header.

       The checksum field must be set to 0 by the caller.

       Parametersipv4_hdr The pointer to the contiguous IPv4 header.

       Returns
           The complemented checksum to set in the IP packet.

       Definition at line 159 of file rte_ip4.h.

   static__rte_experimentaluint16_trte_ipv4_cksum_simple(conststructrte_ipv4_hdr*ipv4_hdr)[inline],[static]WarningEXPERIMENTAL: this API may change without prior notice.

       Process the IPv4 checksum of an IPv4 header without any extensions.

       The checksum field does NOT have to be set by the caller, the field is skipped by the calculation.

       Parametersipv4_hdr The pointer to the contiguous IPv4 header.

       Returns
           The complemented checksum to set in the IP packet.

       Definition at line 182 of file rte_ip4.h.

   staticuint16_trte_ipv4_phdr_cksum(conststructrte_ipv4_hdr*ipv4_hdr,uint64_tol_flags)[inline],[static]
       Process the pseudo-header checksum of an IPv4 header.

       The checksum field must be set to 0 by the caller.

       Depending on the ol_flags, the pseudo-header checksum expected by the drivers is not the same. For
       instance, when TSO is enabled, the IP payload length must not be included in the packet.

       When ol_flags is 0, it computes the standard pseudo-header checksum.

       Parametersipv4_hdr The pointer to the contiguous IPv4 header.
           ol_flags The ol_flags of the associated mbuf.

       Returns
           The non-complemented checksum to set in the L4 header.

       Definition at line 220 of file rte_ip4.h.

   staticuint16_trte_ipv4_udptcp_cksum(conststructrte_ipv4_hdr*ipv4_hdr,constvoid*l4_hdr)[inline],[static]
       Process the IPv4 UDP or TCP checksum.

       The layer 4 checksum must be set to 0 in the L4 header by the caller.

       Parametersipv4_hdr The pointer to the contiguous IPv4 header.
           l4_hdr The pointer to the beginning of the L4 header.

       Returns
           The complemented checksum to set in the L4 header.

       Definition at line 284 of file rte_ip4.h.

   staticuint16_trte_ipv4_udptcp_cksum_mbuf(conststructrte_mbuf*m,conststructrte_ipv4_hdr*ipv4_hdr,uint16_tl4_off)[inline],[static]
       Compute the IPv4 UDP/TCP checksum of a packet.

       Parametersm The pointer to the mbuf.
           ipv4_hdr The pointer to the contiguous IPv4 header.
           l4_off The offset in bytes to start L4 checksum.

       Returns
           The complemented checksum to set in the L4 header.

       Definition at line 341 of file rte_ip4.h.

   staticintrte_ipv4_udptcp_cksum_verify(conststructrte_ipv4_hdr*ipv4_hdr,constvoid*l4_hdr)[inline],[static]
       Validate the IPv4 UDP or TCP checksum.

       In case of UDP, the caller must first check if udp_hdr->dgram_cksum is 0 (i.e. no checksum).

       Parametersipv4_hdr The pointer to the contiguous IPv4 header.
           l4_hdr The pointer to the beginning of the L4 header.

       Returns
           Return 0 if the checksum is correct, else -1.

       Definition at line 373 of file rte_ip4.h.

   staticintrte_ipv4_udptcp_cksum_mbuf_verify(conststructrte_mbuf*m,conststructrte_ipv4_hdr*ipv4_hdr,uint16_tl4_off)[inline],[static]
       Verify the IPv4 UDP/TCP checksum of a packet.

       In case of UDP, the caller must first check if udp_hdr->dgram_cksum is 0 (i.e. no checksum).

       Parametersm The pointer to the mbuf.
           ipv4_hdr The pointer to the contiguous IPv4 header.
           l4_off The offset in bytes to start L4 checksum.

       Returns
           Return 0 if the checksum is correct, else -1.

       Definition at line 400 of file rte_ip4.h.

Macro Definition Documentation

#defineRTE_IPV4(a,b,c,d)Value:.PP
                              ((uint32_t)(((a) & 0xff) << 24) | \
                              (((b) & 0xff) << 16) | \
                              (((c) & 0xff) << 8)  | \
                              ((d) & 0xff))
       Create IPv4 address

       Definition at line 68 of file rte_ip4.h.

   #defineRTE_IPV4_MAX_PKT_LEN65535
       Maximal IPv4 packet length (including a header)

       Definition at line 74 of file rte_ip4.h.

   #defineRTE_IPV4_HDR_IHL_MASK(0x0f)
       Internet header length mask for version_ihl field

       Definition at line 77 of file rte_ip4.h.

   #defineRTE_IPV4_IHL_MULTIPLIER(4)
       Internet header length field multiplier (IHL field specifies overall header length in number of 4-byte
       words)

       Definition at line 82 of file rte_ip4.h.

   #defineRTE_IPV4_ANY((uint32_t)0x00000000)
       0.0.0.0

       Definition at line 110 of file rte_ip4.h.

   #defineRTE_IPV4_LOOPBACK((uint32_t)0x7f000001)
       127.0.0.1

       Definition at line 111 of file rte_ip4.h.

   #defineRTE_IPV4_BROADCAST((uint32_t)0xe0000000)
       224.0.0.0

       Definition at line 112 of file rte_ip4.h.

   #defineRTE_IPV4_ALLHOSTS_GROUP((uint32_t)0xe0000001)
       224.0.0.1

       Definition at line 113 of file rte_ip4.h.

   #defineRTE_IPV4_ALLRTRS_GROUP((uint32_t)0xe0000002)
       224.0.0.2

       Definition at line 114 of file rte_ip4.h.

   #defineRTE_IPV4_MAX_LOCAL_GROUP((uint32_t)0xe00000ff)
       224.0.0.255

       Definition at line 115 of file rte_ip4.h.

   #defineRTE_IPV4_MIN_MCASTRTE_IPV4(224,0,0,0)
       Minimal IPv4-multicast address

       Definition at line 121 of file rte_ip4.h.

   #defineRTE_IPV4_MAX_MCASTRTE_IPV4(239,255,255,255)
       Maximum IPv4 multicast address

       Definition at line 123 of file rte_ip4.h.

   #defineRTE_IPV4_MIN_IHL(0x5)
       < check if IPv4 address is multicast

       Definition at line 130 of file rte_ip4.h.

Name

       rte_ip4.h

Synopsis

       #include <stdint.h>
       #include <sys/socket.h>
       #include <sys/types.h>
       #include <netinet/in.h>
       #include <arpa/inet.h>
       #include <netinet/ip.h>
       #include <netinet/ip6.h>
       #include <rte_byteorder.h>
       #include <rte_cksum.h>
       #include <rte_mbuf.h>

   Macros
       #define RTE_IPV4(a,  b,  c,  d)
       #define RTE_IPV4_MAX_PKT_LEN   65535
       #define RTE_IPV4_HDR_IHL_MASK   (0x0f)
       #define RTE_IPV4_IHL_MULTIPLIER   (4)
       #define RTE_IPV4_ANY   ((uint32_t)0x00000000)
       #define RTE_IPV4_LOOPBACK   ((uint32_t)0x7f000001)
       #define RTE_IPV4_BROADCAST   ((uint32_t)0xe0000000)
       #define RTE_IPV4_ALLHOSTS_GROUP   ((uint32_t)0xe0000001)
       #define RTE_IPV4_ALLRTRS_GROUP   ((uint32_t)0xe0000002)
       #define RTE_IPV4_MAX_LOCAL_GROUP   ((uint32_t)0xe00000ff)
       #define RTE_IPV4_MIN_MCASTRTE_IPV4(224, 0, 0, 0)
       #define RTE_IPV4_MAX_MCASTRTE_IPV4(239, 255, 255, 255)
       #define RTE_IPV4_MIN_IHL   (0x5)

   Functions
       struct __rte_aligned (2) rte_ipv4_hdr
       static uint8_t rte_ipv4_hdr_len (const struct rte_ipv4_hdr *ipv4_hdr)
       static uint16_t rte_ipv4_cksum (const struct rte_ipv4_hdr *ipv4_hdr)
       static __rte_experimental uint16_t rte_ipv4_cksum_simple (const struct rte_ipv4_hdr *ipv4_hdr)
       static uint16_t rte_ipv4_phdr_cksum (const struct rte_ipv4_hdr *ipv4_hdr, uint64_t ol_flags)
       static uint16_t rte_ipv4_udptcp_cksum (const struct rte_ipv4_hdr *ipv4_hdr, const void *l4_hdr)
       static uint16_t rte_ipv4_udptcp_cksum_mbuf (const struct rte_mbuf *m, const struct rte_ipv4_hdr
           *ipv4_hdr, uint16_t l4_off)
       static int rte_ipv4_udptcp_cksum_verify (const struct rte_ipv4_hdr *ipv4_hdr, const void *l4_hdr)
       static int rte_ipv4_udptcp_cksum_mbuf_verify (const struct rte_mbuf *m, const struct rte_ipv4_hdr
           *ipv4_hdr, uint16_t l4_off)

See Also