34 #include <drm/drm.h>
35 #include <drm/drm_device.h>
68  *             struct drm_printer p = drm_info_printer(drm->dev);
74  * enum drm_debug_category - The DRM debug categories
76  * Each of the DRM debug logging macros use a specific category, and the logging
77  * is filtered by the drm.debug module parameter. This enum specifies the values
83  * Enabling verbose debug messages is done through the drm.debug parameter, each
86  *  - drm.debug=0x1 will enable CORE messages
87  *  - drm.debug=0x2 will enable DRIVER messages
88  *  - drm.debug=0x3 will enable CORE and DRIVER messages
90  *  - drm.debug=0x1ff will enable all messages
95  *   # echo 0xf > /sys/module/drm/parameters/debug
101 	 * @DRM_UT_CORE: Used in the generic drm code: drm_ioctl.c, drm_mm.c,
139 	 * @DRM_UT_DRMRES: Used in the drm managed resources code.
157  * the drm.debug API uses dyndbg, so each drm_*dbg macro/callsite gets
169  * struct drm_printer - drm output "stream"
223  * @printer: DRM printer
381  * drm_dbg_printer - construct a &drm_printer for drm device specific output
382  * @drm: the &struct drm_device pointer, or NULL
389 static inline struct drm_printer drm_dbg_printer(struct drm_device *drm,  in drm_dbg_printer()  argument
395 		.arg = drm,  in drm_dbg_printer()
405  * @drm: the &struct drm_device pointer
411 static inline struct drm_printer drm_err_printer(struct drm_device *drm,  in drm_err_printer()  argument
416 		.arg = drm,  in drm_err_printer()
434  *	void crash_dump(struct drm_device *drm)
437  *		struct drm_printer p = drm_err_printer(drm, "crash");
446  *	[ ] 0000:00:00.0: [drm] *ERROR* crash dump 1.1: foo
447  *	[ ] 0000:00:00.0: [drm] *ERROR* crash dump 1.2: bar
462  *	[ ] 0000:00:00.0: [drm] 1: foo
463  *	[ ] 0000:00:00.0: [drm] 2: bar
551  * DRM_DEV_DEBUG() - Debug output for generic drm code
588 #define __drm_printk(drm, level, type, fmt, ...)			\  argument
589 	dev_##level##type((drm) ? (drm)->dev : NULL, "[drm] " fmt, ##__VA_ARGS__)
592 #define drm_info(drm, fmt, ...)					\  argument
593 	__drm_printk((drm), info,, fmt, ##__VA_ARGS__)
595 #define drm_notice(drm, fmt, ...)				\  argument
596 	__drm_printk((drm), notice,, fmt, ##__VA_ARGS__)
598 #define drm_warn(drm, fmt, ...)					\  argument
599 	__drm_printk((drm), warn,, fmt, ##__VA_ARGS__)
601 #define drm_err(drm, fmt, ...)					\  argument
602 	__drm_printk((drm), err,, "*ERROR* " fmt, ##__VA_ARGS__)
605 #define drm_info_once(drm, fmt, ...)				\  argument
606 	__drm_printk((drm), info, _once, fmt, ##__VA_ARGS__)
608 #define drm_notice_once(drm, fmt, ...)				\  argument
609 	__drm_printk((drm), notice, _once, fmt, ##__VA_ARGS__)
611 #define drm_warn_once(drm, fmt, ...)				\  argument
612 	__drm_printk((drm), warn, _once, fmt, ##__VA_ARGS__)
614 #define drm_err_once(drm, fmt, ...)				\  argument
615 	__drm_printk((drm), err, _once, "*ERROR* " fmt, ##__VA_ARGS__)
618 #define drm_err_ratelimited(drm, fmt, ...)				\  argument
619 	__drm_printk((drm), err, _ratelimited, "*ERROR* " fmt, ##__VA_ARGS__)
622 #define drm_dbg_core(drm, fmt, ...)					\  argument
623 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_CORE, fmt, ##__VA_ARGS__)
624 #define drm_dbg_driver(drm, fmt, ...)						\  argument
625 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_DRIVER, fmt, ##__VA_ARGS__)
626 #define drm_dbg_kms(drm, fmt, ...)					\  argument
627 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_KMS, fmt, ##__VA_ARGS__)
628 #define drm_dbg_prime(drm, fmt, ...)					\  argument
629 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_PRIME, fmt, ##__VA_ARGS__)
630 #define drm_dbg_atomic(drm, fmt, ...)					\  argument
631 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_ATOMIC, fmt, ##__VA_ARGS__)
632 #define drm_dbg_vbl(drm, fmt, ...)					\  argument
633 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_VBL, fmt, ##__VA_ARGS__)
634 #define drm_dbg_state(drm, fmt, ...)					\  argument
635 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_STATE, fmt, ##__VA_ARGS__)
636 #define drm_dbg_lease(drm, fmt, ...)					\  argument
637 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_LEASE, fmt, ##__VA_ARGS__)
638 #define drm_dbg_dp(drm, fmt, ...)					\  argument
639 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_DP, fmt, ##__VA_ARGS__)
640 #define drm_dbg_drmres(drm, fmt, ...)					\  argument
641 	drm_dev_dbg((drm) ? (drm)->dev : NULL, DRM_UT_DRMRES, fmt, ##__VA_ARGS__)
643 #define drm_dbg(drm, fmt, ...)	drm_dbg_driver(drm, fmt, ##__VA_ARGS__)  argument
727 #define __DRM_DEFINE_DBG_RATELIMITED(category, drm, fmt, ...)					\  argument
730 	const struct drm_device *drm_ = (drm);							\
736 #define drm_dbg_ratelimited(drm, fmt, ...) \  argument
737 	__DRM_DEFINE_DBG_RATELIMITED(DRIVER, drm, fmt, ## __VA_ARGS__)
739 #define drm_dbg_kms_ratelimited(drm, fmt, ...) \  argument
740 	__DRM_DEFINE_DBG_RATELIMITED(KMS, drm, fmt, ## __VA_ARGS__)
753 #define drm_WARN(drm, condition, format, arg...)			\  argument
754 	WARN(condition, "%s %s: [drm] " format,				\
755 			dev_driver_string((drm)->dev),			\
756 			dev_name((drm)->dev), ## arg)
758 #define drm_WARN_ONCE(drm, condition, format, arg...)			\  argument
759 	WARN_ONCE(condition, "%s %s: [drm] " format,			\
760 			dev_driver_string((drm)->dev),			\
761 			dev_name((drm)->dev), ## arg)
763 #define drm_WARN_ON(drm, x)						\  argument
764 	drm_WARN((drm), (x), "%s",					\
767 #define drm_WARN_ON_ONCE(drm, x)					\  argument
768 	drm_WARN_ONCE((drm), (x), "%s",					\