v4l2_device_set_name(9)

💖 v4l2_device_set_name(9) 💖

okay bestie, welcome to the Kernel API Manual page for v4l2_device_set_name(9) — it’s giving optional function realness, and yes, we’re about to make the name field of struct &v4l2_device make sense 🫶

---

✨ NAME ✨

v4l2_device_set_name — optional function to initialize the name field of struct &v4l2_device

🌸 SYNOPSIS 🌸

int v4l2_device_set_name (struct v4l2_device *v4l2_dev , const char
       *basename , atomic_t *instance );

🎀 ARGUMENTS 🎀

• v4l2_dev — pointer to struct v4l2_device
• basename — base name for the device name
• instance — pointer to a static atomic_t var with the instance usage for the device driver.

💅 DESCRIPTION 💅

v4l2_device_set_name initializes the name field of struct v4l2_device using the driver name and a driver-global atomic_t instance.

This function will increment the instance counter and returns the instance value used in the name.

🦋 EXAMPLE 🦋

static atomic_t drv_instance = ATOMIC_INIT(0);

...

instance = v4l2_device_set_name(& v4l2_dev, "foo", & drv_instance);

The first time this is called the name field will be set to foo0 and this function returns 0. If the name ends with a digit (e.g. cx18), then the name will be set to cx18-0 since cx180 would look really odd.

🔥 SEE ALSO 🔥

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

---

that’s the whole vibe, bestie 💜 this one lives under ./include/media, is dated October 2026, and belongs to the v4l2_device_set_name(9) title — mwah 💋