/* SPDX-License-Identifier: GPL-2.0 */ /* * S/390 debug facility * * Copyright IBM Corp. 1999, 2000 */ #ifndef DEBUG_H #define DEBUG_H #include <linux/string.h> #include <linux/spinlock.h> #include <linux/kernel.h> #include <linux/time.h> #include <linux/refcount.h> #include <uapi/asm/debug.h> #define DEBUG_MAX_LEVEL 6 /* debug levels range from 0 to 6 */ #define DEBUG_OFF_LEVEL -1 /* level where debug is switched off */ #define DEBUG_FLUSH_ALL -1 /* parameter to flush all areas */ #define DEBUG_MAX_VIEWS 10 /* max number of views in proc fs */ #define DEBUG_MAX_NAME_LEN 64 /* max length for a debugfs file name */ #define DEBUG_DEFAULT_LEVEL 3 /* initial debug level */ #define DEBUG_DIR_ROOT "s390dbf" /* name of debug root directory in proc fs */ #define DEBUG_DATA(entry) (char *)(entry + 1) /* data is stored behind */ /* the entry information */ typedef struct __debug_entry debug_entry_t; struct debug_view; typedef struct debug_info { struct debug_info *next; struct debug_info *prev; refcount_t ref_count; spinlock_t lock; int level; int nr_areas; int pages_per_area; int buf_size; int entry_size; debug_entry_t ***areas; int active_area; int *active_pages; int *active_entries; struct dentry *debugfs_root_entry; struct dentry *debugfs_entries[DEBUG_MAX_VIEWS]; struct debug_view *views[DEBUG_MAX_VIEWS]; char name[DEBUG_MAX_NAME_LEN]; umode_t mode; } debug_info_t; typedef int (debug_header_proc_t) (debug_info_t *id, struct debug_view *view, int area, debug_entry_t *entry, char *out_buf); typedef int (debug_format_proc_t) (debug_info_t *id, struct debug_view *view, char *out_buf, const char *in_buf); typedef int (debug_prolog_proc_t) (debug_info_t *id, struct debug_view *view, char *out_buf); typedef int (debug_input_proc_t) (debug_info_t *id, struct debug_view *view, struct file *file, const char __user *user_buf, size_t in_buf_size, loff_t *offset); int debug_dflt_header_fn(debug_info_t *id, struct debug_view *view, int area, debug_entry_t *entry, char *out_buf); struct debug_view { char name[DEBUG_MAX_NAME_LEN]; debug_prolog_proc_t *prolog_proc; debug_header_proc_t *header_proc; debug_format_proc_t *format_proc; debug_input_proc_t *input_proc; void *private_data; }; extern struct debug_view debug_hex_ascii_view; extern struct debug_view debug_raw_view; extern struct debug_view debug_sprintf_view; /* do NOT use the _common functions */ debug_entry_t *debug_event_common(debug_info_t *id, int level, const void *data, int length); debug_entry_t *debug_exception_common(debug_info_t *id, int level, const void *data, int length); /* Debug Feature API: */ debug_info_t *debug_register(const char *name, int pages, int nr_areas, int buf_size); debug_info_t *debug_register_mode(const char *name, int pages, int nr_areas, int buf_size, umode_t mode, uid_t uid, gid_t gid); void debug_unregister(debug_info_t *id); void debug_set_level(debug_info_t *id, int new_level); void debug_set_critical(void); void debug_stop_all(void); static inline bool debug_level_enabled(debug_info_t *id, int level) { return level <= id->level; } static inline debug_entry_t *debug_event(debug_info_t *id, int level, void *data, int length) { if ((!id) || (level > id->level) || (id->pages_per_area == 0)) return NULL; return debug_event_common(id, level, data, length); } static inline debug_entry_t *debug_int_event(debug_info_t *id, int level, unsigned int tag) { unsigned int t = tag; if ((!id) || (level > id->level) || (id->pages_per_area == 0)) return NULL; return debug_event_common(id, level, &t, sizeof(unsigned int)); } static inline debug_entry_t *debug_long_event(debug_info_t *id, int level, unsigned long tag) { unsigned long t = tag; if ((!id) || (level > id->level) || (id->pages_per_area == 0)) return NULL; return debug_event_common(id, level, &t, sizeof(unsigned long)); } static inline debug_entry_t *debug_text_event(debug_info_t *id, int level, const char *txt) { if ((!id) || (level > id->level) || (id->pages_per_area == 0)) return NULL; return debug_event_common(id, level, txt, strlen(txt)); } /* * IMPORTANT: Use "%s" in sprintf format strings with care! Only pointers are * stored in the s390dbf. See Documentation/s390/s390dbf.txt for more details! */ extern debug_entry_t * __debug_sprintf_event(debug_info_t *id, int level, char *string, ...) __attribute__ ((format(printf, 3, 4))); #define debug_sprintf_event(_id, _level, _fmt, ...) \ ({ \ debug_entry_t *__ret; \ debug_info_t *__id = _id; \ int __level = _level; \ \ if ((!__id) || (__level > __id->level)) \ __ret = NULL; \ else \ __ret = __debug_sprintf_event(__id, __level, \ _fmt, ## __VA_ARGS__); \ __ret; \ }) static inline debug_entry_t *debug_exception(debug_info_t *id, int level, void *data, int length) { if ((!id) || (level > id->level) || (id->pages_per_area == 0)) return NULL; return debug_exception_common(id, level, data, length); } static inline debug_entry_t *debug_int_exception(debug_info_t *id, int level, unsigned int tag) { unsigned int t = tag; if ((!id) || (level > id->level) || (id->pages_per_area == 0)) return NULL; return debug_exception_common(id, level, &t, sizeof(unsigned int)); } static inline debug_entry_t *debug_long_exception (debug_info_t *id, int level, unsigned long tag) { unsigned long t = tag; if ((!id) || (level > id->level) || (id->pages_per_area == 0)) return NULL; return debug_exception_common(id, level, &t, sizeof(unsigned long)); } static inline debug_entry_t *debug_text_exception(debug_info_t *id, int level, const char *txt) { if ((!id) || (level > id->level) || (id->pages_per_area == 0)) return NULL; return debug_exception_common(id, level, txt, strlen(txt)); } /* * IMPORTANT: Use "%s" in sprintf format strings with care! Only pointers are * stored in the s390dbf. See Documentation/s390/s390dbf.txt for more details! */ extern debug_entry_t * __debug_sprintf_exception(debug_info_t *id, int level, char *string, ...) __attribute__ ((format(printf, 3, 4))); #define debug_sprintf_exception(_id, _level, _fmt, ...) \ ({ \ debug_entry_t *__ret; \ debug_info_t *__id = _id; \ int __level = _level; \ \ if ((!__id) || (__level > __id->level)) \ __ret = NULL; \ else \ __ret = __debug_sprintf_exception(__id, __level, \ _fmt, ## __VA_ARGS__);\ __ret; \ }) int debug_register_view(debug_info_t *id, struct debug_view *view); int debug_unregister_view(debug_info_t *id, struct debug_view *view); /* define the debug levels: - 0 No debugging output to console or syslog - 1 Log internal errors to syslog, ignore check conditions - 2 Log internal errors and check conditions to syslog - 3 Log internal errors to console, log check conditions to syslog - 4 Log internal errors and check conditions to console - 5 panic on internal errors, log check conditions to console - 6 panic on both, internal errors and check conditions */ #ifndef DEBUG_LEVEL #define DEBUG_LEVEL 4 #endif #define INTERNAL_ERRMSG(x,y...) "E" __FILE__ "%d: " x, __LINE__, y #define INTERNAL_WRNMSG(x,y...) "W" __FILE__ "%d: " x, __LINE__, y #define INTERNAL_INFMSG(x,y...) "I" __FILE__ "%d: " x, __LINE__, y #define INTERNAL_DEBMSG(x,y...) "D" __FILE__ "%d: " x, __LINE__, y #if DEBUG_LEVEL > 0 #define PRINT_DEBUG(x...) printk(KERN_DEBUG PRINTK_HEADER x) #define PRINT_INFO(x...) printk(KERN_INFO PRINTK_HEADER x) #define PRINT_WARN(x...) printk(KERN_WARNING PRINTK_HEADER x) #define PRINT_ERR(x...) printk(KERN_ERR PRINTK_HEADER x) #define PRINT_FATAL(x...) panic(PRINTK_HEADER x) #else #define PRINT_DEBUG(x...) printk(KERN_DEBUG PRINTK_HEADER x) #define PRINT_INFO(x...) printk(KERN_DEBUG PRINTK_HEADER x) #define PRINT_WARN(x...) printk(KERN_DEBUG PRINTK_HEADER x) #define PRINT_ERR(x...) printk(KERN_DEBUG PRINTK_HEADER x) #define PRINT_FATAL(x...) printk(KERN_DEBUG PRINTK_HEADER x) #endif /* DASD_DEBUG */ #endif /* DEBUG_H */
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
fpu | Folder | 0755 |
|
|
trace | Folder | 0755 |
|
|
Kbuild | File | 557 B | 0644 |
|
airq.h | File | 3.02 KB | 0644 |
|
alternative-asm.h | File | 3.07 KB | 0644 |
|
alternative.h | File | 4.99 KB | 0644 |
|
ap.h | File | 9.9 KB | 0644 |
|
appldata.h | File | 1.54 KB | 0644 |
|
archrandom.h | File | 1.17 KB | 0644 |
|
asm-prototypes.h | File | 227 B | 0644 |
|
atomic.h | File | 5.1 KB | 0644 |
|
atomic_ops.h | File | 4.02 KB | 0644 |
|
barrier.h | File | 1.84 KB | 0644 |
|
bitops.h | File | 10.13 KB | 0644 |
|
bug.h | File | 1.49 KB | 0644 |
|
bugs.h | File | 441 B | 0644 |
|
cache.h | File | 387 B | 0644 |
|
ccwdev.h | File | 7.99 KB | 0644 |
|
ccwgroup.h | File | 2.53 KB | 0644 |
|
checksum.h | File | 3.24 KB | 0644 |
|
chpid.h | File | 974 B | 0644 |
|
cio.h | File | 8.01 KB | 0644 |
|
clp.h | File | 1.32 KB | 0644 |
|
cmb.h | File | 425 B | 0644 |
|
cmpxchg.h | File | 1.76 KB | 0644 |
|
compat.h | File | 7.9 KB | 0644 |
|
cpacf.h | File | 16.8 KB | 0644 |
|
cpcmd.h | File | 1.11 KB | 0644 |
|
cpu.h | File | 549 B | 0644 |
|
cpu_mf.h | File | 8.99 KB | 0644 |
|
cpufeature.h | File | 963 B | 0644 |
|
cputime.h | File | 805 B | 0644 |
|
crw.h | File | 1.86 KB | 0644 |
|
css_chars.h | File | 769 B | 0644 |
|
ctl_reg.h | File | 2.89 KB | 0644 |
|
current.h | File | 405 B | 0644 |
|
debug.h | File | 8.1 KB | 0644 |
|
delay.h | File | 721 B | 0644 |
|
diag.h | File | 5.94 KB | 0644 |
|
dis.h | File | 637 B | 0644 |
|
dma-mapping.h | File | 621 B | 0644 |
|
dma.h | File | 456 B | 0644 |
|
eadm.h | File | 2.03 KB | 0644 |
|
ebcdic.h | File | 1.41 KB | 0644 |
|
elf.h | File | 10.36 KB | 0644 |
|
exec.h | File | 269 B | 0644 |
|
extable.h | File | 875 B | 0644 |
|
extmem.h | File | 804 B | 0644 |
|
facility.h | File | 2.44 KB | 0644 |
|
fcx.h | File | 7.91 KB | 0644 |
|
ftrace.h | File | 1.66 KB | 0644 |
|
futex.h | File | 2.09 KB | 0644 |
|
gmap.h | File | 4.93 KB | 0644 |
|
hardirq.h | File | 670 B | 0644 |
|
hugetlb.h | File | 2.87 KB | 0644 |
|
hw_irq.h | File | 249 B | 0644 |
|
idals.h | File | 5.22 KB | 0644 |
|
idle.h | File | 709 B | 0644 |
|
io.h | File | 2.03 KB | 0644 |
|
ipl.h | File | 3.6 KB | 0644 |
|
irq.h | File | 2.55 KB | 0644 |
|
irqflags.h | File | 1.76 KB | 0644 |
|
isc.h | File | 1000 B | 0644 |
|
itcw.h | File | 950 B | 0644 |
|
jump_label.h | File | 1.36 KB | 0644 |
|
kdebug.h | File | 386 B | 0644 |
|
kexec.h | File | 1.32 KB | 0644 |
|
kprobes.h | File | 2.24 KB | 0644 |
|
kvm_host.h | File | 22.24 KB | 0644 |
|
kvm_para.h | File | 5.78 KB | 0644 |
|
linkage.h | File | 633 B | 0644 |
|
livepatch.h | File | 461 B | 0644 |
|
lowcore.h | File | 6.29 KB | 0644 |
|
mmu.h | File | 1.19 KB | 0644 |
|
mmu_context.h | File | 3.84 KB | 0644 |
|
mmzone.h | File | 316 B | 0644 |
|
module.h | File | 802 B | 0644 |
|
nmi.h | File | 3.44 KB | 0644 |
|
nospec-branch.h | File | 342 B | 0644 |
|
nospec-insn.h | File | 3.81 KB | 0644 |
|
numa.h | File | 730 B | 0644 |
|
os_info.h | File | 1.1 KB | 0644 |
|
page-states.h | File | 486 B | 0644 |
|
page.h | File | 5.12 KB | 0644 |
|
pci.h | File | 6.26 KB | 0644 |
|
pci_clp.h | File | 4.25 KB | 0644 |
|
pci_debug.h | File | 608 B | 0644 |
|
pci_dma.h | File | 5.7 KB | 0644 |
|
pci_insn.h | File | 2.59 KB | 0644 |
|
pci_io.h | File | 4.58 KB | 0644 |
|
percpu.h | File | 6.44 KB | 0644 |
|
perf_event.h | File | 2.71 KB | 0644 |
|
pgalloc.h | File | 4.32 KB | 0644 |
|
pgtable.h | File | 47.7 KB | 0644 |
|
pkey.h | File | 4.23 KB | 0644 |
|
preempt.h | File | 3.25 KB | 0644 |
|
processor.h | File | 10.42 KB | 0644 |
|
ptrace.h | File | 5.27 KB | 0644 |
|
qdio.h | File | 11.67 KB | 0644 |
|
reset.h | File | 471 B | 0644 |
|
runtime_instr.h | File | 1.76 KB | 0644 |
|
schid.h | File | 525 B | 0644 |
|
sclp.h | File | 3.38 KB | 0644 |
|
scsw.h | File | 24.1 KB | 0644 |
|
seccomp.h | File | 516 B | 0644 |
|
sections.h | File | 155 B | 0644 |
|
segment.h | File | 93 B | 0644 |
|
serial.h | File | 147 B | 0644 |
|
set_memory.h | File | 779 B | 0644 |
|
setup.h | File | 4.44 KB | 0644 |
|
shmparam.h | File | 285 B | 0644 |
|
signal.h | File | 644 B | 0644 |
|
sigp.h | File | 1.8 KB | 0644 |
|
smp.h | File | 2.45 KB | 0644 |
|
sparsemem.h | File | 214 B | 0644 |
|
spinlock.h | File | 3.53 KB | 0644 |
|
spinlock_types.h | File | 437 B | 0644 |
|
stp.h | File | 1.26 KB | 0644 |
|
string.h | File | 4.5 KB | 0644 |
|
switch_to.h | File | 1.37 KB | 0644 |
|
syscall.h | File | 2.63 KB | 0644 |
|
sysinfo.h | File | 4.22 KB | 0644 |
|
termios.h | File | 685 B | 0644 |
|
thread_info.h | File | 3.15 KB | 0644 |
|
timex.h | File | 6.15 KB | 0644 |
|
tlb.h | File | 5.71 KB | 0644 |
|
tlbflush.h | File | 3.52 KB | 0644 |
|
topology.h | File | 2.69 KB | 0644 |
|
uaccess.h | File | 6.57 KB | 0644 |
|
unistd.h | File | 1.03 KB | 0644 |
|
uprobes.h | File | 588 B | 0644 |
|
user.h | File | 3.3 KB | 0644 |
|
vdso.h | File | 1.8 KB | 0644 |
|
vga.h | File | 170 B | 0644 |
|
vtime.h | File | 182 B | 0644 |
|
vtimer.h | File | 866 B | 0644 |
|
vx-insn.h | File | 10.66 KB | 0644 |
|
xor.h | File | 454 B | 0644 |
|