mlx5hws_bwc_matcher_create(9)

💅 mlx5hws_bwc_matcher_create — Kernel API Manual ✨

okay bestie, welcome to the mlx5hws_bwc_matcher_create(9) glow-up page 🌸 this one lives in the Kernel API Manual and it's literally the moment a brand-new BWC direct rule matcher gets born. let's get into it 🫶

---

🎀 NAME 🎀

mlx5hws_bwc_matcher_create — Create a new BWC direct rule matcher. periodt. 💅

---

✨ SYNOPSIS ✨

struct mlx5hws_bwc_matcher * mlx5hws_bwc_matcher_create (struct
mlx5hws_table *table , u32 priority , u8 match_criteria_enable , struct
mlx5hws_match_parameters *mask );

like, that's the whole signature, no cap 🔥

---

🦋 ARGUMENTS 🦋

• table — The table in which the new matcher will be opened. this is the vibe container, the matcher moves in here 🏠
• priority — Priority for this BWC matcher. it's a u32, so like, pick your rank ✨
• match_criteria_enable — Bitmask that defines matching criteria. u8, bitmask, she's doing bit math ngl 💀
• mask — Match parameters. this is your struct mlx5hws_match_parameters *, the actual what-to-match tea 🍓

---

🌈 DESCRIPTION 🌈

okay so this function does the following (spoiler: it's a three-step serve):

• creates match template based on flow items 🧚
• creates an empty action template 🎀
• creates a usual mlx5hws_matcher with these mt and at, setting its size to minimal 💖

like — mt and at in, minimal size out. iconic behavior honestly 👑

---

💀 NOTES 💀

read these before you @ me, fr fr 🙈

• table->ctx must have BWC support — if it doesn't, we're not doing this, bestie 😭
• complex rules are not supported — nope, not a thing, don't try it 💅

---

⭐ RETURN ⭐

pointer to mlx5hws_bwc_matcher on success or NULL otherwise. so like, check for NULL or it's giving undefined vibes 🫶

---

🔥 SEE ALSO 🔥

Kernel file ./drivers/net/ethernet/mellanox/mlx5/core/steering/hws/mlx5hws.h — go read it, iykyk 📖

• 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_insert_header(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_destroy(9)
• mlx5hws_bwc_rule_create(9)
• mlx5hws_bwc_rule_destroy(9)
• mlx5hws_bwc_rule_action_update(9)

---

and that's the page, bestie 🎀 mwah 💋 — this cutie came from ./drivers/net/ethernet/mellano... and she's dated October 2026, so like, future icon behavior fr fr ⭐💜