162306a36Sopenharmony_ci/* SPDX-License-Identifier: GPL-2.0-only */
262306a36Sopenharmony_ci/*
362306a36Sopenharmony_ci * intel_pt_log.h: Intel Processor Trace support
462306a36Sopenharmony_ci * Copyright (c) 2013-2014, Intel Corporation.
562306a36Sopenharmony_ci */
662306a36Sopenharmony_ci
762306a36Sopenharmony_ci#ifndef INCLUDE__INTEL_PT_LOG_H__
862306a36Sopenharmony_ci#define INCLUDE__INTEL_PT_LOG_H__
962306a36Sopenharmony_ci
1062306a36Sopenharmony_ci#include <linux/compiler.h>
1162306a36Sopenharmony_ci#include <stdint.h>
1262306a36Sopenharmony_ci#include <inttypes.h>
1362306a36Sopenharmony_ci
1462306a36Sopenharmony_cistruct intel_pt_pkt;
1562306a36Sopenharmony_ci
1662306a36Sopenharmony_civoid *intel_pt_log_fp(void);
1762306a36Sopenharmony_civoid intel_pt_log_enable(bool dump_log_on_error, unsigned int log_on_error_size);
1862306a36Sopenharmony_civoid intel_pt_log_disable(void);
1962306a36Sopenharmony_civoid intel_pt_log_set_name(const char *name);
2062306a36Sopenharmony_civoid intel_pt_log_dump_buf(void);
2162306a36Sopenharmony_ci
2262306a36Sopenharmony_civoid __intel_pt_log_packet(const struct intel_pt_pkt *packet, int pkt_len,
2362306a36Sopenharmony_ci			   uint64_t pos, const unsigned char *buf);
2462306a36Sopenharmony_ci
2562306a36Sopenharmony_cistruct intel_pt_insn;
2662306a36Sopenharmony_ci
2762306a36Sopenharmony_civoid __intel_pt_log_insn(struct intel_pt_insn *intel_pt_insn, uint64_t ip);
2862306a36Sopenharmony_civoid __intel_pt_log_insn_no_data(struct intel_pt_insn *intel_pt_insn,
2962306a36Sopenharmony_ci				 uint64_t ip);
3062306a36Sopenharmony_ci
3162306a36Sopenharmony_civoid __intel_pt_log(const char *fmt, ...) __printf(1, 2);
3262306a36Sopenharmony_ci
3362306a36Sopenharmony_ci#define intel_pt_log(fmt, ...) \
3462306a36Sopenharmony_ci	do { \
3562306a36Sopenharmony_ci		if (intel_pt_enable_logging) \
3662306a36Sopenharmony_ci			__intel_pt_log(fmt, ##__VA_ARGS__); \
3762306a36Sopenharmony_ci	} while (0)
3862306a36Sopenharmony_ci
3962306a36Sopenharmony_ci#define intel_pt_log_packet(arg, ...) \
4062306a36Sopenharmony_ci	do { \
4162306a36Sopenharmony_ci		if (intel_pt_enable_logging) \
4262306a36Sopenharmony_ci			__intel_pt_log_packet(arg, ##__VA_ARGS__); \
4362306a36Sopenharmony_ci	} while (0)
4462306a36Sopenharmony_ci
4562306a36Sopenharmony_ci#define intel_pt_log_insn(arg, ...) \
4662306a36Sopenharmony_ci	do { \
4762306a36Sopenharmony_ci		if (intel_pt_enable_logging) \
4862306a36Sopenharmony_ci			__intel_pt_log_insn(arg, ##__VA_ARGS__); \
4962306a36Sopenharmony_ci	} while (0)
5062306a36Sopenharmony_ci
5162306a36Sopenharmony_ci#define intel_pt_log_insn_no_data(arg, ...) \
5262306a36Sopenharmony_ci	do { \
5362306a36Sopenharmony_ci		if (intel_pt_enable_logging) \
5462306a36Sopenharmony_ci			__intel_pt_log_insn_no_data(arg, ##__VA_ARGS__); \
5562306a36Sopenharmony_ci	} while (0)
5662306a36Sopenharmony_ci
5762306a36Sopenharmony_ci#define x64_fmt "0x%" PRIx64
5862306a36Sopenharmony_ci
5962306a36Sopenharmony_ciextern bool intel_pt_enable_logging;
6062306a36Sopenharmony_ci
6162306a36Sopenharmony_cistatic inline void intel_pt_log_at(const char *msg, uint64_t u)
6262306a36Sopenharmony_ci{
6362306a36Sopenharmony_ci	intel_pt_log("%s at " x64_fmt "\n", msg, u);
6462306a36Sopenharmony_ci}
6562306a36Sopenharmony_ci
6662306a36Sopenharmony_cistatic inline void intel_pt_log_to(const char *msg, uint64_t u)
6762306a36Sopenharmony_ci{
6862306a36Sopenharmony_ci	intel_pt_log("%s to " x64_fmt "\n", msg, u);
6962306a36Sopenharmony_ci}
7062306a36Sopenharmony_ci
7162306a36Sopenharmony_ci#define intel_pt_log_var(var, fmt) intel_pt_log("%s: " #var " " fmt "\n", __func__, var)
7262306a36Sopenharmony_ci
7362306a36Sopenharmony_ci#define intel_pt_log_x32(var) intel_pt_log_var(var, "%#x")
7462306a36Sopenharmony_ci#define intel_pt_log_x64(var) intel_pt_log_var(var, "%#" PRIx64)
7562306a36Sopenharmony_ci
7662306a36Sopenharmony_ci#endif
77