lib/port/rte_port_frag.h

   1 /* SPDX-License-Identifier: BSD-3-Clause
   2  * Copyright(c) 2010-2014 Intel Corporation
   3  */
   4
   5 #ifndef __INCLUDE_RTE_PORT_IP_FRAG_H__
   6 #define __INCLUDE_RTE_PORT_IP_FRAG_H__
   7
   8 #ifdef __cplusplus
   9 extern "C" {
  10 #endif
  11
  12 /**
  13  * @file
  14  * RTE Port for IPv4 Fragmentation
  15  *
  16  * This port is built on top of pre-initialized single consumer rte_ring. In
  17  * order to minimize the amount of packets stored in the ring at any given
  18  * time, the IP fragmentation functionality is executed on ring read operation,
  19  * hence this port is implemented as an input port. A regular ring_writer port
  20  * can be created to write to the same ring.
  21  *
  22  * The packets written to the ring are either complete IP datagrams or jumbo
  23  * frames (i.e. IP packets with length bigger than provided MTU value). The
  24  * packets read from the ring are all non-jumbo frames. The complete IP
  25  * datagrams written to the ring are not changed. The jumbo frames are
  26  * fragmented into several IP packets with length less or equal to MTU.
  27  *
  28  ***/
  29
  30 #include <stdint.h>
  31
  32
  33 #include "rte_port.h"
  34
  35 /** ring_reader_ipv4_frag port parameters */
  36 struct rte_port_ring_reader_frag_params {
  37         /** Underlying single consumer ring that has to be pre-initialized. */
  38         struct rte_ring *ring;
  39
  40         /** Maximum Transfer Unit (MTU). Maximum IP packet size (in bytes). */
  41         uint32_t mtu;
  42
  43         /** Size of application dependent meta-data stored per each input packet
  44             that has to be copied to each of the fragments originating from the
  45             same input IP datagram. */
  46         uint32_t metadata_size;
  47
  48         /** Pre-initialized buffer pool used for allocating direct buffers for
  49             the output fragments. */
  50         struct rte_mempool *pool_direct;
  51
  52         /** Pre-initialized buffer pool used for allocating indirect buffers for
  53             the output fragments. */
  54         struct rte_mempool *pool_indirect;
  55 };
  56
  57 #define rte_port_ring_reader_ipv4_frag_params rte_port_ring_reader_frag_params
  58
  59 #define rte_port_ring_reader_ipv6_frag_params rte_port_ring_reader_frag_params
  60
  61 /** ring_reader_ipv4_frag port operations */
  62 extern struct rte_port_in_ops rte_port_ring_reader_ipv4_frag_ops;
  63
  64 /** ring_reader_ipv6_frag port operations */
  65 extern struct rte_port_in_ops rte_port_ring_reader_ipv6_frag_ops;
  66
  67 #ifdef __cplusplus
  68 }
  69 #endif
  70
  71 #endif