mlx5hws_act...nsert_header(9)

✨ mlx5hws_act...nsert_header(9) ✨

okay so bestie, this is a page straight out of the Kernel API Manual (section 9, we love a kernel man page moment 💅) and it's all about one very specific little function. let's get into it 🫶

---

🌸 NAME 🌸

mlx5hws_action_create_insert_header — the one that creates an insert header action. yes, that's the whole job. iconic, focused, knows what it wants 👑

---

🦋 SYNOPSIS 🦋

struct mlx5hws_action * mlx5hws_action_create_insert_header (struct
mlx5hws_context *ctx , u8 num_of_hdrs , struct
mlx5hws_action_insert_header *hdrs , u32 log_bulk_size , u32 flags );

look at that signature. five arguments, one pointer back. very demure, very mindful 😌✨

---

🎀 ARGUMENTS 🎀

• ctx — the context where your brand new action is gonna live. it's giving "this is the world we're building in" 🌍
• num_of_hdrs — how many headers you're handing over in the hdrs array. count them, bestie, don't vibe-guess 🔢
• hdrs — the headers array, packed with all your header info. the main character of the argument list fr fr 💖
• log_bulk_size — the number of unique values used with this insert header. (the name says log_, the description says "number of unique values" — we're reporting it exactly as written, no editorializing 🙈)
• flags — action creation flags, and they're of type enum mlx5hws_action_flags 🚩

---

⭐ RETURN ⭐

a pointer to mlx5hws_action when it works 🎉 — and NULL otherwise 😭. that's the whole vibe check: non-NULL = slay, NULL = try again.

---

💜 SEE ALSO 💜

first up, the ✨ Kernel file ✨ — go touch the source, it's right here:

./drivers/net/ethernet/mellanox/mlx5/core/steering/hws/mlx5hws.h

and now the extended universe, aka the whole friend group of related pages 🫶:

• mlx5hws_is_supported(9), mlx5hws_context_open(9),
• mlx5hws_context_close(9), mlx5hws_context_set_peer(9),
• mlx5hws_table_create(9), mlx5hws_table_destroy(9),
• mlx5hws_table_get_id(9), mlx5hws_table_set_default_miss(9),
• mlx5hws_match_template_create(9), mlx5hws_match_template_destroy(9),
• mlx5hws_action_template_create(9), mlx5hws_action_template_destroy(9),
• mlx5hws_matcher_create(9), mlx5hws_matcher_destroy(9),
• mlx5hws_matcher_attach_at(9), mlx5hws_matcher_resize_set_target(9),
• mlx5hws_matcher_resize_rule_move(9), mlx5hws_rule_create(9),
• mlx5hws_rule_destroy(9), mlx5hws_rule_action_update(9),
• mlx5hws_action_get_type(9), mlx5hws_action_get_dev(9),
• mlx5hws_action_create_dest_drop(9),
• mlx5hws_action_create_default_miss(9),
• mlx5hws_action_create_dest_table(9),
• mlx5hws_action_create_dest_table_num(9),
• mlx5hws_action_create_dest_match_range(9),
• mlx5hws_action_create_flow_sampler(9),
• mlx5hws_action_create_dest_vport(9), mlx5hws_action_create_tag(9),
• mlx5hws_action_create_counter(9), mlx5hws_action_create_reformat(9),
• mlx5hws_action_create_modify_header(9),
• mlx5hws_action_create_aso_meter(9), mlx5hws_action_create_pop_vlan(9),
• mlx5hws_action_create_push_vlan(9), mlx5hws_action_create_dest_array(9),
• mlx5hws_action_create_remove_header(9), mlx5hws_action_create_last(9),
• mlx5hws_action_destroy(9), mlx5hws_send_queue_poll(9),
• mlx5hws_send_queue_action(9), mlx5hws_debug_dump(9),
• mlx5hws_bwc_matcher_create(9), mlx5hws_bwc_matcher_destroy(9),
• mlx5hws_bwc_rule_create(9), mlx5hws_bwc_rule_destroy(9),
• mlx5hws_bwc_rule_action_update(9)

like i said. the whole friend group. go read them all, i'll wait 🧚

---

ngl the man page header got truncated in the wild as mlx5hws_act...nsert_header(9) — that's not a typo on my end, that's literally how it's printed, and yes it's giving "character limit on the group chat name" 💀

---

okay and one last cute sign-off 🎀 the source path got cut off too, printed as ./drivers/net/ethernet/mellano... (the actual file is the mellanox one up in SEE ALSO, iykyk 🌈), and the date on this whole thing is October 2026. so mark your calendars bestie, the kernel API manual said october 2026 and we're keeping it. mwah 💋✨🌸