for_each_sysfs_gt_path()

#define             for_each_sysfs_gt_path(i915__, path__, pathlen__)

for_each_sysfs_gt_dirfd()

#define             for_each_sysfs_gt_dirfd(i915__, dirfd__, gt__)

for_each_sysfs_tile_dirfd()

#define             for_each_sysfs_tile_dirfd(xe__, dirfd__, tile__)

igt_sysfs_rps_write()

#define             igt_sysfs_rps_write(dir, id, data, len)

igt_sysfs_rps_read()

#define             igt_sysfs_rps_read(dir, id, data, len)

igt_sysfs_rps_set()

#define             igt_sysfs_rps_set(dir, id, value)

igt_sysfs_rps_get()

#define             igt_sysfs_rps_get(dir, id)

igt_sysfs_rps_scanf()

#define             igt_sysfs_rps_scanf(dir, id, fmt, ...)

igt_sysfs_rps_vprintf()

#define             igt_sysfs_rps_vprintf(dir, id, fmt, ap)

igt_sysfs_rps_printf()

#define             igt_sysfs_rps_printf(dir, id, fmt, ...)

igt_sysfs_rps_get_u32()

#define             igt_sysfs_rps_get_u32(dir, id)

igt_sysfs_rps_set_u32()

#define             igt_sysfs_rps_set_u32(dir, id, value)

igt_sysfs_rps_get_boolean()

#define             igt_sysfs_rps_get_boolean(dir, id)

igt_sysfs_rps_set_boolean()

#define             igt_sysfs_rps_set_boolean(dir, id, value)

igt_sysfs_path ()

char *
igt_sysfs_path (int device,
                char *path,
                int pathlen);

This finds the sysfs directory corresponding to device .

igt_sysfs_open ()

int
igt_sysfs_open (int device);

This opens the sysfs directory corresponding to device for use with igt_sysfs_set() and igt_sysfs_get().

igt_sysfs_gt_path ()

char *
igt_sysfs_gt_path (int device,
                   int gt,
                   char *path,
                   int pathlen);

This finds the sysfs directory corresponding to device and gt . If the gt specific directory is not available and gt is 0, path is filled with sysfs base directory.

igt_sysfs_gt_open ()

int
igt_sysfs_gt_open (int device,
                   int gt);

This opens the sysfs gt directory corresponding to device and gt for use with igt_sysfs_set() and igt_sysfs_get().

igt_sysfs_get_num_gt ()

int
igt_sysfs_get_num_gt (int device);

Reads number of GT sysfs entries. Asserts for atleast one GT entry. (see igt_sysfs_gt_path).

igt_sysfs_has_attr ()

bool
igt_sysfs_has_attr (int dir,
                    const char *attr);

This checks if specified attr exists in device sysfs directory.

igt_sysfs_dir_id_to_name ()

const char *
igt_sysfs_dir_id_to_name (int dir,
                          enum i915_attr_id id);

Returns attribute name corresponding to attribute id in either the per-gt or legacy per-device sysfs

igt_sysfs_path_id_to_name ()

const char *
igt_sysfs_path_id_to_name (const char *path,
                           enum i915_attr_id id);

Returns attribute name corresponding to attribute id in either the per-gt or legacy per-device sysfs

igt_sysfs_read ()

int
igt_sysfs_read (int dir,
                const char *attr,
                void *data,
                int len);

This reads len bytes from the sysfs file to data

igt_sysfs_write ()

int
igt_sysfs_write (int dir,
                 const char *attr,
                 const void *data,
                 int len);

This writes len bytes from data to the sysfs file. Contrary to igt_sysfs_set(), this does not automatically write a null char if len is 0. It's caller responsibility to pass the right len according to the data being written.

igt_sysfs_set ()

bool
igt_sysfs_set (int dir,
               const char *attr,
               const char *value);

This writes the value to the sysfs file.

igt_sysfs_get ()

char *
igt_sysfs_get (int dir,
               const char *attr);

This reads the value from the sysfs file.

igt_sysfs_scanf ()

int
igt_sysfs_scanf (int dir,
                 const char *attr,
                 const char *fmt,
                 ...);

scanf() wrapper for sysfs.

