[mirror_ubuntu-bionic-kernel.git] / include / drm / drm_syncobj.h

/*
 * Copyright © 2017 Red Hat
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice (including the next
 * paragraph) shall be included in all copies or substantial portions of the
 * Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
 * IN THE SOFTWARE.
 *
 * Authors:
 *
 */
#ifndef __DRM_SYNCOBJ_H__
#define __DRM_SYNCOBJ_H__

#include "linux/dma-fence.h"

struct drm_syncobj_cb;

/**
 * struct drm_syncobj - sync object.
 *
 * This structure defines a generic sync object which wraps a dma fence.
 */
struct drm_syncobj {
	/**
	 * @refcount:
	 *
	 * Reference count of this object.
	 */
	struct kref refcount;
	/**
	 * @fence:
	 * NULL or a pointer to the fence bound to this object.
	 *
	 * This field should not be used directly.  Use drm_syncobj_fence_get
	 * and drm_syncobj_replace_fence instead.
	 */
	struct dma_fence *fence;
	/**
	 * @cb_list:
	 * List of callbacks to call when the fence gets replaced
	 */
	struct list_head cb_list;
	/**
	 * @lock:
	 * locks cb_list and write-locks fence.
	 */
	spinlock_t lock;
	/**
	 * @file:
	 * a file backing for this syncobj.
	 */
	struct file *file;
};

typedef void (*drm_syncobj_func_t)(struct drm_syncobj *syncobj,
				   struct drm_syncobj_cb *cb);

/**
 * struct drm_syncobj_cb - callback for drm_syncobj_add_callback
 * @node: used by drm_syncob_add_callback to append this struct to
 *	  syncobj::cb_list
 * @func: drm_syncobj_func_t to call
 *
 * This struct will be initialized by drm_syncobj_add_callback, additional
 * data can be passed along by embedding drm_syncobj_cb in another struct.
 * The callback will get called the next time drm_syncobj_replace_fence is
 * called.
 */
struct drm_syncobj_cb {
	struct list_head node;
	drm_syncobj_func_t func;
};

void drm_syncobj_free(struct kref *kref);

/**
 * drm_syncobj_get - acquire a syncobj reference
 * @obj: sync object
 *
 * This acquires additional reference to @obj. It is illegal to call this
 * without already holding a reference. No locks required.
 */
static inline void
drm_syncobj_get(struct drm_syncobj *obj)
{
	kref_get(&obj->refcount);
}

/**
 * drm_syncobj_put - release a reference to a sync object.
 * @obj: sync object.
 */
static inline void
drm_syncobj_put(struct drm_syncobj *obj)
{
	kref_put(&obj->refcount, drm_syncobj_free);
}

static inline struct dma_fence *
drm_syncobj_fence_get(struct drm_syncobj *syncobj)
{
	struct dma_fence *fence;

	rcu_read_lock();
	fence = dma_fence_get_rcu_safe(&syncobj->fence);
	rcu_read_unlock();

	return fence;
}

struct drm_syncobj *drm_syncobj_find(struct drm_file *file_private,
				     u32 handle);
void drm_syncobj_add_callback(struct drm_syncobj *syncobj,
			      struct drm_syncobj_cb *cb,
			      drm_syncobj_func_t func);
void drm_syncobj_remove_callback(struct drm_syncobj *syncobj,
				 struct drm_syncobj_cb *cb);
void drm_syncobj_replace_fence(struct drm_syncobj *syncobj,
			       struct dma_fence *fence);
int drm_syncobj_find_fence(struct drm_file *file_private,
			   u32 handle,
			   struct dma_fence **fence);
void drm_syncobj_free(struct kref *kref);
int drm_syncobj_create(struct drm_syncobj **out_syncobj, uint32_t flags,
		       struct dma_fence *fence);
int drm_syncobj_get_handle(struct drm_file *file_private,
			   struct drm_syncobj *syncobj, u32 *handle);
int drm_syncobj_get_fd(struct drm_syncobj *syncobj, int *p_fd);

#endif
Commit	Line	Data
e9083420 DA	1	/*
	2	* Copyright © 2017 Red Hat
	3	*
	4	* Permission is hereby granted, free of charge, to any person obtaining a
	5	* copy of this software and associated documentation files (the "Software"),
	6	* to deal in the Software without restriction, including without limitation
	7	* the rights to use, copy, modify, merge, publish, distribute, sublicense,
	8	* and/or sell copies of the Software, and to permit persons to whom the
	9	* Software is furnished to do so, subject to the following conditions:
	10	*
	11	* The above copyright notice and this permission notice (including the next
	12	* paragraph) shall be included in all copies or substantial portions of the
	13	* Software.
	14	*
	15	* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
	16	* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
	17	* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
	18	* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
	19	* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
	20	* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
	21	* IN THE SOFTWARE.
	22	*
	23	* Authors:
	24	*
	25	*/
	26	#ifndef __DRM_SYNCOBJ_H__
	27	#define __DRM_SYNCOBJ_H__
	28
	29	#include "linux/dma-fence.h"
	30
