drivers/gpu/drm/xe/xe_gt_printk.h

Source file repositories/reference/linux-study-clean/drivers/gpu/drm/xe/xe_gt_printk.h

File Facts

System
Linux kernel
Corpus path
drivers/gpu/drm/xe/xe_gt_printk.h
Extension
.h
Size
3454 bytes
Lines
129
Domain
Driver Families
Bucket
drivers/gpu
Inferred role
Driver Families: implementation source
Status
source implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

Dependency Surface

Detected Declarations

Annotated Snippet

#ifndef _XE_GT_PRINTK_H_
#define _XE_GT_PRINTK_H_

#include "xe_gt_types.h"
#include "xe_tile_printk.h"

#define __XE_GT_PRINTK_FMT(_gt, _fmt, _args...)	"GT%u: " _fmt, (_gt)->info.id, ##_args

#define xe_gt_printk(_gt, _level, _fmt, ...) \
	xe_tile_printk((_gt)->tile, _level, __XE_GT_PRINTK_FMT((_gt), _fmt, ##__VA_ARGS__))

#define xe_gt_err(_gt, _fmt, ...) \
	xe_gt_printk((_gt), err, _fmt, ##__VA_ARGS__)

#define xe_gt_err_once(_gt, _fmt, ...) \
	xe_gt_printk((_gt), err_once, _fmt, ##__VA_ARGS__)

#define xe_gt_err_ratelimited(_gt, _fmt, ...) \
	xe_gt_printk((_gt), err_ratelimited, _fmt, ##__VA_ARGS__)

#define xe_gt_warn(_gt, _fmt, ...) \
	xe_gt_printk((_gt), warn, _fmt, ##__VA_ARGS__)

#define xe_gt_notice(_gt, _fmt, ...) \
	xe_gt_printk((_gt), notice, _fmt, ##__VA_ARGS__)

#define xe_gt_info(_gt, _fmt, ...) \
	xe_gt_printk((_gt), info, _fmt, ##__VA_ARGS__)

#define xe_gt_dbg(_gt, _fmt, ...) \
	xe_gt_printk((_gt), dbg, _fmt, ##__VA_ARGS__)

#define xe_gt_WARN_type(_gt, _type, _condition, _fmt, ...) \
	xe_tile_WARN##_type((_gt)->tile, _condition, _fmt, ## __VA_ARGS__)

#define xe_gt_WARN(_gt, _condition, _fmt, ...) \
	xe_gt_WARN_type((_gt),, _condition, __XE_GT_PRINTK_FMT((_gt), _fmt, ##__VA_ARGS__))

#define xe_gt_WARN_ONCE(_gt, _condition, _fmt, ...) \
	xe_gt_WARN_type((_gt), _ONCE, _condition, __XE_GT_PRINTK_FMT((_gt), _fmt, ##__VA_ARGS__))

#define xe_gt_WARN_ON(_gt, _condition) \
	xe_gt_WARN((_gt), _condition, "%s(%s)", "WARN_ON", __stringify(_condition))

#define xe_gt_WARN_ON_ONCE(_gt, _condition) \
	xe_gt_WARN_ONCE((_gt), _condition, "%s(%s)", "WARN_ON_ONCE", __stringify(_condition))

static inline void __xe_gt_printfn_err(struct drm_printer *p, struct va_format *vaf)
{
	struct xe_gt *gt = p->arg;

	xe_gt_err(gt, "%pV", vaf);
}

static inline void __xe_gt_printfn_info(struct drm_printer *p, struct va_format *vaf)
{
	struct xe_gt *gt = p->arg;

	xe_gt_info(gt, "%pV", vaf);
}

static inline void __xe_gt_printfn_dbg(struct drm_printer *p, struct va_format *vaf)
{
	struct xe_gt *gt = p->arg;
	struct drm_printer dbg;

	/*
	 * The original xe_gt_dbg() callsite annotations are useless here,
	 * redirect to the tweaked xe_tile_dbg_printer() instead.
	 */
	dbg = xe_tile_dbg_printer((gt)->tile);
	dbg.origin = p->origin;

	drm_printf(&dbg, __XE_GT_PRINTK_FMT(gt, "%pV", vaf));
}

/**
 * xe_gt_err_printer - Construct a &drm_printer that outputs to xe_gt_err()
 * @gt: the &xe_gt pointer to use in xe_gt_err()
 *
 * Return: The &drm_printer object.
 */
static inline struct drm_printer xe_gt_err_printer(struct xe_gt *gt)
{
	struct drm_printer p = {
		.printfn = __xe_gt_printfn_err,
		.arg = gt,
	};
	return p;
}

Annotation

Implementation Notes