mlx5hws_send_queue_poll(9)

💅 mlx5hws_send_queue_poll 💅

okay so bestie, welcome to the Kernel API Manual entry for mlx5hws_send_queue_poll(9) — like, it's literally just one function but she's iconic and you're gonna understand her perfectly, no cap 🫶

---

✨ NAME ✨

mlx5hws_send_queue_poll — poll the queue to see if your rule creations and deletions have finished yet. that's it, that's the whole thing 💖

---

🌸 SYNOPSIS 🌸

int mlx5hws_send_queue_poll (struct mlx5hws_context *ctx , u16 queue_id , struct mlx5hws_flow_op_result res[] , u32 res_nb );

like, she returns an int, obviously 😌

---

🎀 ARGUMENTS 🎀

• ctx — the context that this queue belongs to. her home, her origin, her main character context 👑
• queue_id — the id of the queue you want to poll. like, which queue bestie. u16, so keep it cute and in range 🦋
• res — the completion array. this is where the finished ops come home to roost, an array of struct mlx5hws_flow_op_result ✨
• res_nb — the max number of results to return, u32. basically how many snacks you're willing to carry out of the kitchen 🍓

---

🔥 RETURN 🔥

• a negative number on failure 😭 (something went wrong, go fix it)
• otherwise, the number of completions. so you literally get told how many ops got done. slay 💅

lowkey important: negative = bad vibes, anything else = how many completions you actually got back. don't mix those up, bestie 🙈

---

🌈 SEE ALSO 🌈

first up, the kernel file herself — the source of truth, the blueprint, the literal mothership:

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

and then the whole friend group, the entire squad, every single one, no gatekeeping:

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_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)

that's 48 besties. we counted. we don't play about completeness 💀💜

---

that's the whole page, bestie — go poll that queue and collect your completions 🧚💖

signed off from ./drivers/net/ethernet/mellano..., dated October 2026, brought to you by the Kernel API Manual and mlx5hws_send_queue_poll(9) — mwah 💋✨