igt_sysfs_vprintf ()

int
igt_sysfs_vprintf (int dir,
                   const char *attr,
                   const char *fmt,
                   va_list ap);

igt_sysfs_printf ()

int
igt_sysfs_printf (int dir,
                  const char *attr,
                  const char *fmt,
                  ...);

printf() wrapper for sysfs.

igt_sysfs_get_u32 ()

uint32_t
igt_sysfs_get_u32 (int dir,
                   const char *attr);

Convenience wrapper to read a unsigned 32bit integer from a sysfs file. It asserts on failure.

igt_sysfs_set_u32 ()

void
igt_sysfs_set_u32 (int dir,
                   const char *attr,
                   uint32_t value);

Convenience wrapper to write a unsigned 32bit integer to a sysfs file. It asserts on failure.

igt_sysfs_get_u64 ()

uint64_t
igt_sysfs_get_u64 (int dir,
                   const char *attr);

Convenience wrapper to read a unsigned 64bit integer from a sysfs file. It asserts on failure.

igt_sysfs_set_u64 ()

void
igt_sysfs_set_u64 (int dir,
                   const char *attr,
                   uint64_t value);

Convenience wrapper to write a unsigned 64bit integer to a sysfs file. It asserts on failure.

igt_sysfs_get_boolean ()

bool
igt_sysfs_get_boolean (int dir,
                       const char *attr);

Convenience wrapper to read a boolean sysfs file. It asserts on failure.

igt_sysfs_set_boolean ()

void
igt_sysfs_set_boolean (int dir,
                       const char *attr,
                       bool value);

Convenience wrapper to write a boolean sysfs file. It asserts on failure.

bind_fbcon ()

void
bind_fbcon (bool enable);

This functions enables/disables the text console running on top of the framebuffer device.

fbcon_blink_enable ()

void
fbcon_blink_enable (bool enable);

Enables or disables the cursor blinking in fbcon, it also restores the previous blinking state when exiting test.

igt_sysfs_rw_attr_verify ()

void
igt_sysfs_rw_attr_verify (igt_sysfs_rw_attr_t *rw);

This function attempts to verify writable sysfs attributes, that is the attribute is first written to and then read back and it is verified that the read value matches the written value to a tolerance. However, when we try to do this we run into the issue that a sysfs attribute might have a behavior where the read value is different from the written value for any reason. For example, attributes such as power, voltage, frequency and time typically have a linear region outside which they are clamped (the values saturate). Therefore for such attributes read values match the written value only in the linear region and when writing we don't know if we are writing to the linear or to the clamped region.

Therefore the verification implemented here takes the approach of sweeping across the range of possible values of the attribute (this is done using 'doubling' rather than linearly) and seeing where there are matches. There should be at least one match (to a tolerance) for the verification to have succeeded.

igt_sysfs_engines ()

void
igt_sysfs_engines (int xe,
                   int engines,
                   const char **property,
                   void (*test) (int, int, const char **));

It iterates over sysfs/engines and runs a dynamic engine test.

xe_sysfs_gt_path ()

char *
xe_sysfs_gt_path (int xe_device,
                  int gt,
                  char *path,
                  int pathlen);

xe_sysfs_gt_open ()

int
xe_sysfs_gt_open (int xe_device,
                  int gt);

This opens the sysfs gt directory corresponding to device and tile for use

xe_sysfs_tile_path ()

char *
xe_sysfs_tile_path (int xe_device,
                    int tile,
                    char *path,
                    int pathlen);

xe_sysfs_tile_open ()

int
xe_sysfs_tile_open (int xe_device,
                    int tile);

This opens the sysfs tile directory corresponding to device and tile for use

xe_sysfs_get_num_tiles ()

int
xe_sysfs_get_num_tiles (int xe_device);

Reads number of tile sysfs entries. Asserts for at least one tile entry. (see xe_sysfs_tile_path).

i915_for_each_gt

#define i915_for_each_gt for_each_sysfs_gt_dirfd

enum i915_attr_id

igt_sysfs_rw_attr_t

typedef struct {
	int dir;
	char *attr;
	uint64_t start;
	double tol;
} igt_sysfs_rw_attr_t;