ARRAY_SIZE()

#define ARRAY_SIZE(arr) (sizeof(arr)/sizeof(arr[0]))

Macro to compute the size of the static array arr .

ALIGN()

#define ALIGN(v, a) (((v) + (a)-1) & ~((a)-1))

Macro to align a value v to a specified unit a .

drm_get_card ()

int
drm_get_card (void);

Get an i915 drm card index number for use in /dev or /sys. The minor index of the legacy node is returned, not of the control or render node.

drm_open_driver ()

int
drm_open_driver (int chipset);

Open a drm legacy device node. This function always returns a valid file descriptor.

drm_open_driver_master ()

int
drm_open_driver_master (int chipset);

Open a drm legacy device node and ensure that it is drm master.

drm_open_driver_render ()

int
drm_open_driver_render (int chipset);

Open a drm render device node.

gem_quiescent_gpu ()

void
gem_quiescent_gpu (int fd);

Ensure the gpu is idle by launching a nop execbuf and stalling for it. This is automatically run when opening a drm device node and is also installed as an exit handler to have the best assurance that the test is run in a pristine and controlled environment.

This function simply allows tests to make additional calls in-between, if so desired.

igt_require_intel ()

void
igt_require_intel (int fd);

is_i915_device ()

bool
is_i915_device (int fd);

do_or_die()

#define do_or_die(x) igt_assert((x) == 0)

Simple macro to execute x and check that it's return value is 0. Presumes that in any failure case the return value is non-zero and a precise error is logged into errno. Uses igt_assert() internally.

do_ioctl()

#define             do_ioctl(fd, ioc, ioc_data)

This macro wraps drmIoctl() and uses igt_assert to check that it has been successfully executed.

do_ioctl_err()

#define             do_ioctl_err(fd, ioc, ioc_data, err)

This macro wraps drmIoctl() and uses igt_assert to check that it fails, returning a particular value in errno.

DRIVER_INTEL

#define DRIVER_INTEL (1 << 0)

DRIVER_VC4

#define DRIVER_VC4 (1 << 1)

DRIVER_VGEM

#define DRIVER_VGEM (1 << 2)

DRIVER_VIRTIO

#define DRIVER_VIRTIO (1 << 3)

DRIVER_AMDGPU

#define DRIVER_AMDGPU (1 << 4)

DRIVER_V3D

#define DRIVER_V3D (1 << 5)

DRIVER_ANY

#define DRIVER_ANY 	~(DRIVER_VGEM)