Sync

Summary

Functions
sync_file_info(int32_t fd)	struct sync_file_info * Retrieve detailed information about a sync file and its fences.
sync_file_info_free(struct sync_file_info *info)	void Free a struct sync_file_info structure.
sync_get_fence_info(const struct sync_file_info *info)	struct sync_fence_info * Get the array of fence infos from the sync file's info.
sync_merge(const char *name, int32_t fd1, int32_t fd2)	int32_t Merge two sync files.

Functions

sync_file_info

Declared in android/sync.h

struct sync_file_info * sync_file_info(
  int32_t fd
)

Retrieve detailed information about a sync file and its fences.

The returned sync_file_info must be freed by calling sync_file_info_free().

Available since API level 26.

sync_file_info_free

Declared in android/sync.h

void sync_file_info_free(
  struct sync_file_info *info
)

Free a struct sync_file_info structure.

Available since API level 26.

sync_get_fence_info

Declared in android/sync.h

struct sync_fence_info * sync_get_fence_info(
  const struct sync_file_info *info
)

Get the array of fence infos from the sync file's info.

The returned array is owned by the parent sync file info, and has info->num_fences entries.

Available since API level 26.

sync_merge

Declared in android/sync.h

int32_t sync_merge(
  const char *name,
  int32_t fd1,
  int32_t fd2
)

Merge two sync files.

This produces a new sync file with the given name which has the union of the two original sync file's fences; redundant fences may be removed.

If one of the input sync files is signaled or invalid, then this function may behave like dup(): the new file descriptor refers to the valid/unsignaled sync file with its original name, rather than a new sync file.

The original fences remain valid, and the caller is responsible for closing them.

Available since API level 26.