mlx5dv_flow_action_esp(3) — Linux manual page

mlx5dv_flow_action_esp(3)                       mlx5dv_flow_action_esp(3)

NAME         top

       mlx5dv_flow_action_esp - Flow action esp for mlx5 provider

SYNOPSIS         top

              #include <infiniband/mlx5/mlx5dv.h>

              struct ibv_flow_action *
              mlx5dv_create_flow_action_esp(struct ibv_context *ctx,
                                struct ibv_flow_action_esp_attr *esp,
                                struct mlx5dv_flow_action_esp *mlx5_attr);

DESCRIPTION         top

       Create an IPSEC ESP flow steering action.
       This verb is identical to ibv_create_flow_action_esp verb, but
       allows mlx5 specific flags.

ARGUMENTS         top

       Please see ibv_flow_action_esp(3) man page for ctx and esp.

   mlx5_attr argument
              struct mlx5dv_flow_action_esp {
                  uint64_t comp_mask;  /* Use enum mlx5dv_flow_action_esp_mask */
                  uint32_t action_flags; /* Use enum mlx5dv_flow_action_flags */
              };

       comp_mask
              Bitmask specifying what fields in the structure are valid
              (enum mlx5dv_flow_action_esp_mask).

       action_flags
              A bitwise OR of the various values described below.

              MLX5DV_FLOW_ACTION_FLAGS_REQUIRE_METADATA:
              Each received and transmitted packet using offload is
              expected to carry metadata in the form of a L2 header
              with ethernet type 0x8CE4, followed by 6 bytes of data and
              the original packet ethertype.

NOTE         top

       The ESN is expected to be placed in the IV field for egress
       packets.
       The 64 bit sequence number is written in big-endian over the 64
       bit IV field.
       There is no need to call modify to update the ESN window on egress
       when this DV is used.

SEE ALSO         top

       ibv_flow_action_esp(3), RFC 4106

COLOPHON         top

       This page is part of the rdma-core (RDMA Core Userspace Libraries
       and Daemons) project.  Information about the project can be found
       at ⟨https://github.com/linux-rdma/rdma-core⟩.  If you have a bug
       report for this manual page, send it to
       linux-rdma@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/linux-rdma/rdma-core.git⟩ on 2025-08-11.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2025-08-04.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

                                                mlx5dv_flow_action_esp(3)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.