Re: [PATCH v8 04/20] drm/imagination/uapi: Add PowerVR driver UAPI

[Faith Ekstrand]

On Tue, 2023-10-31 at 15:12 +0000, Sarah Walker wrote:
> Add the UAPI implementation for the PowerVR driver.
> 
> Changes from v7:
> - Remove prefixes from DRM_PVR_BO_* flags
> - Improve struct drm_pvr_ioctl_create_hwrt_dataset_args documentation
> - Remove references to static area carveouts
> - CREATE_BO ioctl now returns an error if provided size isn't page
> aligned
> - Clarify documentation for DRM_PVR_STATIC_DATA_AREA_EOT
> 
> Changes from v6:
> - Add padding to struct drm_pvr_dev_query_gpu_info
> - Improve BYPASS_CACHE flag documentation
> - Add SUBMIT_JOB_FRAG_CMD_DISABLE_PIXELMERGE flag
> 
> Changes from v4:
> - Remove CREATE_ZEROED flag for BO creation (all buffers are now
> zeroed)

Latest API is

Reviewed-by: Faith Ekstrand <faith.ekstrand@xxxxxxxxxxxxx>

I think we're good to begin the upstreaming process.

~Faith


> Co-developed-by: Frank Binns <frank.binns@xxxxxxxxxx>
> Signed-off-by: Frank Binns <frank.binns@xxxxxxxxxx>
> Co-developed-by: Boris Brezillon <boris.brezillon@xxxxxxxxxxxxx>
> Signed-off-by: Boris Brezillon <boris.brezillon@xxxxxxxxxxxxx>
> Co-developed-by: Matt Coster <matt.coster@xxxxxxxxxx>
> Signed-off-by: Matt Coster <matt.coster@xxxxxxxxxx>
> Co-developed-by: Donald Robson <donald.robson@xxxxxxxxxx>
> Signed-off-by: Donald Robson <donald.robson@xxxxxxxxxx>
> Signed-off-by: Sarah Walker <sarah.walker@xxxxxxxxxx>
> ---
>  MAINTAINERS                |    1 +
>  include/uapi/drm/pvr_drm.h | 1297
> ++++++++++++++++++++++++++++++++++++
>  2 files changed, 1298 insertions(+)
>  create mode 100644 include/uapi/drm/pvr_drm.h
> 
> diff --git a/MAINTAINERS b/MAINTAINERS
> index 5b2018ff3e0f..bef1ac7ed647 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -10265,6 +10265,7 @@ M:	Frank Binns <frank.binns@xxxxxxxxxx>
>  M:	Donald Robson <donald.robson@xxxxxxxxxx>
>  S:	Supported
>  F:	Documentation/devicetree/bindings/gpu/img,powervr.yaml
> +F:	include/uapi/drm/pvr_drm.h
>  
>  IMON SOUNDGRAPH USB IR RECEIVER
>  M:	Sean Young <sean@xxxxxxxx>
> diff --git a/include/uapi/drm/pvr_drm.h b/include/uapi/drm/pvr_drm.h
> new file mode 100644
> index 000000000000..d8e82f2a072a
> --- /dev/null
> +++ b/include/uapi/drm/pvr_drm.h
> @@ -0,0 +1,1297 @@
> +/* SPDX-License-Identifier: (GPL-2.0 WITH Linux-syscall-note) OR MIT
> */
> +/* Copyright (c) 2023 Imagination Technologies Ltd. */
> +
> +#ifndef PVR_DRM_UAPI_H
> +#define PVR_DRM_UAPI_H
> +
> +#include "drm.h"
> +
> +#include <linux/const.h>
> +#include <linux/types.h>
> +
> +#if defined(__cplusplus)
> +extern "C" {
> +#endif
> +
> +/**
> + * DOC: PowerVR UAPI
> + *
> + * The PowerVR IOCTL argument structs have a few limitations in
> place, in
> + * addition to the standard kernel restrictions:
> + *
> + *  - All members must be type-aligned.
> + *  - The overall struct must be padded to 64-bit alignment.
> + *  - Explicit padding is almost always required. This takes the
> form of
> + *    ``_padding_[x]`` members of sufficient size to pad to the next
> power-of-two
> + *    alignment, where [x] is the offset into the struct in
> hexadecimal. Arrays
> + *    are never used for alignment. Padding fields must be zeroed;
> this is
> + *    always checked.
> + *  - Unions may only appear as the last member of a struct.
> + *  - Individual union members may grow in the future. The space
> between the
> + *    end of a union member and the end of its containing union is
> considered
> + *    "implicit padding" and must be zeroed. This is always checked.
> + *
> + * In addition to the IOCTL argument structs, the PowerVR UAPI makes
> use of
> + * DEV_QUERY argument structs. These are used to fetch information
> about the
> + * device and runtime. These structs are subject to the same rules
> set out
> + * above.
> + */
> +
> +/**
> + * struct drm_pvr_obj_array - Container used to pass arrays of
> objects
> + *
> + * It is not unusual to have to extend objects to pass new
> parameters, and the DRM
> + * ioctl infrastructure is supporting that by padding ioctl
> arguments with zeros
> + * when the data passed by userspace is smaller than the struct
> defined in the
> + * drm_ioctl_desc, thus keeping things backward compatible. This
> type is just
> + * applying the same concepts to indirect objects passed through
> arrays referenced
> + * from the main ioctl arguments structure: the stride basically
> defines the size
> + * of the object passed by userspace, which allows the kernel driver
> to pad with
> + * zeros when it's smaller than the size of the object it expects.
> + *
> + * Use ``DRM_PVR_OBJ_ARRAY()`` to fill object array fields, unless
> you
> + * have a very good reason not to.
> + */
> +struct drm_pvr_obj_array {
> +	/** @stride: Stride of object struct. Used for versioning.
> */
> +	__u32 stride;
> +
> +	/** @count: Number of objects in the array. */
> +	__u32 count;
> +
> +	/** @array: User pointer to an array of objects. */
> +	__u64 array;
> +};
> +
> +/**
> + * DRM_PVR_OBJ_ARRAY() - Helper macro for filling &struct
> drm_pvr_obj_array.
> + * @cnt: Number of elements pointed to py @ptr.
> + * @ptr: Pointer to start of a C array.
> + *
> + * Return: Literal of type &struct drm_pvr_obj_array.
> + */
> +#define DRM_PVR_OBJ_ARRAY(cnt, ptr) \
> +	{ .stride = sizeof((ptr)[0]), .count = (cnt), .array =
> (__u64)(uintptr_t)(ptr) }
> +
> +/**
> + * DOC: PowerVR IOCTL interface
> + */
> +
> +/**
> + * PVR_IOCTL() - Build a PowerVR IOCTL number
> + * @_ioctl: An incrementing id for this IOCTL. Added to
> %DRM_COMMAND_BASE.
> + * @_mode: Must be one of %DRM_IOR, %DRM_IOW or %DRM_IOWR.
> + * @_data: The type of the args struct passed by this IOCTL.
> + *
> + * The struct referred to by @_data must have a ``drm_pvr_ioctl_``
> prefix and an
> + * ``_args suffix``. They are therefore omitted from @_data.
> + *
> + * This should only be used to build the constants described below;
> it should
> + * never be used to call an IOCTL directly.
> + *
> + * Return: An IOCTL number to be passed to ioctl() from userspace.
> + */
> +#define PVR_IOCTL(_ioctl, _mode, _data) \
> +	_mode(DRM_COMMAND_BASE + (_ioctl), struct
> drm_pvr_ioctl_##_data##_args)
> +
> +#define DRM_IOCTL_PVR_DEV_QUERY PVR_IOCTL(0x00, DRM_IOWR, dev_query)
> +#define DRM_IOCTL_PVR_CREATE_BO PVR_IOCTL(0x01, DRM_IOWR, create_bo)
> +#define DRM_IOCTL_PVR_GET_BO_MMAP_OFFSET PVR_IOCTL(0x02, DRM_IOWR,
> get_bo_mmap_offset)
> +#define DRM_IOCTL_PVR_CREATE_VM_CONTEXT PVR_IOCTL(0x03, DRM_IOWR,
> create_vm_context)
> +#define DRM_IOCTL_PVR_DESTROY_VM_CONTEXT PVR_IOCTL(0x04, DRM_IOW,
> destroy_vm_context)
> +#define DRM_IOCTL_PVR_VM_MAP PVR_IOCTL(0x05, DRM_IOW, vm_map)
> +#define DRM_IOCTL_PVR_VM_UNMAP PVR_IOCTL(0x06, DRM_IOW, vm_unmap)
> +#define DRM_IOCTL_PVR_CREATE_CONTEXT PVR_IOCTL(0x07, DRM_IOWR,
> create_context)
> +#define DRM_IOCTL_PVR_DESTROY_CONTEXT PVR_IOCTL(0x08, DRM_IOW,
> destroy_context)
> +#define DRM_IOCTL_PVR_CREATE_FREE_LIST PVR_IOCTL(0x09, DRM_IOWR,
> create_free_list)
> +#define DRM_IOCTL_PVR_DESTROY_FREE_LIST PVR_IOCTL(0x0a, DRM_IOW,
> destroy_free_list)
> +#define DRM_IOCTL_PVR_CREATE_HWRT_DATASET PVR_IOCTL(0x0b, DRM_IOWR,
> create_hwrt_dataset)
> +#define DRM_IOCTL_PVR_DESTROY_HWRT_DATASET PVR_IOCTL(0x0c, DRM_IOW,
> destroy_hwrt_dataset)
> +#define DRM_IOCTL_PVR_SUBMIT_JOBS PVR_IOCTL(0x0d, DRM_IOW,
> submit_jobs)
> +
> +/**
> + * DOC: PowerVR IOCTL DEV_QUERY interface
> + */
> +
> +/**
> + * struct drm_pvr_dev_query_gpu_info - Container used to fetch
> information about
> + * the graphics processor.
> + *
> + * When fetching this type &struct drm_pvr_ioctl_dev_query_args.type
> must be set
> + * to %DRM_PVR_DEV_QUERY_GPU_INFO_GET.
> + */
> +struct drm_pvr_dev_query_gpu_info {
> +	/**
> +	 * @gpu_id: GPU identifier.
> +	 *
> +	 * For all currently supported GPUs this is the BVNC encoded
> as a 64-bit
> +	 * value as follows:
> +	 *
> +	 *    +--------+--------+--------+-------+
> +	 *    | 63..48 | 47..32 | 31..16 | 15..0 |
> +	 *    +========+========+========+=======+
> +	 *    | B      | V      | N      | C     |
> +	 *    +--------+--------+--------+-------+
> +	 */
> +	__u64 gpu_id;
> +
> +	/**
> +	 * @num_phantoms: Number of Phantoms present.
> +	 */
> +	__u32 num_phantoms;
> +
> +	/** @_padding_c: Reserved. This field must be zeroed. */
> +	__u32 _padding_c;
> +};
> +
> +/**
> + * struct drm_pvr_dev_query_runtime_info - Container used to fetch
> information
> + * about the graphics runtime.
> + *
> + * When fetching this type &struct drm_pvr_ioctl_dev_query_args.type
> must be set
> + * to %DRM_PVR_DEV_QUERY_RUNTIME_INFO_GET.
> + */
> +struct drm_pvr_dev_query_runtime_info {
> +	/**
> +	 * @free_list_min_pages: Minimum allowed free list size,
> +	 * in PM physical pages.
> +	 */
> +	__u64 free_list_min_pages;
> +
> +	/**
> +	 * @free_list_max_pages: Maximum allowed free list size,
> +	 * in PM physical pages.
> +	 */
> +	__u64 free_list_max_pages;
> +
> +	/**
> +	 * @common_store_alloc_region_size: Size of the Allocation
> +	 * Region within the Common Store used for coefficient and
> shared
> +	 * registers, in dwords.
> +	 */
> +	__u32 common_store_alloc_region_size;
> +
> +	/**
> +	 * @common_store_partition_space_size: Size of the
> +	 * Partition Space within the Common Store for output
> buffers, in
> +	 * dwords.
> +	 */
> +	__u32 common_store_partition_space_size;
> +
> +	/**
> +	 * @max_coeffs: Maximum coefficients, in dwords.
> +	 */
> +	__u32 max_coeffs;
> +
> +	/**
> +	 * @cdm_max_local_mem_size_regs: Maximum amount of local
> +	 * memory available to a compute kernel, in dwords.
> +	 */
> +	__u32 cdm_max_local_mem_size_regs;
> +};
> +
> +/**
> + * struct drm_pvr_dev_query_quirks - Container used to fetch
> information about
> + * hardware fixes for which the device may require support in the
> user mode
> + * driver.
> + *
> + * When fetching this type &struct drm_pvr_ioctl_dev_query_args.type
> must be set
> + * to %DRM_PVR_DEV_QUERY_QUIRKS_GET.
> + */
> +struct drm_pvr_dev_query_quirks {
> +	/**
> +	 * @quirks: A userspace address for the hardware quirks
> __u32 array.
> +	 *
> +	 * The first @musthave_count items in the list are quirks
> that the
> +	 * client must support for this device. If userspace does
> not support
> +	 * all these quirks then functionality is not guaranteed and
> client
> +	 * initialisation must fail.
> +	 * The remaining quirks in the list affect userspace and the
> kernel or
> +	 * firmware. They are disabled by default and require
> userspace to
> +	 * opt-in. The opt-in mechanism depends on the quirk.
> +	 */
> +	__u64 quirks;
> +
> +	/** @count: Length of @quirks (number of __u32). */
> +	__u16 count;
> +
> +	/**
> +	 * @musthave_count: The number of entries in @quirks that
> are
> +	 * mandatory, starting at index 0.
> +	 */
> +	__u16 musthave_count;
> +
> +	/** @_padding_c: Reserved. This field must be zeroed. */
> +	__u32 _padding_c;
> +};
> +
> +/**
> + * struct drm_pvr_dev_query_enhancements - Container used to fetch
> information
> + * about optional enhancements supported by the device that require
> support in
> + * the user mode driver.
> + *
> + * When fetching this type &struct drm_pvr_ioctl_dev_query_args.type
> must be set
> + * to %DRM_PVR_DEV_ENHANCEMENTS_GET.
> + */
> +struct drm_pvr_dev_query_enhancements {
> +	/**
> +	 * @enhancements: A userspace address for the hardware
> enhancements
> +	 * __u32 array.
> +	 *
> +	 * These enhancements affect userspace and the kernel or
> firmware. They
> +	 * are disabled by default and require userspace to opt-in.
> The opt-in
> +	 * mechanism depends on the enhancement.
> +	 */
> +	__u64 enhancements;
> +
> +	/** @count: Length of @enhancements (number of __u32). */
> +	__u16 count;
> +
> +	/** @_padding_a: Reserved. This field must be zeroed. */
> +	__u16 _padding_a;
> +
> +	/** @_padding_c: Reserved. This field must be zeroed. */
> +	__u32 _padding_c;
> +};
> +
> +/**
> + * enum drm_pvr_heap_id - Array index for heap info data returned by
> + * %DRM_PVR_DEV_QUERY_HEAP_INFO_GET.
> + *
> + * For compatibility reasons all indices will be present in the
> returned array,
> + * however some heaps may not be present. These are indicated where
> + * &struct drm_pvr_heap.size is set to zero.
> + */
> +enum drm_pvr_heap_id {
> +	/** @DRM_PVR_HEAP_GENERAL: General purpose heap. */
> +	DRM_PVR_HEAP_GENERAL = 0,
> +	/** @DRM_PVR_HEAP_PDS_CODE_DATA: PDS code and data heap. */
> +	DRM_PVR_HEAP_PDS_CODE_DATA,
> +	/** @DRM_PVR_HEAP_USC_CODE: USC code heap. */
> +	DRM_PVR_HEAP_USC_CODE,
> +	/** @DRM_PVR_HEAP_RGNHDR: Region header heap. Only used if
> GPU has BRN63142. */
> +	DRM_PVR_HEAP_RGNHDR,
> +	/** @DRM_PVR_HEAP_VIS_TEST: Visibility test heap. */
> +	DRM_PVR_HEAP_VIS_TEST,
> +	/** @DRM_PVR_HEAP_TRANSFER_FRAG: Transfer fragment heap. */
> +	DRM_PVR_HEAP_TRANSFER_FRAG,
> +
> +	/**
> +	 * @DRM_PVR_HEAP_COUNT: The number of heaps returned by
> +	 * %DRM_PVR_DEV_QUERY_HEAP_INFO_GET.
> +	 *
> +	 * More heaps may be added, so this also serves as the copy
> limit when
> +	 * sent by the caller.
> +	 */
> +	DRM_PVR_HEAP_COUNT
> +	/* Please only add additional heaps above
> DRM_PVR_HEAP_COUNT! */
> +};
> +
> +/**
> + * struct drm_pvr_heap - Container holding information about a
> single heap.
> + *
> + * This will always be fetched as an array.
> + */
> +struct drm_pvr_heap {
> +	/** @base: Base address of heap. */
> +	__u64 base;
> +
> +	/** @size: Size of heap, in bytes. Will be 0 if the heap is
> not present. */
> +	__u64 size;
> +
> +	/** @flags: Flags for this heap. Currently always 0. */
> +	__u32 flags;
> +
> +	/** @page_size_log2: Log2 of page size. */
> +	__u32 page_size_log2;
> +};
> +
> +/**
> + * struct drm_pvr_dev_query_heap_info - Container used to fetch
> information
> + * about heaps supported by the device driver.
> + *
> + * Please note all driver-supported heaps will be returned up to
> &heaps.count.
> + * Some heaps will not be present in all devices, which will be
> indicated by
> + * &struct drm_pvr_heap.size being set to zero.
> + *
> + * When fetching this type &struct drm_pvr_ioctl_dev_query_args.type
> must be set
> + * to %DRM_PVR_DEV_QUERY_HEAP_INFO_GET.
> + */
> +struct drm_pvr_dev_query_heap_info {
> +	/**
> +	 * @heaps: Array of &struct drm_pvr_heap. If pointer is
> NULL, the count
> +	 * and stride will be updated with those known to the driver
> version, to
> +	 * facilitate allocation by the caller.
> +	 */
> +	struct drm_pvr_obj_array heaps;
> +};
> +
> +/**
> + * enum drm_pvr_static_data_area_usage - Array index for static data
> area info
> + * returned by %DRM_PVR_DEV_QUERY_STATIC_DATA_AREAS_GET.
> + *
> + * For compatibility reasons all indices will be present in the
> returned array,
> + * however some areas may not be present. These are indicated where
> + * &struct drm_pvr_static_data_area.size is set to zero.
> + */
> +enum drm_pvr_static_data_area_usage {
> +	/**
> +	 * @DRM_PVR_STATIC_DATA_AREA_EOT: End of Tile PDS program
> code segment.
> +	 *
> +	 * The End of Tile PDS task runs at completion of a tile
> during a fragment job, and is
> +	 * responsible for emitting the tile to the Pixel Back End.
> +	 */
> +	DRM_PVR_STATIC_DATA_AREA_EOT = 0,
> +
> +	/**
> +	 * @DRM_PVR_STATIC_DATA_AREA_FENCE: MCU fence area, used
> during cache flush and
> +	 * invalidation.
> +	 *
> +	 * This must point to valid physical memory but the contents
> otherwise are not used.
> +	 */
> +	DRM_PVR_STATIC_DATA_AREA_FENCE,
> +
> +	/**
> +	 * @DRM_PVR_STATIC_DATA_AREA_VDM_SYNC: VDM sync program.
> +	 *
> +	 * The VDM sync program is used to synchronise multiple
> areas of the GPU hardware.
> +	 */
> +	DRM_PVR_STATIC_DATA_AREA_VDM_SYNC,
> +
> +	/**
> +	 * @DRM_PVR_STATIC_DATA_AREA_YUV_CSC: YUV coefficients.
> +	 *
> +	 * Area contains up to 16 slots with stride of 64 bytes.
> Each is a 3x4 matrix of u16 fixed
> +	 * point numbers, with 1 sign bit, 2 integer bits and 13
> fractional bits.
> +	 *
> +	 * The slots are :
> +	 * 0 = VK_SAMPLER_YCBCR_MODEL_CONVERSION_RGB_IDENTITY_KHR
> +	 * 1 = VK_SAMPLER_YCBCR_MODEL_CONVERSION_YCBCR_IDENTITY_KHR
> (full range)
> +	 * 2 = VK_SAMPLER_YCBCR_MODEL_CONVERSION_YCBCR_IDENTITY_KHR
> (conformant range)
> +	 * 3 = VK_SAMPLER_YCBCR_MODEL_CONVERSION_YCBCR_709_KHR (full
> range)
> +	 * 4 = VK_SAMPLER_YCBCR_MODEL_CONVERSION_YCBCR_709_KHR
> (conformant range)
> +	 * 5 = VK_SAMPLER_YCBCR_MODEL_CONVERSION_YCBCR_601_KHR (full
> range)
> +	 * 6 = VK_SAMPLER_YCBCR_MODEL_CONVERSION_YCBCR_601_KHR
> (conformant range)
> +	 * 7 = VK_SAMPLER_YCBCR_MODEL_CONVERSION_YCBCR_2020_KHR
> (full range)
> +	 * 8 = VK_SAMPLER_YCBCR_MODEL_CONVERSION_YCBCR_2020_KHR
> (conformant range)
> +	 * 9 = VK_SAMPLER_YCBCR_MODEL_CONVERSION_YCBCR_601_KHR
> (conformant range, 10 bit)
> +	 * 10 = VK_SAMPLER_YCBCR_MODEL_CONVERSION_YCBCR_709_KHR
> (conformant range, 10 bit)
> +	 * 11 = VK_SAMPLER_YCBCR_MODEL_CONVERSION_YCBCR_2020_KHR
> (conformant range, 10 bit)
> +	 * 14 = Identity (biased)
> +	 * 15 = Identity
> +	 */
> +	DRM_PVR_STATIC_DATA_AREA_YUV_CSC,
> +};
> +
> +/**
> + * struct drm_pvr_static_data_area - Container holding information
> about a
> + * single static data area.
> + *
> + * This will always be fetched as an array.
> + */
> +struct drm_pvr_static_data_area {
> +	/**
> +	 * @area_usage: Usage of static data area.
> +	 * See &enum drm_pvr_static_data_area_usage.
> +	 */
> +	__u16 area_usage;
> +
> +	/**
> +	 * @location_heap_id: Array index of heap where this of
> static data
> +	 * area is located. This array is fetched using
> +	 * %DRM_PVR_DEV_QUERY_HEAP_INFO_GET.
> +	 */
> +	__u16 location_heap_id;
> +
> +	/** @size: Size of static data area. Not present if set to
> zero. */
> +	__u32 size;
> +
> +	/** @offset: Offset of static data area from start of heap.
> */
> +	__u64 offset;
> +};
> +
> +/**
> + * struct drm_pvr_dev_query_static_data_areas - Container used to
> fetch
> + * information about the static data areas in heaps supported by the
> device
> + * driver.
> + *
> + * Please note all driver-supported static data areas will be
> returned up to
> + * &static_data_areas.count. Some will not be present for all
> devices which,
> + * will be indicated by &struct drm_pvr_static_data_area.size being
> set to zero.
> + *
> + * Further, some heaps will not be present either. See &struct
> + * drm_pvr_dev_query_heap_info.
> + *
> + * When fetching this type &struct drm_pvr_ioctl_dev_query_args.type
> must be set
> + * to %DRM_PVR_DEV_QUERY_STATIC_DATA_AREAS_GET.
> + */
> +struct drm_pvr_dev_query_static_data_areas {
> +	/**
> +	 * @static_data_areas: Array of &struct
> drm_pvr_static_data_area. If
> +	 * pointer is NULL, the count and stride will be updated
> with those
> +	 * known to the driver version, to facilitate allocation by
> the caller.
> +	 */
> +	struct drm_pvr_obj_array static_data_areas;
> +};
> +
> +/**
> + * enum drm_pvr_dev_query - For use with
> &drm_pvr_ioctl_dev_query_args.type to
> + * indicate the type of the receiving container.
> + *
> + * Append only. Do not reorder.
> + */
> +enum drm_pvr_dev_query {
> +	/**
> +	 * @DRM_PVR_DEV_QUERY_GPU_INFO_GET: The dev query args
> contain a pointer
> +	 * to &struct drm_pvr_dev_query_gpu_info.
> +	 */
> +	DRM_PVR_DEV_QUERY_GPU_INFO_GET = 0,
> +
> +	/**
> +	 * @DRM_PVR_DEV_QUERY_RUNTIME_INFO_GET: The dev query args
> contain a
> +	 * pointer to &struct drm_pvr_dev_query_runtime_info.
> +	 */
> +	DRM_PVR_DEV_QUERY_RUNTIME_INFO_GET,
> +
> +	/**
> +	 * @DRM_PVR_DEV_QUERY_QUIRKS_GET: The dev query args contain
> a pointer
> +	 * to &struct drm_pvr_dev_query_quirks.
> +	 */
> +	DRM_PVR_DEV_QUERY_QUIRKS_GET,
> +
> +	/**
> +	 * @DRM_PVR_DEV_QUERY_ENHANCEMENTS_GET: The dev query args
> contain a
> +	 * pointer to &struct drm_pvr_dev_query_enhancements.
> +	 */
> +	DRM_PVR_DEV_QUERY_ENHANCEMENTS_GET,
> +
> +	/**
> +	 * @DRM_PVR_DEV_QUERY_HEAP_INFO_GET: The dev query args
> contain a
> +	 * pointer to &struct drm_pvr_dev_query_heap_info.
> +	 */
> +	DRM_PVR_DEV_QUERY_HEAP_INFO_GET,
> +
> +	/**
> +	 * @DRM_PVR_DEV_QUERY_STATIC_DATA_AREAS_GET: The dev query
> args contain
> +	 * a pointer to &struct drm_pvr_dev_query_static_data_areas.
> +	 */
> +	DRM_PVR_DEV_QUERY_STATIC_DATA_AREAS_GET,
> +};
> +
> +/**
> + * struct drm_pvr_ioctl_dev_query_args - Arguments for
> %DRM_IOCTL_PVR_DEV_QUERY.
> + */
> +struct drm_pvr_ioctl_dev_query_args {
> +	/**
> +	 * @type: Type of query and output struct. See &enum
> drm_pvr_dev_query.
> +	 */
> +	__u32 type;
> +
> +	/**
> +	 * @size: Size of the receiving struct, see @type.
> +	 *
> +	 * After a successful call this will be updated to the
> written byte
> +	 * length.
> +	 * Can also be used to get the minimum byte length (see
> @pointer).
> +	 * This allows additional fields to be appended to the
> structs in
> +	 * future.
> +	 */
> +	__u32 size;
> +
> +	/**
> +	 * @pointer: Pointer to struct @type.
> +	 *
> +	 * Must be large enough to contain @size bytes.
> +	 * If pointer is NULL, the expected size will be returned in
> the @size
> +	 * field, but no other data will be written.
> +	 */
> +	__u64 pointer;
> +};
> +
> +/**
> + * DOC: PowerVR IOCTL CREATE_BO interface
> + */
> +
> +/**
> + * DOC: Flags for CREATE_BO
> + *
> + * We use "device" to refer to the GPU here because of the ambiguity
> between CPU and GPU in some
> + * fonts.
> + *
> + * Device mapping options
> + *    :DRM_PVR_BO_BYPASS_DEVICE_CACHE: Specify that device accesses
> to this memory will bypass the
> + *       cache. This is used for buffers that will either be
> regularly updated by the CPU (eg free
> + *       lists) or will be accessed only once and therefore isn't
> worth caching (eg partial render
> + *       buffers).
> + *       By default, the device flushes its memory caches after
> every job, so this is not normally
> + *       required for coherency.
> + *    :DRM_PVR_BO_PM_FW_PROTECT: Specify that only the Parameter
> Manager (PM) and/or firmware
> + *       processor should be allowed to access this memory when
> mapped to the device. It is not
> + *       valid to specify this flag with
> DRM_PVR_BO_ALLOW_CPU_USERSPACE_ACCESS.
> + *
> + * CPU mapping options
> + *    :DRM_PVR_BO_ALLOW_CPU_USERSPACE_ACCESS: Allow userspace to map
> and access the contents of this
> + *       memory. It is not valid to specify this flag with
> DRM_PVR_BO_PM_FW_PROTECT.
> + */
> +#define DRM_PVR_BO_BYPASS_DEVICE_CACHE _BITULL(0)
> +#define DRM_PVR_BO_PM_FW_PROTECT _BITULL(1)
> +#define DRM_PVR_BO_ALLOW_CPU_USERSPACE_ACCESS _BITULL(2)
> +/* Bits 3..63 are reserved. */
> +
> +#define DRM_PVR_BO_FLAGS_MASK (DRM_PVR_BO_BYPASS_DEVICE_CACHE |
> DRM_PVR_BO_PM_FW_PROTECT | \
> +			      
> DRM_PVR_BO_ALLOW_CPU_USERSPACE_ACCESS)
> +
> +/**
> + * struct drm_pvr_ioctl_create_bo_args - Arguments for
> %DRM_IOCTL_PVR_CREATE_BO
> + */
> +struct drm_pvr_ioctl_create_bo_args {
> +	/**
> +	 * @size: [IN] Size of buffer object to create. This must be
> page size
> +	 * aligned.
> +	 */
> +	__u64 size;
> +
> +	/**
> +	 * @handle: [OUT] GEM handle of the new buffer object for
> use in
> +	 * userspace.
> +	 */
> +	__u32 handle;
> +
> +	/** @_padding_c: Reserved. This field must be zeroed. */
> +	__u32 _padding_c;
> +
> +	/**
> +	 * @flags: [IN] Options which will affect the behaviour of
> this
> +	 * creation operation and future mapping operations on the
> created
> +	 * object. This field must be a valid combination of
> ``DRM_PVR_BO_*``
> +	 * values, with all bits marked as reserved set to zero.
> +	 */
> +	__u64 flags;
> +};
> +
> +/**
> + * DOC: PowerVR IOCTL GET_BO_MMAP_OFFSET interface
> + */
> +
> +/**
> + * struct drm_pvr_ioctl_get_bo_mmap_offset_args - Arguments for
> + * %DRM_IOCTL_PVR_GET_BO_MMAP_OFFSET
> + *
> + * Like other DRM drivers, the "mmap" IOCTL doesn't actually map any
> memory.
> + * Instead, it allocates a fake offset which refers to the specified
> buffer
> + * object. This offset can be used with a real mmap call on the DRM
> device
> + * itself.
> + */
> +struct drm_pvr_ioctl_get_bo_mmap_offset_args {
> +	/** @handle: [IN] GEM handle of the buffer object to be
> mapped. */
> +	__u32 handle;
> +
> +	/** @_padding_4: Reserved. This field must be zeroed. */
> +	__u32 _padding_4;
> +
> +	/** @offset: [OUT] Fake offset to use in the real mmap call.
> */
> +	__u64 offset;
> +};
> +
> +/**
> + * DOC: PowerVR IOCTL CREATE_VM_CONTEXT and DESTROY_VM_CONTEXT
> interfaces
> + */
> +
> +/**
> + * struct drm_pvr_ioctl_create_vm_context_args - Arguments for
> + * %DRM_IOCTL_PVR_CREATE_VM_CONTEXT
> + */
> +struct drm_pvr_ioctl_create_vm_context_args {
> +	/** @handle: [OUT] Handle for new VM context. */
> +	__u32 handle;
> +
> +	/** @_padding_4: Reserved. This field must be zeroed. */
> +	__u32 _padding_4;
> +};
> +
> +/**
> + * struct drm_pvr_ioctl_destroy_vm_context_args - Arguments for
> + * %DRM_IOCTL_PVR_DESTROY_VM_CONTEXT
> + */
> +struct drm_pvr_ioctl_destroy_vm_context_args {
> +	/**
> +	 * @handle: [IN] Handle for VM context to be destroyed.
> +	 */
> +	__u32 handle;
> +
> +	/** @_padding_4: Reserved. This field must be zeroed. */
> +	__u32 _padding_4;
> +};
> +
> +/**
> + * DOC: PowerVR IOCTL VM_MAP and VM_UNMAP interfaces
> + *
> + * The VM UAPI allows userspace to create buffer object mappings in
> GPU virtual address space.
> + *
> + * The client is responsible for managing GPU address space. It
> should allocate mappings within
> + * the heaps returned by %DRM_PVR_DEV_QUERY_HEAP_INFO_GET.
> + *
> + * %DRM_IOCTL_PVR_VM_MAP creates a new mapping. The client provides
> the target virtual address for
> + * the mapping. Size and offset within the mapped buffer object can
> be specified, so the client can
> + * partially map a buffer.
> + *
> + * %DRM_IOCTL_PVR_VM_UNMAP removes a mapping. The entire mapping
> will be removed from GPU address
> + * space. For this reason only the start address is provided by the
> client.
> + */
> +
> +/**
> + * struct drm_pvr_ioctl_vm_map_args - Arguments for
> %DRM_IOCTL_PVR_VM_MAP.
> + */
> +struct drm_pvr_ioctl_vm_map_args {
> +	/**
> +	 * @vm_context_handle: [IN] Handle for VM context for this
> mapping to
> +	 * exist in.
> +	 */
> +	__u32 vm_context_handle;
> +
> +	/** @flags: [IN] Flags which affect this mapping. Currently
> always 0. */
> +	__u32 flags;
> +
> +	/**
> +	 * @device_addr: [IN] Requested device-virtual address for
> the mapping.
> +	 * This must be non-zero and aligned to the device page size
> for the
> +	 * heap containing the requested address. It is an error to
> specify an
> +	 * address which is not contained within one of the heaps
> returned by
> +	 * %DRM_PVR_DEV_QUERY_HEAP_INFO_GET.
> +	 */
> +	__u64 device_addr;
> +
> +	/**
> +	 * @handle: [IN] Handle of the target buffer object. This
> must be a
> +	 * valid handle returned by %DRM_IOCTL_PVR_CREATE_BO.
> +	 */
> +	__u32 handle;
> +
> +	/** @_padding_14: Reserved. This field must be zeroed. */
> +	__u32 _padding_14;
> +
> +	/**
> +	 * @offset: [IN] Offset into the target bo from which to
> begin the
> +	 * mapping.
> +	 */
> +	__u64 offset;
> +
> +	/**
> +	 * @size: [IN] Size of the requested mapping. Must be
> aligned to
> +	 * the device page size for the heap containing the
> requested address,
> +	 * as well as the host page size. When added to
> @device_addr, the
> +	 * result must not overflow the heap which contains
> @device_addr (i.e.
> +	 * the range specified by @device_addr and @size must be
> completely
> +	 * contained within a single heap specified by
> +	 * %DRM_PVR_DEV_QUERY_HEAP_INFO_GET).
> +	 */
> +	__u64 size;
> +};
> +
> +/**
> + * struct drm_pvr_ioctl_vm_unmap_args - Arguments for
> %DRM_IOCTL_PVR_VM_UNMAP.
> + */
> +struct drm_pvr_ioctl_vm_unmap_args {
> +	/**
> +	 * @vm_context_handle: [IN] Handle for VM context that this
> mapping
> +	 * exists in.
> +	 */
> +	__u32 vm_context_handle;
> +
> +	/** @_padding_4: Reserved. This field must be zeroed. */
> +	__u32 _padding_4;
> +
> +	/**
> +	 * @device_addr: [IN] Device-virtual address at the start of
> the target
> +	 * mapping. This must be non-zero.
> +	 */
> +	__u64 device_addr;
> +
> +	/**
> +	 * @size: Size in bytes of the target mapping. This must be
> non-zero.
> +	 */
> +	__u64 size;
> +};
> +
> +/**
> + * DOC: PowerVR IOCTL CREATE_CONTEXT and DESTROY_CONTEXT interfaces
> + */
> +
> +/**
> + * enum drm_pvr_ctx_priority - Arguments for
> + * &drm_pvr_ioctl_create_context_args.priority
> + */
> +enum drm_pvr_ctx_priority {
> +	/** @DRM_PVR_CTX_PRIORITY_LOW: Priority below normal. */
> +	DRM_PVR_CTX_PRIORITY_LOW = -512,
> +
> +	/** @DRM_PVR_CTX_PRIORITY_NORMAL: Normal priority. */
> +	DRM_PVR_CTX_PRIORITY_NORMAL = 0,
> +
> +	/**
> +	 * @DRM_PVR_CTX_PRIORITY_HIGH: Priority above normal.
> +	 * Note this requires ``CAP_SYS_NICE`` or ``DRM_MASTER``.
> +	 */
> +	DRM_PVR_CTX_PRIORITY_HIGH = 512,
> +};
> +
> +/**
> + * enum drm_pvr_ctx_type - Arguments for
> + * &struct drm_pvr_ioctl_create_context_args.type
> + */
> +enum drm_pvr_ctx_type {
> +	/**
> +	 * @DRM_PVR_CTX_TYPE_RENDER: Render context. Use &struct
> +	 * drm_pvr_ioctl_create_render_context_args for context
> creation arguments.
> +	 */
> +	DRM_PVR_CTX_TYPE_RENDER = 0,
> +
> +	/**
> +	 * @DRM_PVR_CTX_TYPE_COMPUTE: Compute context. Use &struct
> +	 * drm_pvr_ioctl_create_compute_context_args for context
> creation arguments.
> +	 */
> +	DRM_PVR_CTX_TYPE_COMPUTE,
> +
> +	/**
> +	 * @DRM_PVR_CTX_TYPE_TRANSFER_FRAG: Transfer context for
> fragment data masters. Use
> +	 * &struct drm_pvr_ioctl_create_transfer_context_args for
> context creation arguments.
> +	 */
> +	DRM_PVR_CTX_TYPE_TRANSFER_FRAG,
> +};
> +
> +/**
> + * struct drm_pvr_ioctl_create_context_args - Arguments for
> + * %DRM_IOCTL_PVR_CREATE_CONTEXT
> + */
> +struct drm_pvr_ioctl_create_context_args {
> +	/**
> +	 * @type: [IN] Type of context to create.
> +	 *
> +	 * This must be one of the values defined by &enum
> drm_pvr_ctx_type.
> +	 */
> +	__u32 type;
> +
> +	/** @flags: [IN] Flags for context. */
> +	__u32 flags;
> +
> +	/**
> +	 * @priority: [IN] Priority of new context.
> +	 *
> +	 * This must be one of the values defined by &enum
> drm_pvr_ctx_priority.
> +	 */
> +	__s32 priority;
> +
> +	/** @handle: [OUT] Handle for new context. */
> +	__u32 handle;
> +
> +	/**
> +	 * @static_context_state: [IN] Pointer to static context
> state stream.
> +	 */
> +	__u64 static_context_state;
> +
> +	/**
> +	 * @static_context_state_len: [IN] Length of static context
> state, in bytes.
> +	 */
> +	__u32 static_context_state_len;
> +
> +	/**
> +	 * @vm_context_handle: [IN] Handle for VM context that this
> context is
> +	 * associated with.
> +	 */
> +	__u32 vm_context_handle;
> +
> +	/**
> +	 * @callstack_addr: [IN] Address for initial call stack
> pointer. Only valid
> +	 * if @type is %DRM_PVR_CTX_TYPE_RENDER, otherwise must be
> 0.
> +	 */
> +	__u64 callstack_addr;
> +};
> +
> +/**
> + * struct drm_pvr_ioctl_destroy_context_args - Arguments for
> + * %DRM_IOCTL_PVR_DESTROY_CONTEXT
> + */
> +struct drm_pvr_ioctl_destroy_context_args {
> +	/**
> +	 * @handle: [IN] Handle for context to be destroyed.
> +	 */
> +	__u32 handle;
> +
> +	/** @_padding_4: Reserved. This field must be zeroed. */
> +	__u32 _padding_4;
> +};
> +
> +/**
> + * DOC: PowerVR IOCTL CREATE_FREE_LIST and DESTROY_FREE_LIST
> interfaces
> + */
> +
> +/**
> + * struct drm_pvr_ioctl_create_free_list_args - Arguments for
> + * %DRM_IOCTL_PVR_CREATE_FREE_LIST
> + *
> + * Free list arguments have the following constraints :
> + *
> + * - @max_num_pages must be greater than zero.
> + * - @grow_threshold must be between 0 and 100.
> + * - @grow_num_pages must be less than or equal to &max_num_pages.
> + * - @initial_num_pages, @max_num_pages and @grow_num_pages must be
> multiples
> + *   of 4.
> + * - When &grow_num_pages is 0, @initial_num_pages must be equal to
> + *   @max_num_pages.
> + * - When &grow_num_pages is non-zero, @initial_num_pages must be
> less than
> + *   @max_num_pages.
> + */
> +struct drm_pvr_ioctl_create_free_list_args {
> +	/**
> +	 * @free_list_gpu_addr: [IN] Address of GPU mapping of
> buffer object
> +	 * containing memory to be used by free list.
> +	 *
> +	 * The mapped region of the buffer object must be at least
> +	 * @max_num_pages * ``sizeof(__u32)``.
> +	 *
> +	 * The buffer object must have been created with
> +	 * %DRM_PVR_BO_DEVICE_PM_FW_PROTECT set and
> +	 * %DRM_PVR_BO_CPU_ALLOW_USERSPACE_ACCESS not set.
> +	 */
> +	__u64 free_list_gpu_addr;
> +
> +	/** @initial_num_pages: [IN] Pages initially allocated to
> free list. */
> +	__u32 initial_num_pages;
> +
> +	/** @max_num_pages: [IN] Maximum number of pages in free
> list. */
> +	__u32 max_num_pages;
> +
> +	/** @grow_num_pages: [IN] Pages to grow free list by per
> request. */
> +	__u32 grow_num_pages;
> +
> +	/**
> +	 * @grow_threshold: [IN] Percentage of FL memory used that
> should
> +	 * trigger a new grow request.
> +	 */
> +	__u32 grow_threshold;
> +
> +	/**
> +	 * @vm_context_handle: [IN] Handle for VM context that the
> free list buffer
> +	 * object is mapped in.
> +	 */
> +	__u32 vm_context_handle;
> +
> +	/**
> +	 * @handle: [OUT] Handle for created free list.
> +	 */
> +	__u32 handle;
> +};
> +
> +/**
> + * struct drm_pvr_ioctl_destroy_free_list_args - Arguments for
> + * %DRM_IOCTL_PVR_DESTROY_FREE_LIST
> + */
> +struct drm_pvr_ioctl_destroy_free_list_args {
> +	/**
> +	 * @handle: [IN] Handle for free list to be destroyed.
> +	 */
> +	__u32 handle;
> +
> +	/** @_padding_4: Reserved. This field must be zeroed. */
> +	__u32 _padding_4;
> +};
> +
> +/**
> + * DOC: PowerVR IOCTL CREATE_HWRT_DATASET and DESTROY_HWRT_DATASET
> interfaces
> + */
> +
> +/**
> + * struct drm_pvr_create_hwrt_geom_data_args - Geometry data
> arguments used for
> + * &struct drm_pvr_ioctl_create_hwrt_dataset_args.geom_data_args.
> + */
> +struct drm_pvr_create_hwrt_geom_data_args {
> +	/** @tpc_dev_addr: [IN] Tail pointer cache GPU virtual
> address. */
> +	__u64 tpc_dev_addr;
> +
> +	/** @tpc_size: [IN] Size of TPC, in bytes. */
> +	__u32 tpc_size;
> +
> +	/** @tpc_stride: [IN] Stride between layers in TPC, in pages
> */
> +	__u32 tpc_stride;
> +
> +	/** @vheap_table_dev_addr: [IN] VHEAP table GPU virtual
> address. */
> +	__u64 vheap_table_dev_addr;
> +
> +	/** @rtc_dev_addr: [IN] Render Target Cache virtual address.
> */
> +	__u64 rtc_dev_addr;
> +};
> +
> +/**
> + * struct drm_pvr_create_hwrt_rt_data_args - Render target arguments
> used for
> + * &struct drm_pvr_ioctl_create_hwrt_dataset_args.rt_data_args.
> + */
> +struct drm_pvr_create_hwrt_rt_data_args {
> +	/** @pm_mlist_dev_addr: [IN] PM MLIST GPU virtual address.
> */
> +	__u64 pm_mlist_dev_addr;
> +
> +	/** @macrotile_array_dev_addr: [IN] Macrotile array GPU
> virtual address. */
> +	__u64 macrotile_array_dev_addr;
> +
> +	/** @region_header_dev_addr: [IN] Region header array GPU
> virtual address. */
> +	__u64 region_header_dev_addr;
> +};
> +
> +#define PVR_DRM_HWRT_FREE_LIST_LOCAL 0
> +#define PVR_DRM_HWRT_FREE_LIST_GLOBAL 1U
> +
> +/**
> + * struct drm_pvr_ioctl_create_hwrt_dataset_args - Arguments for
> + * %DRM_IOCTL_PVR_CREATE_HWRT_DATASET
> + */
> +struct drm_pvr_ioctl_create_hwrt_dataset_args {
> +	/** @geom_data_args: [IN] Geometry data arguments. */
> +	struct drm_pvr_create_hwrt_geom_data_args geom_data_args;
> +
> +	/**
> +	 * @rt_data_args: [IN] Array of render target arguments.
> +	 *
> +	 * Each entry in this array represents a render target in a
> double buffered
> +	 * setup.
> +	 */
> +	struct drm_pvr_create_hwrt_rt_data_args rt_data_args[2];
> +
> +	/**
> +	 * @free_list_handles: [IN] Array of free list handles.
> +	 *
> +	 * free_list_handles[PVR_DRM_HWRT_FREE_LIST_LOCAL] must have
> initial
> +	 * size of at least that reported by
> +	 * &drm_pvr_dev_query_runtime_info.free_list_min_pages.
> +	 */
> +	__u32 free_list_handles[2];
> +
> +	/** @width: [IN] Width in pixels. */
> +	__u32 width;
> +
> +	/** @height: [IN] Height in pixels. */
> +	__u32 height;
> +
> +	/** @samples: [IN] Number of samples. */
> +	__u32 samples;
> +
> +	/** @layers: [IN] Number of layers. */
> +	__u32 layers;
> +
> +	/** @isp_merge_lower_x: [IN] Lower X coefficient for
> triangle merging. */
> +	__u32 isp_merge_lower_x;
> +
> +	/** @isp_merge_lower_y: [IN] Lower Y coefficient for
> triangle merging. */
> +	__u32 isp_merge_lower_y;
> +
> +	/** @isp_merge_scale_x: [IN] Scale X coefficient for
> triangle merging. */
> +	__u32 isp_merge_scale_x;
> +
> +	/** @isp_merge_scale_y: [IN] Scale Y coefficient for
> triangle merging. */
> +	__u32 isp_merge_scale_y;
> +
> +	/** @isp_merge_upper_x: [IN] Upper X coefficient for
> triangle merging. */
> +	__u32 isp_merge_upper_x;
> +
> +	/** @isp_merge_upper_y: [IN] Upper Y coefficient for
> triangle merging. */
> +	__u32 isp_merge_upper_y;
> +
> +	/**
> +	 * @region_header_size: [IN] Size of region header array.
> This common field is used by
> +	 * both render targets in this data set.
> +	 *
> +	 * The units for this field differ depending on what version
> of the simple internal
> +	 * parameter format the device uses. If format 2 is in use
> then this is interpreted as the
> +	 * number of region headers. For other formats it is
> interpreted as the size in dwords.
> +	 */
> +	__u32 region_header_size;
> +
> +	/**
> +	 * @handle: [OUT] Handle for created HWRT dataset.
> +	 */
> +	__u32 handle;
> +};
> +
> +/**
> + * struct drm_pvr_ioctl_destroy_hwrt_dataset_args - Arguments for
> + * %DRM_IOCTL_PVR_DESTROY_HWRT_DATASET
> + */
> +struct drm_pvr_ioctl_destroy_hwrt_dataset_args {
> +	/**
> +	 * @handle: [IN] Handle for HWRT dataset to be destroyed.
> +	 */
> +	__u32 handle;
> +
> +	/** @_padding_4: Reserved. This field must be zeroed. */
> +	__u32 _padding_4;
> +};
> +
> +/**
> + * DOC: PowerVR IOCTL SUBMIT_JOBS interface
> + */
> +
> +/**
> + * DOC: Flags for the drm_pvr_sync_op object.
> + *
> + * .. c:macro:: DRM_PVR_SYNC_OP_HANDLE_TYPE_MASK
> + *
> + *    Handle type mask for the drm_pvr_sync_op::flags field.
> + *
> + * .. c:macro:: DRM_PVR_SYNC_OP_FLAG_HANDLE_TYPE_SYNCOBJ
> + *
> + *    Indicates the handle passed in drm_pvr_sync_op::handle is a
> syncobj handle.
> + *    This is the default type.
> + *
> + * .. c:macro:: DRM_PVR_SYNC_OP_FLAG_HANDLE_TYPE_TIMELINE_SYNCOBJ
> + *
> + *    Indicates the handle passed in drm_pvr_sync_op::handle is a
> timeline syncobj handle.
> + *
> + * .. c:macro:: DRM_PVR_SYNC_OP_FLAG_SIGNAL
> + *
> + *    Signal operation requested. The out-fence bound to the job
> will be attached to
> + *    the syncobj whose handle is passed in drm_pvr_sync_op::handle.
> + *
> + * .. c:macro:: DRM_PVR_SYNC_OP_FLAG_WAIT
> + *
> + *    Wait operation requested. The job will wait for this
> particular syncobj or syncobj
> + *    point to be signaled before being started.
> + *    This is the default operation.
> + */
> +#define DRM_PVR_SYNC_OP_FLAG_HANDLE_TYPE_MASK 0xf
> +#define DRM_PVR_SYNC_OP_FLAG_HANDLE_TYPE_SYNCOBJ 0
> +#define DRM_PVR_SYNC_OP_FLAG_HANDLE_TYPE_TIMELINE_SYNCOBJ 1
> +#define DRM_PVR_SYNC_OP_FLAG_SIGNAL _BITULL(31)
> +#define DRM_PVR_SYNC_OP_FLAG_WAIT 0
> +
> +#define DRM_PVR_SYNC_OP_FLAGS_MASK
> (DRM_PVR_SYNC_OP_FLAG_HANDLE_TYPE_MASK | \
> +				    DRM_PVR_SYNC_OP_FLAG_SIGNAL)
> +
> +/**
> + * struct drm_pvr_sync_op - Object describing a sync operation
> + */
> +struct drm_pvr_sync_op {
> +	/** @handle: Handle of sync object. */
> +	__u32 handle;
> +
> +	/** @flags: Combination of ``DRM_PVR_SYNC_OP_FLAG_`` flags.
> */
> +	__u32 flags;
> +
> +	/** @value: Timeline value for this drm_syncobj. MBZ for a
> binary syncobj. */
> +	__u64 value;
> +};
> +
> +/**
> + * DOC: Flags for SUBMIT_JOB ioctl geometry command.
> + *
> + * .. c:macro:: DRM_PVR_SUBMIT_JOB_GEOM_CMD_FIRST
> + *
> + *    Indicates if this the first command to be issued for a render.
> + *
> + * .. c:macro:: DRM_PVR_SUBMIT_JOB_GEOM_CMD_LAST
> + *
> + *    Indicates if this the last command to be issued for a render.
> + *
> + * .. c:macro:: DRM_PVR_SUBMIT_JOB_GEOM_CMD_SINGLE_CORE
> + *
> + *    Forces to use single core in a multi core device.
> + *
> + * .. c:macro:: DRM_PVR_SUBMIT_JOB_GEOM_CMD_FLAGS_MASK
> + *
> + *    Logical OR of all the geometry cmd flags.
> + */
> +#define DRM_PVR_SUBMIT_JOB_GEOM_CMD_FIRST _BITULL(0)
> +#define DRM_PVR_SUBMIT_JOB_GEOM_CMD_LAST _BITULL(1)
> +#define DRM_PVR_SUBMIT_JOB_GEOM_CMD_SINGLE_CORE _BITULL(2)
> +#define
> DRM_PVR_SUBMIT_JOB_GEOM_CMD_FLAGS_MASK                               
>   \
> +	(DRM_PVR_SUBMIT_JOB_GEOM_CMD_FIRST
> |                                   \
> +	 DRM_PVR_SUBMIT_JOB_GEOM_CMD_LAST
> |                                    \
> +	 DRM_PVR_SUBMIT_JOB_GEOM_CMD_SINGLE_CORE)
> +
> +/**
> + * DOC: Flags for SUBMIT_JOB ioctl fragment command.
> + *
> + * .. c:macro:: DRM_PVR_SUBMIT_JOB_FRAG_CMD_SINGLE_CORE
> + *
> + *    Use single core in a multi core setup.
> + *
> + * .. c:macro:: DRM_PVR_SUBMIT_JOB_FRAG_CMD_DEPTHBUFFER
> + *
> + *    Indicates whether a depth buffer is present.
> + *
> + * .. c:macro:: DRM_PVR_SUBMIT_JOB_FRAG_CMD_STENCILBUFFER
> + *
> + *    Indicates whether a stencil buffer is present.
> + *
> + * .. c:macro:: DRM_PVR_SUBMIT_JOB_FRAG_CMD_PREVENT_CDM_OVERLAP
> + *
> + *    Disallow compute overlapped with this render.
> + *
> + * .. c:macro:: DRM_PVR_SUBMIT_JOB_FRAG_CMD_GET_VIS_RESULTS
> + *
> + *    Indicates whether this render produces visibility results.
> + *
> + * .. c:macro:: DRM_PVR_SUBMIT_JOB_FRAG_CMD_SCRATCHBUFFER
> + *
> + *    Indicates whether partial renders write to a scratch buffer
> instead of
> + *    the final surface. It also forces the full screen copy
> expected to be
> + *    present on the last render after all partial renders have
> completed.
> + *
> + * .. c:macro:: DRM_PVR_SUBMIT_JOB_FRAG_CMD_DISABLE_PIXELMERGE
> + *
> + *    Disable pixel merging for this render.
> + *
> + * .. c:macro:: DRM_PVR_SUBMIT_JOB_FRAG_CMD_FLAGS_MASK
> + *
> + *    Logical OR of all the fragment cmd flags.
> + */
> +#define DRM_PVR_SUBMIT_JOB_FRAG_CMD_SINGLE_CORE _BITULL(0)
> +#define DRM_PVR_SUBMIT_JOB_FRAG_CMD_DEPTHBUFFER _BITULL(1)
> +#define DRM_PVR_SUBMIT_JOB_FRAG_CMD_STENCILBUFFER _BITULL(2)
> +#define DRM_PVR_SUBMIT_JOB_FRAG_CMD_PREVENT_CDM_OVERLAP _BITULL(3)
> +#define DRM_PVR_SUBMIT_JOB_FRAG_CMD_SCRATCHBUFFER _BITULL(4)
> +#define DRM_PVR_SUBMIT_JOB_FRAG_CMD_GET_VIS_RESULTS _BITULL(5)
> +#define DRM_PVR_SUBMIT_JOB_FRAG_CMD_PARTIAL_RENDER _BITULL(6)
> +#define DRM_PVR_SUBMIT_JOB_FRAG_CMD_DISABLE_PIXELMERGE _BITULL(7)
> +#define
> DRM_PVR_SUBMIT_JOB_FRAG_CMD_FLAGS_MASK                               
>   \
> +	(DRM_PVR_SUBMIT_JOB_FRAG_CMD_SINGLE_CORE
> |                             \
> +	 DRM_PVR_SUBMIT_JOB_FRAG_CMD_DEPTHBUFFER
> |                             \
> +	 DRM_PVR_SUBMIT_JOB_FRAG_CMD_STENCILBUFFER
> |                           \
> +	 DRM_PVR_SUBMIT_JOB_FRAG_CMD_PREVENT_CDM_OVERLAP
> |                     \
> +	 DRM_PVR_SUBMIT_JOB_FRAG_CMD_SCRATCHBUFFER
> |                           \
> +	 DRM_PVR_SUBMIT_JOB_FRAG_CMD_GET_VIS_RESULTS
> |                         \
> +	 DRM_PVR_SUBMIT_JOB_FRAG_CMD_PARTIAL_RENDER
> |                          \
> +	 DRM_PVR_SUBMIT_JOB_FRAG_CMD_DISABLE_PIXELMERGE)
> +
> +/**
> + * DOC: Flags for SUBMIT_JOB ioctl compute command.
> + *
> + * .. c:macro:: DRM_PVR_SUBMIT_JOB_COMPUTE_CMD_PREVENT_ALL_OVERLAP
> + *
> + *    Disallow other jobs overlapped with this compute.
> + *
> + * .. c:macro:: DRM_PVR_SUBMIT_JOB_COMPUTE_CMD_SINGLE_CORE
> + *
> + *    Forces to use single core in a multi core device.
> + *
> + * .. c:macro:: DRM_PVR_SUBMIT_JOB_COMPUTE_CMD_FLAGS_MASK
> + *
> + *    Logical OR of all the compute cmd flags.
> + */
> +#define DRM_PVR_SUBMIT_JOB_COMPUTE_CMD_PREVENT_ALL_OVERLAP
> _BITULL(0)
> +#define DRM_PVR_SUBMIT_JOB_COMPUTE_CMD_SINGLE_CORE _BITULL(1)
> +#define DRM_PVR_SUBMIT_JOB_COMPUTE_CMD_FLAGS_MASK         \
> +	(DRM_PVR_SUBMIT_JOB_COMPUTE_CMD_PREVENT_ALL_OVERLAP | \
> +	 DRM_PVR_SUBMIT_JOB_COMPUTE_CMD_SINGLE_CORE)
> +
> +/**
> + * DOC: Flags for SUBMIT_JOB ioctl transfer command.
> + *
> + * .. c:macro:: DRM_PVR_SUBMIT_JOB_TRANSFER_CMD_SINGLE_CORE
> + *
> + *    Forces job to use a single core in a multi core device.
> + *
> + * .. c:macro:: DRM_PVR_SUBMIT_JOB_TRANSFER_CMD_FLAGS_MASK
> + *
> + *    Logical OR of all the transfer cmd flags.
> + */
> +#define DRM_PVR_SUBMIT_JOB_TRANSFER_CMD_SINGLE_CORE _BITULL(0)
> +
> +#define DRM_PVR_SUBMIT_JOB_TRANSFER_CMD_FLAGS_MASK \
> +	DRM_PVR_SUBMIT_JOB_TRANSFER_CMD_SINGLE_CORE
> +
> +/**
> + * enum drm_pvr_job_type - Arguments for &struct
> drm_pvr_job.job_type
> + */
> +enum drm_pvr_job_type {
> +	/** @DRM_PVR_JOB_TYPE_GEOMETRY: Job type is geometry. */
> +	DRM_PVR_JOB_TYPE_GEOMETRY = 0,
> +
> +	/** @DRM_PVR_JOB_TYPE_FRAGMENT: Job type is fragment. */
> +	DRM_PVR_JOB_TYPE_FRAGMENT,
> +
> +	/** @DRM_PVR_JOB_TYPE_COMPUTE: Job type is compute. */
> +	DRM_PVR_JOB_TYPE_COMPUTE,
> +
> +	/** @DRM_PVR_JOB_TYPE_TRANSFER_FRAG: Job type is a fragment
> transfer. */
> +	DRM_PVR_JOB_TYPE_TRANSFER_FRAG,
> +};
> +
> +/**
> + * struct drm_pvr_hwrt_data_ref - Reference HWRT data
> + */
> +struct drm_pvr_hwrt_data_ref {
> +	/** @set_handle: HWRT data set handle. */
> +	__u32 set_handle;
> +
> +	/** @data_index: Index of the HWRT data inside the data set.
> */
> +	__u32 data_index;
> +};
> +
> +/**
> + * struct drm_pvr_job - Job arguments passed to the
> %DRM_IOCTL_PVR_SUBMIT_JOBS ioctl
> + */
> +struct drm_pvr_job {
> +	/**
> +	 * @type: [IN] Type of job being submitted
> +	 *
> +	 * This must be one of the values defined by &enum
> drm_pvr_job_type.
> +	 */
> +	__u32 type;
> +
> +	/**
> +	 * @context_handle: [IN] Context handle.
> +	 *
> +	 * When @job_type is %DRM_PVR_JOB_TYPE_RENDER,
> %DRM_PVR_JOB_TYPE_COMPUTE or
> +	 * %DRM_PVR_JOB_TYPE_TRANSFER_FRAG, this must be a valid
> handle returned by
> +	 * %DRM_IOCTL_PVR_CREATE_CONTEXT. The type of context must
> be compatible
> +	 * with the type of job being submitted.
> +	 *
> +	 * When @job_type is %DRM_PVR_JOB_TYPE_NULL, this must be
> zero.
> +	 */
> +	__u32 context_handle;
> +
> +	/**
> +	 * @flags: [IN] Flags for command.
> +	 *
> +	 * Those are job-dependent. See all
> ``DRM_PVR_SUBMIT_JOB_*``.
> +	 */
> +	__u32 flags;
> +
> +	/**
> +	 * @cmd_stream_len: [IN] Length of command stream, in bytes.
> +	 */
> +	__u32 cmd_stream_len;
> +
> +	/**
> +	 * @cmd_stream: [IN] Pointer to command stream for command.
> +	 *
> +	 * The command stream must be u64-aligned.
> +	 */
> +	__u64 cmd_stream;
> +
> +	/** @sync_ops: [IN] Fragment sync operations. */
> +	struct drm_pvr_obj_array sync_ops;
> +
> +	/**
> +	 * @hwrt: [IN] HWRT data used by render jobs (geometry or
> fragment).
> +	 *
> +	 * Must be zero for non-render jobs.
> +	 */
> +	struct drm_pvr_hwrt_data_ref hwrt;
> +};
> +
> +/**
> + * struct drm_pvr_ioctl_submit_jobs_args - Arguments for
> %DRM_IOCTL_PVR_SUBMIT_JOB
> + *
> + * If the syscall returns an error it is important to check the
> value of
> + * @jobs.count. This indicates the index into @jobs.array where the
> + * error occurred.
> + */
> +struct drm_pvr_ioctl_submit_jobs_args {
> +	/** @jobs: [IN] Array of jobs to submit. */
> +	struct drm_pvr_obj_array jobs;
> +};
> +
> +#if defined(__cplusplus)
> +}
> +#endif
> +
> +#endif /* PVR_DRM_UAPI_H */