Sync

#include <sync.h>

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

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

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

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

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.