vb2_queue_error(9)

💖 NAME 💖

vb2_queue_error(9) — signal a fatal error on the queue. This lil page lives in the Kernel API Manual, bestie, and it’s giving “emergency siren but make it kernel” 🚨✨

---

🌸 SYNOPSIS 🌸

void vb2_queue_error (struct vb2_queue *q );

---

🎀 ARGUMENTS 🎀

• q — pointer to struct vb2_queue with videobuf2 queue. That’s the queue bestie we’re about to flag 🫶

---

✨ DESCRIPTION ✨

Okay so this function is literally the “something went very wrong” button 💀. It flags that a fatal unrecoverable error has occurred and wakes up all processes waiting on the queue.

After that, polling will now set EPOLLERR, and queuing and dequeuing buffers will return -EIO. Not a cute vibe, but very important information 🔥.

The error flag will be cleared when canceling the queue — either from vb2_streamoff or vb2_queue_release. Periodt, that’s the cleanup path 💅.

Drivers should thus not call this function before starting the stream, otherwise the error flag will remain set until the queue is released when closing the device node. Ma’am, please do not do that 🙈.

---

👀 SEE ALSO 👀

Kernel file ./include/media/videobuf2-core.h is the source of this whole friend group 🌈:

• enum vb2_memory(9)
• struct vb2_mem_ops(9)
• struct vb2_plane(9)
• enum vb2_io_modes(9)
• enum vb2_buffer_state(9)
• struct vb2_buffer(9)
• struct vb2_ops(9)
• struct vb2_buf_ops(9)
• struct vb2_queue(9)
• vb2_queue_allows_cache_hints(9)
• vb2_plane_vaddr(9)
• vb2_plane_cookie(9)
• vb2_buffer_done(9)
• vb2_discard_done(9)
• vb2_wait_for_all_buffers(9)
• vb2_core_querybuf(9)
• vb2_core_reqbufs(9)
• vb2_core_create_bufs(9)
• vb2_core_prepare_buf(9)
• vb2_core_remove_bufs(9)
• vb2_core_qbuf(9)
• vb2_core_dqbuf(9)
• vb2_core_streamon(9)
• vb2_core_streamoff(9)
• vb2_core_expbuf(9)
• vb2_core_queue_init(9)
• vb2_core_queue_release(9)
• vb2_mmap(9)
• vb2_get_unmapped_area(9)
• vb2_core_poll(9)
• vb2_read(9)
• vb2_write(9)
• vb2_thread_fnc(9)
• vb2_thread_start(9)
• vb2_thread_stop(9)
• vb2_is_streaming(9)
• vb2_fileio_is_active(9)
• vb2_get_num_buffers(9)
• vb2_is_busy(9)
• vb2_get_drv_priv(9)
• vb2_set_plane_payload(9)
• vb2_get_plane_payload(9)
• vb2_plane_size(9)
• vb2_start_streaming_called(9)
• vb2_clear_last_buffer_dequeued(9)
• vb2_get_buffer(9)
• vb2_buffer_in_use(9)
• vb2_verify_memory_type(9)
• vb2_request_object_is_buffer(9)
• vb2_request_buffer_cnt(9)

---

That’s the whole page, bestie 🫶💖. Source/version: ./include/media · date: October 2026 · page: vb2_queue_error(9). Go forth and signal fatal errors responsibly ✨🌸