xref: /dragonfly/sys/dev/drm/i915/i915_utils.h (revision 3f2dd94a569761201b5b0a18b2f697f97fe1b9dc)
1 /*
2  * Copyright © 2016 Intel Corporation
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  */
24 
25 #ifndef __I915_UTILS_H
26 #define __I915_UTILS_H
27 
28 #undef WARN_ON
29 /* Many gcc seem to no see through this and fall over :( */
30 #if 0
31 #define WARN_ON(x) ({ \
32           bool __i915_warn_cond = (x); \
33           if (__builtin_constant_p(__i915_warn_cond)) \
34                     BUILD_BUG_ON(__i915_warn_cond); \
35           WARN(__i915_warn_cond, "WARN_ON(" #x ")"); })
36 #else
37 #define WARN_ON(x) WARN((x), "%s", "WARN_ON(" __stringify(x) ")")
38 #endif
39 
40 #undef WARN_ON_ONCE
41 #define WARN_ON_ONCE(x) WARN_ONCE((x), "%s", "WARN_ON_ONCE(" __stringify(x) ")")
42 
43 #define MISSING_CASE(x) WARN(1, "Missing switch case (%lu) in %s\n", \
44                                    (long)(x), __func__)
45 
46 #if GCC_VERSION >= 70000
47 #define add_overflows(A, B) \
48           __builtin_add_overflow_p((A), (B), (typeof((A) + (B)))0)
49 #else
50 #define add_overflows(A, B) ({ \
51           typeof(A) a = (A); \
52           typeof(B) b = (B); \
53           a + b < a; \
54 })
55 #endif
56 
57 #define range_overflows(start, size, max) ({ \
58           typeof(start) start__ = (start); \
59           typeof(size) size__ = (size); \
60           typeof(max) max__ = (max); \
61           (void)(&start__ == &size__); \
62           (void)(&start__ == &max__); \
63           start__ > max__ || size__ > max__ - start__; \
64 })
65 
66 #define range_overflows_t(type, start, size, max) \
67           range_overflows((type)(start), (type)(size), (type)(max))
68 
69 /* Note we don't consider signbits :| */
70 #define overflows_type(x, T) \
71           (sizeof(x) > sizeof(T) && (x) >> (sizeof(T) * BITS_PER_BYTE))
72 
73 #define ptr_mask_bits(ptr, n) ({                                                \
74           unsigned long __v = (unsigned long)(ptr);                             \
75           (typeof(ptr))(__v & -BIT(n));                                         \
76 })
77 
78 #define ptr_unmask_bits(ptr, n) ((unsigned long)(ptr) & (BIT(n) - 1))
79 
80 #define ptr_unpack_bits(ptr, bits, n) ({                                        \
81           unsigned long __v = (unsigned long)(ptr);                             \
82           *(bits) = __v & (BIT(n) - 1);                                         \
83           (typeof(ptr))(__v & -BIT(n));                                         \
84 })
85 
86 #define ptr_pack_bits(ptr, bits, n)                                             \
87           ((typeof(ptr))((unsigned long)(ptr) | (bits)))
88 
89 #define page_mask_bits(ptr) ptr_mask_bits(ptr, PAGE_SHIFT)
90 #define page_unmask_bits(ptr) ptr_unmask_bits(ptr, PAGE_SHIFT)
91 #define page_pack_bits(ptr, bits) ptr_pack_bits(ptr, bits, PAGE_SHIFT)
92 #define page_unpack_bits(ptr, bits) ptr_unpack_bits(ptr, bits, PAGE_SHIFT)
93 
94 #define ptr_offset(ptr, member) offsetof(typeof(*(ptr)), member)
95 
96 #define fetch_and_zero(ptr) ({                                                            \
97           typeof(*ptr) __T = *(ptr);                                            \
98           *(ptr) = (typeof(*ptr))0;                                             \
99           __T;                                                                            \
100 })
101 
ptr_to_u64(const void * ptr)102 static inline u64 ptr_to_u64(const void *ptr)
103 {
104           return (uintptr_t)ptr;
105 }
106 
107 #define u64_to_ptr(T, x) ({                                                     \
108           typecheck(u64, x);                                                    \
109           (T *)(uintptr_t)(x);                                                            \
110 })
111 
112 #define __mask_next_bit(mask) ({                                                \
113           int __idx = ffs(mask) - 1;                                            \
114           mask &= ~BIT(__idx);                                                            \
115           __idx;                                                                          \
116 })
117 
118 #include <linux/list.h>
119 
__list_del_many(struct list_head * head,struct list_head * first)120 static inline void __list_del_many(struct list_head *head,
121                                            struct list_head *first)
122 {
123           first->prev = head;
124           WRITE_ONCE(head->next, first);
125 }
126 
127 /*
128  * Wait until the work is finally complete, even if it tries to postpone
129  * by requeueing itself. Note, that if the worker never cancels itself,
130  * we will spin forever.
131  */
drain_delayed_work(struct delayed_work * dw)132 static inline void drain_delayed_work(struct delayed_work *dw)
133 {
134           do {
135                     while (flush_delayed_work(dw))
136                               ;
137           } while (delayed_work_pending(dw));
138 }
139 
140 #endif /* !__I915_UTILS_H */
141