mlx5dv_create_st..._steering_anchor(3)

okay bestie, welcome to the mlx5dv_create_st..._steering_anchor(3) manual page — this is the one about steering anchors, and yes we’re gonna make it make sense 💅✨

💖 NAME 💖

mlx5dv_create_steering_anchor — creates a steering anchor, no cap 🫶

mlx5dv_destroy_steering_anchor — destroys a steering anchor, periodt 💀

---

✨ SYNOPSIS ✨

#include <infiniband/mlx5dv.h>

struct mlx5dv_steering_anchor *
mlx5dv_create_steering_anchor(struct ibv_context *context,
                              struct mlx5dv_steering_anchor_attr *attr);

int mlx5dv_destroy_steering_anchor(struct mlx5dv_steering_anchor *sa);

---

🌸 DESCRIPTION 🌸

So the vibe is: a user can take packets into a user-configured sandbox and do packet processing there. At the end of that little journey, a steering pipeline decision is made about what to do with the packet. Iconic, honestly 🌈

A steering anchor lets the user reinject the packet back into the kernel for additional processing. Like sending it back home for extra glow-up time 🧚

mlx5dv_create_steering_anchor() creates an anchor that will allow injecting the packet back into the kernel steering pipeline. Obsessed with the pipeline re-entry moment 💫

mlx5dv_destroy_steering_anchor() destroys a steering anchor. Cleanup queen behavior 👑

---

🎀 ARGUMENTS 🎀

context

The device context to associate the steering anchor with. Basically: which device is this anchor gonna be linked to, bestie? 🦋

attr

Anchor attributes specify the priority and flow table type to which the anchor will point. It’s giving “tell me where this anchor should aim its main character energy” ✨

struct mlx5dv_steering_anchor_attr {
        enum mlx5dv_flow_table_type ft_type;
        uint16_t priority;
        uint64_t comp_mask;
};

• ft_type — the flow table type to which the anchor will point. The destination type, iykyk 💜
• priority — the priority inside ft_type to which the created anchor will point. Priorities matter, fr fr 🎯
• comp_mask — reserved for future extension, must be 0 now.

🚨 bestie do not mess with comp_mask — it’s reserved for future extension and must be 0 now. No cap.

mlx5dv_steering_anchor

struct mlx5dv_steering_anchor {
    uint32_t id;
};

• id — the flow table ID to use as the destination when creating the flow table entry. That’s the destination ID, periodt 💅

---

⭐ RETURN VALUE ⭐

• mlx5dv_create_steering_anchor() — returns a pointer to a new mlx5dv_steering_anchor on success. On error NULL is returned and errno is set. Sad girl error path 😭
• mlx5dv_destroy_steering_anchor() — returns 0 on success and errno value on error. Very straightforward, very demure 🎀

---

👑 AUTHORS 👑

Mark Bloch <mbloch@nvidia.com> — author credit, legendary behavior 🌟

---

source/version + date check, bestie: the footer is literally mlx5dv_create_st..._steering_anchor(3), and the page doesn’t show a separate version or date beyond that — so that’s the whole paper trail, slay 💖✨