drivers/gpu/drm/msm/sde/sde_fence.h

/* Copyright (c) 2016, The Linux Foundation. All rights reserved.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 and
 * only version 2 as published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 */

#ifndef _SDE_FENCE_H_
#define _SDE_FENCE_H_

#include <linux/kernel.h>
#include <linux/errno.h>
#include <linux/mutex.h>

#ifndef CHAR_BIT
#define CHAR_BIT 8 /* define this if limits.h not available */
#endif

#ifdef CONFIG_SYNC
/**
 * sde_sync_get - Query sync fence object from a file handle
 *
 * On success, this function also increments the refcount of the sync fence
 *
 * @fd: Integer sync fence handle
 *
 * Return: Pointer to sync fence object, or NULL
 */
void *sde_sync_get(uint64_t fd);

/**
 * sde_sync_put - Releases a sync fence object acquired by @sde_sync_get
 *
 * This function decrements the sync fence's reference count; the object will
 * be released if the reference count goes to zero.
 *
 * @fence: Pointer to sync fence
 */
void sde_sync_put(void *fence);

/**
 * sde_sync_wait - Query sync fence object from a file handle
 *
 * @fence: Pointer to sync fence
 * @timeout_ms: Time to wait, in milliseconds. Waits forever if timeout_ms < 0
 *
 * Return: Zero on success, or -ETIME on timeout
 */
int sde_sync_wait(void *fence, long timeout_ms);

/**
 * sde_sync_get_name_prefix - get integer representation of fence name prefix
 * @fence: Pointer to opaque fence structure
 *
 * Return: 32-bit integer containing first 4 characters of fence name,
 *         big-endian notation
 */
uint32_t sde_sync_get_name_prefix(void *fence);
#else
static inline void *sde_sync_get(uint64_t fd)
{
	return NULL;
}

static inline void sde_sync_put(void *fence)
{
}

static inline int sde_sync_wait(void *fence, long timeout_ms)
{
	return 0;
}

static inline uint32_t sde_sync_get_name_prefix(void *fence)
{
	return 0x0;
}
#endif

/**
 * struct sde_fence - output fence container structure
 * @timeline: Pointer to fence timeline
 * @dev: Pointer to drm device structure
 * @commit_count: Number of detected commits since bootup
 * @done_count: Number of completed commits since bootup
 * @fence_lock: Mutex object to protect local fence variables
 */
struct sde_fence {
	void *timeline;
	void *dev;
	int32_t commit_count;
	int32_t done_count;
	struct mutex fence_lock;
};

#if IS_ENABLED(CONFIG_SW_SYNC)
/**
 * sde_fence_init - initialize fence object
 * @dev: Pointer to drm device structure
 * @fence: Pointer to crtc fence object
 * @name: Timeline name
 * Returns: Zero on success
 */
int sde_fence_init(void *dev,
		struct sde_fence *fence,
		const char *name);

/**
 * sde_fence_deinit - deinit fence container
 * @fence: Pointer fence container
 */
void sde_fence_deinit(struct sde_fence *fence);

/**
 * sde_fence_prepare - prepare to return fences for current commit
 * @fence: Pointer fence container
 * Returns: Zero on success
 */
int sde_fence_prepare(struct sde_fence *fence);

/**
 * sde_fence_create - create output fence object
 * @fence: Pointer fence container
 * @val: Pointer to output value variable, fence fd will be placed here
 * @offset: Fence signal commit offset, e.g., +1 to signal on next commit
 * Returns: Zero on success
 */
int sde_fence_create(struct sde_fence *fence, uint64_t *val, int offset);

/**
 * sde_fence_signal - advance fence timeline to signal outstanding fences
 * @fence: Pointer fence container
 * @is_error: Set to non-zero if the commit didn't complete successfully
 */
void sde_fence_signal(struct sde_fence *fence, bool is_error);
#else
static inline int sde_fence_init(void *dev,
		struct sde_fence *fence,
		const char *name)
{
	/* do nothing */
	return 0;
}

static inline void sde_fence_deinit(struct sde_fence *fence)
{
	/* do nothing */
}

static inline void sde_fence_prepare(struct sde_fence *fence)
{
	/* do nothing */
}

static inline int sde_fence_get(struct sde_fence *fence, uint64_t *val)
{
	return -EINVAL;
}

static inline void sde_fence_signal(struct sde_fence *fence, bool is_error)
{
	/* do nothing */
}

static inline int sde_fence_create(struct sde_fence *fence, uint64_t *val,
								int offset)
{
	return 0;
}
#endif /* IS_ENABLED(CONFIG_SW_SYNC) */

#endif /* _SDE_FENCE_H_ */