]>
Commit | Line | Data |
---|---|---|
79383c9c BS |
1 | #ifndef QEMU_LOG_H |
2 | #define QEMU_LOG_H | |
3 | ||
be0aa7ac PM |
4 | /* A small part of this API is split into its own header */ |
5 | #include "qemu/log-for-trace.h" | |
eeacee4d | 6 | |
be0aa7ac | 7 | /* Private global variable, don't use */ |
eeacee4d | 8 | extern FILE *qemu_logfile; |
79383c9c | 9 | |
6d2c5146 AL |
10 | /* |
11 | * The new API: | |
12 | * | |
13 | */ | |
14 | ||
15 | /* Log settings checking macros: */ | |
16 | ||
17 | /* Returns true if qemu_log() will really write somewhere | |
18 | */ | |
eeacee4d BS |
19 | static inline bool qemu_log_enabled(void) |
20 | { | |
21 | return qemu_logfile != NULL; | |
22 | } | |
6d2c5146 | 23 | |
013a2942 PB |
24 | /* Returns true if qemu_log() will write somewhere else than stderr |
25 | */ | |
26 | static inline bool qemu_log_separate(void) | |
27 | { | |
28 | return qemu_logfile != NULL && qemu_logfile != stderr; | |
29 | } | |
30 | ||
5726c27f BS |
31 | #define CPU_LOG_TB_OUT_ASM (1 << 0) |
32 | #define CPU_LOG_TB_IN_ASM (1 << 1) | |
33 | #define CPU_LOG_TB_OP (1 << 2) | |
34 | #define CPU_LOG_TB_OP_OPT (1 << 3) | |
35 | #define CPU_LOG_INT (1 << 4) | |
36 | #define CPU_LOG_EXEC (1 << 5) | |
37 | #define CPU_LOG_PCALL (1 << 6) | |
5726c27f BS |
38 | #define CPU_LOG_TB_CPU (1 << 8) |
39 | #define CPU_LOG_RESET (1 << 9) | |
dafdf1ab | 40 | #define LOG_UNIMP (1 << 10) |
e54eba19 | 41 | #define LOG_GUEST_ERROR (1 << 11) |
339aaf5b | 42 | #define CPU_LOG_MMU (1 << 12) |
89a82cd4 | 43 | #define CPU_LOG_TB_NOCHAIN (1 << 13) |
13829020 | 44 | #define CPU_LOG_PAGE (1 << 14) |
be0aa7ac | 45 | /* LOG_TRACE (1 << 15) is defined in log-for-trace.h */ |
5a18407f | 46 | #define CPU_LOG_TB_OP_IND (1 << 16) |
ae765180 | 47 | #define CPU_LOG_TB_FPU (1 << 17) |
5726c27f | 48 | |
1ee73216 RH |
49 | /* Lock output for a series of related logs. Since this is not needed |
50 | * for a single qemu_log / qemu_log_mask / qemu_log_mask_and_addr, we | |
51 | * assume that qemu_loglevel_mask has already been tested, and that | |
52 | * qemu_loglevel is never set when qemu_logfile is unset. | |
53 | */ | |
54 | ||
55 | static inline void qemu_log_lock(void) | |
56 | { | |
57 | qemu_flockfile(qemu_logfile); | |
58 | } | |
59 | ||
60 | static inline void qemu_log_unlock(void) | |
61 | { | |
62 | qemu_funlockfile(qemu_logfile); | |
63 | } | |
64 | ||
6d2c5146 AL |
65 | /* Logging functions: */ |
66 | ||
6d2c5146 AL |
67 | /* vfprintf-like logging function |
68 | */ | |
726f8cbf SW |
69 | static inline void GCC_FMT_ATTR(1, 0) |
70 | qemu_log_vprintf(const char *fmt, va_list va) | |
eeacee4d BS |
71 | { |
72 | if (qemu_logfile) { | |
73 | vfprintf(qemu_logfile, fmt, va); | |
74 | } | |
75 | } | |
6d2c5146 | 76 | |
7ee60623 PM |
77 | /* log only if a bit is set on the current loglevel mask: |
78 | * @mask: bit to check in the mask | |
79 | * @fmt: printf-style format string | |
80 | * @args: optional arguments for format string | |
6d2c5146 | 81 | */ |
7ee60623 PM |
82 | #define qemu_log_mask(MASK, FMT, ...) \ |
83 | do { \ | |
84 | if (unlikely(qemu_loglevel_mask(MASK))) { \ | |
85 | qemu_log(FMT, ## __VA_ARGS__); \ | |
86 | } \ | |
87 | } while (0) | |
6d2c5146 | 88 | |
d977e1c2 AB |
89 | /* log only if a bit is set on the current loglevel mask |
90 | * and we are in the address range we care about: | |
91 | * @mask: bit to check in the mask | |
92 | * @addr: address to check in dfilter | |
93 | * @fmt: printf-style format string | |
94 | * @args: optional arguments for format string | |
95 | */ | |
96 | #define qemu_log_mask_and_addr(MASK, ADDR, FMT, ...) \ | |
97 | do { \ | |
98 | if (unlikely(qemu_loglevel_mask(MASK)) && \ | |
99 | qemu_log_in_addr_range(ADDR)) { \ | |
100 | qemu_log(FMT, ## __VA_ARGS__); \ | |
101 | } \ | |
102 | } while (0) | |
103 | ||
6d2c5146 AL |
104 | /* Maintenance: */ |
105 | ||
5726c27f | 106 | /* define log items */ |
38dad9e5 | 107 | typedef struct QEMULogItem { |
5726c27f BS |
108 | int mask; |
109 | const char *name; | |
110 | const char *help; | |
38dad9e5 | 111 | } QEMULogItem; |
5726c27f | 112 | |
38dad9e5 | 113 | extern const QEMULogItem qemu_log_items[]; |
5726c27f | 114 | |
f2937a33 PB |
115 | void qemu_set_log(int log_flags); |
116 | void qemu_log_needs_buffers(void); | |
daa76aa4 | 117 | void qemu_set_log_filename(const char *filename, Error **errp); |
bd6fee9f | 118 | void qemu_set_dfilter_ranges(const char *ranges, Error **errp); |
3514552e | 119 | bool qemu_log_in_addr_range(uint64_t addr); |
4fde1eba | 120 | int qemu_str_to_log_mask(const char *str); |
6d2c5146 | 121 | |
59a6fa6e PM |
122 | /* Print a usage message listing all the valid logging categories |
123 | * to the specified FILE*. | |
124 | */ | |
125 | void qemu_print_log_usage(FILE *f); | |
126 | ||
99affd1d DL |
127 | /* fflush() the log file */ |
128 | void qemu_log_flush(void); | |
129 | /* Close the log file */ | |
130 | void qemu_log_close(void); | |
131 | ||
79383c9c | 132 | #endif |