081806e5f2
The new header provides an updated interface to libsync appropriate for the NDK. Clients use existing syscalls where possible (e.g. poll() instead of sync_wait()), and the remaining functions return structures used in mainline Linux kernels rather than the Android staging sync framework. Over time, framework clients will be migrated to using the NDK interface, which will eventually replace the current internal interface. The only difference is the header will be named <android/sync.h> in the NDK and <sync/sync.h> internally. Bug: 35138793 Test: sync-unit-tests on bullhead Change-Id: Ieb3649b80565393e26b604416158438d32c2a256
115 lines
3.4 KiB
C
115 lines
3.4 KiB
C
/*
|
|
* sync.h
|
|
*
|
|
* Copyright 2012 Google, Inc
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#ifndef __SYS_CORE_SYNC_H
|
|
#define __SYS_CORE_SYNC_H
|
|
|
|
/* This file contains the legacy sync interface used by Android platform and
|
|
* device code. The direct contents will be removed over time as code
|
|
* transitions to using the updated interface in ndk/sync.h. When this file is
|
|
* empty other than the ndk/sync.h include, that file will be renamed to
|
|
* replace this one.
|
|
*
|
|
* New code should continue to include this file (#include <sync/sync.h>)
|
|
* instead of ndk/sync.h so the eventual rename is seamless, but should only
|
|
* use the things declared in ndk/sync.h.
|
|
*/
|
|
|
|
#include "../ndk/sync.h"
|
|
|
|
#include <sys/cdefs.h>
|
|
#include <stdint.h>
|
|
|
|
#include <linux/types.h>
|
|
|
|
__BEGIN_DECLS
|
|
|
|
struct sync_legacy_merge_data {
|
|
int32_t fd2;
|
|
char name[32];
|
|
int32_t fence;
|
|
};
|
|
|
|
struct sync_fence_info_data {
|
|
uint32_t len;
|
|
char name[32];
|
|
int32_t status;
|
|
uint8_t pt_info[0];
|
|
};
|
|
|
|
struct sync_pt_info {
|
|
uint32_t len;
|
|
char obj_name[32];
|
|
char driver_name[32];
|
|
int32_t status;
|
|
uint64_t timestamp_ns;
|
|
uint8_t driver_data[0];
|
|
};
|
|
|
|
#define SYNC_IOC_MAGIC '>'
|
|
|
|
/**
|
|
* DOC: SYNC_IOC_LEGACY_WAIT - wait for a fence to signal
|
|
*
|
|
* pass timeout in milliseconds. Waits indefinitely timeout < 0.
|
|
*
|
|
* This is the legacy version of the Sync API before the de-stage that happened
|
|
* on Linux kernel 4.7.
|
|
*/
|
|
#define SYNC_IOC_LEGACY_WAIT _IOW(SYNC_IOC_MAGIC, 0, __s32)
|
|
|
|
/**
|
|
* DOC: SYNC_IOC_MERGE - merge two fences
|
|
*
|
|
* Takes a struct sync_merge_data. Creates a new fence containing copies of
|
|
* the sync_pts in both the calling fd and sync_merge_data.fd2. Returns the
|
|
* new fence's fd in sync_merge_data.fence
|
|
*
|
|
* This is the legacy version of the Sync API before the de-stage that happened
|
|
* on Linux kernel 4.7.
|
|
*/
|
|
#define SYNC_IOC_LEGACY_MERGE _IOWR(SYNC_IOC_MAGIC, 1, \
|
|
struct sync_legacy_merge_data)
|
|
|
|
/**
|
|
* DOC: SYNC_IOC_LEGACY_FENCE_INFO - get detailed information on a fence
|
|
*
|
|
* Takes a struct sync_fence_info_data with extra space allocated for pt_info.
|
|
* Caller should write the size of the buffer into len. On return, len is
|
|
* updated to reflect the total size of the sync_fence_info_data including
|
|
* pt_info.
|
|
*
|
|
* pt_info is a buffer containing sync_pt_infos for every sync_pt in the fence.
|
|
* To iterate over the sync_pt_infos, use the sync_pt_info.len field.
|
|
*
|
|
* This is the legacy version of the Sync API before the de-stage that happened
|
|
* on Linux kernel 4.7.
|
|
*/
|
|
#define SYNC_IOC_LEGACY_FENCE_INFO _IOWR(SYNC_IOC_MAGIC, 2,\
|
|
struct sync_fence_info_data)
|
|
|
|
/* timeout in msecs */
|
|
int sync_wait(int fd, int timeout);
|
|
struct sync_fence_info_data *sync_fence_info(int fd);
|
|
struct sync_pt_info *sync_pt_info(struct sync_fence_info_data *info,
|
|
struct sync_pt_info *itr);
|
|
void sync_fence_info_free(struct sync_fence_info_data *info);
|
|
|
|
__END_DECLS
|
|
|
|
#endif /* __SYS_CORE_SYNC_H */
|