15d5314d6SJason Wessel #ifndef _KDB_H
25d5314d6SJason Wessel #define _KDB_H
35d5314d6SJason Wessel
45d5314d6SJason Wessel /*
55d5314d6SJason Wessel * Kernel Debugger Architecture Independent Global Headers
65d5314d6SJason Wessel *
75d5314d6SJason Wessel * This file is subject to the terms and conditions of the GNU General Public
85d5314d6SJason Wessel * License. See the file "COPYING" in the main directory of this archive
95d5314d6SJason Wessel * for more details.
105d5314d6SJason Wessel *
115d5314d6SJason Wessel * Copyright (c) 2000-2007 Silicon Graphics, Inc. All Rights Reserved.
125d5314d6SJason Wessel * Copyright (C) 2000 Stephane Eranian <eranian@hpl.hp.com>
135d5314d6SJason Wessel * Copyright (C) 2009 Jason Wessel <jason.wessel@windriver.com>
145d5314d6SJason Wessel */
155d5314d6SJason Wessel
16c25abcd6SSumit Garg #include <linux/list.h>
17c25abcd6SSumit Garg
189452e977SDaniel Thompson /* Shifted versions of the command enable bits are be used if the command
199452e977SDaniel Thompson * has no arguments (see kdb_check_flags). This allows commands, such as
209452e977SDaniel Thompson * go, to have different permissions depending upon whether it is called
219452e977SDaniel Thompson * with an argument.
229452e977SDaniel Thompson */
239452e977SDaniel Thompson #define KDB_ENABLE_NO_ARGS_SHIFT 10
249452e977SDaniel Thompson
25729043e8SAnton Vorontsov typedef enum {
269452e977SDaniel Thompson KDB_ENABLE_ALL = (1 << 0), /* Enable everything */
279452e977SDaniel Thompson KDB_ENABLE_MEM_READ = (1 << 1),
289452e977SDaniel Thompson KDB_ENABLE_MEM_WRITE = (1 << 2),
299452e977SDaniel Thompson KDB_ENABLE_REG_READ = (1 << 3),
309452e977SDaniel Thompson KDB_ENABLE_REG_WRITE = (1 << 4),
319452e977SDaniel Thompson KDB_ENABLE_INSPECT = (1 << 5),
329452e977SDaniel Thompson KDB_ENABLE_FLOW_CTRL = (1 << 6),
339452e977SDaniel Thompson KDB_ENABLE_SIGNAL = (1 << 7),
349452e977SDaniel Thompson KDB_ENABLE_REBOOT = (1 << 8),
359452e977SDaniel Thompson /* User exposed values stop here, all remaining flags are
369452e977SDaniel Thompson * exclusively used to describe a commands behaviour.
379452e977SDaniel Thompson */
389452e977SDaniel Thompson
399452e977SDaniel Thompson KDB_ENABLE_ALWAYS_SAFE = (1 << 9),
409452e977SDaniel Thompson KDB_ENABLE_MASK = (1 << KDB_ENABLE_NO_ARGS_SHIFT) - 1,
419452e977SDaniel Thompson
429452e977SDaniel Thompson KDB_ENABLE_ALL_NO_ARGS = KDB_ENABLE_ALL << KDB_ENABLE_NO_ARGS_SHIFT,
439452e977SDaniel Thompson KDB_ENABLE_MEM_READ_NO_ARGS = KDB_ENABLE_MEM_READ
449452e977SDaniel Thompson << KDB_ENABLE_NO_ARGS_SHIFT,
459452e977SDaniel Thompson KDB_ENABLE_MEM_WRITE_NO_ARGS = KDB_ENABLE_MEM_WRITE
469452e977SDaniel Thompson << KDB_ENABLE_NO_ARGS_SHIFT,
479452e977SDaniel Thompson KDB_ENABLE_REG_READ_NO_ARGS = KDB_ENABLE_REG_READ
489452e977SDaniel Thompson << KDB_ENABLE_NO_ARGS_SHIFT,
499452e977SDaniel Thompson KDB_ENABLE_REG_WRITE_NO_ARGS = KDB_ENABLE_REG_WRITE
509452e977SDaniel Thompson << KDB_ENABLE_NO_ARGS_SHIFT,
519452e977SDaniel Thompson KDB_ENABLE_INSPECT_NO_ARGS = KDB_ENABLE_INSPECT
529452e977SDaniel Thompson << KDB_ENABLE_NO_ARGS_SHIFT,
539452e977SDaniel Thompson KDB_ENABLE_FLOW_CTRL_NO_ARGS = KDB_ENABLE_FLOW_CTRL
549452e977SDaniel Thompson << KDB_ENABLE_NO_ARGS_SHIFT,
559452e977SDaniel Thompson KDB_ENABLE_SIGNAL_NO_ARGS = KDB_ENABLE_SIGNAL
569452e977SDaniel Thompson << KDB_ENABLE_NO_ARGS_SHIFT,
579452e977SDaniel Thompson KDB_ENABLE_REBOOT_NO_ARGS = KDB_ENABLE_REBOOT
589452e977SDaniel Thompson << KDB_ENABLE_NO_ARGS_SHIFT,
599452e977SDaniel Thompson KDB_ENABLE_ALWAYS_SAFE_NO_ARGS = KDB_ENABLE_ALWAYS_SAFE
609452e977SDaniel Thompson << KDB_ENABLE_NO_ARGS_SHIFT,
619452e977SDaniel Thompson KDB_ENABLE_MASK_NO_ARGS = KDB_ENABLE_MASK << KDB_ENABLE_NO_ARGS_SHIFT,
629452e977SDaniel Thompson
639452e977SDaniel Thompson KDB_REPEAT_NO_ARGS = 0x40000000, /* Repeat the command w/o arguments */
649452e977SDaniel Thompson KDB_REPEAT_WITH_ARGS = 0x80000000, /* Repeat the command with args */
6515a42a9bSAnton Vorontsov } kdb_cmdflags_t;
66729043e8SAnton Vorontsov
67729043e8SAnton Vorontsov typedef int (*kdb_func_t)(int, const char **);
68729043e8SAnton Vorontsov
69c25abcd6SSumit Garg /* The KDB shell command table */
70c25abcd6SSumit Garg typedef struct _kdbtab {
71e868f0a3SSumit Garg char *name; /* Command name */
72e868f0a3SSumit Garg kdb_func_t func; /* Function to execute command */
73e868f0a3SSumit Garg char *usage; /* Usage String for this command */
74e868f0a3SSumit Garg char *help; /* Help message for this command */
75e868f0a3SSumit Garg short minlen; /* Minimum legal # cmd chars required */
76e868f0a3SSumit Garg kdb_cmdflags_t flags; /* Command behaviour flags */
77c25abcd6SSumit Garg struct list_head list_node; /* Command list */
78c25abcd6SSumit Garg } kdbtab_t;
79c25abcd6SSumit Garg
805d5314d6SJason Wessel #ifdef CONFIG_KGDB_KDB
815d5314d6SJason Wessel #include <linux/init.h>
825d5314d6SJason Wessel #include <linux/sched.h>
8360063497SArun Sharma #include <linux/atomic.h>
845d5314d6SJason Wessel
855d5314d6SJason Wessel #define KDB_POLL_FUNC_MAX 5
86f5316b4aSJason Wessel extern int kdb_poll_idx;
875d5314d6SJason Wessel
885d5314d6SJason Wessel /*
895d5314d6SJason Wessel * kdb_initial_cpu is initialized to -1, and is set to the cpu
905d5314d6SJason Wessel * number whenever the kernel debugger is entered.
915d5314d6SJason Wessel */
925d5314d6SJason Wessel extern int kdb_initial_cpu;
935d5314d6SJason Wessel
94f7030bbcSJason Wessel /* Types and messages used for dynamically added kdb shell commands */
95f7030bbcSJason Wessel
96f7030bbcSJason Wessel #define KDB_MAXARGS 16 /* Maximum number of arguments to a function */
97f7030bbcSJason Wessel
98f7030bbcSJason Wessel /* KDB return codes from a command or internal kdb function */
99f7030bbcSJason Wessel #define KDB_NOTFOUND (-1)
100f7030bbcSJason Wessel #define KDB_ARGCOUNT (-2)
101f7030bbcSJason Wessel #define KDB_BADWIDTH (-3)
102f7030bbcSJason Wessel #define KDB_BADRADIX (-4)
103f7030bbcSJason Wessel #define KDB_NOTENV (-5)
104f7030bbcSJason Wessel #define KDB_NOENVVALUE (-6)
105f7030bbcSJason Wessel #define KDB_NOTIMP (-7)
106f7030bbcSJason Wessel #define KDB_ENVFULL (-8)
107f7030bbcSJason Wessel #define KDB_ENVBUFFULL (-9)
108f7030bbcSJason Wessel #define KDB_TOOMANYBPT (-10)
109f7030bbcSJason Wessel #define KDB_TOOMANYDBREGS (-11)
110f7030bbcSJason Wessel #define KDB_DUPBPT (-12)
111f7030bbcSJason Wessel #define KDB_BPTNOTFOUND (-13)
112f7030bbcSJason Wessel #define KDB_BADMODE (-14)
113f7030bbcSJason Wessel #define KDB_BADINT (-15)
114f7030bbcSJason Wessel #define KDB_INVADDRFMT (-16)
115f7030bbcSJason Wessel #define KDB_BADREG (-17)
116f7030bbcSJason Wessel #define KDB_BADCPUNUM (-18)
117f7030bbcSJason Wessel #define KDB_BADLENGTH (-19)
118f7030bbcSJason Wessel #define KDB_NOBP (-20)
119f7030bbcSJason Wessel #define KDB_BADADDR (-21)
120420c2b1bSAnton Vorontsov #define KDB_NOPERM (-22)
121f7030bbcSJason Wessel
1225d5314d6SJason Wessel /*
1235d5314d6SJason Wessel * kdb_diemsg
1245d5314d6SJason Wessel *
1255d5314d6SJason Wessel * Contains a pointer to the last string supplied to the
1265d5314d6SJason Wessel * kernel 'die' panic function.
1275d5314d6SJason Wessel */
1285d5314d6SJason Wessel extern const char *kdb_diemsg;
1295d5314d6SJason Wessel
1305d5314d6SJason Wessel #define KDB_FLAG_EARLYKDB (1 << 0) /* set from boot parameter kdb=early */
1315d5314d6SJason Wessel #define KDB_FLAG_CATASTROPHIC (1 << 1) /* A catastrophic event has occurred */
1325d5314d6SJason Wessel #define KDB_FLAG_CMD_INTERRUPT (1 << 2) /* Previous command was interrupted */
1335d5314d6SJason Wessel #define KDB_FLAG_NOIPI (1 << 3) /* Do not send IPIs */
1345d5314d6SJason Wessel #define KDB_FLAG_NO_CONSOLE (1 << 5) /* No console is available,
1355d5314d6SJason Wessel * kdb is disabled */
1365d5314d6SJason Wessel #define KDB_FLAG_NO_VT_CONSOLE (1 << 6) /* No VT console is available, do
1375d5314d6SJason Wessel * not use keyboard */
1385d5314d6SJason Wessel #define KDB_FLAG_NO_I8042 (1 << 7) /* No i8042 chip is available, do
1395d5314d6SJason Wessel * not use keyboard */
1405d5314d6SJason Wessel
141c893de12SWei Li extern unsigned int kdb_flags; /* Global flags, see kdb_state for per cpu state */
1425d5314d6SJason Wessel
1435d5314d6SJason Wessel extern void kdb_save_flags(void);
1445d5314d6SJason Wessel extern void kdb_restore_flags(void);
1455d5314d6SJason Wessel
1465d5314d6SJason Wessel #define KDB_FLAG(flag) (kdb_flags & KDB_FLAG_##flag)
1475d5314d6SJason Wessel #define KDB_FLAG_SET(flag) ((void)(kdb_flags |= KDB_FLAG_##flag))
1485d5314d6SJason Wessel #define KDB_FLAG_CLEAR(flag) ((void)(kdb_flags &= ~KDB_FLAG_##flag))
1495d5314d6SJason Wessel
1505d5314d6SJason Wessel /*
1515d5314d6SJason Wessel * External entry point for the kernel debugger. The pt_regs
1525d5314d6SJason Wessel * at the time of entry are supplied along with the reason for
1535d5314d6SJason Wessel * entry to the kernel debugger.
1545d5314d6SJason Wessel */
1555d5314d6SJason Wessel
1565d5314d6SJason Wessel typedef enum {
1575d5314d6SJason Wessel KDB_REASON_ENTER = 1, /* KDB_ENTER() trap/fault - regs valid */
1585d5314d6SJason Wessel KDB_REASON_ENTER_SLAVE, /* KDB_ENTER_SLAVE() trap/fault - regs valid */
1595d5314d6SJason Wessel KDB_REASON_BREAK, /* Breakpoint inst. - regs valid */
1605d5314d6SJason Wessel KDB_REASON_DEBUG, /* Debug Fault - regs valid */
1615d5314d6SJason Wessel KDB_REASON_OOPS, /* Kernel Oops - regs valid */
1625d5314d6SJason Wessel KDB_REASON_SWITCH, /* CPU switch - regs valid*/
1635d5314d6SJason Wessel KDB_REASON_KEYBOARD, /* Keyboard entry - regs valid */
1645d5314d6SJason Wessel KDB_REASON_NMI, /* Non-maskable interrupt; regs valid */
1655d5314d6SJason Wessel KDB_REASON_RECURSE, /* Recursive entry to kdb;
1665d5314d6SJason Wessel * regs probably valid */
1675d5314d6SJason Wessel KDB_REASON_SSTEP, /* Single Step trap. - regs valid */
1688daaa5f8SMike Travis KDB_REASON_SYSTEM_NMI, /* In NMI due to SYSTEM cmd; regs valid */
1695d5314d6SJason Wessel } kdb_reason_t;
1705d5314d6SJason Wessel
171f7d4ca8bSDaniel Thompson enum kdb_msgsrc {
172f7d4ca8bSDaniel Thompson KDB_MSGSRC_INTERNAL, /* direct call to kdb_printf() */
173f7d4ca8bSDaniel Thompson KDB_MSGSRC_PRINTK, /* trapped from printk() */
174f7d4ca8bSDaniel Thompson };
175f7d4ca8bSDaniel Thompson
176d37d39aeSJason Wessel extern int kdb_trap_printk;
17734aaff40SPetr Mladek extern int kdb_printf_cpu;
178f7d4ca8bSDaniel Thompson extern __printf(2, 0) int vkdb_printf(enum kdb_msgsrc src, const char *fmt,
179f7d4ca8bSDaniel Thompson va_list args);
180b9075fa9SJoe Perches extern __printf(1, 2) int kdb_printf(const char *, ...);
181b9075fa9SJoe Perches typedef __printf(1, 2) int (*kdb_printf_t)(const char *, ...);
1825d5314d6SJason Wessel
1835d5314d6SJason Wessel extern void kdb_init(int level);
1845d5314d6SJason Wessel
1855d5314d6SJason Wessel /* Access to kdb specific polling devices */
1865d5314d6SJason Wessel typedef int (*get_char_func)(void);
1875d5314d6SJason Wessel extern get_char_func kdb_poll_funcs[];
1885d5314d6SJason Wessel extern int kdb_get_kbd_char(void);
1895d5314d6SJason Wessel
1905d5314d6SJason Wessel static inline
kdb_process_cpu(const struct task_struct * p)1915d5314d6SJason Wessel int kdb_process_cpu(const struct task_struct *p)
1925d5314d6SJason Wessel {
193e558af65SAndy Lutomirski unsigned int cpu = task_cpu(p);
1945d5314d6SJason Wessel if (cpu > num_possible_cpus())
1955d5314d6SJason Wessel cpu = 0;
1965d5314d6SJason Wessel return cpu;
1975d5314d6SJason Wessel }
1985d5314d6SJason Wessel
199*b6464883SDaniel Thompson extern void kdb_send_sig(struct task_struct *p, int sig);
200*b6464883SDaniel Thompson
20191b152aaSJason Wessel #ifdef CONFIG_KALLSYMS
20291b152aaSJason Wessel extern const char *kdb_walk_kallsyms(loff_t *pos);
20391b152aaSJason Wessel #else /* ! CONFIG_KALLSYMS */
kdb_walk_kallsyms(loff_t * pos)20491b152aaSJason Wessel static inline const char *kdb_walk_kallsyms(loff_t *pos)
20591b152aaSJason Wessel {
20691b152aaSJason Wessel return NULL;
20791b152aaSJason Wessel }
20891b152aaSJason Wessel #endif /* ! CONFIG_KALLSYMS */
2095d5314d6SJason Wessel
210f7030bbcSJason Wessel /* Dynamic kdb shell command registration */
211c25abcd6SSumit Garg extern int kdb_register(kdbtab_t *cmd);
212c25abcd6SSumit Garg extern void kdb_unregister(kdbtab_t *cmd);
2135d5314d6SJason Wessel #else /* ! CONFIG_KGDB_KDB */
kdb_printf(const char * fmt,...)214729043e8SAnton Vorontsov static inline __printf(1, 2) int kdb_printf(const char *fmt, ...) { return 0; }
kdb_init(int level)215729043e8SAnton Vorontsov static inline void kdb_init(int level) {}
kdb_register(kdbtab_t * cmd)216c25abcd6SSumit Garg static inline int kdb_register(kdbtab_t *cmd) { return 0; }
kdb_unregister(kdbtab_t * cmd)217c25abcd6SSumit Garg static inline void kdb_unregister(kdbtab_t *cmd) {}
2185d5314d6SJason Wessel #endif /* CONFIG_KGDB_KDB */
2195d5314d6SJason Wessel enum {
2205d5314d6SJason Wessel KDB_NOT_INITIALIZED,
2215d5314d6SJason Wessel KDB_INIT_EARLY,
2225d5314d6SJason Wessel KDB_INIT_FULL,
2235d5314d6SJason Wessel };
22481d44507SJason Wessel
22581d44507SJason Wessel extern int kdbgetintenv(const char *, int *);
22681d44507SJason Wessel extern int kdb_set(int, const char **);
227f64205a4SAaron Tomlin int kdb_lsmod(int argc, const char **argv);
22881d44507SJason Wessel
2295d5314d6SJason Wessel #endif /* !_KDB_H */
230