€•Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œtranslations”Œ LanguagesNode”“”)”}”(hhh]”(hŒpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ` for a general overview of virtio.”h]”(hŒžThis document serves as a basic guideline for driver programmers that need to hack a new virtio driver or understand the essentials of the existing ones. See ”…””}”(hhêhžhhŸNh Nubh)”}”(hŒ:ref:`Virtio on Linux `”h]”hŒinline”“”)”}”(hhôh]”hŒVirtio on Linux”…””}”(hhøhžhhŸNh Nubah}”(h]”h ]”(Œxref”Œstd”Œstd-ref”eh"]”h$]”h&]”uh1höhhòubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”Œ(driver-api/virtio/writing_virtio_drivers”Œ refdomain”jŒreftype”Œref”Œrefexplicit”ˆŒrefwarn”ˆŒ reftarget”Œvirtio”uh1hhŸh³h KhhêubhŒ" for a general overview of virtio.”…””}”(hhêhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Khh×hžhubeh}”(h]”Œintroduction”ah ]”h"]”Œintroduction”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K ubhÃ)”}”(hhh]”(hÈ)”}”(hŒDriver boilerplate”h]”hŒDriver boilerplate”…””}”(hj,hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj)hžhhŸh³h Kubhé)”}”(hX#As a bare minimum, a virtio driver needs to register in the virtio bus and configure the virtqueues for the device according to its spec, the configuration of the virtqueues in the driver side must match the virtqueue definitions in the device. A basic driver skeleton could look like this::”h]”hX"As a bare minimum, a virtio driver needs to register in the virtio bus and configure the virtqueues for the device according to its spec, the configuration of the virtqueues in the driver side must match the virtqueue definitions in the device. A basic driver skeleton could look like this:”…””}”(hj:hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Khj)hžhubhŒ literal_block”“”)”}”(hX`#include #include #include #include /* device private data (one per device) */ struct virtio_dummy_dev { struct virtqueue *vq; }; static void virtio_dummy_recv_cb(struct virtqueue *vq) { struct virtio_dummy_dev *dev = vq->vdev->priv; char *buf; unsigned int len; while ((buf = virtqueue_get_buf(dev->vq, &len)) != NULL) { /* process the received data */ } } static int virtio_dummy_probe(struct virtio_device *vdev) { struct virtio_dummy_dev *dev = NULL; /* initialize device data */ dev = kzalloc(sizeof(struct virtio_dummy_dev), GFP_KERNEL); if (!dev) return -ENOMEM; /* the device has a single virtqueue */ dev->vq = virtio_find_single_vq(vdev, virtio_dummy_recv_cb, "input"); if (IS_ERR(dev->vq)) { kfree(dev); return PTR_ERR(dev->vq); } vdev->priv = dev; /* from this point on, the device can notify and get callbacks */ virtio_device_ready(vdev); return 0; } static void virtio_dummy_remove(struct virtio_device *vdev) { struct virtio_dummy_dev *dev = vdev->priv; /* * disable vq interrupts: equivalent to * vdev->config->reset(vdev) */ virtio_reset_device(vdev); /* detach unused buffers */ while ((buf = virtqueue_detach_unused_buf(dev->vq)) != NULL) { kfree(buf); } /* remove virtqueues */ vdev->config->del_vqs(vdev); kfree(dev); } static const struct virtio_device_id id_table[] = { { VIRTIO_ID_DUMMY, VIRTIO_DEV_ANY_ID }, { 0 }, }; static struct virtio_driver virtio_dummy_driver = { .driver.name = KBUILD_MODNAME, .id_table = id_table, .probe = virtio_dummy_probe, .remove = virtio_dummy_remove, }; module_virtio_driver(virtio_dummy_driver); MODULE_DEVICE_TABLE(virtio, id_table); MODULE_DESCRIPTION("Dummy virtio driver"); MODULE_LICENSE("GPL");”h]”hX`#include #include #include #include /* device private data (one per device) */ struct virtio_dummy_dev { struct virtqueue *vq; }; static void virtio_dummy_recv_cb(struct virtqueue *vq) { struct virtio_dummy_dev *dev = vq->vdev->priv; char *buf; unsigned int len; while ((buf = virtqueue_get_buf(dev->vq, &len)) != NULL) { /* process the received data */ } } static int virtio_dummy_probe(struct virtio_device *vdev) { struct virtio_dummy_dev *dev = NULL; /* initialize device data */ dev = kzalloc(sizeof(struct virtio_dummy_dev), GFP_KERNEL); if (!dev) return -ENOMEM; /* the device has a single virtqueue */ dev->vq = virtio_find_single_vq(vdev, virtio_dummy_recv_cb, "input"); if (IS_ERR(dev->vq)) { kfree(dev); return PTR_ERR(dev->vq); } vdev->priv = dev; /* from this point on, the device can notify and get callbacks */ virtio_device_ready(vdev); return 0; } static void virtio_dummy_remove(struct virtio_device *vdev) { struct virtio_dummy_dev *dev = vdev->priv; /* * disable vq interrupts: equivalent to * vdev->config->reset(vdev) */ virtio_reset_device(vdev); /* detach unused buffers */ while ((buf = virtqueue_detach_unused_buf(dev->vq)) != NULL) { kfree(buf); } /* remove virtqueues */ vdev->config->del_vqs(vdev); kfree(dev); } static const struct virtio_device_id id_table[] = { { VIRTIO_ID_DUMMY, VIRTIO_DEV_ANY_ID }, { 0 }, }; static struct virtio_driver virtio_dummy_driver = { .driver.name = KBUILD_MODNAME, .id_table = id_table, .probe = virtio_dummy_probe, .remove = virtio_dummy_remove, }; module_virtio_driver(virtio_dummy_driver); MODULE_DEVICE_TABLE(virtio, id_table); MODULE_DESCRIPTION("Dummy virtio driver"); MODULE_LICENSE("GPL");”…””}”hjJsbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jHhŸh³h Khj)hžhubhé)”}”(hXThe device id ``VIRTIO_ID_DUMMY`` here is a placeholder, virtio drivers should be added only for devices that are defined in the spec, see include/uapi/linux/virtio_ids.h. Device ids need to be at least reserved in the virtio spec before being added to that file.”h]”(hŒThe device id ”…””}”(hjXhžhhŸNh NubhŒliteral”“”)”}”(hŒ``VIRTIO_ID_DUMMY``”h]”hŒVIRTIO_ID_DUMMY”…””}”(hjbhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hjXubhŒæ here is a placeholder, virtio drivers should be added only for devices that are defined in the spec, see include/uapi/linux/virtio_ids.h. Device ids need to be at least reserved in the virtio spec before being added to that file.”…””}”(hjXhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Knhj)hžhubhé)”}”(hŒ°If your driver doesn't have to do anything special in its ``init`` and ``exit`` methods, you can use the module_virtio_driver() helper to reduce the amount of boilerplate code.”h]”(hŒvq, sg, 1, buffer, GFP_ATOMIC); virtqueue_kick(dev->vq);”h]”hŒŒstruct scatterlist sg[1]; sg_init_one(sg, buffer, BUFLEN); virtqueue_add_inbuf(dev->vq, sg, 1, buffer, GFP_ATOMIC); virtqueue_kick(dev->vq);”…””}”hjZsbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jHhŸh³h K˜hjãhžhubjß)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jëŒ virtqueue_add_inbuf (C function)”Œc.virtqueue_add_inbuf”hNt”auh1jÞhjãhžhhŸNh Nubjð)”}”(hhh]”(jõ)”}”(hŒoint virtqueue_add_inbuf (struct virtqueue *vq, struct scatterlist *sg, unsigned int num, void *data, gfp_t gfp)”h]”jû)”}”(hŒnint virtqueue_add_inbuf(struct virtqueue *vq, struct scatterlist *sg, unsigned int num, void *data, gfp_t gfp)”h]”(j)”}”(hŒint”h]”hŒint”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhj}hžhhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:157: ./drivers/virtio/virtio_ring.c”h MK ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj}hžhhŸjh MK ubj$)”}”(hŒvirtqueue_add_inbuf”h]”j*)”}”(hŒvirtqueue_add_inbuf”h]”hŒvirtqueue_add_inbuf”…””}”(hj¢hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjžubah}”(h]”h ]”(j=j>eh"]”h$]”h&]”h±h²uh1j#hj}hžhhŸjh MK ubjC)”}”(hŒW(struct virtqueue *vq, struct scatterlist *sg, unsigned int num, void *data, gfp_t gfp)”h]”(jI)”}”(hŒstruct virtqueue *vq”h]”(jO)”}”(hjRh]”hŒstruct”…””}”(hj¾hžhhŸNh Nubah}”(h]”h ]”j[ah"]”h$]”h&]”uh1jNhjºubj)”}”(hŒ ”h]”hŒ ”…””}”(hjËhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjºubh)”}”(hhh]”j*)”}”(hŒ virtqueue”h]”hŒ virtqueue”…””}”(hjÜhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjÙubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j…Œreftype”j‡Œ reftarget”jÞŒmodname”NŒ classname”Nj‹jŽ)”}”j‘]”j”)”}”j‡j¤sbŒc.virtqueue_add_inbuf”†”asbuh1hhjºubj)”}”(hŒ ”h]”hŒ ”…””}”(hjühžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjºubj¨)”}”(hj«h]”hŒ*”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hjºubj*)”}”(hŒvq”h]”hŒvq”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjºubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhj¶ubjI)”}”(hŒstruct scatterlist *sg”h]”(jO)”}”(hjRh]”hŒstruct”…””}”(hj0hžhhŸNh Nubah}”(h]”h ]”j[ah"]”h$]”h&]”uh1jNhj,ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj=hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj,ubh)”}”(hhh]”j*)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjNhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjKubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j…Œreftype”j‡Œ reftarget”jPŒmodname”NŒ classname”Nj‹jŽ)”}”j‘]”jøŒc.virtqueue_add_inbuf”†”asbuh1hhj,ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjlhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj,ubj¨)”}”(hj«h]”hŒ*”…””}”(hjzhžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hj,ubj*)”}”(hŒsg”h]”hŒsg”…””}”(hj‡hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hj,ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhj¶ubjI)”}”(hŒunsigned int num”h]”(j)”}”(hŒunsigned”h]”hŒunsigned”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhjœubj)”}”(hŒ ”h]”hŒ ”…””}”(hj®hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjœubj)”}”(hŒint”h]”hŒint”…””}”(hj¼hžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhjœubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÊhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjœubj*)”}”(hŒnum”h]”hŒnum”…””}”(hjØhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjœubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhj¶ubjI)”}”(hŒ void *data”h]”(j)”}”(hŒvoid”h]”hŒvoid”…””}”(hjñhžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhjíubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÿhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjíubj¨)”}”(hj«h]”hŒ*”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hjíubj*)”}”(hŒdata”h]”hŒdata”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjíubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhj¶ubjI)”}”(hŒ gfp_t gfp”h]”(h)”}”(hhh]”j*)”}”(hŒgfp_t”h]”hŒgfp_t”…””}”(hj6hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hj3ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j…Œreftype”j‡Œ reftarget”j8Œmodname”NŒ classname”Nj‹jŽ)”}”j‘]”jøŒc.virtqueue_add_inbuf”†”asbuh1hhj/ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjThžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj/ubj*)”}”(hŒgfp”h]”hŒgfp”…””}”(hjbhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hj/ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhj¶ubeh}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jBhj}hžhhŸjh MK ubeh}”(h]”h ]”h"]”h$]”h&]”h±h²jÙˆuh1jújÚjÛhjyhžhhŸjh MK ubah}”(h]”jtah ]”(jßjàeh"]”h$]”h&]”jäˆjå)jæhuh1jôhŸjh MK hjvhžhubjè)”}”(hhh]”hé)”}”(hŒ!expose input buffers to other end”h]”hŒ!expose input buffers to other end”…””}”(hjŒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:157: ./drivers/virtio/virtio_ring.c”h M? hj‰hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jçhjvhžhhŸjh MK ubeh}”(h]”h ]”(j…Œfunction”eh"]”h$]”h&]”jj…j j¤j j¤j‰j‰j ‰uh1jïhžhhjãhŸNh Nubj)”}”(hX!**Parameters** ``struct virtqueue *vq`` the struct virtqueue we're talking about. ``struct scatterlist *sg`` scatterlist (must be well-formed and terminated!) ``unsigned int num`` the number of entries in **sg** writable by other side ``void *data`` the token identifying the buffer. ``gfp_t gfp`` how to do memory allocations (if necessary). **Description** Caller must ensure we don't call this with other virtqueue operations at the same time (except where noted). Returns zero or a negative error (ie. ENOSPC, ENOMEM, EIO).”h]”(hé)”}”(hŒ**Parameters**”h]”j)”}”(hj®h]”hŒ Parameters”…””}”(hj°hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj¬ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:157: ./drivers/virtio/virtio_ring.c”h MC hj¨ubj/)”}”(hhh]”(j4)”}”(hŒC``struct virtqueue *vq`` the struct virtqueue we're talking about. ”h]”(j:)”}”(hŒ``struct virtqueue *vq``”h]”ja)”}”(hjÍh]”hŒstruct virtqueue *vq”…””}”(hjÏhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hjËubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:157: ./drivers/virtio/virtio_ring.c”h M@ hjÇubjT)”}”(hhh]”hé)”}”(hŒ)the struct virtqueue we're talking about.”h]”hŒ+the struct virtqueue weâ€™re talking about.”…””}”(hjæhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸjâh M@ hjãubah}”(h]”h ]”h"]”h$]”h&]”uh1jShjÇubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸjâh M@ hjÄubj4)”}”(hŒM``struct scatterlist *sg`` scatterlist (must be well-formed and terminated!) ”h]”(j:)”}”(hŒ``struct scatterlist *sg``”h]”ja)”}”(hjh]”hŒstruct scatterlist *sg”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hjubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:157: ./drivers/virtio/virtio_ring.c”h MA hjubjT)”}”(hhh]”hé)”}”(hŒ1scatterlist (must be well-formed and terminated!)”h]”hŒ1scatterlist (must be well-formed and terminated!)”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸjh MA hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jShjubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸjh MA hjÄubj4)”}”(hŒL``unsigned int num`` the number of entries in **sg** writable by other side ”h]”(j:)”}”(hŒ``unsigned int num``”h]”ja)”}”(hj?h]”hŒunsigned int num”…””}”(hjAhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hj=ubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:157: ./drivers/virtio/virtio_ring.c”h MB hj9ubjT)”}”(hhh]”hé)”}”(hŒ6the number of entries in **sg** writable by other side”h]”(hŒthe number of entries in ”…””}”(hjXhžhhŸNh Nubj)”}”(hŒ**sg**”h]”hŒsg”…””}”(hj`hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjXubhŒ writable by other side”…””}”(hjXhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸjTh MB hjUubah}”(h]”h ]”h"]”h$]”h&]”uh1jShj9ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸjTh MB hjÄubj4)”}”(hŒ1``void *data`` the token identifying the buffer. ”h]”(j:)”}”(hŒ``void *data``”h]”ja)”}”(hjŠh]”hŒ void *data”…””}”(hjŒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hjˆubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:157: ./drivers/virtio/virtio_ring.c”h MC hj„ubjT)”}”(hhh]”hé)”}”(hŒ!the token identifying the buffer.”h]”hŒ!the token identifying the buffer.”…””}”(hj£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸjŸh MC hj ubah}”(h]”h ]”h"]”h$]”h&]”uh1jShj„ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸjŸh MC hjÄubj4)”}”(hŒ;``gfp_t gfp`` how to do memory allocations (if necessary). ”h]”(j:)”}”(hŒ ``gfp_t gfp``”h]”ja)”}”(hjÃh]”hŒ gfp_t gfp”…””}”(hjÅhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hjÁubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:157: ./drivers/virtio/virtio_ring.c”h MD hj½ubjT)”}”(hhh]”hé)”}”(hŒ,how to do memory allocations (if necessary).”h]”hŒ,how to do memory allocations (if necessary).”…””}”(hjÜhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸjØh MD hjÙubah}”(h]”h ]”h"]”h$]”h&]”uh1jShj½ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸjØh MD hjÄubeh}”(h]”h ]”h"]”h$]”h&]”uh1j.hj¨ubhé)”}”(hŒ**Description**”h]”j)”}”(hjþh]”hŒDescription”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjüubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:157: ./drivers/virtio/virtio_ring.c”h MF hj¨ubhé)”}”(hŒlCaller must ensure we don't call this with other virtqueue operations at the same time (except where noted).”h]”hŒnCaller must ensure we donâ€™t call this with other virtqueue operations at the same time (except where noted).”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:157: ./drivers/virtio/virtio_ring.c”h MF hj¨ubhé)”}”(hŒ;Returns zero or a negative error (ie. ENOSPC, ENOMEM, EIO).”h]”hŒ;Returns zero or a negative error (ie. ENOSPC, ENOMEM, EIO).”…””}”(hj#hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:157: ./drivers/virtio/virtio_ring.c”h MI hj¨ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1jhjãhžhhŸNh Nubjß)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jëŒ!virtqueue_add_outbuf (C function)”Œc.virtqueue_add_outbuf”hNt”auh1jÞhjãhžhhŸNh Nubjð)”}”(hhh]”(jõ)”}”(hŒpint virtqueue_add_outbuf (struct virtqueue *vq, struct scatterlist *sg, unsigned int num, void *data, gfp_t gfp)”h]”jû)”}”(hŒoint virtqueue_add_outbuf(struct virtqueue *vq, struct scatterlist *sg, unsigned int num, void *data, gfp_t gfp)”h]”(j)”}”(hŒint”h]”hŒint”…””}”(hjRhžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhjNhžhhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:160: ./drivers/virtio/virtio_ring.c”h M ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjahžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjNhžhhŸj`h M ubj$)”}”(hŒvirtqueue_add_outbuf”h]”j*)”}”(hŒvirtqueue_add_outbuf”h]”hŒvirtqueue_add_outbuf”…””}”(hjshžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjoubah}”(h]”h ]”(j=j>eh"]”h$]”h&]”h±h²uh1j#hjNhžhhŸj`h M ubjC)”}”(hŒW(struct virtqueue *vq, struct scatterlist *sg, unsigned int num, void *data, gfp_t gfp)”h]”(jI)”}”(hŒstruct virtqueue *vq”h]”(jO)”}”(hjRh]”hŒstruct”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j[ah"]”h$]”h&]”uh1jNhj‹ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjœhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj‹ubh)”}”(hhh]”j*)”}”(hŒ virtqueue”h]”hŒ virtqueue”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjªubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j…Œreftype”j‡Œ reftarget”j¯Œmodname”NŒ classname”Nj‹jŽ)”}”j‘]”j”)”}”j‡jusbŒc.virtqueue_add_outbuf”†”asbuh1hhj‹ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÍhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj‹ubj¨)”}”(hj«h]”hŒ*”…””}”(hjÛhžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hj‹ubj*)”}”(hŒvq”h]”hŒvq”…””}”(hjèhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hj‹ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhj‡ubjI)”}”(hŒstruct scatterlist *sg”h]”(jO)”}”(hjRh]”hŒstruct”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”j[ah"]”h$]”h&]”uh1jNhjýubj)”}”(hŒ ”h]”hŒ ”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjýubh)”}”(hhh]”j*)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hj ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j…Œreftype”j‡Œ reftarget”j! Œmodname”NŒ classname”Nj‹jŽ)”}”j‘]”jÉŒc.virtqueue_add_outbuf”†”asbuh1hhjýubj)”}”(hŒ ”h]”hŒ ”…””}”(hj= hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjýubj¨)”}”(hj«h]”hŒ*”…””}”(hjK hžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hjýubj*)”}”(hŒsg”h]”hŒsg”…””}”(hjX hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjýubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhj‡ubjI)”}”(hŒunsigned int num”h]”(j)”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjq hžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhjm ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjm ubj)”}”(hŒint”h]”hŒint”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhjm ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj› hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjm ubj*)”}”(hŒnum”h]”hŒnum”…””}”(hj© hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjm ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhj‡ubjI)”}”(hŒ void *data”h]”(j)”}”(hŒvoid”h]”hŒvoid”…””}”(hjÂ hžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhj¾ ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÐ hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj¾ ubj¨)”}”(hj«h]”hŒ*”…””}”(hjÞ hžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hj¾ ubj*)”}”(hŒdata”h]”hŒdata”…””}”(hjë hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hj¾ ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhj‡ubjI)”}”(hŒ gfp_t gfp”h]”(h)”}”(hhh]”j*)”}”(hŒgfp_t”h]”hŒgfp_t”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hj ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j…Œreftype”j‡Œ reftarget”j Œmodname”NŒ classname”Nj‹jŽ)”}”j‘]”jÉŒc.virtqueue_add_outbuf”†”asbuh1hhj ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj% hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj ubj*)”}”(hŒgfp”h]”hŒgfp”…””}”(hj3 hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hj ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhj‡ubeh}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jBhjNhžhhŸj`h M ubeh}”(h]”h ]”h"]”h$]”h&]”h±h²jÙˆuh1jújÚjÛhjJhžhhŸj`h M ubah}”(h]”jEah ]”(jßjàeh"]”h$]”h&]”jäˆjå)jæhuh1jôhŸj`h M hjGhžhubjè)”}”(hhh]”hé)”}”(hŒ"expose output buffers to other end”h]”hŒ"expose output buffers to other end”…””}”(hj] hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:160: ./drivers/virtio/virtio_ring.c”h M hjZ hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jçhjGhžhhŸj`h M ubeh}”(h]”h ]”(j…Œfunction”eh"]”h$]”h&]”jj…j ju j ju j‰j‰j ‰uh1jïhžhhjãhŸNh Nubj)”}”(hX!**Parameters** ``struct virtqueue *vq`` the struct virtqueue we're talking about. ``struct scatterlist *sg`` scatterlist (must be well-formed and terminated!) ``unsigned int num`` the number of entries in **sg** readable by other side ``void *data`` the token identifying the buffer. ``gfp_t gfp`` how to do memory allocations (if necessary). **Description** Caller must ensure we don't call this with other virtqueue operations at the same time (except where noted). Returns zero or a negative error (ie. ENOSPC, ENOMEM, EIO).”h]”(hé)”}”(hŒ**Parameters**”h]”j)”}”(hj h]”hŒ Parameters”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj} ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:160: ./drivers/virtio/virtio_ring.c”h M hjy ubj/)”}”(hhh]”(j4)”}”(hŒC``struct virtqueue *vq`` the struct virtqueue we're talking about. ”h]”(j:)”}”(hŒ``struct virtqueue *vq``”h]”ja)”}”(hjž h]”hŒstruct virtqueue *vq”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hjœ ubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:160: ./drivers/virtio/virtio_ring.c”h M hj˜ ubjT)”}”(hhh]”hé)”}”(hŒ)the struct virtqueue we're talking about.”h]”hŒ+the struct virtqueue weâ€™re talking about.”…””}”(hj· hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸj³ h M hj´ ubah}”(h]”h ]”h"]”h$]”h&]”uh1jShj˜ ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸj³ h M hj• ubj4)”}”(hŒM``struct scatterlist *sg`` scatterlist (must be well-formed and terminated!) ”h]”(j:)”}”(hŒ``struct scatterlist *sg``”h]”ja)”}”(hj× h]”hŒstruct scatterlist *sg”…””}”(hjÙ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hjÕ ubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:160: ./drivers/virtio/virtio_ring.c”h M hjÑ ubjT)”}”(hhh]”hé)”}”(hŒ1scatterlist (must be well-formed and terminated!)”h]”hŒ1scatterlist (must be well-formed and terminated!)”…””}”(hjð hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸjì h M hjí ubah}”(h]”h ]”h"]”h$]”h&]”uh1jShjÑ ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸjì h M hj• ubj4)”}”(hŒL``unsigned int num`` the number of entries in **sg** readable by other side ”h]”(j:)”}”(hŒ``unsigned int num``”h]”ja)”}”(hjh]”hŒunsigned int num”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hjubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:160: ./drivers/virtio/virtio_ring.c”h M hj ubjT)”}”(hhh]”hé)”}”(hŒ6the number of entries in **sg** readable by other side”h]”(hŒthe number of entries in ”…””}”(hj)hžhhŸNh Nubj)”}”(hŒ**sg**”h]”hŒsg”…””}”(hj1hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj)ubhŒ readable by other side”…””}”(hj)hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸj%h M hj&ubah}”(h]”h ]”h"]”h$]”h&]”uh1jShj ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸj%h M hj• ubj4)”}”(hŒ1``void *data`` the token identifying the buffer. ”h]”(j:)”}”(hŒ``void *data``”h]”ja)”}”(hj[h]”hŒ void *data”…””}”(hj]hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hjYubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:160: ./drivers/virtio/virtio_ring.c”h M hjUubjT)”}”(hhh]”hé)”}”(hŒ!the token identifying the buffer.”h]”hŒ!the token identifying the buffer.”…””}”(hjthžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸjph M hjqubah}”(h]”h ]”h"]”h$]”h&]”uh1jShjUubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸjph M hj• ubj4)”}”(hŒ;``gfp_t gfp`` how to do memory allocations (if necessary). ”h]”(j:)”}”(hŒ ``gfp_t gfp``”h]”ja)”}”(hj”h]”hŒ gfp_t gfp”…””}”(hj–hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hj’ubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:160: ./drivers/virtio/virtio_ring.c”h M hjŽubjT)”}”(hhh]”hé)”}”(hŒ,how to do memory allocations (if necessary).”h]”hŒ,how to do memory allocations (if necessary).”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸj©h M hjªubah}”(h]”h ]”h"]”h$]”h&]”uh1jShjŽubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸj©h M hj• ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j.hjy ubhé)”}”(hŒ**Description**”h]”j)”}”(hjÏh]”hŒDescription”…””}”(hjÑhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjÍubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:160: ./drivers/virtio/virtio_ring.c”h M hjy ubhé)”}”(hŒlCaller must ensure we don't call this with other virtqueue operations at the same time (except where noted).”h]”hŒnCaller must ensure we donâ€™t call this with other virtqueue operations at the same time (except where noted).”…””}”(hjåhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:160: ./drivers/virtio/virtio_ring.c”h M hjy ubhé)”}”(hŒ;Returns zero or a negative error (ie. ENOSPC, ENOMEM, EIO).”h]”hŒ;Returns zero or a negative error (ie. ENOSPC, ENOMEM, EIO).”…””}”(hjôhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:160: ./drivers/virtio/virtio_ring.c”h M hjy ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1jhjãhžhhŸNh Nubjß)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jëŒvirtqueue_add_sgs (C function)”Œc.virtqueue_add_sgs”hNt”auh1jÞhjãhžhhŸNh Nubjð)”}”(hhh]”(jõ)”}”(hŒŠint virtqueue_add_sgs (struct virtqueue *_vq, struct scatterlist *sgs[], unsigned int out_sgs, unsigned int in_sgs, void *data, gfp_t gfp)”h]”jû)”}”(hŒ‰int virtqueue_add_sgs(struct virtqueue *_vq, struct scatterlist *sgs[], unsigned int out_sgs, unsigned int in_sgs, void *data, gfp_t gfp)”h]”(j)”}”(hŒint”h]”hŒint”…””}”(hj#hžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhjhžhhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:163: ./drivers/virtio/virtio_ring.c”h Müubj)”}”(hŒ ”h]”hŒ ”…””}”(hj2hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjhžhhŸj1h Müubj$)”}”(hŒvirtqueue_add_sgs”h]”j*)”}”(hŒvirtqueue_add_sgs”h]”hŒvirtqueue_add_sgs”…””}”(hjDhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hj@ubah}”(h]”h ]”(j=j>eh"]”h$]”h&]”h±h²uh1j#hjhžhhŸj1h MüubjC)”}”(hŒt(struct virtqueue *_vq, struct scatterlist *sgs[], unsigned int out_sgs, unsigned int in_sgs, void *data, gfp_t gfp)”h]”(jI)”}”(hŒstruct virtqueue *_vq”h]”(jO)”}”(hjRh]”hŒstruct”…””}”(hj`hžhhŸNh Nubah}”(h]”h ]”j[ah"]”h$]”h&]”uh1jNhj\ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjmhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj\ubh)”}”(hhh]”j*)”}”(hŒ virtqueue”h]”hŒ virtqueue”…””}”(hj~hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hj{ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j…Œreftype”j‡Œ reftarget”j€Œmodname”NŒ classname”Nj‹jŽ)”}”j‘]”j”)”}”j‡jFsbŒc.virtqueue_add_sgs”†”asbuh1hhj\ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjžhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj\ubj¨)”}”(hj«h]”hŒ*”…””}”(hj¬hžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hj\ubj*)”}”(hŒ_vq”h]”hŒ_vq”…””}”(hj¹hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hj\ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhjXubjI)”}”(hŒstruct scatterlist *sgs[]”h]”(jO)”}”(hjRh]”hŒstruct”…””}”(hjÒhžhhŸNh Nubah}”(h]”h ]”j[ah"]”h$]”h&]”uh1jNhjÎubj)”}”(hŒ ”h]”hŒ ”…””}”(hjßhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjÎubh)”}”(hhh]”j*)”}”(hŒscatterlist”h]”hŒscatterlist”…””}”(hjðhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjíubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j…Œreftype”j‡Œ reftarget”jòŒmodname”NŒ classname”Nj‹jŽ)”}”j‘]”jšŒc.virtqueue_add_sgs”†”asbuh1hhjÎubj)”}”(hŒ ”h]”hŒ ”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjÎubj¨)”}”(hj«h]”hŒ*”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hjÎubj*)”}”(hŒsgs”h]”hŒsgs”…””}”(hj) hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjÎubj¨)”}”(hŒ[”h]”hŒ[”…””}”(hj7 hžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hjÎubj¨)”}”(hŒ]”h]”hŒ]”…””}”(hjE hžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hjÎubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhjXubjI)”}”(hŒunsigned int out_sgs”h]”(j)”}”(hŒunsigned”h]”hŒunsigned”…””}”(hj^ hžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhjZ ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjl hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjZ ubj)”}”(hŒint”h]”hŒint”…””}”(hjz hžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhjZ ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjˆ hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjZ ubj*)”}”(hŒout_sgs”h]”hŒout_sgs”…””}”(hj– hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjZ ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhjXubjI)”}”(hŒunsigned int in_sgs”h]”(j)”}”(hŒunsigned”h]”hŒunsigned”…””}”(hj¯ hžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhj« ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj½ hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj« ubj)”}”(hŒint”h]”hŒint”…””}”(hjË hžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhj« ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÙ hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj« ubj*)”}”(hŒin_sgs”h]”hŒin_sgs”…””}”(hjç hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hj« ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhjXubjI)”}”(hŒ void *data”h]”(j)”}”(hŒvoid”h]”hŒvoid”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhjü ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjü ubj¨)”}”(hj«h]”hŒ*”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hjü ubj*)”}”(hŒdata”h]”hŒdata”…””}”(hj)hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjü ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhjXubjI)”}”(hŒ gfp_t gfp”h]”(h)”}”(hhh]”j*)”}”(hŒgfp_t”h]”hŒgfp_t”…””}”(hjEhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjBubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j…Œreftype”j‡Œ reftarget”jGŒmodname”NŒ classname”Nj‹jŽ)”}”j‘]”jšŒc.virtqueue_add_sgs”†”asbuh1hhj>ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjchžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj>ubj*)”}”(hŒgfp”h]”hŒgfp”…””}”(hjqhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hj>ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhjXubeh}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jBhjhžhhŸj1h Müubeh}”(h]”h ]”h"]”h$]”h&]”h±h²jÙˆuh1jújÚjÛhjhžhhŸj1h Müubah}”(h]”jah ]”(jßjàeh"]”h$]”h&]”jäˆjå)jæhuh1jôhŸj1h Mühjhžhubjè)”}”(hhh]”hé)”}”(hŒexpose buffers to other end”h]”hŒexpose buffers to other end”…””}”(hj›hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:163: ./drivers/virtio/virtio_ring.c”h Mïhj˜hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jçhjhžhhŸj1h Müubeh}”(h]”h ]”(j…Œfunction”eh"]”h$]”h&]”jj…j j³j j³j‰j‰j ‰uh1jïhžhhjãhŸNh Nubj)”}”(hXs**Parameters** ``struct virtqueue *_vq`` the struct virtqueue we're talking about. ``struct scatterlist *sgs[]`` array of terminated scatterlists. ``unsigned int out_sgs`` the number of scatterlists readable by other side ``unsigned int in_sgs`` the number of scatterlists which are writable (after readable ones) ``void *data`` the token identifying the buffer. ``gfp_t gfp`` how to do memory allocations (if necessary). **Description** Caller must ensure we don't call this with other virtqueue operations at the same time (except where noted). Returns zero or a negative error (ie. ENOSPC, ENOMEM, EIO).”h]”(hé)”}”(hŒ**Parameters**”h]”j)”}”(hj½h]”hŒ Parameters”…””}”(hj¿hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj»ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:163: ./drivers/virtio/virtio_ring.c”h Móhj·ubj/)”}”(hhh]”(j4)”}”(hŒD``struct virtqueue *_vq`` the struct virtqueue we're talking about. ”h]”(j:)”}”(hŒ``struct virtqueue *_vq``”h]”ja)”}”(hjÜh]”hŒstruct virtqueue *_vq”…””}”(hjÞhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hjÚubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:163: ./drivers/virtio/virtio_ring.c”h MðhjÖubjT)”}”(hhh]”hé)”}”(hŒ)the struct virtqueue we're talking about.”h]”hŒ+the struct virtqueue weâ€™re talking about.”…””}”(hjõhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸjñh Mðhjòubah}”(h]”h ]”h"]”h$]”h&]”uh1jShjÖubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸjñh MðhjÓubj4)”}”(hŒ@``struct scatterlist *sgs[]`` array of terminated scatterlists. ”h]”(j:)”}”(hŒ``struct scatterlist *sgs[]``”h]”ja)”}”(hjh]”hŒstruct scatterlist *sgs[]”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hjubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:163: ./drivers/virtio/virtio_ring.c”h MñhjubjT)”}”(hhh]”hé)”}”(hŒ!array of terminated scatterlists.”h]”hŒ!array of terminated scatterlists.”…””}”(hj.hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸj*h Mñhj+ubah}”(h]”h ]”h"]”h$]”h&]”uh1jShjubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸj*h MñhjÓubj4)”}”(hŒK``unsigned int out_sgs`` the number of scatterlists readable by other side ”h]”(j:)”}”(hŒ``unsigned int out_sgs``”h]”ja)”}”(hjNh]”hŒunsigned int out_sgs”…””}”(hjPhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hjLubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:163: ./drivers/virtio/virtio_ring.c”h MòhjHubjT)”}”(hhh]”hé)”}”(hŒ1the number of scatterlists readable by other side”h]”hŒ1the number of scatterlists readable by other side”…””}”(hjghžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸjch Mòhjdubah}”(h]”h ]”h"]”h$]”h&]”uh1jShjHubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸjch MòhjÓubj4)”}”(hŒ\``unsigned int in_sgs`` the number of scatterlists which are writable (after readable ones) ”h]”(j:)”}”(hŒ``unsigned int in_sgs``”h]”ja)”}”(hj‡h]”hŒunsigned int in_sgs”…””}”(hj‰hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hj…ubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:163: ./drivers/virtio/virtio_ring.c”h MóhjubjT)”}”(hhh]”hé)”}”(hŒCthe number of scatterlists which are writable (after readable ones)”h]”hŒCthe number of scatterlists which are writable (after readable ones)”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸjœh Móhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jShjubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸjœh MóhjÓubj4)”}”(hŒ1``void *data`` the token identifying the buffer. ”h]”(j:)”}”(hŒ``void *data``”h]”ja)”}”(hjÀh]”hŒ void *data”…””}”(hjÂhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hj¾ubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:163: ./drivers/virtio/virtio_ring.c”h MôhjºubjT)”}”(hhh]”hé)”}”(hŒ!the token identifying the buffer.”h]”hŒ!the token identifying the buffer.”…””}”(hjÙhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸjÕh MôhjÖubah}”(h]”h ]”h"]”h$]”h&]”uh1jShjºubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸjÕh MôhjÓubj4)”}”(hŒ;``gfp_t gfp`` how to do memory allocations (if necessary). ”h]”(j:)”}”(hŒ ``gfp_t gfp``”h]”ja)”}”(hjùh]”hŒ gfp_t gfp”…””}”(hjûhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hj÷ubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:163: ./drivers/virtio/virtio_ring.c”h MõhjóubjT)”}”(hhh]”hé)”}”(hŒ,how to do memory allocations (if necessary).”h]”hŒ,how to do memory allocations (if necessary).”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸjh Mõhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jShjóubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸjh MõhjÓubeh}”(h]”h ]”h"]”h$]”h&]”uh1j.hj·ubhé)”}”(hŒ**Description**”h]”j)”}”(hj4h]”hŒDescription”…””}”(hj6hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj2ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:163: ./drivers/virtio/virtio_ring.c”h M÷hj·ubhé)”}”(hŒlCaller must ensure we don't call this with other virtqueue operations at the same time (except where noted).”h]”hŒnCaller must ensure we donâ€™t call this with other virtqueue operations at the same time (except where noted).”…””}”(hjJhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:163: ./drivers/virtio/virtio_ring.c”h M÷hj·ubhé)”}”(hŒ;Returns zero or a negative error (ie. ENOSPC, ENOMEM, EIO).”h]”hŒ;Returns zero or a negative error (ie. ENOSPC, ENOMEM, EIO).”…””}”(hjYhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:163: ./drivers/virtio/virtio_ring.c”h Múhj·ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1jhjãhžhhŸNh Nubhé)”}”(hX2Then, after the device has read or written the buffers prepared by the driver and notifies it back, the driver can call virtqueue_get_buf() to read the data produced by the device (if the virtqueue was set up with input buffers) or simply to reclaim the buffers if they were already consumed by the device:”h]”hX2Then, after the device has read or written the buffers prepared by the driver and notifies it back, the driver can call virtqueue_get_buf() to read the data produced by the device (if the virtqueue was set up with input buffers) or simply to reclaim the buffers if they were already consumed by the device:”…””}”(hjohžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K¦hjãhžhubjß)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jëŒ"virtqueue_get_buf_ctx (C function)”Œc.virtqueue_get_buf_ctx”hNt”auh1jÞhjãhžhhŸNh Nubjð)”}”(hhh]”(jõ)”}”(hŒSvoid * virtqueue_get_buf_ctx (struct virtqueue *_vq, unsigned int *len, void **ctx)”h]”jû)”}”(hŒQvoid *virtqueue_get_buf_ctx(struct virtqueue *_vq, unsigned int *len, void **ctx)”h]”(j)”}”(hŒvoid”h]”hŒvoid”…””}”(hj–hžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhj’hžhhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:172: ./drivers/virtio/virtio_ring.c”h Mç ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¥hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj’hžhhŸj¤h Mç ubj¨)”}”(hj«h]”hŒ*”…””}”(hj³hžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hj’hžhhŸj¤h Mç ubj$)”}”(hŒvirtqueue_get_buf_ctx”h]”j*)”}”(hŒvirtqueue_get_buf_ctx”h]”hŒvirtqueue_get_buf_ctx”…””}”(hjÄhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjÀubah}”(h]”h ]”(j=j>eh"]”h$]”h&]”h±h²uh1j#hj’hžhhŸj¤h Mç ubjC)”}”(hŒ6(struct virtqueue *_vq, unsigned int *len, void **ctx)”h]”(jI)”}”(hŒstruct virtqueue *_vq”h]”(jO)”}”(hjRh]”hŒstruct”…””}”(hjàhžhhŸNh Nubah}”(h]”h ]”j[ah"]”h$]”h&]”uh1jNhjÜubj)”}”(hŒ ”h]”hŒ ”…””}”(hjíhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjÜubh)”}”(hhh]”j*)”}”(hŒ virtqueue”h]”hŒ virtqueue”…””}”(hjþhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjûubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j…Œreftype”j‡Œ reftarget”jŒmodname”NŒ classname”Nj‹jŽ)”}”j‘]”j”)”}”j‡jÆsbŒc.virtqueue_get_buf_ctx”†”asbuh1hhjÜubj)”}”(hŒ ”h]”hŒ ”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjÜubj¨)”}”(hj«h]”hŒ*”…””}”(hj,hžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hjÜubj*)”}”(hŒ_vq”h]”hŒ_vq”…””}”(hj9hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjÜubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhjØubjI)”}”(hŒunsigned int *len”h]”(j)”}”(hŒunsigned”h]”hŒunsigned”…””}”(hjRhžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhjNubj)”}”(hŒ ”h]”hŒ ”…””}”(hj`hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjNubj)”}”(hŒint”h]”hŒint”…””}”(hjnhžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhjNubj)”}”(hŒ ”h]”hŒ ”…””}”(hj|hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjNubj¨)”}”(hj«h]”hŒ*”…””}”(hjŠhžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hjNubj*)”}”(hŒlen”h]”hŒlen”…””}”(hj—hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjNubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhjØubjI)”}”(hŒ void **ctx”h]”(j)”}”(hŒvoid”h]”hŒvoid”…””}”(hj°hžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhj¬ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¾hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj¬ubj¨)”}”(hj«h]”hŒ*”…””}”(hjÌhžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hj¬ubj¨)”}”(hj«h]”hŒ*”…””}”(hjÙhžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hj¬ubj*)”}”(hŒctx”h]”hŒctx”…””}”(hjæhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hj¬ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhjØubeh}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jBhj’hžhhŸj¤h Mç ubeh}”(h]”h ]”h"]”h$]”h&]”h±h²jÙˆuh1jújÚjÛhjŽhžhhŸj¤h Mç ubah}”(h]”j‰ah ]”(jßjàeh"]”h$]”h&]”jäˆjå)jæhuh1jôhŸj¤h Mç hj‹hžhubjè)”}”(hhh]”hé)”}”(hŒget the next used buffer”h]”hŒget the next used buffer”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:172: ./drivers/virtio/virtio_ring.c”h M× hj hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jçhj‹hžhhŸj¤h Mç ubeh}”(h]”h ]”(j…Œfunction”eh"]”h$]”h&]”jj…j j(j j(j‰j‰j ‰uh1jïhžhhjãhŸNh Nubj)”}”(hXj**Parameters** ``struct virtqueue *_vq`` the struct virtqueue we're talking about. ``unsigned int *len`` the length written into the buffer ``void **ctx`` extra context for the token **Description** If the device wrote data into the buffer, **len** will be set to the amount written. This means you don't need to clear the buffer beforehand to ensure there's no data leakage in the case of short writes. Caller must ensure we don't call this with other virtqueue operations at the same time (except where noted). Returns NULL if there are no used buffers, or the "data" token handed to virtqueue_add_*().”h]”(hé)”}”(hŒ**Parameters**”h]”j)”}”(hj2h]”hŒ Parameters”…””}”(hj4hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj0ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:172: ./drivers/virtio/virtio_ring.c”h MÛ hj,ubj/)”}”(hhh]”(j4)”}”(hŒD``struct virtqueue *_vq`` the struct virtqueue we're talking about. ”h]”(j:)”}”(hŒ``struct virtqueue *_vq``”h]”ja)”}”(hjQh]”hŒstruct virtqueue *_vq”…””}”(hjShžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hjOubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:172: ./drivers/virtio/virtio_ring.c”h MØ hjKubjT)”}”(hhh]”hé)”}”(hŒ)the struct virtqueue we're talking about.”h]”hŒ+the struct virtqueue weâ€™re talking about.”…””}”(hjjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸjfh MØ hjgubah}”(h]”h ]”h"]”h$]”h&]”uh1jShjKubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸjfh MØ hjHubj4)”}”(hŒ9``unsigned int *len`` the length written into the buffer ”h]”(j:)”}”(hŒ``unsigned int *len``”h]”ja)”}”(hjŠh]”hŒunsigned int *len”…””}”(hjŒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hjˆubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:172: ./drivers/virtio/virtio_ring.c”h MÙ hj„ubjT)”}”(hhh]”hé)”}”(hŒ"the length written into the buffer”h]”hŒ"the length written into the buffer”…””}”(hj£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸjŸh MÙ hj ubah}”(h]”h ]”h"]”h$]”h&]”uh1jShj„ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸjŸh MÙ hjHubj4)”}”(hŒ+``void **ctx`` extra context for the token ”h]”(j:)”}”(hŒ``void **ctx``”h]”ja)”}”(hjÃh]”hŒ void **ctx”…””}”(hjÅhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hjÁubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:172: ./drivers/virtio/virtio_ring.c”h MÚ hj½ubjT)”}”(hhh]”hé)”}”(hŒextra context for the token”h]”hŒextra context for the token”…””}”(hjÜhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸjØh MÚ hjÙubah}”(h]”h ]”h"]”h$]”h&]”uh1jShj½ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸjØh MÚ hjHubeh}”(h]”h ]”h"]”h$]”h&]”uh1j.hj,ubhé)”}”(hŒ**Description**”h]”j)”}”(hjþh]”hŒDescription”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjüubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:172: ./drivers/virtio/virtio_ring.c”h MÜ hj,ubhé)”}”(hŒÍIf the device wrote data into the buffer, **len** will be set to the amount written. This means you don't need to clear the buffer beforehand to ensure there's no data leakage in the case of short writes.”h]”(hŒ*If the device wrote data into the buffer, ”…””}”(hjhžhhŸNh Nubj)”}”(hŒ**len**”h]”hŒlen”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjubhŒ will be set to the amount written. This means you donâ€™t need to clear the buffer beforehand to ensure thereâ€™s no data leakage in the case of short writes.”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:172: ./drivers/virtio/virtio_ring.c”h MÜ hj,ubhé)”}”(hŒlCaller must ensure we don't call this with other virtqueue operations at the same time (except where noted).”h]”hŒnCaller must ensure we donâ€™t call this with other virtqueue operations at the same time (except where noted).”…””}”(hj5hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:172: ./drivers/virtio/virtio_ring.c”h Má hj,ubhé)”}”(hŒ[Returns NULL if there are no used buffers, or the "data" token handed to virtqueue_add_*().”h]”hŒ_Returns NULL if there are no used buffers, or the â€œdataâ€ token handed to virtqueue_add_*().”…””}”(hjDhžhhŸNh •“=Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:172: ./drivers/virtio/virtio_ring.c”h Mä hj,ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1jhjãhžhhŸNh Nubhé)”}”(hŒÊThe virtqueue callbacks can be disabled and re-enabled using the virtqueue_disable_cb() and the family of virtqueue_enable_cb() functions respectively. See drivers/virtio/virtio_ring.c for more details:”h]”hŒÊThe virtqueue callbacks can be disabled and re-enabled using the virtqueue_disable_cb() and the family of virtqueue_enable_cb() functions respectively. See drivers/virtio/virtio_ring.c for more details:”…””}”(hjZhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K¯hjãhžhubjß)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jëŒ!virtqueue_disable_cb (C function)”Œc.virtqueue_disable_cb”hNt”auh1jÞhjãhžhhŸNh Nubjð)”}”(hhh]”(jõ)”}”(hŒ1void virtqueue_disable_cb (struct virtqueue *_vq)”h]”jû)”}”(hŒ0void virtqueue_disable_cb(struct virtqueue *_vq)”h]”(j)”}”(hŒvoid”h]”hŒvoid”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhj}hžhhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:179: ./drivers/virtio/virtio_ring.c”h Mÿ ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj}hžhhŸjh Mÿ ubj$)”}”(hŒvirtqueue_disable_cb”h]”j*)”}”(hŒvirtqueue_disable_cb”h]”hŒvirtqueue_disable_cb”…””}”(hj¢hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjžubah}”(h]”h ]”(j=j>eh"]”h$]”h&]”h±h²uh1j#hj}hžhhŸjh Mÿ ubjC)”}”(hŒ(struct virtqueue *_vq)”h]”jI)”}”(hŒstruct virtqueue *_vq”h]”(jO)”}”(hjRh]”hŒstruct”…””}”(hj¾hžhhŸNh Nubah}”(h]”h ]”j[ah"]”h$]”h&]”uh1jNhjºubj)”}”(hŒ ”h]”hŒ ”…””}”(hjËhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjºubh)”}”(hhh]”j*)”}”(hŒ virtqueue”h]”hŒ virtqueue”…””}”(hjÜhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjÙubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j…Œreftype”j‡Œ reftarget”jÞŒmodname”NŒ classname”Nj‹jŽ)”}”j‘]”j”)”}”j‡j¤sbŒc.virtqueue_disable_cb”†”asbuh1hhjºubj)”}”(hŒ ”h]”hŒ ”…””}”(hjühžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjºubj¨)”}”(hj«h]”hŒ*”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hjºubj*)”}”(hŒ_vq”h]”hŒ_vq”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjºubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhj¶ubah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jBhj}hžhhŸjh Mÿ ubeh}”(h]”h ]”h"]”h$]”h&]”h±h²jÙˆuh1jújÚjÛhjyhžhhŸjh Mÿ ubah}”(h]”jtah ]”(jßjàeh"]”h$]”h&]”jäˆjå)jæhuh1jôhŸjh Mÿ hjvhžhubjè)”}”(hhh]”hé)”}”(hŒdisable callbacks”h]”hŒdisable callbacks”…””}”(hjAhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:179: ./drivers/virtio/virtio_ring.c”h M÷ hj>hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jçhjvhžhhŸjh Mÿ ubeh}”(h]”h ]”(j…Œfunction”eh"]”h$]”h&]”jj…j jYj jYj‰j‰j ‰uh1jïhžhhjãhŸNh Nubj)”}”(hX**Parameters** ``struct virtqueue *_vq`` the struct virtqueue we're talking about. **Description** Note that this is not necessarily synchronous, hence unreliable and only useful as an optimization. Unlike other operations, this need not be serialized.”h]”(hé)”}”(hŒ**Parameters**”h]”j)”}”(hjch]”hŒ Parameters”…””}”(hjehžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjaubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:179: ./drivers/virtio/virtio_ring.c”h Mû hj]ubj/)”}”(hhh]”j4)”}”(hŒD``struct virtqueue *_vq`` the struct virtqueue we're talking about. ”h]”(j:)”}”(hŒ``struct virtqueue *_vq``”h]”ja)”}”(hj‚h]”hŒstruct virtqueue *_vq”…””}”(hj„hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hj€ubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:179: ./drivers/virtio/virtio_ring.c”h Mø hj|ubjT)”}”(hhh]”hé)”}”(hŒ)the struct virtqueue we're talking about.”h]”hŒ+the struct virtqueue weâ€™re talking about.”…””}”(hj›hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸj—h Mø hj˜ubah}”(h]”h ]”h"]”h$]”h&]”uh1jShj|ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸj—h Mø hjyubah}”(h]”h ]”h"]”h$]”h&]”uh1j.hj]ubhé)”}”(hŒ**Description**”h]”j)”}”(hj½h]”hŒDescription”…””}”(hj¿hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj»ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:179: ./drivers/virtio/virtio_ring.c”h Mú hj]ubhé)”}”(hŒcNote that this is not necessarily synchronous, hence unreliable and only useful as an optimization.”h]”hŒcNote that this is not necessarily synchronous, hence unreliable and only useful as an optimization.”…””}”(hjÓhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:179: ./drivers/virtio/virtio_ring.c”h Mú hj]ubhé)”}”(hŒ5Unlike other operations, this need not be serialized.”h]”hŒ5Unlike other operations, this need not be serialized.”…””}”(hjâhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:179: ./drivers/virtio/virtio_ring.c”h Mý hj]ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1jhjãhžhhŸNh Nubjß)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jëŒ virtqueue_enable_cb (C function)”Œc.virtqueue_enable_cb”hNt”auh1jÞhjãhžhhŸNh Nubjð)”}”(hhh]”(jõ)”}”(hŒ0bool virtqueue_enable_cb (struct virtqueue *_vq)”h]”jû)”}”(hŒ/bool virtqueue_enable_cb(struct virtqueue *_vq)”h]”(j)”}”(hŒbool”h]”hŒbool”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j ah"]”h$]”h&]”uh1jhj hžhhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:182: ./drivers/virtio/virtio_ring.c”h MC ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj hžhhŸjh MC ubj$)”}”(hŒvirtqueue_enable_cb”h]”j*)”}”(hŒvirtqueue_enable_cb”h]”hŒvirtqueue_enable_cb”…””}”(hj2hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hj.ubah}”(h]”h ]”(j=j>eh"]”h$]”h&]”h±h²uh1j#hj hžhhŸjh MC ubjC)”}”(hŒ(struct virtqueue *_vq)”h]”jI)”}”(hŒstruct virtqueue *_vq”h]”(jO)”}”(hjRh]”hŒstruct”…””}”(hjNhžhhŸNh Nubah}”(h]”h ]”j[ah"]”h$]”h&]”uh1jNhjJubj)”}”(hŒ ”h]”hŒ ”…””}”(hj[hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjJubh)”}”(hhh]”j*)”}”(hŒ virtqueue”h]”hŒ virtqueue”…””}”(hjlhžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjiubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j…Œreftype”j‡Œ reftarget”jnŒmodname”NŒ classname”Nj‹jŽ)”}”j‘]”j”)”}”j‡j4sbŒc.virtqueue_enable_cb”†”asbuh1hhjJubj)”}”(hŒ ”h]”hŒ ”…””}”(hjŒhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjJubj¨)”}”(hj«h]”hŒ*”…””}”(hjšhžhhŸNh Nubah}”(h]”h ]”j´ah"]”h$]”h&]”uh1j§hjJubj*)”}”(hŒ_vq”h]”hŒ_vq”…””}”(hj§hžhhŸNh Nubah}”(h]”h ]”j6ah"]”h$]”h&]”uh1j)hjJubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jHhjFubah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jBhj hžhhŸjh MC ubeh}”(h]”h ]”h"]”h$]”h&]”h±h²jÙˆuh1jújÚjÛhj hžhhŸjh MC ubah}”(h]”jah ]”(jßjàeh"]”h$]”h&]”jäˆjå)jæhuh1jôhŸjh MC hjhžhubjè)”}”(hhh]”hé)”}”(hŒ#restart callbacks after disable_cb.”h]”hŒ#restart callbacks after disable_cb.”…””}”(hjÑhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:182: ./drivers/virtio/virtio_ring.c”h M9 hjÎhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jçhjhžhhŸjh MC ubeh}”(h]”h ]”(j…Œfunction”eh"]”h$]”h&]”jj…j jéj jéj‰j‰j ‰uh1jïhžhhjãhŸNh Nubj)”}”(hX‹**Parameters** ``struct virtqueue *_vq`` the struct virtqueue we're talking about. **Description** This re-enables callbacks; it returns "false" if there are pending buffers in the queue, to detect a possible race between the driver checking for more work, and enabling callbacks. Caller must ensure we don't call this with other virtqueue operations at the same time (except where noted).”h]”(hé)”}”(hŒ**Parameters**”h]”j)”}”(hjóh]”hŒ Parameters”…””}”(hjõhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjñubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:182: ./drivers/virtio/virtio_ring.c”h M= hjíubj/)”}”(hhh]”j4)”}”(hŒD``struct virtqueue *_vq`` the struct virtqueue we're talking about. ”h]”(j:)”}”(hŒ``struct virtqueue *_vq``”h]”ja)”}”(hjh]”hŒstruct virtqueue *_vq”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j`hjubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:182: ./drivers/virtio/virtio_ring.c”h M: hjubjT)”}”(hhh]”hé)”}”(hŒ)the struct virtqueue we're talking about.”h]”hŒ+the struct virtqueue weâ€™re talking about.”…””}”(hj+hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸj'h M: hj(ubah}”(h]”h ]”h"]”h$]”h&]”uh1jShjubeh}”(h]”h ]”h"]”h$]”h&]”uh1j3hŸj'h M: hj ubah}”(h]”h ]”h"]”h$]”h&]”uh1j.hjíubhé)”}”(hŒ**Description**”h]”j)”}”(hjMh]”hŒDescription”…””}”(hjOhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjKubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:182: ./drivers/virtio/virtio_ring.c”h M< hjíubhé)”}”(hŒµThis re-enables callbacks; it returns "false" if there are pending buffers in the queue, to detect a possible race between the driver checking for more work, and enabling callbacks.”h]”hŒ¹This re-enables callbacks; it returns â€œfalseâ€ if there are pending buffers in the queue, to detect a possible race between the driver checking for more work, and enabling callbacks.”…””}”(hjchžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:182: ./drivers/virtio/virtio_ring.c”h M< hjíubhé)”}”(hŒlCaller must ensure we don't call this with other virtqueue operations at the same time (except where noted).”h]”hŒnCaller must ensure we donâ€™t call this with other virtqueue operations at the same time (except where noted).”…””}”(hjrhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸŒv/var/lib/git/docbuild/linux/Documentation/driver-api/virtio/writing_virtio_drivers:182: ./drivers/virtio/virtio_ring.c”h M@ hjíubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1jhjãhžhhŸNh Nubhé)”}”(hŒ¼But note that some spurious callbacks can still be triggered under certain scenarios. The way to disable callbacks reliably is to reset the device or the virtqueue (virtio_reset_device()).”h]”hŒ¼But note that some spurious callbacks can still be triggered under certain scenarios. The way to disable callbacks reliably is to reset the device or the virtqueue (virtio_reset_device()).”…””}”(hjˆhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K¹hjãhžhubeh}”(h]”Œsending-and-receiving-data”ah ]”h"]”Œsending and receiving data”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K…ubhÃ)”}”(hhh]”(hÈ)”}”(hŒ References”h]”hŒ References”…””}”(hj¡hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjžhžhhŸh³h K¿ubhé)”}”(hŒX_`[1]` Virtio Spec v1.2: https://docs.oasis-open.org/virtio/virtio/v1.2/virtio-v1.2.html”h]”(hµ)”}”(hŒ_`[1]`”h]”hŒ[1]”…””}”(hj³hžhhŸNh Nubah}”(h]”Œid2”ah ]”h"]”Œ[1]”ah$]”h&]”uh1h´hj¯ubhŒ Virtio Spec v1.2: ”…””}”(hj¯hžhhŸNh NubhŒ reference”“”)”}”(hŒ?https://docs.oasis-open.org/virtio/virtio/v1.2/virtio-v1.2.html”h]”hŒ?https://docs.oasis-open.org/virtio/virtio/v1.2/virtio-v1.2.html”…””}”(hjÉhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jËuh1jÇhj¯ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KÁhjžhžhubhé)”}”(hŒ-Check for later versions of the spec as well.”h]”hŒ-Check for later versions of the spec as well.”…””}”(hjÞhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KÄhjžhžhubeh}”(h]”Œ references”ah ]”h"]”Œ references”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K¿ubeh}”(h]”(hÁŒid1”eh ]”h"]”(Œwriting virtio drivers”Œwriting_virtio_drivers”eh$]”h&]”uh1hÂhhhžhhŸh³h KŒexpect_referenced_by_name”}”júh¶sŒexpect_referenced_by_id”}”hÁh¶subeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hÇNŒ generator”NŒ datestamp”NŒsource_link”NŒ source_url”NŒ toc_backlinks”Œentry”Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒreport_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j$Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ_destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”hÁ]”h¶asŒnameids”}”(júhÁjùjöj&j#jàjÝj›j˜jñjîjÀj½uŒ nametypes”}”(júˆjù‰j&‰jà‰j›‰jñ‰jÀˆuh}”(hÁhÄjöhÄj#h×jÝj)jíjöj˜jãjtjyjEjJjjj‰jŽjtjyjj jîjžj½j³uŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œcollections”ŒCounter”“”}”j2Ks…”R”Œparse_messages”]”Œtransform_messages”]”(hŒsystem_message”“”)”}”(hhh]”hé)”}”(hhh]”hŒ