__v4l2_devic...vs_until_err(9)

okay so bestie, welcome to the Kernel API Manual ✨ — this is the page for __v4l2_device_call_subdevs_until_err (the header shows it as __v4l2_devic...vs_until_err(9), love a good truncation 💅).

💖 NAME 💖

__v4l2_device_call_subdevs_until_err — calls the specified operation for all subdevs matching the condition. That's the whole vibe: call subdevs until err. Periodt. 💫

🎀 SYNOPSIS 🎀

The signature, exactly as it appears:

       __v4l2_device_call_subdevs_until_err (v4l2_dev , cond , o , f , args...
       );

🦋 ARGUMENTS 🦋

Here's the cast, bestie 🫶:

• v4l2_dev — the struct v4l2_device owning the sub-devices to iterate over.
• cond — the condition to be match 👀 (we're keeping the original phrasing, it's giving kernel-speak).
• o — name of the element at struct v4l2_subdev_ops that contains f. Each element there groups a set of operations functions.
• f — operation function that will be called if cond matches. The operation functions are defined in groups, according to each element at struct v4l2_subdev_ops.
• args — arguments for f.

🌸 DESCRIPTION 🌸

If the operation returns an error other than 0 or -ENOIOCTLCMD for any subdevice, then abort and return with that error code; zero otherwise. No cap, that's the whole rule. 💅

⚠️ NOTE ⚠️

bestie, important: subdevs cannot be added or deleted while walking the subdevs list. So don't touch the list mid-walk — that's the warning, fr fr 💀

🔥 SEE ALSO 🔥

Go read these too, iykyk 📚:

• Kernel file ./include/media/v4l2-device.h, struct v4l2_device(9)
• v4l2_device_get(9)
• v4l2_device_put(9)
• v4l2_device_register(9)
• v4l2_device_set_name(9)
• v4l2_device_disconnect(9)
• v4l2_device_unregister(9)
• v4l2_device_register_subdev(9)
• v4l2_device_unregister_subdev(9)
• __v4l2_device_register_subdev_nodes(9)
• v4l2_device_register_subdev_nodes(9)
• v4l2_device_register_ro_subdev_nodes(9)
• v4l2_subdev_notify(9)
• v4l2_device_supports_requests(9)
• v4l2_device_for_each_subdev(9)
• __v4l2_device_call_subdevs_p(9)
• __v4l2_device_call_subdevs(9)
• __v4l2_device_call_subdevs_until_err_p(9)
• v4l2_device_call_all(9)
• v4l2_device_call_until_err(9)
• v4l2_device_mask_call_all(9)
• v4l2_device_mask_call_until_err(9)
• v4l2_device_has_op(9)
• v4l2_device_mask_has_op(9)

cute little sign-off: this page comes from the source spot ./include/media, dated October 2026, and it's the __v4l2_devic...vs_until_err(9) page in the Kernel API Manual — mwah, slay, bye bestie 💖✨