mlx5hws_rule_create(9)

okay bestie, welcome to the mlx5hws_rule_create(9) page from the Kernel API Manual 💖 this one is literally about enqueuing a create-rule operation, and it's giving “put the rule request in the queue” main character energy ✨

🎀 NAME 🎀

mlx5hws_rule_create — enqueue create rule operation. 🫶

✨ SYNOPSIS ✨

int mlx5hws_rule_create (struct mlx5hws_matcher *matcher , u8 mt_idx ,
       u32 *match_param , u8 at_idx , struct mlx5hws_rule_action rule_actions[]
       , struct mlx5hws_rule_attr *attr , struct mlx5hws_rule *rule_handle );

💅 ARGUMENTS 💅

• matcher — the matcher in which the new rule will be created. literally the home for your new rule 🏠
• mt_idx — match template index to create the match with.
• match_param — the match parameter PRM buffer used for value matching.
• at_idx — action template index to apply the actions with.
• rule_actions — rule actions to be executed on match.
• attr — rule creation attributes.
• rule_handle — a valid rule handle. The handle doesn't require any initialization. no cap, zero setup needed 🙈

🔥 RETURN 🔥

Zero on successful enqueue, non-zero otherwise. That's the vibe check: 0 means it enqueued, anything else means nope 😭

🦋 SEE ALSO 🦋

The kernel file is right here, bestie: ./drivers/net/ethernet/mellanox/mlx5/core/steering/hws/mlx5hws.h 📁

and the whole mlx5hws friend group:

• 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_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_create(9)
• mlx5hws_bwc_matcher_destroy(9)
• mlx5hws_bwc_rule_create(9)
• mlx5hws_bwc_rule_destroy(9)
• mlx5hws_bwc_rule_action_update(9)

mwah 💋 — source/version ./drivers/net/ethernet/mellano..., date October 2026, page mlx5hws_rule_create(9). stay slay, bestie 🫶