virtio_device_ready(9)
π virtio_device_ready β bestie's guide to waking up ur vqs
ok so this is a page from the Kernel API Manual, section 9 (the kernel interfaces girlies), and it's about virtio_device_ready. lowercase name, main character function, let's GO π«Ά
β¨ NAME β¨
virtio_device_ready β enable vq use in probe function πΈ
like literally that's the whole job. enable vq use. in the probe function. no notes. π
π SYNOPSIS π
void virtio_device_ready (struct virtio_device *dev );
that's it. that's the whole signature. void in, void out, no return value, no drama, no error codes to check. iconic behaviour honestly β¨
π ARGUMENTS π
devβ the virtio device π (yes that's the entire description, she's a simple girl, she just wants her virtio device)
π¦ DESCRIPTION π¦
ok so LISTEN. the driver must call this to use vqs in the probe function. not "should", not "maybe if u feel like it" β must. π«Ά
so if ur sitting there in ur probe function like "hmm why can't I touch my virtqueues yet π" β it's because u didn't call virtio_device_ready first. that's the whole vibe check. call it, then ur vqs are usable inside probe. periodt. π₯
π NOTE π
vqs are enabled automatically after probe returns β¨
so likeβ¦ yes, they do get turned on for u eventually. but if u need them during probe? that's a u problem and u need virtio_device_ready, bestie. no cap. π
π SEE ALSO π
the lore continues in Kernel file ./include/linux/virtio_config.h π β go read it, it's giving essential context:
struct virtqueue_info(9)struct virtio_config_ops(9)struct virtio_map_ops(9)__virtio_test_bit(9)__virtio_set_bit(9)__virtio_clear_bit(9)virtio_has_feature(9)virtio_has_dma_quirk(9)virtio_synchronize_cbs(9)virtqueue_set_affinity(9)
that's ten whole cross-references, we ate π β¨
and that's the page!! mwah π
cute little sign-off: this one lives in ./include/linux, dated October 2026, and it's page virtio_device_ready(9) of the Kernel API Manual β go call her before u touch a vq in probe, ily, bye π§ββοΈβ
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms