~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/include/drm/drm_print.h

Version: ~ [ linux-6.11-rc3 ] ~ [ linux-6.10.4 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.45 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.104 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.164 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.223 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.281 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.319 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.9 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

Differences between /include/drm/drm_print.h (Architecture sparc64) and /include/drm/drm_print.h (Architecture sparc)


  1 /*                                                  1 /*
  2  * Copyright (C) 2016 Red Hat                       2  * Copyright (C) 2016 Red Hat
  3  *                                                  3  *
  4  * Permission is hereby granted, free of charg      4  * Permission is hereby granted, free of charge, to any person obtaining a
  5  * copy of this software and associated docume      5  * copy of this software and associated documentation files (the "Software"),
  6  * to deal in the Software without restriction      6  * to deal in the Software without restriction, including without limitation
  7  * the rights to use, copy, modify, merge, pub      7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  8  * and/or sell copies of the Software, and to       8  * and/or sell copies of the Software, and to permit persons to whom the
  9  * Software is furnished to do so, subject to       9  * Software is furnished to do so, subject to the following conditions:
 10  *                                                 10  *
 11  * The above copyright notice and this permiss     11  * The above copyright notice and this permission notice shall be included in
 12  * all copies or substantial portions of the S     12  * all copies or substantial portions of the Software.
 13  *                                                 13  *
 14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT W     14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 15  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE W     15  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINF     16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 17  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIA     17  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
 18  * OTHER LIABILITY, WHETHER IN AN ACTION OF CO     18  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 19  * ARISING FROM, OUT OF OR IN CONNECTION WITH      19  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 20  * OTHER DEALINGS IN THE SOFTWARE.                 20  * OTHER DEALINGS IN THE SOFTWARE.
 21  *                                                 21  *
 22  * Authors:                                        22  * Authors:
 23  * Rob Clark <robdclark@gmail.com>                 23  * Rob Clark <robdclark@gmail.com>
 24  */                                                24  */
 25                                                    25 
 26 #ifndef DRM_PRINT_H_                               26 #ifndef DRM_PRINT_H_
 27 #define DRM_PRINT_H_                               27 #define DRM_PRINT_H_
 28                                                    28 
 29 #include <linux/compiler.h>                        29 #include <linux/compiler.h>
 30 #include <linux/printk.h>                          30 #include <linux/printk.h>
 31 #include <linux/device.h>                          31 #include <linux/device.h>
 32 #include <linux/dynamic_debug.h>                   32 #include <linux/dynamic_debug.h>
 33                                                    33 
 34 #include <drm/drm.h>                               34 #include <drm/drm.h>
 35                                                    35 
 36 struct debugfs_regset32;                           36 struct debugfs_regset32;
 37 struct drm_device;                                 37 struct drm_device;
 38 struct seq_file;                                   38 struct seq_file;
 39                                                    39 
 40 /* Do *not* use outside of drm_print.[ch]! */      40 /* Do *not* use outside of drm_print.[ch]! */
 41 extern unsigned long __drm_debug;                  41 extern unsigned long __drm_debug;
 42                                                    42 
 43 /**                                                43 /**
 44  * DOC: print                                      44  * DOC: print
 45  *                                                 45  *
 46  * A simple wrapper for dev_printk(), seq_prin     46  * A simple wrapper for dev_printk(), seq_printf(), etc.  Allows same
 47  * debug code to be used for both debugfs and      47  * debug code to be used for both debugfs and printk logging.
 48  *                                                 48  *
 49  * For example::                                   49  * For example::
 50  *                                                 50  *
 51  *     void log_some_info(struct drm_printer *     51  *     void log_some_info(struct drm_printer *p)
 52  *     {                                           52  *     {
 53  *             drm_printf(p, "foo=%d\n", foo);     53  *             drm_printf(p, "foo=%d\n", foo);
 54  *             drm_printf(p, "bar=%d\n", bar);     54  *             drm_printf(p, "bar=%d\n", bar);
 55  *     }                                           55  *     }
 56  *                                                 56  *
 57  *     #ifdef CONFIG_DEBUG_FS                      57  *     #ifdef CONFIG_DEBUG_FS
 58  *     void debugfs_show(struct seq_file *f)       58  *     void debugfs_show(struct seq_file *f)
 59  *     {                                           59  *     {
 60  *             struct drm_printer p = drm_seq_     60  *             struct drm_printer p = drm_seq_file_printer(f);
 61  *             log_some_info(&p);                  61  *             log_some_info(&p);
 62  *     }                                           62  *     }
 63  *     #endif                                      63  *     #endif
 64  *                                                 64  *
 65  *     void some_other_function(...)               65  *     void some_other_function(...)
 66  *     {                                           66  *     {
 67  *             struct drm_printer p = drm_info     67  *             struct drm_printer p = drm_info_printer(drm->dev);
 68  *             log_some_info(&p);                  68  *             log_some_info(&p);
 69  *     }                                           69  *     }
 70  */                                                70  */
 71                                                    71 
 72 /**                                                72 /**
 73  * enum drm_debug_category - The DRM debug cat     73  * enum drm_debug_category - The DRM debug categories
 74  *                                                 74  *
 75  * Each of the DRM debug logging macros use a      75  * Each of the DRM debug logging macros use a specific category, and the logging
 76  * is filtered by the drm.debug module paramet     76  * is filtered by the drm.debug module parameter. This enum specifies the values
 77  * for the interface.                              77  * for the interface.
 78  *                                                 78  *
 79  * Each DRM_DEBUG_<CATEGORY> macro logs to DRM     79  * Each DRM_DEBUG_<CATEGORY> macro logs to DRM_UT_<CATEGORY> category, except
 80  * DRM_DEBUG() logs to DRM_UT_CORE.                80  * DRM_DEBUG() logs to DRM_UT_CORE.
 81  *                                                 81  *
 82  * Enabling verbose debug messages is done thr     82  * Enabling verbose debug messages is done through the drm.debug parameter, each
 83  * category being enabled by a bit:                83  * category being enabled by a bit:
 84  *                                                 84  *
 85  *  - drm.debug=0x1 will enable CORE messages      85  *  - drm.debug=0x1 will enable CORE messages
 86  *  - drm.debug=0x2 will enable DRIVER message     86  *  - drm.debug=0x2 will enable DRIVER messages
 87  *  - drm.debug=0x3 will enable CORE and DRIVE     87  *  - drm.debug=0x3 will enable CORE and DRIVER messages
 88  *  - ...                                          88  *  - ...
 89  *  - drm.debug=0x1ff will enable all messages     89  *  - drm.debug=0x1ff will enable all messages
 90  *                                                 90  *
 91  * An interesting feature is that it's possibl     91  * An interesting feature is that it's possible to enable verbose logging at
 92  * run-time by echoing the debug value in its      92  * run-time by echoing the debug value in its sysfs node::
 93  *                                                 93  *
 94  *   # echo 0xf > /sys/module/drm/parameters/d     94  *   # echo 0xf > /sys/module/drm/parameters/debug
 95  *                                                 95  *
 96  */                                                96  */
 97 enum drm_debug_category {                          97 enum drm_debug_category {
 98         /* These names must match those in DYN     98         /* These names must match those in DYNAMIC_DEBUG_CLASSBITS */
 99         /**                                        99         /**
100          * @DRM_UT_CORE: Used in the generic d    100          * @DRM_UT_CORE: Used in the generic drm code: drm_ioctl.c, drm_mm.c,
101          * drm_memory.c, ...                      101          * drm_memory.c, ...
102          */                                       102          */
103         DRM_UT_CORE,                              103         DRM_UT_CORE,
104         /**                                       104         /**
105          * @DRM_UT_DRIVER: Used in the vendor     105          * @DRM_UT_DRIVER: Used in the vendor specific part of the driver: i915,
106          * radeon, ... macro.                     106          * radeon, ... macro.
107          */                                       107          */
108         DRM_UT_DRIVER,                            108         DRM_UT_DRIVER,
109         /**                                       109         /**
110          * @DRM_UT_KMS: Used in the modesettin    110          * @DRM_UT_KMS: Used in the modesetting code.
111          */                                       111          */
112         DRM_UT_KMS,                               112         DRM_UT_KMS,
113         /**                                       113         /**
114          * @DRM_UT_PRIME: Used in the prime co    114          * @DRM_UT_PRIME: Used in the prime code.
115          */                                       115          */
116         DRM_UT_PRIME,                             116         DRM_UT_PRIME,
117         /**                                       117         /**
118          * @DRM_UT_ATOMIC: Used in the atomic     118          * @DRM_UT_ATOMIC: Used in the atomic code.
119          */                                       119          */
120         DRM_UT_ATOMIC,                            120         DRM_UT_ATOMIC,
121         /**                                       121         /**
122          * @DRM_UT_VBL: Used for verbose debug    122          * @DRM_UT_VBL: Used for verbose debug message in the vblank code.
123          */                                       123          */
124         DRM_UT_VBL,                               124         DRM_UT_VBL,
125         /**                                       125         /**
126          * @DRM_UT_STATE: Used for verbose ato    126          * @DRM_UT_STATE: Used for verbose atomic state debugging.
127          */                                       127          */
128         DRM_UT_STATE,                             128         DRM_UT_STATE,
129         /**                                       129         /**
130          * @DRM_UT_LEASE: Used in the lease co    130          * @DRM_UT_LEASE: Used in the lease code.
131          */                                       131          */
132         DRM_UT_LEASE,                             132         DRM_UT_LEASE,
133         /**                                       133         /**
134          * @DRM_UT_DP: Used in the DP code.       134          * @DRM_UT_DP: Used in the DP code.
135          */                                       135          */
136         DRM_UT_DP,                                136         DRM_UT_DP,
137         /**                                       137         /**
138          * @DRM_UT_DRMRES: Used in the drm man    138          * @DRM_UT_DRMRES: Used in the drm managed resources code.
139          */                                       139          */
140         DRM_UT_DRMRES                             140         DRM_UT_DRMRES
141 };                                                141 };
142                                                   142 
143 static inline bool drm_debug_enabled_raw(enum     143 static inline bool drm_debug_enabled_raw(enum drm_debug_category category)
144 {                                                 144 {
145         return unlikely(__drm_debug & BIT(cate    145         return unlikely(__drm_debug & BIT(category));
146 }                                                 146 }
147                                                   147 
148 #define drm_debug_enabled_instrumented(categor    148 #define drm_debug_enabled_instrumented(category)                        \
149         ({                                        149         ({                                                              \
150                 pr_debug("todo: is this freque    150                 pr_debug("todo: is this frequent enough to optimize ?\n"); \
151                 drm_debug_enabled_raw(category    151                 drm_debug_enabled_raw(category);                        \
152         })                                        152         })
153                                                   153 
154 #if defined(CONFIG_DRM_USE_DYNAMIC_DEBUG)         154 #if defined(CONFIG_DRM_USE_DYNAMIC_DEBUG)
155 /*                                                155 /*
156  * the drm.debug API uses dyndbg, so each drm_    156  * the drm.debug API uses dyndbg, so each drm_*dbg macro/callsite gets
157  * a descriptor, and only enabled callsites ar    157  * a descriptor, and only enabled callsites are reachable.  They use
158  * the private macro to avoid re-testing the e    158  * the private macro to avoid re-testing the enable-bit.
159  */                                               159  */
160 #define __drm_debug_enabled(category)   true      160 #define __drm_debug_enabled(category)   true
161 #define drm_debug_enabled(category)     drm_de    161 #define drm_debug_enabled(category)     drm_debug_enabled_instrumented(category)
162 #else                                             162 #else
163 #define __drm_debug_enabled(category)   drm_de    163 #define __drm_debug_enabled(category)   drm_debug_enabled_raw(category)
164 #define drm_debug_enabled(category)     drm_de    164 #define drm_debug_enabled(category)     drm_debug_enabled_raw(category)
165 #endif                                            165 #endif
166                                                   166 
167 /**                                               167 /**
168  * struct drm_printer - drm output "stream"       168  * struct drm_printer - drm output "stream"
169  *                                                169  *
170  * Do not use struct members directly.  Use dr    170  * Do not use struct members directly.  Use drm_printer_seq_file(),
171  * drm_printer_info(), etc to initialize.  And    171  * drm_printer_info(), etc to initialize.  And drm_printf() for output.
172  */                                               172  */
173 struct drm_printer {                              173 struct drm_printer {
174         /* private: */                            174         /* private: */
175         void (*printfn)(struct drm_printer *p,    175         void (*printfn)(struct drm_printer *p, struct va_format *vaf);
176         void (*puts)(struct drm_printer *p, co    176         void (*puts)(struct drm_printer *p, const char *str);
177         void *arg;                                177         void *arg;
178         const void *origin;                       178         const void *origin;
179         const char *prefix;                       179         const char *prefix;
180         enum drm_debug_category category;         180         enum drm_debug_category category;
181 };                                                181 };
182                                                   182 
183 void __drm_printfn_coredump(struct drm_printer    183 void __drm_printfn_coredump(struct drm_printer *p, struct va_format *vaf);
184 void __drm_puts_coredump(struct drm_printer *p    184 void __drm_puts_coredump(struct drm_printer *p, const char *str);
185 void __drm_printfn_seq_file(struct drm_printer    185 void __drm_printfn_seq_file(struct drm_printer *p, struct va_format *vaf);
186 void __drm_puts_seq_file(struct drm_printer *p    186 void __drm_puts_seq_file(struct drm_printer *p, const char *str);
187 void __drm_printfn_info(struct drm_printer *p,    187 void __drm_printfn_info(struct drm_printer *p, struct va_format *vaf);
188 void __drm_printfn_dbg(struct drm_printer *p,     188 void __drm_printfn_dbg(struct drm_printer *p, struct va_format *vaf);
189 void __drm_printfn_err(struct drm_printer *p,     189 void __drm_printfn_err(struct drm_printer *p, struct va_format *vaf);
190                                                   190 
191 __printf(2, 3)                                    191 __printf(2, 3)
192 void drm_printf(struct drm_printer *p, const c    192 void drm_printf(struct drm_printer *p, const char *f, ...);
193 void drm_puts(struct drm_printer *p, const cha    193 void drm_puts(struct drm_printer *p, const char *str);
194 void drm_print_regset32(struct drm_printer *p,    194 void drm_print_regset32(struct drm_printer *p, struct debugfs_regset32 *regset);
195 void drm_print_bits(struct drm_printer *p, uns    195 void drm_print_bits(struct drm_printer *p, unsigned long value,
196                     const char * const bits[],    196                     const char * const bits[], unsigned int nbits);
197                                                   197 
198 __printf(2, 0)                                    198 __printf(2, 0)
199 /**                                               199 /**
200  * drm_vprintf - print to a &drm_printer strea    200  * drm_vprintf - print to a &drm_printer stream
201  * @p: the &drm_printer                           201  * @p: the &drm_printer
202  * @fmt: format string                            202  * @fmt: format string
203  * @va: the va_list                               203  * @va: the va_list
204  */                                               204  */
205 static inline void                                205 static inline void
206 drm_vprintf(struct drm_printer *p, const char     206 drm_vprintf(struct drm_printer *p, const char *fmt, va_list *va)
207 {                                                 207 {
208         struct va_format vaf = { .fmt = fmt, .    208         struct va_format vaf = { .fmt = fmt, .va = va };
209                                                   209 
210         p->printfn(p, &vaf);                      210         p->printfn(p, &vaf);
211 }                                                 211 }
212                                                   212 
213 /**                                               213 /**
214  * drm_printf_indent - Print to a &drm_printer    214  * drm_printf_indent - Print to a &drm_printer stream with indentation
215  * @printer: DRM printer                          215  * @printer: DRM printer
216  * @indent: Tab indentation level (max 5)         216  * @indent: Tab indentation level (max 5)
217  * @fmt: Format string                            217  * @fmt: Format string
218  */                                               218  */
219 #define drm_printf_indent(printer, indent, fmt    219 #define drm_printf_indent(printer, indent, fmt, ...) \
220         drm_printf((printer), "%.*s" fmt, (ind    220         drm_printf((printer), "%.*s" fmt, (indent), "\t\t\t\t\tX", ##__VA_ARGS__)
221                                                   221 
222 /**                                               222 /**
223  * struct drm_print_iterator - local struct us    223  * struct drm_print_iterator - local struct used with drm_printer_coredump
224  * @data: Pointer to the devcoredump output bu    224  * @data: Pointer to the devcoredump output buffer
225  * @start: The offset within the buffer to sta    225  * @start: The offset within the buffer to start writing
226  * @remain: The number of bytes to write for t    226  * @remain: The number of bytes to write for this iteration
227  */                                               227  */
228 struct drm_print_iterator {                       228 struct drm_print_iterator {
229         void *data;                               229         void *data;
230         ssize_t start;                            230         ssize_t start;
231         ssize_t remain;                           231         ssize_t remain;
232         /* private: */                            232         /* private: */
233         ssize_t offset;                           233         ssize_t offset;
234 };                                                234 };
235                                                   235 
236 /**                                               236 /**
237  * drm_coredump_printer - construct a &drm_pri    237  * drm_coredump_printer - construct a &drm_printer that can output to a buffer
238  * from the read function for devcoredump         238  * from the read function for devcoredump
239  * @iter: A pointer to a struct drm_print_iter    239  * @iter: A pointer to a struct drm_print_iterator for the read instance
240  *                                                240  *
241  * This wrapper extends drm_printf() to work w    241  * This wrapper extends drm_printf() to work with a dev_coredumpm() callback
242  * function. The passed in drm_print_iterator     242  * function. The passed in drm_print_iterator struct contains the buffer
243  * pointer, size and offset as passed in from     243  * pointer, size and offset as passed in from devcoredump.
244  *                                                244  *
245  * For example::                                  245  * For example::
246  *                                                246  *
247  *      void coredump_read(char *buffer, loff_    247  *      void coredump_read(char *buffer, loff_t offset, size_t count,
248  *              void *data, size_t datalen)       248  *              void *data, size_t datalen)
249  *      {                                         249  *      {
250  *              struct drm_print_iterator iter    250  *              struct drm_print_iterator iter;
251  *              struct drm_printer p;             251  *              struct drm_printer p;
252  *                                                252  *
253  *              iter.data = buffer;               253  *              iter.data = buffer;
254  *              iter.start = offset;              254  *              iter.start = offset;
255  *              iter.remain = count;              255  *              iter.remain = count;
256  *                                                256  *
257  *              p = drm_coredump_printer(&iter    257  *              p = drm_coredump_printer(&iter);
258  *                                                258  *
259  *              drm_printf(p, "foo=%d\n", foo)    259  *              drm_printf(p, "foo=%d\n", foo);
260  *      }                                         260  *      }
261  *                                                261  *
262  *      void makecoredump(...)                    262  *      void makecoredump(...)
263  *      {                                         263  *      {
264  *              ...                               264  *              ...
265  *              dev_coredumpm(dev, THIS_MODULE    265  *              dev_coredumpm(dev, THIS_MODULE, data, 0, GFP_KERNEL,
266  *                      coredump_read, ...)       266  *                      coredump_read, ...)
267  *      }                                         267  *      }
268  *                                                268  *
269  * RETURNS:                                       269  * RETURNS:
270  * The &drm_printer object                        270  * The &drm_printer object
271  */                                               271  */
272 static inline struct drm_printer                  272 static inline struct drm_printer
273 drm_coredump_printer(struct drm_print_iterator    273 drm_coredump_printer(struct drm_print_iterator *iter)
274 {                                                 274 {
275         struct drm_printer p = {                  275         struct drm_printer p = {
276                 .printfn = __drm_printfn_cored    276                 .printfn = __drm_printfn_coredump,
277                 .puts = __drm_puts_coredump,      277                 .puts = __drm_puts_coredump,
278                 .arg = iter,                      278                 .arg = iter,
279         };                                        279         };
280                                                   280 
281         /* Set the internal offset of the iter    281         /* Set the internal offset of the iterator to zero */
282         iter->offset = 0;                         282         iter->offset = 0;
283                                                   283 
284         return p;                                 284         return p;
285 }                                                 285 }
286                                                   286 
287 /**                                               287 /**
288  * drm_seq_file_printer - construct a &drm_pri    288  * drm_seq_file_printer - construct a &drm_printer that outputs to &seq_file
289  * @f:  the &struct seq_file to output to         289  * @f:  the &struct seq_file to output to
290  *                                                290  *
291  * RETURNS:                                       291  * RETURNS:
292  * The &drm_printer object                        292  * The &drm_printer object
293  */                                               293  */
294 static inline struct drm_printer drm_seq_file_    294 static inline struct drm_printer drm_seq_file_printer(struct seq_file *f)
295 {                                                 295 {
296         struct drm_printer p = {                  296         struct drm_printer p = {
297                 .printfn = __drm_printfn_seq_f    297                 .printfn = __drm_printfn_seq_file,
298                 .puts = __drm_puts_seq_file,      298                 .puts = __drm_puts_seq_file,
299                 .arg = f,                         299                 .arg = f,
300         };                                        300         };
301         return p;                                 301         return p;
302 }                                                 302 }
303                                                   303 
304 /**                                               304 /**
305  * drm_info_printer - construct a &drm_printer    305  * drm_info_printer - construct a &drm_printer that outputs to dev_printk()
306  * @dev: the &struct device pointer               306  * @dev: the &struct device pointer
307  *                                                307  *
308  * RETURNS:                                       308  * RETURNS:
309  * The &drm_printer object                        309  * The &drm_printer object
310  */                                               310  */
311 static inline struct drm_printer drm_info_prin    311 static inline struct drm_printer drm_info_printer(struct device *dev)
312 {                                                 312 {
313         struct drm_printer p = {                  313         struct drm_printer p = {
314                 .printfn = __drm_printfn_info,    314                 .printfn = __drm_printfn_info,
315                 .arg = dev,                       315                 .arg = dev,
316         };                                        316         };
317         return p;                                 317         return p;
318 }                                                 318 }
319                                                   319 
320 /**                                               320 /**
321  * drm_dbg_printer - construct a &drm_printer     321  * drm_dbg_printer - construct a &drm_printer for drm device specific output
322  * @drm: the &struct drm_device pointer, or NU    322  * @drm: the &struct drm_device pointer, or NULL
323  * @category: the debug category to use           323  * @category: the debug category to use
324  * @prefix: debug output prefix, or NULL for n    324  * @prefix: debug output prefix, or NULL for no prefix
325  *                                                325  *
326  * RETURNS:                                       326  * RETURNS:
327  * The &drm_printer object                        327  * The &drm_printer object
328  */                                               328  */
329 static inline struct drm_printer drm_dbg_print    329 static inline struct drm_printer drm_dbg_printer(struct drm_device *drm,
330                                                   330                                                  enum drm_debug_category category,
331                                                   331                                                  const char *prefix)
332 {                                                 332 {
333         struct drm_printer p = {                  333         struct drm_printer p = {
334                 .printfn = __drm_printfn_dbg,     334                 .printfn = __drm_printfn_dbg,
335                 .arg = drm,                       335                 .arg = drm,
336                 .origin = (const void *)_THIS_    336                 .origin = (const void *)_THIS_IP_, /* it's fine as we will be inlined */
337                 .prefix = prefix,                 337                 .prefix = prefix,
338                 .category = category,             338                 .category = category,
339         };                                        339         };
340         return p;                                 340         return p;
341 }                                                 341 }
342                                                   342 
343 /**                                               343 /**
344  * drm_err_printer - construct a &drm_printer     344  * drm_err_printer - construct a &drm_printer that outputs to drm_err()
345  * @drm: the &struct drm_device pointer           345  * @drm: the &struct drm_device pointer
346  * @prefix: debug output prefix, or NULL for n    346  * @prefix: debug output prefix, or NULL for no prefix
347  *                                                347  *
348  * RETURNS:                                       348  * RETURNS:
349  * The &drm_printer object                        349  * The &drm_printer object
350  */                                               350  */
351 static inline struct drm_printer drm_err_print    351 static inline struct drm_printer drm_err_printer(struct drm_device *drm,
352                                                   352                                                  const char *prefix)
353 {                                                 353 {
354         struct drm_printer p = {                  354         struct drm_printer p = {
355                 .printfn = __drm_printfn_err,     355                 .printfn = __drm_printfn_err,
356                 .arg = drm,                       356                 .arg = drm,
357                 .prefix = prefix                  357                 .prefix = prefix
358         };                                        358         };
359         return p;                                 359         return p;
360 }                                                 360 }
361                                                   361 
362 /*                                                362 /*
363  * struct device based logging                    363  * struct device based logging
364  *                                                364  *
365  * Prefer drm_device based logging over device    365  * Prefer drm_device based logging over device or printk based logging.
366  */                                               366  */
367                                                   367 
368 __printf(3, 4)                                    368 __printf(3, 4)
369 void drm_dev_printk(const struct device *dev,     369 void drm_dev_printk(const struct device *dev, const char *level,
370                     const char *format, ...);     370                     const char *format, ...);
371 struct _ddebug;                                   371 struct _ddebug;
372 __printf(4, 5)                                    372 __printf(4, 5)
373 void __drm_dev_dbg(struct _ddebug *desc, const    373 void __drm_dev_dbg(struct _ddebug *desc, const struct device *dev,
374                    enum drm_debug_category cat    374                    enum drm_debug_category category, const char *format, ...);
375                                                   375 
376 /**                                               376 /**
377  * DRM_DEV_ERROR() - Error output.                377  * DRM_DEV_ERROR() - Error output.
378  *                                                378  *
379  * NOTE: this is deprecated in favor of drm_er    379  * NOTE: this is deprecated in favor of drm_err() or dev_err().
380  *                                                380  *
381  * @dev: device pointer                           381  * @dev: device pointer
382  * @fmt: printf() like format string.             382  * @fmt: printf() like format string.
383  */                                               383  */
384 #define DRM_DEV_ERROR(dev, fmt, ...)              384 #define DRM_DEV_ERROR(dev, fmt, ...)                                    \
385         drm_dev_printk(dev, KERN_ERR, "*ERROR*    385         drm_dev_printk(dev, KERN_ERR, "*ERROR* " fmt, ##__VA_ARGS__)
386                                                   386 
387 /**                                               387 /**
388  * DRM_DEV_ERROR_RATELIMITED() - Rate limited     388  * DRM_DEV_ERROR_RATELIMITED() - Rate limited error output.
389  *                                                389  *
390  * NOTE: this is deprecated in favor of drm_er    390  * NOTE: this is deprecated in favor of drm_err_ratelimited() or
391  * dev_err_ratelimited().                         391  * dev_err_ratelimited().
392  *                                                392  *
393  * @dev: device pointer                           393  * @dev: device pointer
394  * @fmt: printf() like format string.             394  * @fmt: printf() like format string.
395  *                                                395  *
396  * Like DRM_ERROR() but won't flood the log.      396  * Like DRM_ERROR() but won't flood the log.
397  */                                               397  */
398 #define DRM_DEV_ERROR_RATELIMITED(dev, fmt, ..    398 #define DRM_DEV_ERROR_RATELIMITED(dev, fmt, ...)                        \
399 ({                                                399 ({                                                                      \
400         static DEFINE_RATELIMIT_STATE(_rs,        400         static DEFINE_RATELIMIT_STATE(_rs,                              \
401                                       DEFAULT_    401                                       DEFAULT_RATELIMIT_INTERVAL,       \
402                                       DEFAULT_    402                                       DEFAULT_RATELIMIT_BURST);         \
403                                                   403                                                                         \
404         if (__ratelimit(&_rs))                    404         if (__ratelimit(&_rs))                                          \
405                 DRM_DEV_ERROR(dev, fmt, ##__VA    405                 DRM_DEV_ERROR(dev, fmt, ##__VA_ARGS__);                 \
406 })                                                406 })
407                                                   407 
408 /* NOTE: this is deprecated in favor of drm_in    408 /* NOTE: this is deprecated in favor of drm_info() or dev_info(). */
409 #define DRM_DEV_INFO(dev, fmt, ...)               409 #define DRM_DEV_INFO(dev, fmt, ...)                             \
410         drm_dev_printk(dev, KERN_INFO, fmt, ##    410         drm_dev_printk(dev, KERN_INFO, fmt, ##__VA_ARGS__)
411                                                   411 
412 /* NOTE: this is deprecated in favor of drm_in    412 /* NOTE: this is deprecated in favor of drm_info_once() or dev_info_once(). */
413 #define DRM_DEV_INFO_ONCE(dev, fmt, ...)          413 #define DRM_DEV_INFO_ONCE(dev, fmt, ...)                                \
414 ({                                                414 ({                                                                      \
415         static bool __print_once __read_mostly    415         static bool __print_once __read_mostly;                         \
416         if (!__print_once) {                      416         if (!__print_once) {                                            \
417                 __print_once = true;              417                 __print_once = true;                                    \
418                 DRM_DEV_INFO(dev, fmt, ##__VA_    418                 DRM_DEV_INFO(dev, fmt, ##__VA_ARGS__);                  \
419         }                                         419         }                                                               \
420 })                                                420 })
421                                                   421 
422 #if !defined(CONFIG_DRM_USE_DYNAMIC_DEBUG)        422 #if !defined(CONFIG_DRM_USE_DYNAMIC_DEBUG)
423 #define drm_dev_dbg(dev, cat, fmt, ...)           423 #define drm_dev_dbg(dev, cat, fmt, ...)                         \
424         __drm_dev_dbg(NULL, dev, cat, fmt, ##_    424         __drm_dev_dbg(NULL, dev, cat, fmt, ##__VA_ARGS__)
425 #else                                             425 #else
426 #define drm_dev_dbg(dev, cat, fmt, ...)           426 #define drm_dev_dbg(dev, cat, fmt, ...)                         \
427         _dynamic_func_call_cls(cat, fmt, __drm    427         _dynamic_func_call_cls(cat, fmt, __drm_dev_dbg,         \
428                                dev, cat, fmt,     428                                dev, cat, fmt, ##__VA_ARGS__)
429 #endif                                            429 #endif
430                                                   430 
431 /**                                               431 /**
432  * DRM_DEV_DEBUG() - Debug output for generic     432  * DRM_DEV_DEBUG() - Debug output for generic drm code
433  *                                                433  *
434  * NOTE: this is deprecated in favor of drm_db    434  * NOTE: this is deprecated in favor of drm_dbg_core().
435  *                                                435  *
436  * @dev: device pointer                           436  * @dev: device pointer
437  * @fmt: printf() like format string.             437  * @fmt: printf() like format string.
438  */                                               438  */
439 #define DRM_DEV_DEBUG(dev, fmt, ...)              439 #define DRM_DEV_DEBUG(dev, fmt, ...)                                    \
440         drm_dev_dbg(dev, DRM_UT_CORE, fmt, ##_    440         drm_dev_dbg(dev, DRM_UT_CORE, fmt, ##__VA_ARGS__)
441 /**                                               441 /**
442  * DRM_DEV_DEBUG_DRIVER() - Debug output for v    442  * DRM_DEV_DEBUG_DRIVER() - Debug output for vendor specific part of the driver
443  *                                                443  *
444  * NOTE: this is deprecated in favor of drm_db    444  * NOTE: this is deprecated in favor of drm_dbg() or dev_dbg().
445  *                                                445  *
446  * @dev: device pointer                           446  * @dev: device pointer
447  * @fmt: printf() like format string.             447  * @fmt: printf() like format string.
448  */                                               448  */
449 #define DRM_DEV_DEBUG_DRIVER(dev, fmt, ...)       449 #define DRM_DEV_DEBUG_DRIVER(dev, fmt, ...)                             \
450         drm_dev_dbg(dev, DRM_UT_DRIVER, fmt, #    450         drm_dev_dbg(dev, DRM_UT_DRIVER, fmt, ##__VA_ARGS__)
451 /**                                               451 /**
452  * DRM_DEV_DEBUG_KMS() - Debug output for mode    452  * DRM_DEV_DEBUG_KMS() - Debug output for modesetting code
453  *                                                453  *
454  * NOTE: this is deprecated in favor of drm_db    454  * NOTE: this is deprecated in favor of drm_dbg_kms().
455  *                                                455  *
456  * @dev: device pointer                           456  * @dev: device pointer
457  * @fmt: printf() like format string.             457  * @fmt: printf() like format string.
458  */                                               458  */
459 #define DRM_DEV_DEBUG_KMS(dev, fmt, ...)          459 #define DRM_DEV_DEBUG_KMS(dev, fmt, ...)                                \
460         drm_dev_dbg(dev, DRM_UT_KMS, fmt, ##__    460         drm_dev_dbg(dev, DRM_UT_KMS, fmt, ##__VA_ARGS__)
461                                                   461 
462 /*                                                462 /*
463  * struct drm_device based logging                463  * struct drm_device based logging
464  *                                                464  *
465  * Prefer drm_device based logging over device    465  * Prefer drm_device based logging over device or prink based logging.
466  */                                               466  */
467                                                   467 
468 /* Helper for struct drm_device based logging.    468 /* Helper for struct drm_device based logging. */
469 #define __drm_printk(drm, level, type, fmt, ..    469 #define __drm_printk(drm, level, type, fmt, ...)                        \
470         dev_##level##type((drm) ? (drm)->dev :    470         dev_##level##type((drm) ? (drm)->dev : NULL, "[drm] " fmt, ##__VA_ARGS__)
471                                                   471 
472                                                   472 
473 #define drm_info(drm, fmt, ...)                   473 #define drm_info(drm, fmt, ...)                                 \
474         __drm_printk((drm), info,, fmt, ##__VA    474         __drm_printk((drm), info,, fmt, ##__VA_ARGS__)
475                                                   475 
476 #define drm_notice(drm, fmt, ...)                 476 #define drm_notice(drm, fmt, ...)                               \
477         __drm_printk((drm), notice,, fmt, ##__    477         __drm_printk((drm), notice,, fmt, ##__VA_ARGS__)
478                                                   478 
479 #define drm_warn(drm, fmt, ...)                   479 #define drm_warn(drm, fmt, ...)                                 \
480         __drm_printk((drm), warn,, fmt, ##__VA    480         __drm_printk((drm), warn,, fmt, ##__VA_ARGS__)
481                                                   481 
482 #define drm_err(drm, fmt, ...)                    482 #define drm_err(drm, fmt, ...)                                  \
483         __drm_printk((drm), err,, "*ERROR* " f    483         __drm_printk((drm), err,, "*ERROR* " fmt, ##__VA_ARGS__)
484                                                   484 
485                                                   485 
486 #define drm_info_once(drm, fmt, ...)              486 #define drm_info_once(drm, fmt, ...)                            \
487         __drm_printk((drm), info, _once, fmt,     487         __drm_printk((drm), info, _once, fmt, ##__VA_ARGS__)
488                                                   488 
489 #define drm_notice_once(drm, fmt, ...)            489 #define drm_notice_once(drm, fmt, ...)                          \
490         __drm_printk((drm), notice, _once, fmt    490         __drm_printk((drm), notice, _once, fmt, ##__VA_ARGS__)
491                                                   491 
492 #define drm_warn_once(drm, fmt, ...)              492 #define drm_warn_once(drm, fmt, ...)                            \
493         __drm_printk((drm), warn, _once, fmt,     493         __drm_printk((drm), warn, _once, fmt, ##__VA_ARGS__)
494                                                   494 
495 #define drm_err_once(drm, fmt, ...)               495 #define drm_err_once(drm, fmt, ...)                             \
496         __drm_printk((drm), err, _once, "*ERRO    496         __drm_printk((drm), err, _once, "*ERROR* " fmt, ##__VA_ARGS__)
497                                                   497 
498                                                   498 
499 #define drm_err_ratelimited(drm, fmt, ...)        499 #define drm_err_ratelimited(drm, fmt, ...)                              \
500         __drm_printk((drm), err, _ratelimited,    500         __drm_printk((drm), err, _ratelimited, "*ERROR* " fmt, ##__VA_ARGS__)
501                                                   501 
502                                                   502 
503 #define drm_dbg_core(drm, fmt, ...)               503 #define drm_dbg_core(drm, fmt, ...)                                     \
504         drm_dev_dbg((drm) ? (drm)->dev : NULL,    504         drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_CORE, fmt, ##__VA_ARGS__)
505 #define drm_dbg_driver(drm, fmt, ...)             505 #define drm_dbg_driver(drm, fmt, ...)                                           \
506         drm_dev_dbg((drm) ? (drm)->dev : NULL,    506         drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_DRIVER, fmt, ##__VA_ARGS__)
507 #define drm_dbg_kms(drm, fmt, ...)                507 #define drm_dbg_kms(drm, fmt, ...)                                      \
508         drm_dev_dbg((drm) ? (drm)->dev : NULL,    508         drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_KMS, fmt, ##__VA_ARGS__)
509 #define drm_dbg_prime(drm, fmt, ...)              509 #define drm_dbg_prime(drm, fmt, ...)                                    \
510         drm_dev_dbg((drm) ? (drm)->dev : NULL,    510         drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_PRIME, fmt, ##__VA_ARGS__)
511 #define drm_dbg_atomic(drm, fmt, ...)             511 #define drm_dbg_atomic(drm, fmt, ...)                                   \
512         drm_dev_dbg((drm) ? (drm)->dev : NULL,    512         drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_ATOMIC, fmt, ##__VA_ARGS__)
513 #define drm_dbg_vbl(drm, fmt, ...)                513 #define drm_dbg_vbl(drm, fmt, ...)                                      \
514         drm_dev_dbg((drm) ? (drm)->dev : NULL,    514         drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_VBL, fmt, ##__VA_ARGS__)
515 #define drm_dbg_state(drm, fmt, ...)              515 #define drm_dbg_state(drm, fmt, ...)                                    \
516         drm_dev_dbg((drm) ? (drm)->dev : NULL,    516         drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_STATE, fmt, ##__VA_ARGS__)
517 #define drm_dbg_lease(drm, fmt, ...)              517 #define drm_dbg_lease(drm, fmt, ...)                                    \
518         drm_dev_dbg((drm) ? (drm)->dev : NULL,    518         drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_LEASE, fmt, ##__VA_ARGS__)
519 #define drm_dbg_dp(drm, fmt, ...)                 519 #define drm_dbg_dp(drm, fmt, ...)                                       \
520         drm_dev_dbg((drm) ? (drm)->dev : NULL,    520         drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_DP, fmt, ##__VA_ARGS__)
521 #define drm_dbg_drmres(drm, fmt, ...)             521 #define drm_dbg_drmres(drm, fmt, ...)                                   \
522         drm_dev_dbg((drm) ? (drm)->dev : NULL,    522         drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_DRMRES, fmt, ##__VA_ARGS__)
523                                                   523 
524 #define drm_dbg(drm, fmt, ...)  drm_dbg_driver    524 #define drm_dbg(drm, fmt, ...)  drm_dbg_driver(drm, fmt, ##__VA_ARGS__)
525                                                   525 
526 /*                                                526 /*
527  * printk based logging                           527  * printk based logging
528  *                                                528  *
529  * Prefer drm_device based logging over device    529  * Prefer drm_device based logging over device or prink based logging.
530  */                                               530  */
531                                                   531 
532 __printf(1, 2)                                    532 __printf(1, 2)
533 void __drm_err(const char *format, ...);          533 void __drm_err(const char *format, ...);
534                                                   534 
535 #if !defined(CONFIG_DRM_USE_DYNAMIC_DEBUG)        535 #if !defined(CONFIG_DRM_USE_DYNAMIC_DEBUG)
536 #define __drm_dbg(cat, fmt, ...)        __drm_    536 #define __drm_dbg(cat, fmt, ...)        __drm_dev_dbg(NULL, NULL, cat, fmt, ##__VA_ARGS__)
537 #else                                             537 #else
538 #define __drm_dbg(cat, fmt, ...)                  538 #define __drm_dbg(cat, fmt, ...)                                        \
539         _dynamic_func_call_cls(cat, fmt, __drm    539         _dynamic_func_call_cls(cat, fmt, __drm_dev_dbg,                 \
540                                NULL, cat, fmt,    540                                NULL, cat, fmt, ##__VA_ARGS__)
541 #endif                                            541 #endif
542                                                   542 
543 /* Macros to make printk easier */                543 /* Macros to make printk easier */
544                                                   544 
545 #define _DRM_PRINTK(once, level, fmt, ...)        545 #define _DRM_PRINTK(once, level, fmt, ...)                              \
546         printk##once(KERN_##level "[" DRM_NAME    546         printk##once(KERN_##level "[" DRM_NAME "] " fmt, ##__VA_ARGS__)
547                                                   547 
548 /* NOTE: this is deprecated in favor of pr_inf    548 /* NOTE: this is deprecated in favor of pr_info(). */
549 #define DRM_INFO(fmt, ...)                        549 #define DRM_INFO(fmt, ...)                                              \
550         _DRM_PRINTK(, INFO, fmt, ##__VA_ARGS__    550         _DRM_PRINTK(, INFO, fmt, ##__VA_ARGS__)
551 /* NOTE: this is deprecated in favor of pr_not    551 /* NOTE: this is deprecated in favor of pr_notice(). */
552 #define DRM_NOTE(fmt, ...)                        552 #define DRM_NOTE(fmt, ...)                                              \
553         _DRM_PRINTK(, NOTICE, fmt, ##__VA_ARGS    553         _DRM_PRINTK(, NOTICE, fmt, ##__VA_ARGS__)
554 /* NOTE: this is deprecated in favor of pr_war    554 /* NOTE: this is deprecated in favor of pr_warn(). */
555 #define DRM_WARN(fmt, ...)                        555 #define DRM_WARN(fmt, ...)                                              \
556         _DRM_PRINTK(, WARNING, fmt, ##__VA_ARG    556         _DRM_PRINTK(, WARNING, fmt, ##__VA_ARGS__)
557                                                   557 
558 /* NOTE: this is deprecated in favor of pr_inf    558 /* NOTE: this is deprecated in favor of pr_info_once(). */
559 #define DRM_INFO_ONCE(fmt, ...)                   559 #define DRM_INFO_ONCE(fmt, ...)                                         \
560         _DRM_PRINTK(_once, INFO, fmt, ##__VA_A    560         _DRM_PRINTK(_once, INFO, fmt, ##__VA_ARGS__)
561 /* NOTE: this is deprecated in favor of pr_not    561 /* NOTE: this is deprecated in favor of pr_notice_once(). */
562 #define DRM_NOTE_ONCE(fmt, ...)                   562 #define DRM_NOTE_ONCE(fmt, ...)                                         \
563         _DRM_PRINTK(_once, NOTICE, fmt, ##__VA    563         _DRM_PRINTK(_once, NOTICE, fmt, ##__VA_ARGS__)
564 /* NOTE: this is deprecated in favor of pr_war    564 /* NOTE: this is deprecated in favor of pr_warn_once(). */
565 #define DRM_WARN_ONCE(fmt, ...)                   565 #define DRM_WARN_ONCE(fmt, ...)                                         \
566         _DRM_PRINTK(_once, WARNING, fmt, ##__V    566         _DRM_PRINTK(_once, WARNING, fmt, ##__VA_ARGS__)
567                                                   567 
568 /* NOTE: this is deprecated in favor of pr_err    568 /* NOTE: this is deprecated in favor of pr_err(). */
569 #define DRM_ERROR(fmt, ...)                       569 #define DRM_ERROR(fmt, ...)                                             \
570         __drm_err(fmt, ##__VA_ARGS__)             570         __drm_err(fmt, ##__VA_ARGS__)
571                                                   571 
572 /* NOTE: this is deprecated in favor of pr_err    572 /* NOTE: this is deprecated in favor of pr_err_ratelimited(). */
573 #define DRM_ERROR_RATELIMITED(fmt, ...)           573 #define DRM_ERROR_RATELIMITED(fmt, ...)                                 \
574         DRM_DEV_ERROR_RATELIMITED(NULL, fmt, #    574         DRM_DEV_ERROR_RATELIMITED(NULL, fmt, ##__VA_ARGS__)
575                                                   575 
576 /* NOTE: this is deprecated in favor of drm_db    576 /* NOTE: this is deprecated in favor of drm_dbg_core(NULL, ...). */
577 #define DRM_DEBUG(fmt, ...)                       577 #define DRM_DEBUG(fmt, ...)                                             \
578         __drm_dbg(DRM_UT_CORE, fmt, ##__VA_ARG    578         __drm_dbg(DRM_UT_CORE, fmt, ##__VA_ARGS__)
579                                                   579 
580 /* NOTE: this is deprecated in favor of drm_db    580 /* NOTE: this is deprecated in favor of drm_dbg(NULL, ...). */
581 #define DRM_DEBUG_DRIVER(fmt, ...)                581 #define DRM_DEBUG_DRIVER(fmt, ...)                                      \
582         __drm_dbg(DRM_UT_DRIVER, fmt, ##__VA_A    582         __drm_dbg(DRM_UT_DRIVER, fmt, ##__VA_ARGS__)
583                                                   583 
584 /* NOTE: this is deprecated in favor of drm_db    584 /* NOTE: this is deprecated in favor of drm_dbg_kms(NULL, ...). */
585 #define DRM_DEBUG_KMS(fmt, ...)                   585 #define DRM_DEBUG_KMS(fmt, ...)                                         \
586         __drm_dbg(DRM_UT_KMS, fmt, ##__VA_ARGS    586         __drm_dbg(DRM_UT_KMS, fmt, ##__VA_ARGS__)
587                                                   587 
588 /* NOTE: this is deprecated in favor of drm_db    588 /* NOTE: this is deprecated in favor of drm_dbg_prime(NULL, ...). */
589 #define DRM_DEBUG_PRIME(fmt, ...)                 589 #define DRM_DEBUG_PRIME(fmt, ...)                                       \
590         __drm_dbg(DRM_UT_PRIME, fmt, ##__VA_AR    590         __drm_dbg(DRM_UT_PRIME, fmt, ##__VA_ARGS__)
591                                                   591 
592 /* NOTE: this is deprecated in favor of drm_db    592 /* NOTE: this is deprecated in favor of drm_dbg_atomic(NULL, ...). */
593 #define DRM_DEBUG_ATOMIC(fmt, ...)                593 #define DRM_DEBUG_ATOMIC(fmt, ...)                                      \
594         __drm_dbg(DRM_UT_ATOMIC, fmt, ##__VA_A    594         __drm_dbg(DRM_UT_ATOMIC, fmt, ##__VA_ARGS__)
595                                                   595 
596 /* NOTE: this is deprecated in favor of drm_db    596 /* NOTE: this is deprecated in favor of drm_dbg_vbl(NULL, ...). */
597 #define DRM_DEBUG_VBL(fmt, ...)                   597 #define DRM_DEBUG_VBL(fmt, ...)                                         \
598         __drm_dbg(DRM_UT_VBL, fmt, ##__VA_ARGS    598         __drm_dbg(DRM_UT_VBL, fmt, ##__VA_ARGS__)
599                                                   599 
600 /* NOTE: this is deprecated in favor of drm_db    600 /* NOTE: this is deprecated in favor of drm_dbg_lease(NULL, ...). */
601 #define DRM_DEBUG_LEASE(fmt, ...)                 601 #define DRM_DEBUG_LEASE(fmt, ...)                                       \
602         __drm_dbg(DRM_UT_LEASE, fmt, ##__VA_AR    602         __drm_dbg(DRM_UT_LEASE, fmt, ##__VA_ARGS__)
603                                                   603 
604 /* NOTE: this is deprecated in favor of drm_db    604 /* NOTE: this is deprecated in favor of drm_dbg_dp(NULL, ...). */
605 #define DRM_DEBUG_DP(fmt, ...)                    605 #define DRM_DEBUG_DP(fmt, ...)                                          \
606         __drm_dbg(DRM_UT_DP, fmt, ## __VA_ARGS    606         __drm_dbg(DRM_UT_DP, fmt, ## __VA_ARGS__)
607                                                   607 
608 #define __DRM_DEFINE_DBG_RATELIMITED(category,    608 #define __DRM_DEFINE_DBG_RATELIMITED(category, drm, fmt, ...)                                   \
609 ({                                                609 ({                                                                                              \
610         static DEFINE_RATELIMIT_STATE(rs_, DEF    610         static DEFINE_RATELIMIT_STATE(rs_, DEFAULT_RATELIMIT_INTERVAL, DEFAULT_RATELIMIT_BURST);\
611         const struct drm_device *drm_ = (drm);    611         const struct drm_device *drm_ = (drm);                                                  \
612                                                   612                                                                                                 \
613         if (drm_debug_enabled(DRM_UT_ ## categ    613         if (drm_debug_enabled(DRM_UT_ ## category) && __ratelimit(&rs_))                        \
614                 drm_dev_printk(drm_ ? drm_->de    614                 drm_dev_printk(drm_ ? drm_->dev : NULL, KERN_DEBUG, fmt, ## __VA_ARGS__);       \
615 })                                                615 })
616                                                   616 
617 #define drm_dbg_ratelimited(drm, fmt, ...) \      617 #define drm_dbg_ratelimited(drm, fmt, ...) \
618         __DRM_DEFINE_DBG_RATELIMITED(DRIVER, d    618         __DRM_DEFINE_DBG_RATELIMITED(DRIVER, drm, fmt, ## __VA_ARGS__)
619                                                   619 
620 #define drm_dbg_kms_ratelimited(drm, fmt, ...)    620 #define drm_dbg_kms_ratelimited(drm, fmt, ...) \
621         __DRM_DEFINE_DBG_RATELIMITED(KMS, drm,    621         __DRM_DEFINE_DBG_RATELIMITED(KMS, drm, fmt, ## __VA_ARGS__)
622                                                   622 
623 /*                                                623 /*
624  * struct drm_device based WARNs                  624  * struct drm_device based WARNs
625  *                                                625  *
626  * drm_WARN*() acts like WARN*(), but with the    626  * drm_WARN*() acts like WARN*(), but with the key difference of
627  * using device specific information so that w    627  * using device specific information so that we know from which device
628  * warning is originating from.                   628  * warning is originating from.
629  *                                                629  *
630  * Prefer drm_device based drm_WARN* over regu    630  * Prefer drm_device based drm_WARN* over regular WARN*
631  */                                               631  */
632                                                   632 
633 /* Helper for struct drm_device based WARNs */    633 /* Helper for struct drm_device based WARNs */
634 #define drm_WARN(drm, condition, format, arg..    634 #define drm_WARN(drm, condition, format, arg...)                        \
635         WARN(condition, "%s %s: [drm] " format    635         WARN(condition, "%s %s: [drm] " format,                         \
636                         dev_driver_string((drm    636                         dev_driver_string((drm)->dev),                  \
637                         dev_name((drm)->dev),     637                         dev_name((drm)->dev), ## arg)
638                                                   638 
639 #define drm_WARN_ONCE(drm, condition, format,     639 #define drm_WARN_ONCE(drm, condition, format, arg...)                   \
640         WARN_ONCE(condition, "%s %s: [drm] " f    640         WARN_ONCE(condition, "%s %s: [drm] " format,                    \
641                         dev_driver_string((drm    641                         dev_driver_string((drm)->dev),                  \
642                         dev_name((drm)->dev),     642                         dev_name((drm)->dev), ## arg)
643                                                   643 
644 #define drm_WARN_ON(drm, x)                       644 #define drm_WARN_ON(drm, x)                                             \
645         drm_WARN((drm), (x), "%s",                645         drm_WARN((drm), (x), "%s",                                      \
646                  "drm_WARN_ON(" __stringify(x)    646                  "drm_WARN_ON(" __stringify(x) ")")
647                                                   647 
648 #define drm_WARN_ON_ONCE(drm, x)                  648 #define drm_WARN_ON_ONCE(drm, x)                                        \
649         drm_WARN_ONCE((drm), (x), "%s",           649         drm_WARN_ONCE((drm), (x), "%s",                                 \
650                       "drm_WARN_ON_ONCE(" __st    650                       "drm_WARN_ON_ONCE(" __stringify(x) ")")
651                                                   651 
652 #endif /* DRM_PRINT_H_ */                         652 #endif /* DRM_PRINT_H_ */
653                                                   653 

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php