include/drm/drm_print.h

36 #include <drm/drm.h>
67  *             struct drm_printer p = drm_info_printer(drm->dev);
76  * is filtered by the drm.debug module parameter. This enum specifies the values
82  * Enabling verbose debug messages is done through the drm.debug parameter, each
85  *  - drm.debug=0x1 will enable CORE messages
86  *  - drm.debug=0x2 will enable DRIVER messages
87  *  - drm.debug=0x3 will enable CORE and DRIVER messages
89  *  - drm.debug=0x1ff will enable all messages
94  *   # echo 0xf > /sys/module/drm/parameters/debug
100 	 * @DRM_UT_CORE: Used in the generic drm code: drm_ioctl.c, drm_mm.c,
138 	 * @DRM_UT_DRMRES: Used in the drm managed resources code.
156  * the drm.debug API uses dyndbg, so each drm_*dbg macro/callsite gets
168  * struct drm_printer - drm output "stream"
320  * drm_dbg_printer - construct a &drm_printer for drm device specific output
321  * @drm: the &struct drm_device pointer, or NULL
328 static inline struct drm_printer drm_dbg_printer(struct drm_device *drm,
334 		.arg = drm,
343  * @drm: the &struct drm_device pointer
349 static inline struct drm_printer drm_err_printer(struct drm_device *drm,
354 		.arg = drm,
430  * DRM_DEV_DEBUG() - Debug output for generic drm code
467 #define __drm_printk(drm, level, type, fmt, ...)			\
468 	dev_##level##type((drm) ? (drm)->dev : NULL, "[drm] " fmt, ##__VA_ARGS__)
471 #define drm_info(drm, fmt, ...)					\
472 	__drm_printk((drm), info,, fmt, ##__VA_ARGS__)
474 #define drm_notice(drm, fmt, ...)				\
475 	__drm_printk((drm), notice,, fmt, ##__VA_ARGS__)
477 #define drm_warn(drm, fmt, ...)					\
478 	__drm_printk((drm), warn,, fmt, ##__VA_ARGS__)
480 #define drm_err(drm, fmt, ...)					\
481 	__drm_printk((drm), err,, "*ERROR* " fmt, ##__VA_ARGS__)
484 #define drm_info_once(drm, fmt, ...)				\
485 	__drm_printk((drm), info, _once, fmt, ##__VA_ARGS__)
487 #define drm_notice_once(drm, fmt, ...)				\
488 	__drm_printk((drm), notice, _once, fmt, ##__VA_ARGS__)
490 #define drm_warn_once(drm, fmt, ...)				\
491 	__drm_printk((drm), warn, _once, fmt, ##__VA_ARGS__)
493 #define drm_err_once(drm, fmt, ...)				\
494 	__drm_printk((drm), err, _once, "*ERROR* " fmt, ##__VA_ARGS__)
497 #define drm_err_ratelimited(drm, fmt, ...)				\
498 	__drm_printk((drm), err, _ratelimited, "*ERROR* " fmt, ##__VA_ARGS__)
501 #define drm_dbg_core(drm, fmt, ...)					\
502 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_CORE, fmt, ##__VA_ARGS__)
503 #define drm_dbg_driver(drm, fmt, ...)						\
504 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_DRIVER, fmt, ##__VA_ARGS__)
505 #define drm_dbg_kms(drm, fmt, ...)					\
506 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_KMS, fmt, ##__VA_ARGS__)
507 #define drm_dbg_prime(drm, fmt, ...)					\
508 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_PRIME, fmt, ##__VA_ARGS__)
509 #define drm_dbg_atomic(drm, fmt, ...)					\
510 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_ATOMIC, fmt, ##__VA_ARGS__)
511 #define drm_dbg_vbl(drm, fmt, ...)					\
512 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_VBL, fmt, ##__VA_ARGS__)
513 #define drm_dbg_state(drm, fmt, ...)					\
514 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_STATE, fmt, ##__VA_ARGS__)
515 #define drm_dbg_lease(drm, fmt, ...)					\
516 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_LEASE, fmt, ##__VA_ARGS__)
517 #define drm_dbg_dp(drm, fmt, ...)					\
518 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_DP, fmt, ##__VA_ARGS__)
519 #define drm_dbg_drmres(drm, fmt, ...)					\
520 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_DRMRES, fmt, ##__VA_ARGS__)
522 #define drm_dbg(drm, fmt, ...)	drm_dbg_driver(drm, fmt, ##__VA_ARGS__)
608 #define __DRM_DEFINE_DBG_RATELIMITED(category, drm, fmt, ...)					\
611 	const struct drm_device *drm_ = (drm);							\
617 #define drm_dbg_ratelimited(drm, fmt, ...) \
618 	__DRM_DEFINE_DBG_RATELIMITED(DRIVER, drm, fmt, ## __VA_ARGS__)
620 #define drm_dbg_kms_ratelimited(drm, fmt, ...) \
621 	__DRM_DEFINE_DBG_RATELIMITED(KMS, drm, fmt, ## __VA_ARGS__)
634 #define drm_WARN(drm, condition, format, arg...)			\
636 			dev_driver_string((drm)->dev),			\
637 			dev_name((drm)->dev), ## arg)
639 #define drm_WARN_ONCE(drm, condition, format, arg...)			\
641 			dev_driver_string((drm)->dev),			\
642 			dev_name((drm)->dev), ## arg)
644 #define drm_WARN_ON(drm, x)						\
645 	drm_WARN((drm), (x), "%s",					\
648 #define drm_WARN_ON_ONCE(drm, x)					\
649 	drm_WARN_ONCE((drm), (x), "%s",					\