syncobj

syncobj — Library with syncobj helpers

Functions

Includes

#include <igt_syncobj.h>

Description

This library contains helpers for sync object tests.

Functions

syncobj_create ()

uint32_t
syncobj_create (int fd,
                uint32_t flags);

Create a syncobj with the flags.

Parameters

fd

The DRM file descriptor

 

flags

Flags to pass syncobj create

 

Returns

A newly created syncobj


syncobj_destroy ()

void
syncobj_destroy (int fd,
                 uint32_t handle);

Parameters

fd

The DRM file descriptor

 

handle

The handle to the syncobj to destroy Destroy a syncobj.

 

syncobj_handle_to_fd ()

int
syncobj_handle_to_fd (int fd,
                      uint32_t handle,
                      uint32_t flags);

Convert a syncobj handle to an fd using the flags.

Parameters

fd

The DRM file descriptor

 

handle

Handle to syncobj

 

flags

Flags to handle to fd ioctl.

 

Returns

a file descriptor (either syncobj or sync_file.


syncobj_fd_to_handle ()

uint32_t
syncobj_fd_to_handle (int fd,
                      int syncobj_fd,
                      uint32_t flags);

Convert a syncobj fd a syncobj handle using the flags.

Parameters

fd

The DRM file descriptor

 

syncobj_fd

syncobj fd to convert

 

flags

Flags to the syncobj fd to handle ioctl.

 

Returns

a syncobj handle.


syncobj_import_sync_file ()

void
syncobj_import_sync_file (int fd,
                          uint32_t handle,
                          int sync_file);

Import a sync_file fd into a syncobj handle.

Parameters

fd

The DRM file descriptor

 

handle

Handle to the syncobt to import file into

 

sync_file

The sync_file fd to import state from.

 

syncobj_wait_err ()

int
syncobj_wait_err (int fd,
                  uint32_t *handles,
                  uint32_t count,
                  uint64_t abs_timeout_nsec,
                  uint32_t flags);

syncobj_wait ()

bool
syncobj_wait (int fd,
              uint32_t *handles,
              uint32_t count,
              uint64_t abs_timeout_nsec,
              uint32_t flags,
              uint32_t *first_signaled);

Waits in the kernel for any/all the requested syncobjs using the timeout and flags.

Parameters

fd

The DRM file descriptor

 

handles

List of syncobj handles to wait for.

 

count

Count of handles

 

abs_timeout_nsec

Absolute wait timeout in nanoseconds.

 

flags

Wait ioctl flags.

 

first_signaled

Returned handle for first signaled syncobj.

 

Returns

bool value - false = timedout, true = signaled


syncobj_reset ()

void
syncobj_reset (int fd,
               uint32_t *handles,
               uint32_t count);

Reset state of a set of syncobjs.

Parameters

fd

The DRM file descriptor.

 

handles

Array of syncobj handles to reset

 

count

Count of syncobj handles.

 

syncobj_signal ()

void
syncobj_signal (int fd,
                uint32_t *handles,
                uint32_t count);

Signal a set of syncobjs.

Parameters

fd

The DRM file descriptor.

 

handles

Array of syncobj handles to signal

 

count

Count of syncobj handles.

 

Types and Values