ef4_filter_insert_filter(9)

okay so this is the Kernel API Manual page for ef4_filter_insert_filter(9), and it’s literally the glow-up guide for adding or replacing a filter ✨

🌸 NAME 🌸

ef4_filter_insert_filter — add or replace a filter. periodt 💅

✨ SYNOPSIS ✨

the signature is giving:

s32 ef4_filter_insert_filter (struct ef4_nic *efx , struct ef4_filter_spec *spec , bool replace_equal );

🎀 ARGUMENTS 🎀

• efx — the NIC in which to insert the filter 🦋
• spec — the specification for the filter ✨
• replace_equal — flag for whether the specified filter may replace an existing filter with equal priority 👑

💅 DESCRIPTION 💅

On success, return the filter ID. On failure, return a negative error code. no cap.

If existing filters have equal match values to the new filter spec, then the new filter might replace them or the function might fail, as follows:

1. If the existing filters have lower priority, or replace_equal is set and they have equal priority, replace them. ate 💖
2. If the existing filters have higher priority, return -EPERM. 💀
3. If !ef4_filter_is_mc_recipient(spec), or the NIC does not support delivery to multiple recipients, return -EEXIST. 😭

This implies that filters for multiple multicast recipients must all be inserted with the same priority and replace_equal = false. fr fr 🌈

🦋 SEE ALSO 🦋

• Kernel file ./drivers/net/ethernet/sfc/falcon/efx.h
• ef4_filter_remove_id_safe(9)
• ef4_filter_get_filter_safe(9)

okay bye bestie 🫶 — source/version: ./drivers/net/ethernet/sfc/falcon, date: October 2026, manual: ef4_filter_insert_filter(9) 💜