1/*	$NetBSD: i915_gem.h,v 1.8 2023/08/08 06:59:40 mrg Exp $	*/
2
3/*
4 * Copyright �� 2016 Intel Corporation
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the "Software"),
8 * to deal in the Software without restriction, including without limitation
9 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
10 * and/or sell copies of the Software, and to permit persons to whom the
11 * Software is furnished to do so, subject to the following conditions:
12 *
13 * The above copyright notice and this permission notice (including the next
14 * paragraph) shall be included in all copies or substantial portions of the
15 * Software.
16 *
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
20 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
22 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
23 * IN THE SOFTWARE.
24 *
25 */
26
27#ifndef __I915_GEM_H__
28#define __I915_GEM_H__
29
30#include <linux/bug.h>
31#include <linux/interrupt.h>
32#include <linux/stringify.h>
33
34#include <drm/drm_drv.h>
35
36#include "i915_utils.h"
37
38struct drm_i915_private;
39
40#ifdef CONFIG_DRM_I915_DEBUG_GEM
41
42#define GEM_SHOW_DEBUG() drm_debug_enabled(DRM_UT_DRIVER)
43
44#define GEM_BUG_ON(condition) do { if (unlikely((condition))) {	\
45		GEM_TRACE_ERR("%s:%d GEM_BUG_ON(%s)\n", \
46			      __func__, __LINE__, __stringify(condition)); \
47		GEM_TRACE_DUMP(); \
48		BUG(); \
49		} \
50	} while(0)
51#define GEM_WARN_ON(expr) WARN_ON(expr)
52
53#define GEM_DEBUG_DECL(var) var
54#define GEM_DEBUG_EXEC(expr) expr
55#define GEM_DEBUG_BUG_ON(expr) GEM_BUG_ON(expr)
56#define GEM_DEBUG_WARN_ON(expr) GEM_WARN_ON(expr)
57
58#else
59
60#define GEM_SHOW_DEBUG() (0)
61
62#define GEM_BUG_ON(expr) BUILD_BUG_ON_INVALID(expr)
63#define GEM_WARN_ON(expr) ({ unlikely(!!(expr)); })
64
65#define GEM_DEBUG_DECL(var)
66#define GEM_DEBUG_EXEC(expr) do { } while (0)
67#define GEM_DEBUG_BUG_ON(expr)
68#define GEM_DEBUG_WARN_ON(expr) ({ BUILD_BUG_ON_INVALID(expr); 0; })
69#endif
70
71#if IS_ENABLED(CONFIG_DRM_I915_TRACE_GEM)
72#define GEM_TRACE(...) trace_printk(__VA_ARGS__)
73#define GEM_TRACE_ERR(...) do {						\
74	pr_err(__VA_ARGS__);						\
75	trace_printk(__VA_ARGS__);					\
76} while (0)
77#define GEM_TRACE_DUMP() \
78	do { ftrace_dump(DUMP_ALL); add_taint_for_CI(TAINT_WARN); } while (0)
79#define GEM_TRACE_DUMP_ON(expr) \
80	do { if (expr) GEM_TRACE_DUMP(); } while (0)
81#else
82#define GEM_TRACE(...) do { } while (0)
83#define GEM_TRACE_ERR(...) do { } while (0)
84#define GEM_TRACE_DUMP() do { } while (0)
85#define GEM_TRACE_DUMP_ON(expr) BUILD_BUG_ON_INVALID(expr)
86#endif
87
88#define I915_GEM_IDLE_TIMEOUT (HZ / 5)
89
90static inline void tasklet_lock(struct tasklet_struct *t)
91{
92	while (!tasklet_trylock(t))
93		cpu_relax();
94}
95
96#ifndef __NetBSD__
97
98static inline bool tasklet_is_locked(const struct tasklet_struct *t)
99{
100	return test_bit(TASKLET_STATE_RUN, &t->state);
101}
102
103static inline void __tasklet_disable_sync_once(struct tasklet_struct *t)
104{
105	if (!atomic_fetch_inc(&t->count))
106		tasklet_unlock_wait(t);
107}
108
109static inline bool __tasklet_is_enabled(const struct tasklet_struct *t)
110{
111	return !atomic_read(&t->count);
112}
113
114static inline bool __tasklet_enable(struct tasklet_struct *t)
115{
116	return atomic_dec_and_test(&t->count);
117}
118
119static inline bool __tasklet_is_scheduled(struct tasklet_struct *t)
120{
121	return test_bit(TASKLET_STATE_SCHED, &t->state);
122}
123
124#endif
125
126#endif /* __I915_GEM_H__ */
127