9c19fb10 JE	31	struct drm_syncobj_cb;
9c19fb10 JE	32
e9083420 DA	33	/**
	34	* struct drm_syncobj - sync object.
	35	*
	36	* This structure defines a generic sync object which wraps a dma fence.
	37	*/
	38	struct drm_syncobj {
	39	/**
	40	* @refcount:
	41	*
	42	* Reference count of this object.
	43	*/
	44	struct kref refcount;
	45	/**
	46	* @fence:
	47	* NULL or a pointer to the fence bound to this object.
9c19fb10 JE	48	*
	49	* This field should not be used directly. Use drm_syncobj_fence_get
	50	* and drm_syncobj_replace_fence instead.
e9083420 DA	51	*/
e9083420 DA	52	struct dma_fence *fence;
9c19fb10 JE	53	/**
	54	* @cb_list:
	55	* List of callbacks to call when the fence gets replaced
	56	*/
	57	struct list_head cb_list;
	58	/**
	59	* @lock:
	60	* locks cb_list and write-locks fence.
	61	*/
	62	spinlock_t lock;
e9083420 DA	63	/**
	64	* @file:
	65	* a file backing for this syncobj.
	66	*/
	67	struct file *file;
	68	};
	69
9c19fb10 JE	70	typedef void (drm_syncobj_func_t)(struct drm_syncobj syncobj,
	71	struct drm_syncobj_cb *cb);
	72
	73	/**
	74	* struct drm_syncobj_cb - callback for drm_syncobj_add_callback
	75	* @node: used by drm_syncob_add_callback to append this struct to
	76	* syncobj::cb_list
	77	* @func: drm_syncobj_func_t to call
	78	*
	79	* This struct will be initialized by drm_syncobj_add_callback, additional
	80	* data can be passed along by embedding drm_syncobj_cb in another struct.
	81	* The callback will get called the next time drm_syncobj_replace_fence is
	82	* called.
	83	*/
	84	struct drm_syncobj_cb {
	85	struct list_head node;
	86	drm_syncobj_func_t func;
	87	};
	88
e9083420 DA	89	void drm_syncobj_free(struct kref *kref);
	90
	91	/**
	92	* drm_syncobj_get - acquire a syncobj reference
	93	* @obj: sync object
	94	*
	95	* This acquires additional reference to @obj. It is illegal to call this
	96	* without already holding a reference. No locks required.
	97	*/
	98	static inline void
	99	drm_syncobj_get(struct drm_syncobj *obj)
	100	{
	101	kref_get(&obj->refcount);
	102	}
	103
	104	/**
	105	* drm_syncobj_put - release a reference to a sync object.
	106	* @obj: sync object.
	107	*/
	108	static inline void
	109	drm_syncobj_put(struct drm_syncobj *obj)
	110	{
	111	kref_put(&obj->refcount, drm_syncobj_free);
	112	}
	113
309a5482 JE	114	static inline struct dma_fence *
	115	drm_syncobj_fence_get(struct drm_syncobj *syncobj)
	116	{
	117	struct dma_fence *fence;
	118
	119	rcu_read_lock();
	120	fence = dma_fence_get_rcu_safe(&syncobj->fence);
	121	rcu_read_unlock();
	122
	123	return fence;
	124	}
	125
e9083420 DA	126	struct drm_syncobj drm_syncobj_find(struct drm_file file_private,
e9083420 DA	127	u32 handle);
9c19fb10 JE	128	void drm_syncobj_add_callback(struct drm_syncobj *syncobj,
	129	struct drm_syncobj_cb *cb,
	130	drm_syncobj_func_t func);
	131	void drm_syncobj_remove_callback(struct drm_syncobj *syncobj,
	132	struct drm_syncobj_cb *cb);
00fc2c26	133	void drm_syncobj_replace_fence(struct drm_syncobj *syncobj,
e9083420	134	struct dma_fence *fence);
afaf5923 JE	135	int drm_syncobj_find_fence(struct drm_file *file_private,
	136	u32 handle,
	137	struct dma_fence **fence);
e9083420	138	void drm_syncobj_free(struct kref *kref);
1321fd2c MO	139	int drm_syncobj_create(struct drm_syncobj **out_syncobj, uint32_t flags,
	140	struct dma_fence *fence);
	141	int drm_syncobj_get_handle(struct drm_file *file_private,
	142	struct drm_syncobj syncobj, u32 handle);
684fd0af	143	int drm_syncobj_get_fd(struct drm_syncobj syncobj, int p_fd);
e9083420 DA	144
e9083420 DA	145	#endif