OSDN Git Service

Improve docs for IOCTL_GNTDEV_MAP_GRANT_REF
authorDemi Marie Obenour <demiobenour@gmail.com>
Mon, 31 Jan 2022 17:23:07 +0000 (12:23 -0500)
committerJuergen Gross <jgross@suse.com>
Thu, 3 Feb 2022 07:23:32 +0000 (08:23 +0100)
commit164666fa66669d437bdcc8d5f1744a2aee73be41
treefbf92095acdeaf34419af1f4501500cb152a4ce6
parent4564661af6ee321942ec1ab012191d7adedd3e00
Improve docs for IOCTL_GNTDEV_MAP_GRANT_REF

--------------cKY3Ggs6VDUCSn4I6iN78sHA
Content-Type: multipart/mixed; boundary="------------g0T69ASidFiPhh4eOY4XzIg1"

--------------g0T69ASidFiPhh4eOY4XzIg1
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

The current implementation of gntdev guarantees that the first call to
IOCTL_GNTDEV_MAP_GRANT_REF will set @index to 0.  This is required to
use gntdev for Wayland, which is a future desire of Qubes OS.
Additionally, requesting zero grants results in an error, but this was
not documented either.  Document both of these.

Signed-off-by: Demi Marie Obenour <demiobenour@gmail.com>
Reviewed-by: Juergen Gross <jgross@suse.com>
Link: https://lore.kernel.org/r/f66c5a4e-2034-00b5-a635-6983bd999c07@gmail.com
Signed-off-by: Juergen Gross <jgross@suse.com>
include/uapi/xen/gntdev.h