sh_eth: fix EESIPR values for SH77{34|63}
[linux/fpc-iii.git] / kernel / debug / kdb / kdb_main.c
blobca183919d3027a7b3d6792ffc07de0c55fbc920f
1 /*
2 * Kernel Debugger Architecture Independent Main Code
4 * This file is subject to the terms and conditions of the GNU General Public
5 * License. See the file "COPYING" in the main directory of this archive
6 * for more details.
8 * Copyright (C) 1999-2004 Silicon Graphics, Inc. All Rights Reserved.
9 * Copyright (C) 2000 Stephane Eranian <eranian@hpl.hp.com>
10 * Xscale (R) modifications copyright (C) 2003 Intel Corporation.
11 * Copyright (c) 2009 Wind River Systems, Inc. All Rights Reserved.
14 #include <linux/ctype.h>
15 #include <linux/types.h>
16 #include <linux/string.h>
17 #include <linux/kernel.h>
18 #include <linux/kmsg_dump.h>
19 #include <linux/reboot.h>
20 #include <linux/sched.h>
21 #include <linux/sysrq.h>
22 #include <linux/smp.h>
23 #include <linux/utsname.h>
24 #include <linux/vmalloc.h>
25 #include <linux/atomic.h>
26 #include <linux/module.h>
27 #include <linux/moduleparam.h>
28 #include <linux/mm.h>
29 #include <linux/init.h>
30 #include <linux/kallsyms.h>
31 #include <linux/kgdb.h>
32 #include <linux/kdb.h>
33 #include <linux/notifier.h>
34 #include <linux/interrupt.h>
35 #include <linux/delay.h>
36 #include <linux/nmi.h>
37 #include <linux/time.h>
38 #include <linux/ptrace.h>
39 #include <linux/sysctl.h>
40 #include <linux/cpu.h>
41 #include <linux/kdebug.h>
42 #include <linux/proc_fs.h>
43 #include <linux/uaccess.h>
44 #include <linux/slab.h>
45 #include "kdb_private.h"
47 #undef MODULE_PARAM_PREFIX
48 #define MODULE_PARAM_PREFIX "kdb."
50 static int kdb_cmd_enabled = CONFIG_KDB_DEFAULT_ENABLE;
51 module_param_named(cmd_enable, kdb_cmd_enabled, int, 0600);
53 char kdb_grep_string[KDB_GREP_STRLEN];
54 int kdb_grepping_flag;
55 EXPORT_SYMBOL(kdb_grepping_flag);
56 int kdb_grep_leading;
57 int kdb_grep_trailing;
60 * Kernel debugger state flags
62 int kdb_flags;
65 * kdb_lock protects updates to kdb_initial_cpu. Used to
66 * single thread processors through the kernel debugger.
68 int kdb_initial_cpu = -1; /* cpu number that owns kdb */
69 int kdb_nextline = 1;
70 int kdb_state; /* General KDB state */
72 struct task_struct *kdb_current_task;
73 EXPORT_SYMBOL(kdb_current_task);
74 struct pt_regs *kdb_current_regs;
76 const char *kdb_diemsg;
77 static int kdb_go_count;
78 #ifdef CONFIG_KDB_CONTINUE_CATASTROPHIC
79 static unsigned int kdb_continue_catastrophic =
80 CONFIG_KDB_CONTINUE_CATASTROPHIC;
81 #else
82 static unsigned int kdb_continue_catastrophic;
83 #endif
85 /* kdb_commands describes the available commands. */
86 static kdbtab_t *kdb_commands;
87 #define KDB_BASE_CMD_MAX 50
88 static int kdb_max_commands = KDB_BASE_CMD_MAX;
89 static kdbtab_t kdb_base_commands[KDB_BASE_CMD_MAX];
90 #define for_each_kdbcmd(cmd, num) \
91 for ((cmd) = kdb_base_commands, (num) = 0; \
92 num < kdb_max_commands; \
93 num++, num == KDB_BASE_CMD_MAX ? cmd = kdb_commands : cmd++)
95 typedef struct _kdbmsg {
96 int km_diag; /* kdb diagnostic */
97 char *km_msg; /* Corresponding message text */
98 } kdbmsg_t;
100 #define KDBMSG(msgnum, text) \
101 { KDB_##msgnum, text }
103 static kdbmsg_t kdbmsgs[] = {
104 KDBMSG(NOTFOUND, "Command Not Found"),
105 KDBMSG(ARGCOUNT, "Improper argument count, see usage."),
106 KDBMSG(BADWIDTH, "Illegal value for BYTESPERWORD use 1, 2, 4 or 8, "
107 "8 is only allowed on 64 bit systems"),
108 KDBMSG(BADRADIX, "Illegal value for RADIX use 8, 10 or 16"),
109 KDBMSG(NOTENV, "Cannot find environment variable"),
110 KDBMSG(NOENVVALUE, "Environment variable should have value"),
111 KDBMSG(NOTIMP, "Command not implemented"),
112 KDBMSG(ENVFULL, "Environment full"),
113 KDBMSG(ENVBUFFULL, "Environment buffer full"),
114 KDBMSG(TOOMANYBPT, "Too many breakpoints defined"),
115 #ifdef CONFIG_CPU_XSCALE
116 KDBMSG(TOOMANYDBREGS, "More breakpoints than ibcr registers defined"),
117 #else
118 KDBMSG(TOOMANYDBREGS, "More breakpoints than db registers defined"),
119 #endif
120 KDBMSG(DUPBPT, "Duplicate breakpoint address"),
121 KDBMSG(BPTNOTFOUND, "Breakpoint not found"),
122 KDBMSG(BADMODE, "Invalid IDMODE"),
123 KDBMSG(BADINT, "Illegal numeric value"),
124 KDBMSG(INVADDRFMT, "Invalid symbolic address format"),
125 KDBMSG(BADREG, "Invalid register name"),
126 KDBMSG(BADCPUNUM, "Invalid cpu number"),
127 KDBMSG(BADLENGTH, "Invalid length field"),
128 KDBMSG(NOBP, "No Breakpoint exists"),
129 KDBMSG(BADADDR, "Invalid address"),
130 KDBMSG(NOPERM, "Permission denied"),
132 #undef KDBMSG
134 static const int __nkdb_err = ARRAY_SIZE(kdbmsgs);
138 * Initial environment. This is all kept static and local to
139 * this file. We don't want to rely on the memory allocation
140 * mechanisms in the kernel, so we use a very limited allocate-only
141 * heap for new and altered environment variables. The entire
142 * environment is limited to a fixed number of entries (add more
143 * to __env[] if required) and a fixed amount of heap (add more to
144 * KDB_ENVBUFSIZE if required).
147 static char *__env[] = {
148 #if defined(CONFIG_SMP)
149 "PROMPT=[%d]kdb> ",
150 #else
151 "PROMPT=kdb> ",
152 #endif
153 "MOREPROMPT=more> ",
154 "RADIX=16",
155 "MDCOUNT=8", /* lines of md output */
156 KDB_PLATFORM_ENV,
157 "DTABCOUNT=30",
158 "NOSECT=1",
159 (char *)0,
160 (char *)0,
161 (char *)0,
162 (char *)0,
163 (char *)0,
164 (char *)0,
165 (char *)0,
166 (char *)0,
167 (char *)0,
168 (char *)0,
169 (char *)0,
170 (char *)0,
171 (char *)0,
172 (char *)0,
173 (char *)0,
174 (char *)0,
175 (char *)0,
176 (char *)0,
177 (char *)0,
178 (char *)0,
179 (char *)0,
180 (char *)0,
181 (char *)0,
182 (char *)0,
185 static const int __nenv = ARRAY_SIZE(__env);
187 struct task_struct *kdb_curr_task(int cpu)
189 struct task_struct *p = curr_task(cpu);
190 #ifdef _TIF_MCA_INIT
191 if ((task_thread_info(p)->flags & _TIF_MCA_INIT) && KDB_TSK(cpu))
192 p = krp->p;
193 #endif
194 return p;
198 * Check whether the flags of the current command and the permissions
199 * of the kdb console has allow a command to be run.
201 static inline bool kdb_check_flags(kdb_cmdflags_t flags, int permissions,
202 bool no_args)
204 /* permissions comes from userspace so needs massaging slightly */
205 permissions &= KDB_ENABLE_MASK;
206 permissions |= KDB_ENABLE_ALWAYS_SAFE;
208 /* some commands change group when launched with no arguments */
209 if (no_args)
210 permissions |= permissions << KDB_ENABLE_NO_ARGS_SHIFT;
212 flags |= KDB_ENABLE_ALL;
214 return permissions & flags;
218 * kdbgetenv - This function will return the character string value of
219 * an environment variable.
220 * Parameters:
221 * match A character string representing an environment variable.
222 * Returns:
223 * NULL No environment variable matches 'match'
224 * char* Pointer to string value of environment variable.
226 char *kdbgetenv(const char *match)
228 char **ep = __env;
229 int matchlen = strlen(match);
230 int i;
232 for (i = 0; i < __nenv; i++) {
233 char *e = *ep++;
235 if (!e)
236 continue;
238 if ((strncmp(match, e, matchlen) == 0)
239 && ((e[matchlen] == '\0')
240 || (e[matchlen] == '='))) {
241 char *cp = strchr(e, '=');
242 return cp ? ++cp : "";
245 return NULL;
249 * kdballocenv - This function is used to allocate bytes for
250 * environment entries.
251 * Parameters:
252 * match A character string representing a numeric value
253 * Outputs:
254 * *value the unsigned long representation of the env variable 'match'
255 * Returns:
256 * Zero on success, a kdb diagnostic on failure.
257 * Remarks:
258 * We use a static environment buffer (envbuffer) to hold the values
259 * of dynamically generated environment variables (see kdb_set). Buffer
260 * space once allocated is never free'd, so over time, the amount of space
261 * (currently 512 bytes) will be exhausted if env variables are changed
262 * frequently.
264 static char *kdballocenv(size_t bytes)
266 #define KDB_ENVBUFSIZE 512
267 static char envbuffer[KDB_ENVBUFSIZE];
268 static int envbufsize;
269 char *ep = NULL;
271 if ((KDB_ENVBUFSIZE - envbufsize) >= bytes) {
272 ep = &envbuffer[envbufsize];
273 envbufsize += bytes;
275 return ep;
279 * kdbgetulenv - This function will return the value of an unsigned
280 * long-valued environment variable.
281 * Parameters:
282 * match A character string representing a numeric value
283 * Outputs:
284 * *value the unsigned long represntation of the env variable 'match'
285 * Returns:
286 * Zero on success, a kdb diagnostic on failure.
288 static int kdbgetulenv(const char *match, unsigned long *value)
290 char *ep;
292 ep = kdbgetenv(match);
293 if (!ep)
294 return KDB_NOTENV;
295 if (strlen(ep) == 0)
296 return KDB_NOENVVALUE;
298 *value = simple_strtoul(ep, NULL, 0);
300 return 0;
304 * kdbgetintenv - This function will return the value of an
305 * integer-valued environment variable.
306 * Parameters:
307 * match A character string representing an integer-valued env variable
308 * Outputs:
309 * *value the integer representation of the environment variable 'match'
310 * Returns:
311 * Zero on success, a kdb diagnostic on failure.
313 int kdbgetintenv(const char *match, int *value)
315 unsigned long val;
316 int diag;
318 diag = kdbgetulenv(match, &val);
319 if (!diag)
320 *value = (int) val;
321 return diag;
325 * kdbgetularg - This function will convert a numeric string into an
326 * unsigned long value.
327 * Parameters:
328 * arg A character string representing a numeric value
329 * Outputs:
330 * *value the unsigned long represntation of arg.
331 * Returns:
332 * Zero on success, a kdb diagnostic on failure.
334 int kdbgetularg(const char *arg, unsigned long *value)
336 char *endp;
337 unsigned long val;
339 val = simple_strtoul(arg, &endp, 0);
341 if (endp == arg) {
343 * Also try base 16, for us folks too lazy to type the
344 * leading 0x...
346 val = simple_strtoul(arg, &endp, 16);
347 if (endp == arg)
348 return KDB_BADINT;
351 *value = val;
353 return 0;
356 int kdbgetu64arg(const char *arg, u64 *value)
358 char *endp;
359 u64 val;
361 val = simple_strtoull(arg, &endp, 0);
363 if (endp == arg) {
365 val = simple_strtoull(arg, &endp, 16);
366 if (endp == arg)
367 return KDB_BADINT;
370 *value = val;
372 return 0;
376 * kdb_set - This function implements the 'set' command. Alter an
377 * existing environment variable or create a new one.
379 int kdb_set(int argc, const char **argv)
381 int i;
382 char *ep;
383 size_t varlen, vallen;
386 * we can be invoked two ways:
387 * set var=value argv[1]="var", argv[2]="value"
388 * set var = value argv[1]="var", argv[2]="=", argv[3]="value"
389 * - if the latter, shift 'em down.
391 if (argc == 3) {
392 argv[2] = argv[3];
393 argc--;
396 if (argc != 2)
397 return KDB_ARGCOUNT;
400 * Check for internal variables
402 if (strcmp(argv[1], "KDBDEBUG") == 0) {
403 unsigned int debugflags;
404 char *cp;
406 debugflags = simple_strtoul(argv[2], &cp, 0);
407 if (cp == argv[2] || debugflags & ~KDB_DEBUG_FLAG_MASK) {
408 kdb_printf("kdb: illegal debug flags '%s'\n",
409 argv[2]);
410 return 0;
412 kdb_flags = (kdb_flags &
413 ~(KDB_DEBUG_FLAG_MASK << KDB_DEBUG_FLAG_SHIFT))
414 | (debugflags << KDB_DEBUG_FLAG_SHIFT);
416 return 0;
420 * Tokenizer squashed the '=' sign. argv[1] is variable
421 * name, argv[2] = value.
423 varlen = strlen(argv[1]);
424 vallen = strlen(argv[2]);
425 ep = kdballocenv(varlen + vallen + 2);
426 if (ep == (char *)0)
427 return KDB_ENVBUFFULL;
429 sprintf(ep, "%s=%s", argv[1], argv[2]);
431 ep[varlen+vallen+1] = '\0';
433 for (i = 0; i < __nenv; i++) {
434 if (__env[i]
435 && ((strncmp(__env[i], argv[1], varlen) == 0)
436 && ((__env[i][varlen] == '\0')
437 || (__env[i][varlen] == '=')))) {
438 __env[i] = ep;
439 return 0;
444 * Wasn't existing variable. Fit into slot.
446 for (i = 0; i < __nenv-1; i++) {
447 if (__env[i] == (char *)0) {
448 __env[i] = ep;
449 return 0;
453 return KDB_ENVFULL;
456 static int kdb_check_regs(void)
458 if (!kdb_current_regs) {
459 kdb_printf("No current kdb registers."
460 " You may need to select another task\n");
461 return KDB_BADREG;
463 return 0;
467 * kdbgetaddrarg - This function is responsible for parsing an
468 * address-expression and returning the value of the expression,
469 * symbol name, and offset to the caller.
471 * The argument may consist of a numeric value (decimal or
472 * hexidecimal), a symbol name, a register name (preceded by the
473 * percent sign), an environment variable with a numeric value
474 * (preceded by a dollar sign) or a simple arithmetic expression
475 * consisting of a symbol name, +/-, and a numeric constant value
476 * (offset).
477 * Parameters:
478 * argc - count of arguments in argv
479 * argv - argument vector
480 * *nextarg - index to next unparsed argument in argv[]
481 * regs - Register state at time of KDB entry
482 * Outputs:
483 * *value - receives the value of the address-expression
484 * *offset - receives the offset specified, if any
485 * *name - receives the symbol name, if any
486 * *nextarg - index to next unparsed argument in argv[]
487 * Returns:
488 * zero is returned on success, a kdb diagnostic code is
489 * returned on error.
491 int kdbgetaddrarg(int argc, const char **argv, int *nextarg,
492 unsigned long *value, long *offset,
493 char **name)
495 unsigned long addr;
496 unsigned long off = 0;
497 int positive;
498 int diag;
499 int found = 0;
500 char *symname;
501 char symbol = '\0';
502 char *cp;
503 kdb_symtab_t symtab;
506 * If the enable flags prohibit both arbitrary memory access
507 * and flow control then there are no reasonable grounds to
508 * provide symbol lookup.
510 if (!kdb_check_flags(KDB_ENABLE_MEM_READ | KDB_ENABLE_FLOW_CTRL,
511 kdb_cmd_enabled, false))
512 return KDB_NOPERM;
515 * Process arguments which follow the following syntax:
517 * symbol | numeric-address [+/- numeric-offset]
518 * %register
519 * $environment-variable
522 if (*nextarg > argc)
523 return KDB_ARGCOUNT;
525 symname = (char *)argv[*nextarg];
528 * If there is no whitespace between the symbol
529 * or address and the '+' or '-' symbols, we
530 * remember the character and replace it with a
531 * null so the symbol/value can be properly parsed
533 cp = strpbrk(symname, "+-");
534 if (cp != NULL) {
535 symbol = *cp;
536 *cp++ = '\0';
539 if (symname[0] == '$') {
540 diag = kdbgetulenv(&symname[1], &addr);
541 if (diag)
542 return diag;
543 } else if (symname[0] == '%') {
544 diag = kdb_check_regs();
545 if (diag)
546 return diag;
547 /* Implement register values with % at a later time as it is
548 * arch optional.
550 return KDB_NOTIMP;
551 } else {
552 found = kdbgetsymval(symname, &symtab);
553 if (found) {
554 addr = symtab.sym_start;
555 } else {
556 diag = kdbgetularg(argv[*nextarg], &addr);
557 if (diag)
558 return diag;
562 if (!found)
563 found = kdbnearsym(addr, &symtab);
565 (*nextarg)++;
567 if (name)
568 *name = symname;
569 if (value)
570 *value = addr;
571 if (offset && name && *name)
572 *offset = addr - symtab.sym_start;
574 if ((*nextarg > argc)
575 && (symbol == '\0'))
576 return 0;
579 * check for +/- and offset
582 if (symbol == '\0') {
583 if ((argv[*nextarg][0] != '+')
584 && (argv[*nextarg][0] != '-')) {
586 * Not our argument. Return.
588 return 0;
589 } else {
590 positive = (argv[*nextarg][0] == '+');
591 (*nextarg)++;
593 } else
594 positive = (symbol == '+');
597 * Now there must be an offset!
599 if ((*nextarg > argc)
600 && (symbol == '\0')) {
601 return KDB_INVADDRFMT;
604 if (!symbol) {
605 cp = (char *)argv[*nextarg];
606 (*nextarg)++;
609 diag = kdbgetularg(cp, &off);
610 if (diag)
611 return diag;
613 if (!positive)
614 off = -off;
616 if (offset)
617 *offset += off;
619 if (value)
620 *value += off;
622 return 0;
625 static void kdb_cmderror(int diag)
627 int i;
629 if (diag >= 0) {
630 kdb_printf("no error detected (diagnostic is %d)\n", diag);
631 return;
634 for (i = 0; i < __nkdb_err; i++) {
635 if (kdbmsgs[i].km_diag == diag) {
636 kdb_printf("diag: %d: %s\n", diag, kdbmsgs[i].km_msg);
637 return;
641 kdb_printf("Unknown diag %d\n", -diag);
645 * kdb_defcmd, kdb_defcmd2 - This function implements the 'defcmd'
646 * command which defines one command as a set of other commands,
647 * terminated by endefcmd. kdb_defcmd processes the initial
648 * 'defcmd' command, kdb_defcmd2 is invoked from kdb_parse for
649 * the following commands until 'endefcmd'.
650 * Inputs:
651 * argc argument count
652 * argv argument vector
653 * Returns:
654 * zero for success, a kdb diagnostic if error
656 struct defcmd_set {
657 int count;
658 int usable;
659 char *name;
660 char *usage;
661 char *help;
662 char **command;
664 static struct defcmd_set *defcmd_set;
665 static int defcmd_set_count;
666 static int defcmd_in_progress;
668 /* Forward references */
669 static int kdb_exec_defcmd(int argc, const char **argv);
671 static int kdb_defcmd2(const char *cmdstr, const char *argv0)
673 struct defcmd_set *s = defcmd_set + defcmd_set_count - 1;
674 char **save_command = s->command;
675 if (strcmp(argv0, "endefcmd") == 0) {
676 defcmd_in_progress = 0;
677 if (!s->count)
678 s->usable = 0;
679 if (s->usable)
680 /* macros are always safe because when executed each
681 * internal command re-enters kdb_parse() and is
682 * safety checked individually.
684 kdb_register_flags(s->name, kdb_exec_defcmd, s->usage,
685 s->help, 0,
686 KDB_ENABLE_ALWAYS_SAFE);
687 return 0;
689 if (!s->usable)
690 return KDB_NOTIMP;
691 s->command = kzalloc((s->count + 1) * sizeof(*(s->command)), GFP_KDB);
692 if (!s->command) {
693 kdb_printf("Could not allocate new kdb_defcmd table for %s\n",
694 cmdstr);
695 s->usable = 0;
696 return KDB_NOTIMP;
698 memcpy(s->command, save_command, s->count * sizeof(*(s->command)));
699 s->command[s->count++] = kdb_strdup(cmdstr, GFP_KDB);
700 kfree(save_command);
701 return 0;
704 static int kdb_defcmd(int argc, const char **argv)
706 struct defcmd_set *save_defcmd_set = defcmd_set, *s;
707 if (defcmd_in_progress) {
708 kdb_printf("kdb: nested defcmd detected, assuming missing "
709 "endefcmd\n");
710 kdb_defcmd2("endefcmd", "endefcmd");
712 if (argc == 0) {
713 int i;
714 for (s = defcmd_set; s < defcmd_set + defcmd_set_count; ++s) {
715 kdb_printf("defcmd %s \"%s\" \"%s\"\n", s->name,
716 s->usage, s->help);
717 for (i = 0; i < s->count; ++i)
718 kdb_printf("%s", s->command[i]);
719 kdb_printf("endefcmd\n");
721 return 0;
723 if (argc != 3)
724 return KDB_ARGCOUNT;
725 if (in_dbg_master()) {
726 kdb_printf("Command only available during kdb_init()\n");
727 return KDB_NOTIMP;
729 defcmd_set = kmalloc((defcmd_set_count + 1) * sizeof(*defcmd_set),
730 GFP_KDB);
731 if (!defcmd_set)
732 goto fail_defcmd;
733 memcpy(defcmd_set, save_defcmd_set,
734 defcmd_set_count * sizeof(*defcmd_set));
735 s = defcmd_set + defcmd_set_count;
736 memset(s, 0, sizeof(*s));
737 s->usable = 1;
738 s->name = kdb_strdup(argv[1], GFP_KDB);
739 if (!s->name)
740 goto fail_name;
741 s->usage = kdb_strdup(argv[2], GFP_KDB);
742 if (!s->usage)
743 goto fail_usage;
744 s->help = kdb_strdup(argv[3], GFP_KDB);
745 if (!s->help)
746 goto fail_help;
747 if (s->usage[0] == '"') {
748 strcpy(s->usage, argv[2]+1);
749 s->usage[strlen(s->usage)-1] = '\0';
751 if (s->help[0] == '"') {
752 strcpy(s->help, argv[3]+1);
753 s->help[strlen(s->help)-1] = '\0';
755 ++defcmd_set_count;
756 defcmd_in_progress = 1;
757 kfree(save_defcmd_set);
758 return 0;
759 fail_help:
760 kfree(s->usage);
761 fail_usage:
762 kfree(s->name);
763 fail_name:
764 kfree(defcmd_set);
765 fail_defcmd:
766 kdb_printf("Could not allocate new defcmd_set entry for %s\n", argv[1]);
767 defcmd_set = save_defcmd_set;
768 return KDB_NOTIMP;
772 * kdb_exec_defcmd - Execute the set of commands associated with this
773 * defcmd name.
774 * Inputs:
775 * argc argument count
776 * argv argument vector
777 * Returns:
778 * zero for success, a kdb diagnostic if error
780 static int kdb_exec_defcmd(int argc, const char **argv)
782 int i, ret;
783 struct defcmd_set *s;
784 if (argc != 0)
785 return KDB_ARGCOUNT;
786 for (s = defcmd_set, i = 0; i < defcmd_set_count; ++i, ++s) {
787 if (strcmp(s->name, argv[0]) == 0)
788 break;
790 if (i == defcmd_set_count) {
791 kdb_printf("kdb_exec_defcmd: could not find commands for %s\n",
792 argv[0]);
793 return KDB_NOTIMP;
795 for (i = 0; i < s->count; ++i) {
796 /* Recursive use of kdb_parse, do not use argv after
797 * this point */
798 argv = NULL;
799 kdb_printf("[%s]kdb> %s\n", s->name, s->command[i]);
800 ret = kdb_parse(s->command[i]);
801 if (ret)
802 return ret;
804 return 0;
807 /* Command history */
808 #define KDB_CMD_HISTORY_COUNT 32
809 #define CMD_BUFLEN 200 /* kdb_printf: max printline
810 * size == 256 */
811 static unsigned int cmd_head, cmd_tail;
812 static unsigned int cmdptr;
813 static char cmd_hist[KDB_CMD_HISTORY_COUNT][CMD_BUFLEN];
814 static char cmd_cur[CMD_BUFLEN];
817 * The "str" argument may point to something like | grep xyz
819 static void parse_grep(const char *str)
821 int len;
822 char *cp = (char *)str, *cp2;
824 /* sanity check: we should have been called with the \ first */
825 if (*cp != '|')
826 return;
827 cp++;
828 while (isspace(*cp))
829 cp++;
830 if (strncmp(cp, "grep ", 5)) {
831 kdb_printf("invalid 'pipe', see grephelp\n");
832 return;
834 cp += 5;
835 while (isspace(*cp))
836 cp++;
837 cp2 = strchr(cp, '\n');
838 if (cp2)
839 *cp2 = '\0'; /* remove the trailing newline */
840 len = strlen(cp);
841 if (len == 0) {
842 kdb_printf("invalid 'pipe', see grephelp\n");
843 return;
845 /* now cp points to a nonzero length search string */
846 if (*cp == '"') {
847 /* allow it be "x y z" by removing the "'s - there must
848 be two of them */
849 cp++;
850 cp2 = strchr(cp, '"');
851 if (!cp2) {
852 kdb_printf("invalid quoted string, see grephelp\n");
853 return;
855 *cp2 = '\0'; /* end the string where the 2nd " was */
857 kdb_grep_leading = 0;
858 if (*cp == '^') {
859 kdb_grep_leading = 1;
860 cp++;
862 len = strlen(cp);
863 kdb_grep_trailing = 0;
864 if (*(cp+len-1) == '$') {
865 kdb_grep_trailing = 1;
866 *(cp+len-1) = '\0';
868 len = strlen(cp);
869 if (!len)
870 return;
871 if (len >= KDB_GREP_STRLEN) {
872 kdb_printf("search string too long\n");
873 return;
875 strcpy(kdb_grep_string, cp);
876 kdb_grepping_flag++;
877 return;
881 * kdb_parse - Parse the command line, search the command table for a
882 * matching command and invoke the command function. This
883 * function may be called recursively, if it is, the second call
884 * will overwrite argv and cbuf. It is the caller's
885 * responsibility to save their argv if they recursively call
886 * kdb_parse().
887 * Parameters:
888 * cmdstr The input command line to be parsed.
889 * regs The registers at the time kdb was entered.
890 * Returns:
891 * Zero for success, a kdb diagnostic if failure.
892 * Remarks:
893 * Limited to 20 tokens.
895 * Real rudimentary tokenization. Basically only whitespace
896 * is considered a token delimeter (but special consideration
897 * is taken of the '=' sign as used by the 'set' command).
899 * The algorithm used to tokenize the input string relies on
900 * there being at least one whitespace (or otherwise useless)
901 * character between tokens as the character immediately following
902 * the token is altered in-place to a null-byte to terminate the
903 * token string.
906 #define MAXARGC 20
908 int kdb_parse(const char *cmdstr)
910 static char *argv[MAXARGC];
911 static int argc;
912 static char cbuf[CMD_BUFLEN+2];
913 char *cp;
914 char *cpp, quoted;
915 kdbtab_t *tp;
916 int i, escaped, ignore_errors = 0, check_grep = 0;
919 * First tokenize the command string.
921 cp = (char *)cmdstr;
923 if (KDB_FLAG(CMD_INTERRUPT)) {
924 /* Previous command was interrupted, newline must not
925 * repeat the command */
926 KDB_FLAG_CLEAR(CMD_INTERRUPT);
927 KDB_STATE_SET(PAGER);
928 argc = 0; /* no repeat */
931 if (*cp != '\n' && *cp != '\0') {
932 argc = 0;
933 cpp = cbuf;
934 while (*cp) {
935 /* skip whitespace */
936 while (isspace(*cp))
937 cp++;
938 if ((*cp == '\0') || (*cp == '\n') ||
939 (*cp == '#' && !defcmd_in_progress))
940 break;
941 /* special case: check for | grep pattern */
942 if (*cp == '|') {
943 check_grep++;
944 break;
946 if (cpp >= cbuf + CMD_BUFLEN) {
947 kdb_printf("kdb_parse: command buffer "
948 "overflow, command ignored\n%s\n",
949 cmdstr);
950 return KDB_NOTFOUND;
952 if (argc >= MAXARGC - 1) {
953 kdb_printf("kdb_parse: too many arguments, "
954 "command ignored\n%s\n", cmdstr);
955 return KDB_NOTFOUND;
957 argv[argc++] = cpp;
958 escaped = 0;
959 quoted = '\0';
960 /* Copy to next unquoted and unescaped
961 * whitespace or '=' */
962 while (*cp && *cp != '\n' &&
963 (escaped || quoted || !isspace(*cp))) {
964 if (cpp >= cbuf + CMD_BUFLEN)
965 break;
966 if (escaped) {
967 escaped = 0;
968 *cpp++ = *cp++;
969 continue;
971 if (*cp == '\\') {
972 escaped = 1;
973 ++cp;
974 continue;
976 if (*cp == quoted)
977 quoted = '\0';
978 else if (*cp == '\'' || *cp == '"')
979 quoted = *cp;
980 *cpp = *cp++;
981 if (*cpp == '=' && !quoted)
982 break;
983 ++cpp;
985 *cpp++ = '\0'; /* Squash a ws or '=' character */
988 if (!argc)
989 return 0;
990 if (check_grep)
991 parse_grep(cp);
992 if (defcmd_in_progress) {
993 int result = kdb_defcmd2(cmdstr, argv[0]);
994 if (!defcmd_in_progress) {
995 argc = 0; /* avoid repeat on endefcmd */
996 *(argv[0]) = '\0';
998 return result;
1000 if (argv[0][0] == '-' && argv[0][1] &&
1001 (argv[0][1] < '0' || argv[0][1] > '9')) {
1002 ignore_errors = 1;
1003 ++argv[0];
1006 for_each_kdbcmd(tp, i) {
1007 if (tp->cmd_name) {
1009 * If this command is allowed to be abbreviated,
1010 * check to see if this is it.
1013 if (tp->cmd_minlen
1014 && (strlen(argv[0]) <= tp->cmd_minlen)) {
1015 if (strncmp(argv[0],
1016 tp->cmd_name,
1017 tp->cmd_minlen) == 0) {
1018 break;
1022 if (strcmp(argv[0], tp->cmd_name) == 0)
1023 break;
1028 * If we don't find a command by this name, see if the first
1029 * few characters of this match any of the known commands.
1030 * e.g., md1c20 should match md.
1032 if (i == kdb_max_commands) {
1033 for_each_kdbcmd(tp, i) {
1034 if (tp->cmd_name) {
1035 if (strncmp(argv[0],
1036 tp->cmd_name,
1037 strlen(tp->cmd_name)) == 0) {
1038 break;
1044 if (i < kdb_max_commands) {
1045 int result;
1047 if (!kdb_check_flags(tp->cmd_flags, kdb_cmd_enabled, argc <= 1))
1048 return KDB_NOPERM;
1050 KDB_STATE_SET(CMD);
1051 result = (*tp->cmd_func)(argc-1, (const char **)argv);
1052 if (result && ignore_errors && result > KDB_CMD_GO)
1053 result = 0;
1054 KDB_STATE_CLEAR(CMD);
1056 if (tp->cmd_flags & KDB_REPEAT_WITH_ARGS)
1057 return result;
1059 argc = tp->cmd_flags & KDB_REPEAT_NO_ARGS ? 1 : 0;
1060 if (argv[argc])
1061 *(argv[argc]) = '\0';
1062 return result;
1066 * If the input with which we were presented does not
1067 * map to an existing command, attempt to parse it as an
1068 * address argument and display the result. Useful for
1069 * obtaining the address of a variable, or the nearest symbol
1070 * to an address contained in a register.
1073 unsigned long value;
1074 char *name = NULL;
1075 long offset;
1076 int nextarg = 0;
1078 if (kdbgetaddrarg(0, (const char **)argv, &nextarg,
1079 &value, &offset, &name)) {
1080 return KDB_NOTFOUND;
1083 kdb_printf("%s = ", argv[0]);
1084 kdb_symbol_print(value, NULL, KDB_SP_DEFAULT);
1085 kdb_printf("\n");
1086 return 0;
1091 static int handle_ctrl_cmd(char *cmd)
1093 #define CTRL_P 16
1094 #define CTRL_N 14
1096 /* initial situation */
1097 if (cmd_head == cmd_tail)
1098 return 0;
1099 switch (*cmd) {
1100 case CTRL_P:
1101 if (cmdptr != cmd_tail)
1102 cmdptr = (cmdptr-1) % KDB_CMD_HISTORY_COUNT;
1103 strncpy(cmd_cur, cmd_hist[cmdptr], CMD_BUFLEN);
1104 return 1;
1105 case CTRL_N:
1106 if (cmdptr != cmd_head)
1107 cmdptr = (cmdptr+1) % KDB_CMD_HISTORY_COUNT;
1108 strncpy(cmd_cur, cmd_hist[cmdptr], CMD_BUFLEN);
1109 return 1;
1111 return 0;
1115 * kdb_reboot - This function implements the 'reboot' command. Reboot
1116 * the system immediately, or loop for ever on failure.
1118 static int kdb_reboot(int argc, const char **argv)
1120 emergency_restart();
1121 kdb_printf("Hmm, kdb_reboot did not reboot, spinning here\n");
1122 while (1)
1123 cpu_relax();
1124 /* NOTREACHED */
1125 return 0;
1128 static void kdb_dumpregs(struct pt_regs *regs)
1130 int old_lvl = console_loglevel;
1131 console_loglevel = CONSOLE_LOGLEVEL_MOTORMOUTH;
1132 kdb_trap_printk++;
1133 show_regs(regs);
1134 kdb_trap_printk--;
1135 kdb_printf("\n");
1136 console_loglevel = old_lvl;
1139 void kdb_set_current_task(struct task_struct *p)
1141 kdb_current_task = p;
1143 if (kdb_task_has_cpu(p)) {
1144 kdb_current_regs = KDB_TSKREGS(kdb_process_cpu(p));
1145 return;
1147 kdb_current_regs = NULL;
1151 * kdb_local - The main code for kdb. This routine is invoked on a
1152 * specific processor, it is not global. The main kdb() routine
1153 * ensures that only one processor at a time is in this routine.
1154 * This code is called with the real reason code on the first
1155 * entry to a kdb session, thereafter it is called with reason
1156 * SWITCH, even if the user goes back to the original cpu.
1157 * Inputs:
1158 * reason The reason KDB was invoked
1159 * error The hardware-defined error code
1160 * regs The exception frame at time of fault/breakpoint.
1161 * db_result Result code from the break or debug point.
1162 * Returns:
1163 * 0 KDB was invoked for an event which it wasn't responsible
1164 * 1 KDB handled the event for which it was invoked.
1165 * KDB_CMD_GO User typed 'go'.
1166 * KDB_CMD_CPU User switched to another cpu.
1167 * KDB_CMD_SS Single step.
1169 static int kdb_local(kdb_reason_t reason, int error, struct pt_regs *regs,
1170 kdb_dbtrap_t db_result)
1172 char *cmdbuf;
1173 int diag;
1174 struct task_struct *kdb_current =
1175 kdb_curr_task(raw_smp_processor_id());
1177 KDB_DEBUG_STATE("kdb_local 1", reason);
1178 kdb_go_count = 0;
1179 if (reason == KDB_REASON_DEBUG) {
1180 /* special case below */
1181 } else {
1182 kdb_printf("\nEntering kdb (current=0x%p, pid %d) ",
1183 kdb_current, kdb_current ? kdb_current->pid : 0);
1184 #if defined(CONFIG_SMP)
1185 kdb_printf("on processor %d ", raw_smp_processor_id());
1186 #endif
1189 switch (reason) {
1190 case KDB_REASON_DEBUG:
1193 * If re-entering kdb after a single step
1194 * command, don't print the message.
1196 switch (db_result) {
1197 case KDB_DB_BPT:
1198 kdb_printf("\nEntering kdb (0x%p, pid %d) ",
1199 kdb_current, kdb_current->pid);
1200 #if defined(CONFIG_SMP)
1201 kdb_printf("on processor %d ", raw_smp_processor_id());
1202 #endif
1203 kdb_printf("due to Debug @ " kdb_machreg_fmt "\n",
1204 instruction_pointer(regs));
1205 break;
1206 case KDB_DB_SS:
1207 break;
1208 case KDB_DB_SSBPT:
1209 KDB_DEBUG_STATE("kdb_local 4", reason);
1210 return 1; /* kdba_db_trap did the work */
1211 default:
1212 kdb_printf("kdb: Bad result from kdba_db_trap: %d\n",
1213 db_result);
1214 break;
1218 break;
1219 case KDB_REASON_ENTER:
1220 if (KDB_STATE(KEYBOARD))
1221 kdb_printf("due to Keyboard Entry\n");
1222 else
1223 kdb_printf("due to KDB_ENTER()\n");
1224 break;
1225 case KDB_REASON_KEYBOARD:
1226 KDB_STATE_SET(KEYBOARD);
1227 kdb_printf("due to Keyboard Entry\n");
1228 break;
1229 case KDB_REASON_ENTER_SLAVE:
1230 /* drop through, slaves only get released via cpu switch */
1231 case KDB_REASON_SWITCH:
1232 kdb_printf("due to cpu switch\n");
1233 break;
1234 case KDB_REASON_OOPS:
1235 kdb_printf("Oops: %s\n", kdb_diemsg);
1236 kdb_printf("due to oops @ " kdb_machreg_fmt "\n",
1237 instruction_pointer(regs));
1238 kdb_dumpregs(regs);
1239 break;
1240 case KDB_REASON_SYSTEM_NMI:
1241 kdb_printf("due to System NonMaskable Interrupt\n");
1242 break;
1243 case KDB_REASON_NMI:
1244 kdb_printf("due to NonMaskable Interrupt @ "
1245 kdb_machreg_fmt "\n",
1246 instruction_pointer(regs));
1247 break;
1248 case KDB_REASON_SSTEP:
1249 case KDB_REASON_BREAK:
1250 kdb_printf("due to %s @ " kdb_machreg_fmt "\n",
1251 reason == KDB_REASON_BREAK ?
1252 "Breakpoint" : "SS trap", instruction_pointer(regs));
1254 * Determine if this breakpoint is one that we
1255 * are interested in.
1257 if (db_result != KDB_DB_BPT) {
1258 kdb_printf("kdb: error return from kdba_bp_trap: %d\n",
1259 db_result);
1260 KDB_DEBUG_STATE("kdb_local 6", reason);
1261 return 0; /* Not for us, dismiss it */
1263 break;
1264 case KDB_REASON_RECURSE:
1265 kdb_printf("due to Recursion @ " kdb_machreg_fmt "\n",
1266 instruction_pointer(regs));
1267 break;
1268 default:
1269 kdb_printf("kdb: unexpected reason code: %d\n", reason);
1270 KDB_DEBUG_STATE("kdb_local 8", reason);
1271 return 0; /* Not for us, dismiss it */
1274 while (1) {
1276 * Initialize pager context.
1278 kdb_nextline = 1;
1279 KDB_STATE_CLEAR(SUPPRESS);
1280 kdb_grepping_flag = 0;
1281 /* ensure the old search does not leak into '/' commands */
1282 kdb_grep_string[0] = '\0';
1284 cmdbuf = cmd_cur;
1285 *cmdbuf = '\0';
1286 *(cmd_hist[cmd_head]) = '\0';
1288 do_full_getstr:
1289 #if defined(CONFIG_SMP)
1290 snprintf(kdb_prompt_str, CMD_BUFLEN, kdbgetenv("PROMPT"),
1291 raw_smp_processor_id());
1292 #else
1293 snprintf(kdb_prompt_str, CMD_BUFLEN, kdbgetenv("PROMPT"));
1294 #endif
1295 if (defcmd_in_progress)
1296 strncat(kdb_prompt_str, "[defcmd]", CMD_BUFLEN);
1299 * Fetch command from keyboard
1301 cmdbuf = kdb_getstr(cmdbuf, CMD_BUFLEN, kdb_prompt_str);
1302 if (*cmdbuf != '\n') {
1303 if (*cmdbuf < 32) {
1304 if (cmdptr == cmd_head) {
1305 strncpy(cmd_hist[cmd_head], cmd_cur,
1306 CMD_BUFLEN);
1307 *(cmd_hist[cmd_head] +
1308 strlen(cmd_hist[cmd_head])-1) = '\0';
1310 if (!handle_ctrl_cmd(cmdbuf))
1311 *(cmd_cur+strlen(cmd_cur)-1) = '\0';
1312 cmdbuf = cmd_cur;
1313 goto do_full_getstr;
1314 } else {
1315 strncpy(cmd_hist[cmd_head], cmd_cur,
1316 CMD_BUFLEN);
1319 cmd_head = (cmd_head+1) % KDB_CMD_HISTORY_COUNT;
1320 if (cmd_head == cmd_tail)
1321 cmd_tail = (cmd_tail+1) % KDB_CMD_HISTORY_COUNT;
1324 cmdptr = cmd_head;
1325 diag = kdb_parse(cmdbuf);
1326 if (diag == KDB_NOTFOUND) {
1327 kdb_printf("Unknown kdb command: '%s'\n", cmdbuf);
1328 diag = 0;
1330 if (diag == KDB_CMD_GO
1331 || diag == KDB_CMD_CPU
1332 || diag == KDB_CMD_SS
1333 || diag == KDB_CMD_KGDB)
1334 break;
1336 if (diag)
1337 kdb_cmderror(diag);
1339 KDB_DEBUG_STATE("kdb_local 9", diag);
1340 return diag;
1345 * kdb_print_state - Print the state data for the current processor
1346 * for debugging.
1347 * Inputs:
1348 * text Identifies the debug point
1349 * value Any integer value to be printed, e.g. reason code.
1351 void kdb_print_state(const char *text, int value)
1353 kdb_printf("state: %s cpu %d value %d initial %d state %x\n",
1354 text, raw_smp_processor_id(), value, kdb_initial_cpu,
1355 kdb_state);
1359 * kdb_main_loop - After initial setup and assignment of the
1360 * controlling cpu, all cpus are in this loop. One cpu is in
1361 * control and will issue the kdb prompt, the others will spin
1362 * until 'go' or cpu switch.
1364 * To get a consistent view of the kernel stacks for all
1365 * processes, this routine is invoked from the main kdb code via
1366 * an architecture specific routine. kdba_main_loop is
1367 * responsible for making the kernel stacks consistent for all
1368 * processes, there should be no difference between a blocked
1369 * process and a running process as far as kdb is concerned.
1370 * Inputs:
1371 * reason The reason KDB was invoked
1372 * error The hardware-defined error code
1373 * reason2 kdb's current reason code.
1374 * Initially error but can change
1375 * according to kdb state.
1376 * db_result Result code from break or debug point.
1377 * regs The exception frame at time of fault/breakpoint.
1378 * should always be valid.
1379 * Returns:
1380 * 0 KDB was invoked for an event which it wasn't responsible
1381 * 1 KDB handled the event for which it was invoked.
1383 int kdb_main_loop(kdb_reason_t reason, kdb_reason_t reason2, int error,
1384 kdb_dbtrap_t db_result, struct pt_regs *regs)
1386 int result = 1;
1387 /* Stay in kdb() until 'go', 'ss[b]' or an error */
1388 while (1) {
1390 * All processors except the one that is in control
1391 * will spin here.
1393 KDB_DEBUG_STATE("kdb_main_loop 1", reason);
1394 while (KDB_STATE(HOLD_CPU)) {
1395 /* state KDB is turned off by kdb_cpu to see if the
1396 * other cpus are still live, each cpu in this loop
1397 * turns it back on.
1399 if (!KDB_STATE(KDB))
1400 KDB_STATE_SET(KDB);
1403 KDB_STATE_CLEAR(SUPPRESS);
1404 KDB_DEBUG_STATE("kdb_main_loop 2", reason);
1405 if (KDB_STATE(LEAVING))
1406 break; /* Another cpu said 'go' */
1407 /* Still using kdb, this processor is in control */
1408 result = kdb_local(reason2, error, regs, db_result);
1409 KDB_DEBUG_STATE("kdb_main_loop 3", result);
1411 if (result == KDB_CMD_CPU)
1412 break;
1414 if (result == KDB_CMD_SS) {
1415 KDB_STATE_SET(DOING_SS);
1416 break;
1419 if (result == KDB_CMD_KGDB) {
1420 if (!KDB_STATE(DOING_KGDB))
1421 kdb_printf("Entering please attach debugger "
1422 "or use $D#44+ or $3#33\n");
1423 break;
1425 if (result && result != 1 && result != KDB_CMD_GO)
1426 kdb_printf("\nUnexpected kdb_local return code %d\n",
1427 result);
1428 KDB_DEBUG_STATE("kdb_main_loop 4", reason);
1429 break;
1431 if (KDB_STATE(DOING_SS))
1432 KDB_STATE_CLEAR(SSBPT);
1434 /* Clean up any keyboard devices before leaving */
1435 kdb_kbd_cleanup_state();
1437 return result;
1441 * kdb_mdr - This function implements the guts of the 'mdr', memory
1442 * read command.
1443 * mdr <addr arg>,<byte count>
1444 * Inputs:
1445 * addr Start address
1446 * count Number of bytes
1447 * Returns:
1448 * Always 0. Any errors are detected and printed by kdb_getarea.
1450 static int kdb_mdr(unsigned long addr, unsigned int count)
1452 unsigned char c;
1453 while (count--) {
1454 if (kdb_getarea(c, addr))
1455 return 0;
1456 kdb_printf("%02x", c);
1457 addr++;
1459 kdb_printf("\n");
1460 return 0;
1464 * kdb_md - This function implements the 'md', 'md1', 'md2', 'md4',
1465 * 'md8' 'mdr' and 'mds' commands.
1467 * md|mds [<addr arg> [<line count> [<radix>]]]
1468 * mdWcN [<addr arg> [<line count> [<radix>]]]
1469 * where W = is the width (1, 2, 4 or 8) and N is the count.
1470 * for eg., md1c20 reads 20 bytes, 1 at a time.
1471 * mdr <addr arg>,<byte count>
1473 static void kdb_md_line(const char *fmtstr, unsigned long addr,
1474 int symbolic, int nosect, int bytesperword,
1475 int num, int repeat, int phys)
1477 /* print just one line of data */
1478 kdb_symtab_t symtab;
1479 char cbuf[32];
1480 char *c = cbuf;
1481 int i;
1482 unsigned long word;
1484 memset(cbuf, '\0', sizeof(cbuf));
1485 if (phys)
1486 kdb_printf("phys " kdb_machreg_fmt0 " ", addr);
1487 else
1488 kdb_printf(kdb_machreg_fmt0 " ", addr);
1490 for (i = 0; i < num && repeat--; i++) {
1491 if (phys) {
1492 if (kdb_getphysword(&word, addr, bytesperword))
1493 break;
1494 } else if (kdb_getword(&word, addr, bytesperword))
1495 break;
1496 kdb_printf(fmtstr, word);
1497 if (symbolic)
1498 kdbnearsym(word, &symtab);
1499 else
1500 memset(&symtab, 0, sizeof(symtab));
1501 if (symtab.sym_name) {
1502 kdb_symbol_print(word, &symtab, 0);
1503 if (!nosect) {
1504 kdb_printf("\n");
1505 kdb_printf(" %s %s "
1506 kdb_machreg_fmt " "
1507 kdb_machreg_fmt " "
1508 kdb_machreg_fmt, symtab.mod_name,
1509 symtab.sec_name, symtab.sec_start,
1510 symtab.sym_start, symtab.sym_end);
1512 addr += bytesperword;
1513 } else {
1514 union {
1515 u64 word;
1516 unsigned char c[8];
1517 } wc;
1518 unsigned char *cp;
1519 #ifdef __BIG_ENDIAN
1520 cp = wc.c + 8 - bytesperword;
1521 #else
1522 cp = wc.c;
1523 #endif
1524 wc.word = word;
1525 #define printable_char(c) \
1526 ({unsigned char __c = c; isascii(__c) && isprint(__c) ? __c : '.'; })
1527 switch (bytesperword) {
1528 case 8:
1529 *c++ = printable_char(*cp++);
1530 *c++ = printable_char(*cp++);
1531 *c++ = printable_char(*cp++);
1532 *c++ = printable_char(*cp++);
1533 addr += 4;
1534 case 4:
1535 *c++ = printable_char(*cp++);
1536 *c++ = printable_char(*cp++);
1537 addr += 2;
1538 case 2:
1539 *c++ = printable_char(*cp++);
1540 addr++;
1541 case 1:
1542 *c++ = printable_char(*cp++);
1543 addr++;
1544 break;
1546 #undef printable_char
1549 kdb_printf("%*s %s\n", (int)((num-i)*(2*bytesperword + 1)+1),
1550 " ", cbuf);
1553 static int kdb_md(int argc, const char **argv)
1555 static unsigned long last_addr;
1556 static int last_radix, last_bytesperword, last_repeat;
1557 int radix = 16, mdcount = 8, bytesperword = KDB_WORD_SIZE, repeat;
1558 int nosect = 0;
1559 char fmtchar, fmtstr[64];
1560 unsigned long addr;
1561 unsigned long word;
1562 long offset = 0;
1563 int symbolic = 0;
1564 int valid = 0;
1565 int phys = 0;
1567 kdbgetintenv("MDCOUNT", &mdcount);
1568 kdbgetintenv("RADIX", &radix);
1569 kdbgetintenv("BYTESPERWORD", &bytesperword);
1571 /* Assume 'md <addr>' and start with environment values */
1572 repeat = mdcount * 16 / bytesperword;
1574 if (strcmp(argv[0], "mdr") == 0) {
1575 if (argc != 2)
1576 return KDB_ARGCOUNT;
1577 valid = 1;
1578 } else if (isdigit(argv[0][2])) {
1579 bytesperword = (int)(argv[0][2] - '0');
1580 if (bytesperword == 0) {
1581 bytesperword = last_bytesperword;
1582 if (bytesperword == 0)
1583 bytesperword = 4;
1585 last_bytesperword = bytesperword;
1586 repeat = mdcount * 16 / bytesperword;
1587 if (!argv[0][3])
1588 valid = 1;
1589 else if (argv[0][3] == 'c' && argv[0][4]) {
1590 char *p;
1591 repeat = simple_strtoul(argv[0] + 4, &p, 10);
1592 mdcount = ((repeat * bytesperword) + 15) / 16;
1593 valid = !*p;
1595 last_repeat = repeat;
1596 } else if (strcmp(argv[0], "md") == 0)
1597 valid = 1;
1598 else if (strcmp(argv[0], "mds") == 0)
1599 valid = 1;
1600 else if (strcmp(argv[0], "mdp") == 0) {
1601 phys = valid = 1;
1603 if (!valid)
1604 return KDB_NOTFOUND;
1606 if (argc == 0) {
1607 if (last_addr == 0)
1608 return KDB_ARGCOUNT;
1609 addr = last_addr;
1610 radix = last_radix;
1611 bytesperword = last_bytesperword;
1612 repeat = last_repeat;
1613 mdcount = ((repeat * bytesperword) + 15) / 16;
1616 if (argc) {
1617 unsigned long val;
1618 int diag, nextarg = 1;
1619 diag = kdbgetaddrarg(argc, argv, &nextarg, &addr,
1620 &offset, NULL);
1621 if (diag)
1622 return diag;
1623 if (argc > nextarg+2)
1624 return KDB_ARGCOUNT;
1626 if (argc >= nextarg) {
1627 diag = kdbgetularg(argv[nextarg], &val);
1628 if (!diag) {
1629 mdcount = (int) val;
1630 repeat = mdcount * 16 / bytesperword;
1633 if (argc >= nextarg+1) {
1634 diag = kdbgetularg(argv[nextarg+1], &val);
1635 if (!diag)
1636 radix = (int) val;
1640 if (strcmp(argv[0], "mdr") == 0)
1641 return kdb_mdr(addr, mdcount);
1643 switch (radix) {
1644 case 10:
1645 fmtchar = 'd';
1646 break;
1647 case 16:
1648 fmtchar = 'x';
1649 break;
1650 case 8:
1651 fmtchar = 'o';
1652 break;
1653 default:
1654 return KDB_BADRADIX;
1657 last_radix = radix;
1659 if (bytesperword > KDB_WORD_SIZE)
1660 return KDB_BADWIDTH;
1662 switch (bytesperword) {
1663 case 8:
1664 sprintf(fmtstr, "%%16.16l%c ", fmtchar);
1665 break;
1666 case 4:
1667 sprintf(fmtstr, "%%8.8l%c ", fmtchar);
1668 break;
1669 case 2:
1670 sprintf(fmtstr, "%%4.4l%c ", fmtchar);
1671 break;
1672 case 1:
1673 sprintf(fmtstr, "%%2.2l%c ", fmtchar);
1674 break;
1675 default:
1676 return KDB_BADWIDTH;
1679 last_repeat = repeat;
1680 last_bytesperword = bytesperword;
1682 if (strcmp(argv[0], "mds") == 0) {
1683 symbolic = 1;
1684 /* Do not save these changes as last_*, they are temporary mds
1685 * overrides.
1687 bytesperword = KDB_WORD_SIZE;
1688 repeat = mdcount;
1689 kdbgetintenv("NOSECT", &nosect);
1692 /* Round address down modulo BYTESPERWORD */
1694 addr &= ~(bytesperword-1);
1696 while (repeat > 0) {
1697 unsigned long a;
1698 int n, z, num = (symbolic ? 1 : (16 / bytesperword));
1700 if (KDB_FLAG(CMD_INTERRUPT))
1701 return 0;
1702 for (a = addr, z = 0; z < repeat; a += bytesperword, ++z) {
1703 if (phys) {
1704 if (kdb_getphysword(&word, a, bytesperword)
1705 || word)
1706 break;
1707 } else if (kdb_getword(&word, a, bytesperword) || word)
1708 break;
1710 n = min(num, repeat);
1711 kdb_md_line(fmtstr, addr, symbolic, nosect, bytesperword,
1712 num, repeat, phys);
1713 addr += bytesperword * n;
1714 repeat -= n;
1715 z = (z + num - 1) / num;
1716 if (z > 2) {
1717 int s = num * (z-2);
1718 kdb_printf(kdb_machreg_fmt0 "-" kdb_machreg_fmt0
1719 " zero suppressed\n",
1720 addr, addr + bytesperword * s - 1);
1721 addr += bytesperword * s;
1722 repeat -= s;
1725 last_addr = addr;
1727 return 0;
1731 * kdb_mm - This function implements the 'mm' command.
1732 * mm address-expression new-value
1733 * Remarks:
1734 * mm works on machine words, mmW works on bytes.
1736 static int kdb_mm(int argc, const char **argv)
1738 int diag;
1739 unsigned long addr;
1740 long offset = 0;
1741 unsigned long contents;
1742 int nextarg;
1743 int width;
1745 if (argv[0][2] && !isdigit(argv[0][2]))
1746 return KDB_NOTFOUND;
1748 if (argc < 2)
1749 return KDB_ARGCOUNT;
1751 nextarg = 1;
1752 diag = kdbgetaddrarg(argc, argv, &nextarg, &addr, &offset, NULL);
1753 if (diag)
1754 return diag;
1756 if (nextarg > argc)
1757 return KDB_ARGCOUNT;
1758 diag = kdbgetaddrarg(argc, argv, &nextarg, &contents, NULL, NULL);
1759 if (diag)
1760 return diag;
1762 if (nextarg != argc + 1)
1763 return KDB_ARGCOUNT;
1765 width = argv[0][2] ? (argv[0][2] - '0') : (KDB_WORD_SIZE);
1766 diag = kdb_putword(addr, contents, width);
1767 if (diag)
1768 return diag;
1770 kdb_printf(kdb_machreg_fmt " = " kdb_machreg_fmt "\n", addr, contents);
1772 return 0;
1776 * kdb_go - This function implements the 'go' command.
1777 * go [address-expression]
1779 static int kdb_go(int argc, const char **argv)
1781 unsigned long addr;
1782 int diag;
1783 int nextarg;
1784 long offset;
1786 if (raw_smp_processor_id() != kdb_initial_cpu) {
1787 kdb_printf("go must execute on the entry cpu, "
1788 "please use \"cpu %d\" and then execute go\n",
1789 kdb_initial_cpu);
1790 return KDB_BADCPUNUM;
1792 if (argc == 1) {
1793 nextarg = 1;
1794 diag = kdbgetaddrarg(argc, argv, &nextarg,
1795 &addr, &offset, NULL);
1796 if (diag)
1797 return diag;
1798 } else if (argc) {
1799 return KDB_ARGCOUNT;
1802 diag = KDB_CMD_GO;
1803 if (KDB_FLAG(CATASTROPHIC)) {
1804 kdb_printf("Catastrophic error detected\n");
1805 kdb_printf("kdb_continue_catastrophic=%d, ",
1806 kdb_continue_catastrophic);
1807 if (kdb_continue_catastrophic == 0 && kdb_go_count++ == 0) {
1808 kdb_printf("type go a second time if you really want "
1809 "to continue\n");
1810 return 0;
1812 if (kdb_continue_catastrophic == 2) {
1813 kdb_printf("forcing reboot\n");
1814 kdb_reboot(0, NULL);
1816 kdb_printf("attempting to continue\n");
1818 return diag;
1822 * kdb_rd - This function implements the 'rd' command.
1824 static int kdb_rd(int argc, const char **argv)
1826 int len = kdb_check_regs();
1827 #if DBG_MAX_REG_NUM > 0
1828 int i;
1829 char *rname;
1830 int rsize;
1831 u64 reg64;
1832 u32 reg32;
1833 u16 reg16;
1834 u8 reg8;
1836 if (len)
1837 return len;
1839 for (i = 0; i < DBG_MAX_REG_NUM; i++) {
1840 rsize = dbg_reg_def[i].size * 2;
1841 if (rsize > 16)
1842 rsize = 2;
1843 if (len + strlen(dbg_reg_def[i].name) + 4 + rsize > 80) {
1844 len = 0;
1845 kdb_printf("\n");
1847 if (len)
1848 len += kdb_printf(" ");
1849 switch(dbg_reg_def[i].size * 8) {
1850 case 8:
1851 rname = dbg_get_reg(i, &reg8, kdb_current_regs);
1852 if (!rname)
1853 break;
1854 len += kdb_printf("%s: %02x", rname, reg8);
1855 break;
1856 case 16:
1857 rname = dbg_get_reg(i, &reg16, kdb_current_regs);
1858 if (!rname)
1859 break;
1860 len += kdb_printf("%s: %04x", rname, reg16);
1861 break;
1862 case 32:
1863 rname = dbg_get_reg(i, &reg32, kdb_current_regs);
1864 if (!rname)
1865 break;
1866 len += kdb_printf("%s: %08x", rname, reg32);
1867 break;
1868 case 64:
1869 rname = dbg_get_reg(i, &reg64, kdb_current_regs);
1870 if (!rname)
1871 break;
1872 len += kdb_printf("%s: %016llx", rname, reg64);
1873 break;
1874 default:
1875 len += kdb_printf("%s: ??", dbg_reg_def[i].name);
1878 kdb_printf("\n");
1879 #else
1880 if (len)
1881 return len;
1883 kdb_dumpregs(kdb_current_regs);
1884 #endif
1885 return 0;
1889 * kdb_rm - This function implements the 'rm' (register modify) command.
1890 * rm register-name new-contents
1891 * Remarks:
1892 * Allows register modification with the same restrictions as gdb
1894 static int kdb_rm(int argc, const char **argv)
1896 #if DBG_MAX_REG_NUM > 0
1897 int diag;
1898 const char *rname;
1899 int i;
1900 u64 reg64;
1901 u32 reg32;
1902 u16 reg16;
1903 u8 reg8;
1905 if (argc != 2)
1906 return KDB_ARGCOUNT;
1908 * Allow presence or absence of leading '%' symbol.
1910 rname = argv[1];
1911 if (*rname == '%')
1912 rname++;
1914 diag = kdbgetu64arg(argv[2], &reg64);
1915 if (diag)
1916 return diag;
1918 diag = kdb_check_regs();
1919 if (diag)
1920 return diag;
1922 diag = KDB_BADREG;
1923 for (i = 0; i < DBG_MAX_REG_NUM; i++) {
1924 if (strcmp(rname, dbg_reg_def[i].name) == 0) {
1925 diag = 0;
1926 break;
1929 if (!diag) {
1930 switch(dbg_reg_def[i].size * 8) {
1931 case 8:
1932 reg8 = reg64;
1933 dbg_set_reg(i, &reg8, kdb_current_regs);
1934 break;
1935 case 16:
1936 reg16 = reg64;
1937 dbg_set_reg(i, &reg16, kdb_current_regs);
1938 break;
1939 case 32:
1940 reg32 = reg64;
1941 dbg_set_reg(i, &reg32, kdb_current_regs);
1942 break;
1943 case 64:
1944 dbg_set_reg(i, &reg64, kdb_current_regs);
1945 break;
1948 return diag;
1949 #else
1950 kdb_printf("ERROR: Register set currently not implemented\n");
1951 return 0;
1952 #endif
1955 #if defined(CONFIG_MAGIC_SYSRQ)
1957 * kdb_sr - This function implements the 'sr' (SYSRQ key) command
1958 * which interfaces to the soi-disant MAGIC SYSRQ functionality.
1959 * sr <magic-sysrq-code>
1961 static int kdb_sr(int argc, const char **argv)
1963 bool check_mask =
1964 !kdb_check_flags(KDB_ENABLE_ALL, kdb_cmd_enabled, false);
1966 if (argc != 1)
1967 return KDB_ARGCOUNT;
1969 kdb_trap_printk++;
1970 __handle_sysrq(*argv[1], check_mask);
1971 kdb_trap_printk--;
1973 return 0;
1975 #endif /* CONFIG_MAGIC_SYSRQ */
1978 * kdb_ef - This function implements the 'regs' (display exception
1979 * frame) command. This command takes an address and expects to
1980 * find an exception frame at that address, formats and prints
1981 * it.
1982 * regs address-expression
1983 * Remarks:
1984 * Not done yet.
1986 static int kdb_ef(int argc, const char **argv)
1988 int diag;
1989 unsigned long addr;
1990 long offset;
1991 int nextarg;
1993 if (argc != 1)
1994 return KDB_ARGCOUNT;
1996 nextarg = 1;
1997 diag = kdbgetaddrarg(argc, argv, &nextarg, &addr, &offset, NULL);
1998 if (diag)
1999 return diag;
2000 show_regs((struct pt_regs *)addr);
2001 return 0;
2004 #if defined(CONFIG_MODULES)
2006 * kdb_lsmod - This function implements the 'lsmod' command. Lists
2007 * currently loaded kernel modules.
2008 * Mostly taken from userland lsmod.
2010 static int kdb_lsmod(int argc, const char **argv)
2012 struct module *mod;
2014 if (argc != 0)
2015 return KDB_ARGCOUNT;
2017 kdb_printf("Module Size modstruct Used by\n");
2018 list_for_each_entry(mod, kdb_modules, list) {
2019 if (mod->state == MODULE_STATE_UNFORMED)
2020 continue;
2022 kdb_printf("%-20s%8u 0x%p ", mod->name,
2023 mod->core_layout.size, (void *)mod);
2024 #ifdef CONFIG_MODULE_UNLOAD
2025 kdb_printf("%4d ", module_refcount(mod));
2026 #endif
2027 if (mod->state == MODULE_STATE_GOING)
2028 kdb_printf(" (Unloading)");
2029 else if (mod->state == MODULE_STATE_COMING)
2030 kdb_printf(" (Loading)");
2031 else
2032 kdb_printf(" (Live)");
2033 kdb_printf(" 0x%p", mod->core_layout.base);
2035 #ifdef CONFIG_MODULE_UNLOAD
2037 struct module_use *use;
2038 kdb_printf(" [ ");
2039 list_for_each_entry(use, &mod->source_list,
2040 source_list)
2041 kdb_printf("%s ", use->target->name);
2042 kdb_printf("]\n");
2044 #endif
2047 return 0;
2050 #endif /* CONFIG_MODULES */
2053 * kdb_env - This function implements the 'env' command. Display the
2054 * current environment variables.
2057 static int kdb_env(int argc, const char **argv)
2059 int i;
2061 for (i = 0; i < __nenv; i++) {
2062 if (__env[i])
2063 kdb_printf("%s\n", __env[i]);
2066 if (KDB_DEBUG(MASK))
2067 kdb_printf("KDBFLAGS=0x%x\n", kdb_flags);
2069 return 0;
2072 #ifdef CONFIG_PRINTK
2074 * kdb_dmesg - This function implements the 'dmesg' command to display
2075 * the contents of the syslog buffer.
2076 * dmesg [lines] [adjust]
2078 static int kdb_dmesg(int argc, const char **argv)
2080 int diag;
2081 int logging;
2082 int lines = 0;
2083 int adjust = 0;
2084 int n = 0;
2085 int skip = 0;
2086 struct kmsg_dumper dumper = { .active = 1 };
2087 size_t len;
2088 char buf[201];
2090 if (argc > 2)
2091 return KDB_ARGCOUNT;
2092 if (argc) {
2093 char *cp;
2094 lines = simple_strtol(argv[1], &cp, 0);
2095 if (*cp)
2096 lines = 0;
2097 if (argc > 1) {
2098 adjust = simple_strtoul(argv[2], &cp, 0);
2099 if (*cp || adjust < 0)
2100 adjust = 0;
2104 /* disable LOGGING if set */
2105 diag = kdbgetintenv("LOGGING", &logging);
2106 if (!diag && logging) {
2107 const char *setargs[] = { "set", "LOGGING", "0" };
2108 kdb_set(2, setargs);
2111 kmsg_dump_rewind_nolock(&dumper);
2112 while (kmsg_dump_get_line_nolock(&dumper, 1, NULL, 0, NULL))
2113 n++;
2115 if (lines < 0) {
2116 if (adjust >= n)
2117 kdb_printf("buffer only contains %d lines, nothing "
2118 "printed\n", n);
2119 else if (adjust - lines >= n)
2120 kdb_printf("buffer only contains %d lines, last %d "
2121 "lines printed\n", n, n - adjust);
2122 skip = adjust;
2123 lines = abs(lines);
2124 } else if (lines > 0) {
2125 skip = n - lines - adjust;
2126 lines = abs(lines);
2127 if (adjust >= n) {
2128 kdb_printf("buffer only contains %d lines, "
2129 "nothing printed\n", n);
2130 skip = n;
2131 } else if (skip < 0) {
2132 lines += skip;
2133 skip = 0;
2134 kdb_printf("buffer only contains %d lines, first "
2135 "%d lines printed\n", n, lines);
2137 } else {
2138 lines = n;
2141 if (skip >= n || skip < 0)
2142 return 0;
2144 kmsg_dump_rewind_nolock(&dumper);
2145 while (kmsg_dump_get_line_nolock(&dumper, 1, buf, sizeof(buf), &len)) {
2146 if (skip) {
2147 skip--;
2148 continue;
2150 if (!lines--)
2151 break;
2152 if (KDB_FLAG(CMD_INTERRUPT))
2153 return 0;
2155 kdb_printf("%.*s\n", (int)len - 1, buf);
2158 return 0;
2160 #endif /* CONFIG_PRINTK */
2162 /* Make sure we balance enable/disable calls, must disable first. */
2163 static atomic_t kdb_nmi_disabled;
2165 static int kdb_disable_nmi(int argc, const char *argv[])
2167 if (atomic_read(&kdb_nmi_disabled))
2168 return 0;
2169 atomic_set(&kdb_nmi_disabled, 1);
2170 arch_kgdb_ops.enable_nmi(0);
2171 return 0;
2174 static int kdb_param_enable_nmi(const char *val, const struct kernel_param *kp)
2176 if (!atomic_add_unless(&kdb_nmi_disabled, -1, 0))
2177 return -EINVAL;
2178 arch_kgdb_ops.enable_nmi(1);
2179 return 0;
2182 static const struct kernel_param_ops kdb_param_ops_enable_nmi = {
2183 .set = kdb_param_enable_nmi,
2185 module_param_cb(enable_nmi, &kdb_param_ops_enable_nmi, NULL, 0600);
2188 * kdb_cpu - This function implements the 'cpu' command.
2189 * cpu [<cpunum>]
2190 * Returns:
2191 * KDB_CMD_CPU for success, a kdb diagnostic if error
2193 static void kdb_cpu_status(void)
2195 int i, start_cpu, first_print = 1;
2196 char state, prev_state = '?';
2198 kdb_printf("Currently on cpu %d\n", raw_smp_processor_id());
2199 kdb_printf("Available cpus: ");
2200 for (start_cpu = -1, i = 0; i < NR_CPUS; i++) {
2201 if (!cpu_online(i)) {
2202 state = 'F'; /* cpu is offline */
2203 } else if (!kgdb_info[i].enter_kgdb) {
2204 state = 'D'; /* cpu is online but unresponsive */
2205 } else {
2206 state = ' '; /* cpu is responding to kdb */
2207 if (kdb_task_state_char(KDB_TSK(i)) == 'I')
2208 state = 'I'; /* idle task */
2210 if (state != prev_state) {
2211 if (prev_state != '?') {
2212 if (!first_print)
2213 kdb_printf(", ");
2214 first_print = 0;
2215 kdb_printf("%d", start_cpu);
2216 if (start_cpu < i-1)
2217 kdb_printf("-%d", i-1);
2218 if (prev_state != ' ')
2219 kdb_printf("(%c)", prev_state);
2221 prev_state = state;
2222 start_cpu = i;
2225 /* print the trailing cpus, ignoring them if they are all offline */
2226 if (prev_state != 'F') {
2227 if (!first_print)
2228 kdb_printf(", ");
2229 kdb_printf("%d", start_cpu);
2230 if (start_cpu < i-1)
2231 kdb_printf("-%d", i-1);
2232 if (prev_state != ' ')
2233 kdb_printf("(%c)", prev_state);
2235 kdb_printf("\n");
2238 static int kdb_cpu(int argc, const char **argv)
2240 unsigned long cpunum;
2241 int diag;
2243 if (argc == 0) {
2244 kdb_cpu_status();
2245 return 0;
2248 if (argc != 1)
2249 return KDB_ARGCOUNT;
2251 diag = kdbgetularg(argv[1], &cpunum);
2252 if (diag)
2253 return diag;
2256 * Validate cpunum
2258 if ((cpunum >= CONFIG_NR_CPUS) || !kgdb_info[cpunum].enter_kgdb)
2259 return KDB_BADCPUNUM;
2261 dbg_switch_cpu = cpunum;
2264 * Switch to other cpu
2266 return KDB_CMD_CPU;
2269 /* The user may not realize that ps/bta with no parameters does not print idle
2270 * or sleeping system daemon processes, so tell them how many were suppressed.
2272 void kdb_ps_suppressed(void)
2274 int idle = 0, daemon = 0;
2275 unsigned long mask_I = kdb_task_state_string("I"),
2276 mask_M = kdb_task_state_string("M");
2277 unsigned long cpu;
2278 const struct task_struct *p, *g;
2279 for_each_online_cpu(cpu) {
2280 p = kdb_curr_task(cpu);
2281 if (kdb_task_state(p, mask_I))
2282 ++idle;
2284 kdb_do_each_thread(g, p) {
2285 if (kdb_task_state(p, mask_M))
2286 ++daemon;
2287 } kdb_while_each_thread(g, p);
2288 if (idle || daemon) {
2289 if (idle)
2290 kdb_printf("%d idle process%s (state I)%s\n",
2291 idle, idle == 1 ? "" : "es",
2292 daemon ? " and " : "");
2293 if (daemon)
2294 kdb_printf("%d sleeping system daemon (state M) "
2295 "process%s", daemon,
2296 daemon == 1 ? "" : "es");
2297 kdb_printf(" suppressed,\nuse 'ps A' to see all.\n");
2302 * kdb_ps - This function implements the 'ps' command which shows a
2303 * list of the active processes.
2304 * ps [DRSTCZEUIMA] All processes, optionally filtered by state
2306 void kdb_ps1(const struct task_struct *p)
2308 int cpu;
2309 unsigned long tmp;
2311 if (!p || probe_kernel_read(&tmp, (char *)p, sizeof(unsigned long)))
2312 return;
2314 cpu = kdb_process_cpu(p);
2315 kdb_printf("0x%p %8d %8d %d %4d %c 0x%p %c%s\n",
2316 (void *)p, p->pid, p->parent->pid,
2317 kdb_task_has_cpu(p), kdb_process_cpu(p),
2318 kdb_task_state_char(p),
2319 (void *)(&p->thread),
2320 p == kdb_curr_task(raw_smp_processor_id()) ? '*' : ' ',
2321 p->comm);
2322 if (kdb_task_has_cpu(p)) {
2323 if (!KDB_TSK(cpu)) {
2324 kdb_printf(" Error: no saved data for this cpu\n");
2325 } else {
2326 if (KDB_TSK(cpu) != p)
2327 kdb_printf(" Error: does not match running "
2328 "process table (0x%p)\n", KDB_TSK(cpu));
2333 static int kdb_ps(int argc, const char **argv)
2335 struct task_struct *g, *p;
2336 unsigned long mask, cpu;
2338 if (argc == 0)
2339 kdb_ps_suppressed();
2340 kdb_printf("%-*s Pid Parent [*] cpu State %-*s Command\n",
2341 (int)(2*sizeof(void *))+2, "Task Addr",
2342 (int)(2*sizeof(void *))+2, "Thread");
2343 mask = kdb_task_state_string(argc ? argv[1] : NULL);
2344 /* Run the active tasks first */
2345 for_each_online_cpu(cpu) {
2346 if (KDB_FLAG(CMD_INTERRUPT))
2347 return 0;
2348 p = kdb_curr_task(cpu);
2349 if (kdb_task_state(p, mask))
2350 kdb_ps1(p);
2352 kdb_printf("\n");
2353 /* Now the real tasks */
2354 kdb_do_each_thread(g, p) {
2355 if (KDB_FLAG(CMD_INTERRUPT))
2356 return 0;
2357 if (kdb_task_state(p, mask))
2358 kdb_ps1(p);
2359 } kdb_while_each_thread(g, p);
2361 return 0;
2365 * kdb_pid - This function implements the 'pid' command which switches
2366 * the currently active process.
2367 * pid [<pid> | R]
2369 static int kdb_pid(int argc, const char **argv)
2371 struct task_struct *p;
2372 unsigned long val;
2373 int diag;
2375 if (argc > 1)
2376 return KDB_ARGCOUNT;
2378 if (argc) {
2379 if (strcmp(argv[1], "R") == 0) {
2380 p = KDB_TSK(kdb_initial_cpu);
2381 } else {
2382 diag = kdbgetularg(argv[1], &val);
2383 if (diag)
2384 return KDB_BADINT;
2386 p = find_task_by_pid_ns((pid_t)val, &init_pid_ns);
2387 if (!p) {
2388 kdb_printf("No task with pid=%d\n", (pid_t)val);
2389 return 0;
2392 kdb_set_current_task(p);
2394 kdb_printf("KDB current process is %s(pid=%d)\n",
2395 kdb_current_task->comm,
2396 kdb_current_task->pid);
2398 return 0;
2401 static int kdb_kgdb(int argc, const char **argv)
2403 return KDB_CMD_KGDB;
2407 * kdb_help - This function implements the 'help' and '?' commands.
2409 static int kdb_help(int argc, const char **argv)
2411 kdbtab_t *kt;
2412 int i;
2414 kdb_printf("%-15.15s %-20.20s %s\n", "Command", "Usage", "Description");
2415 kdb_printf("-----------------------------"
2416 "-----------------------------\n");
2417 for_each_kdbcmd(kt, i) {
2418 char *space = "";
2419 if (KDB_FLAG(CMD_INTERRUPT))
2420 return 0;
2421 if (!kt->cmd_name)
2422 continue;
2423 if (!kdb_check_flags(kt->cmd_flags, kdb_cmd_enabled, true))
2424 continue;
2425 if (strlen(kt->cmd_usage) > 20)
2426 space = "\n ";
2427 kdb_printf("%-15.15s %-20s%s%s\n", kt->cmd_name,
2428 kt->cmd_usage, space, kt->cmd_help);
2430 return 0;
2434 * kdb_kill - This function implements the 'kill' commands.
2436 static int kdb_kill(int argc, const char **argv)
2438 long sig, pid;
2439 char *endp;
2440 struct task_struct *p;
2441 struct siginfo info;
2443 if (argc != 2)
2444 return KDB_ARGCOUNT;
2446 sig = simple_strtol(argv[1], &endp, 0);
2447 if (*endp)
2448 return KDB_BADINT;
2449 if (sig >= 0) {
2450 kdb_printf("Invalid signal parameter.<-signal>\n");
2451 return 0;
2453 sig = -sig;
2455 pid = simple_strtol(argv[2], &endp, 0);
2456 if (*endp)
2457 return KDB_BADINT;
2458 if (pid <= 0) {
2459 kdb_printf("Process ID must be large than 0.\n");
2460 return 0;
2463 /* Find the process. */
2464 p = find_task_by_pid_ns(pid, &init_pid_ns);
2465 if (!p) {
2466 kdb_printf("The specified process isn't found.\n");
2467 return 0;
2469 p = p->group_leader;
2470 info.si_signo = sig;
2471 info.si_errno = 0;
2472 info.si_code = SI_USER;
2473 info.si_pid = pid; /* same capabilities as process being signalled */
2474 info.si_uid = 0; /* kdb has root authority */
2475 kdb_send_sig_info(p, &info);
2476 return 0;
2479 struct kdb_tm {
2480 int tm_sec; /* seconds */
2481 int tm_min; /* minutes */
2482 int tm_hour; /* hours */
2483 int tm_mday; /* day of the month */
2484 int tm_mon; /* month */
2485 int tm_year; /* year */
2488 static void kdb_gmtime(struct timespec *tv, struct kdb_tm *tm)
2490 /* This will work from 1970-2099, 2100 is not a leap year */
2491 static int mon_day[] = { 31, 29, 31, 30, 31, 30, 31,
2492 31, 30, 31, 30, 31 };
2493 memset(tm, 0, sizeof(*tm));
2494 tm->tm_sec = tv->tv_sec % (24 * 60 * 60);
2495 tm->tm_mday = tv->tv_sec / (24 * 60 * 60) +
2496 (2 * 365 + 1); /* shift base from 1970 to 1968 */
2497 tm->tm_min = tm->tm_sec / 60 % 60;
2498 tm->tm_hour = tm->tm_sec / 60 / 60;
2499 tm->tm_sec = tm->tm_sec % 60;
2500 tm->tm_year = 68 + 4*(tm->tm_mday / (4*365+1));
2501 tm->tm_mday %= (4*365+1);
2502 mon_day[1] = 29;
2503 while (tm->tm_mday >= mon_day[tm->tm_mon]) {
2504 tm->tm_mday -= mon_day[tm->tm_mon];
2505 if (++tm->tm_mon == 12) {
2506 tm->tm_mon = 0;
2507 ++tm->tm_year;
2508 mon_day[1] = 28;
2511 ++tm->tm_mday;
2515 * Most of this code has been lifted from kernel/timer.c::sys_sysinfo().
2516 * I cannot call that code directly from kdb, it has an unconditional
2517 * cli()/sti() and calls routines that take locks which can stop the debugger.
2519 static void kdb_sysinfo(struct sysinfo *val)
2521 struct timespec uptime;
2522 ktime_get_ts(&uptime);
2523 memset(val, 0, sizeof(*val));
2524 val->uptime = uptime.tv_sec;
2525 val->loads[0] = avenrun[0];
2526 val->loads[1] = avenrun[1];
2527 val->loads[2] = avenrun[2];
2528 val->procs = nr_threads-1;
2529 si_meminfo(val);
2531 return;
2535 * kdb_summary - This function implements the 'summary' command.
2537 static int kdb_summary(int argc, const char **argv)
2539 struct timespec now;
2540 struct kdb_tm tm;
2541 struct sysinfo val;
2543 if (argc)
2544 return KDB_ARGCOUNT;
2546 kdb_printf("sysname %s\n", init_uts_ns.name.sysname);
2547 kdb_printf("release %s\n", init_uts_ns.name.release);
2548 kdb_printf("version %s\n", init_uts_ns.name.version);
2549 kdb_printf("machine %s\n", init_uts_ns.name.machine);
2550 kdb_printf("nodename %s\n", init_uts_ns.name.nodename);
2551 kdb_printf("domainname %s\n", init_uts_ns.name.domainname);
2552 kdb_printf("ccversion %s\n", __stringify(CCVERSION));
2554 now = __current_kernel_time();
2555 kdb_gmtime(&now, &tm);
2556 kdb_printf("date %04d-%02d-%02d %02d:%02d:%02d "
2557 "tz_minuteswest %d\n",
2558 1900+tm.tm_year, tm.tm_mon+1, tm.tm_mday,
2559 tm.tm_hour, tm.tm_min, tm.tm_sec,
2560 sys_tz.tz_minuteswest);
2562 kdb_sysinfo(&val);
2563 kdb_printf("uptime ");
2564 if (val.uptime > (24*60*60)) {
2565 int days = val.uptime / (24*60*60);
2566 val.uptime %= (24*60*60);
2567 kdb_printf("%d day%s ", days, days == 1 ? "" : "s");
2569 kdb_printf("%02ld:%02ld\n", val.uptime/(60*60), (val.uptime/60)%60);
2571 /* lifted from fs/proc/proc_misc.c::loadavg_read_proc() */
2573 #define LOAD_INT(x) ((x) >> FSHIFT)
2574 #define LOAD_FRAC(x) LOAD_INT(((x) & (FIXED_1-1)) * 100)
2575 kdb_printf("load avg %ld.%02ld %ld.%02ld %ld.%02ld\n",
2576 LOAD_INT(val.loads[0]), LOAD_FRAC(val.loads[0]),
2577 LOAD_INT(val.loads[1]), LOAD_FRAC(val.loads[1]),
2578 LOAD_INT(val.loads[2]), LOAD_FRAC(val.loads[2]));
2579 #undef LOAD_INT
2580 #undef LOAD_FRAC
2581 /* Display in kilobytes */
2582 #define K(x) ((x) << (PAGE_SHIFT - 10))
2583 kdb_printf("\nMemTotal: %8lu kB\nMemFree: %8lu kB\n"
2584 "Buffers: %8lu kB\n",
2585 K(val.totalram), K(val.freeram), K(val.bufferram));
2586 return 0;
2590 * kdb_per_cpu - This function implements the 'per_cpu' command.
2592 static int kdb_per_cpu(int argc, const char **argv)
2594 char fmtstr[64];
2595 int cpu, diag, nextarg = 1;
2596 unsigned long addr, symaddr, val, bytesperword = 0, whichcpu = ~0UL;
2598 if (argc < 1 || argc > 3)
2599 return KDB_ARGCOUNT;
2601 diag = kdbgetaddrarg(argc, argv, &nextarg, &symaddr, NULL, NULL);
2602 if (diag)
2603 return diag;
2605 if (argc >= 2) {
2606 diag = kdbgetularg(argv[2], &bytesperword);
2607 if (diag)
2608 return diag;
2610 if (!bytesperword)
2611 bytesperword = KDB_WORD_SIZE;
2612 else if (bytesperword > KDB_WORD_SIZE)
2613 return KDB_BADWIDTH;
2614 sprintf(fmtstr, "%%0%dlx ", (int)(2*bytesperword));
2615 if (argc >= 3) {
2616 diag = kdbgetularg(argv[3], &whichcpu);
2617 if (diag)
2618 return diag;
2619 if (!cpu_online(whichcpu)) {
2620 kdb_printf("cpu %ld is not online\n", whichcpu);
2621 return KDB_BADCPUNUM;
2625 /* Most architectures use __per_cpu_offset[cpu], some use
2626 * __per_cpu_offset(cpu), smp has no __per_cpu_offset.
2628 #ifdef __per_cpu_offset
2629 #define KDB_PCU(cpu) __per_cpu_offset(cpu)
2630 #else
2631 #ifdef CONFIG_SMP
2632 #define KDB_PCU(cpu) __per_cpu_offset[cpu]
2633 #else
2634 #define KDB_PCU(cpu) 0
2635 #endif
2636 #endif
2637 for_each_online_cpu(cpu) {
2638 if (KDB_FLAG(CMD_INTERRUPT))
2639 return 0;
2641 if (whichcpu != ~0UL && whichcpu != cpu)
2642 continue;
2643 addr = symaddr + KDB_PCU(cpu);
2644 diag = kdb_getword(&val, addr, bytesperword);
2645 if (diag) {
2646 kdb_printf("%5d " kdb_bfd_vma_fmt0 " - unable to "
2647 "read, diag=%d\n", cpu, addr, diag);
2648 continue;
2650 kdb_printf("%5d ", cpu);
2651 kdb_md_line(fmtstr, addr,
2652 bytesperword == KDB_WORD_SIZE,
2653 1, bytesperword, 1, 1, 0);
2655 #undef KDB_PCU
2656 return 0;
2660 * display help for the use of cmd | grep pattern
2662 static int kdb_grep_help(int argc, const char **argv)
2664 kdb_printf("Usage of cmd args | grep pattern:\n");
2665 kdb_printf(" Any command's output may be filtered through an ");
2666 kdb_printf("emulated 'pipe'.\n");
2667 kdb_printf(" 'grep' is just a key word.\n");
2668 kdb_printf(" The pattern may include a very limited set of "
2669 "metacharacters:\n");
2670 kdb_printf(" pattern or ^pattern or pattern$ or ^pattern$\n");
2671 kdb_printf(" And if there are spaces in the pattern, you may "
2672 "quote it:\n");
2673 kdb_printf(" \"pat tern\" or \"^pat tern\" or \"pat tern$\""
2674 " or \"^pat tern$\"\n");
2675 return 0;
2679 * kdb_register_flags - This function is used to register a kernel
2680 * debugger command.
2681 * Inputs:
2682 * cmd Command name
2683 * func Function to execute the command
2684 * usage A simple usage string showing arguments
2685 * help A simple help string describing command
2686 * repeat Does the command auto repeat on enter?
2687 * Returns:
2688 * zero for success, one if a duplicate command.
2690 #define kdb_command_extend 50 /* arbitrary */
2691 int kdb_register_flags(char *cmd,
2692 kdb_func_t func,
2693 char *usage,
2694 char *help,
2695 short minlen,
2696 kdb_cmdflags_t flags)
2698 int i;
2699 kdbtab_t *kp;
2702 * Brute force method to determine duplicates
2704 for_each_kdbcmd(kp, i) {
2705 if (kp->cmd_name && (strcmp(kp->cmd_name, cmd) == 0)) {
2706 kdb_printf("Duplicate kdb command registered: "
2707 "%s, func %p help %s\n", cmd, func, help);
2708 return 1;
2713 * Insert command into first available location in table
2715 for_each_kdbcmd(kp, i) {
2716 if (kp->cmd_name == NULL)
2717 break;
2720 if (i >= kdb_max_commands) {
2721 kdbtab_t *new = kmalloc((kdb_max_commands - KDB_BASE_CMD_MAX +
2722 kdb_command_extend) * sizeof(*new), GFP_KDB);
2723 if (!new) {
2724 kdb_printf("Could not allocate new kdb_command "
2725 "table\n");
2726 return 1;
2728 if (kdb_commands) {
2729 memcpy(new, kdb_commands,
2730 (kdb_max_commands - KDB_BASE_CMD_MAX) * sizeof(*new));
2731 kfree(kdb_commands);
2733 memset(new + kdb_max_commands - KDB_BASE_CMD_MAX, 0,
2734 kdb_command_extend * sizeof(*new));
2735 kdb_commands = new;
2736 kp = kdb_commands + kdb_max_commands - KDB_BASE_CMD_MAX;
2737 kdb_max_commands += kdb_command_extend;
2740 kp->cmd_name = cmd;
2741 kp->cmd_func = func;
2742 kp->cmd_usage = usage;
2743 kp->cmd_help = help;
2744 kp->cmd_minlen = minlen;
2745 kp->cmd_flags = flags;
2747 return 0;
2749 EXPORT_SYMBOL_GPL(kdb_register_flags);
2753 * kdb_register - Compatibility register function for commands that do
2754 * not need to specify a repeat state. Equivalent to
2755 * kdb_register_flags with flags set to 0.
2756 * Inputs:
2757 * cmd Command name
2758 * func Function to execute the command
2759 * usage A simple usage string showing arguments
2760 * help A simple help string describing command
2761 * Returns:
2762 * zero for success, one if a duplicate command.
2764 int kdb_register(char *cmd,
2765 kdb_func_t func,
2766 char *usage,
2767 char *help,
2768 short minlen)
2770 return kdb_register_flags(cmd, func, usage, help, minlen, 0);
2772 EXPORT_SYMBOL_GPL(kdb_register);
2775 * kdb_unregister - This function is used to unregister a kernel
2776 * debugger command. It is generally called when a module which
2777 * implements kdb commands is unloaded.
2778 * Inputs:
2779 * cmd Command name
2780 * Returns:
2781 * zero for success, one command not registered.
2783 int kdb_unregister(char *cmd)
2785 int i;
2786 kdbtab_t *kp;
2789 * find the command.
2791 for_each_kdbcmd(kp, i) {
2792 if (kp->cmd_name && (strcmp(kp->cmd_name, cmd) == 0)) {
2793 kp->cmd_name = NULL;
2794 return 0;
2798 /* Couldn't find it. */
2799 return 1;
2801 EXPORT_SYMBOL_GPL(kdb_unregister);
2803 /* Initialize the kdb command table. */
2804 static void __init kdb_inittab(void)
2806 int i;
2807 kdbtab_t *kp;
2809 for_each_kdbcmd(kp, i)
2810 kp->cmd_name = NULL;
2812 kdb_register_flags("md", kdb_md, "<vaddr>",
2813 "Display Memory Contents, also mdWcN, e.g. md8c1", 1,
2814 KDB_ENABLE_MEM_READ | KDB_REPEAT_NO_ARGS);
2815 kdb_register_flags("mdr", kdb_md, "<vaddr> <bytes>",
2816 "Display Raw Memory", 0,
2817 KDB_ENABLE_MEM_READ | KDB_REPEAT_NO_ARGS);
2818 kdb_register_flags("mdp", kdb_md, "<paddr> <bytes>",
2819 "Display Physical Memory", 0,
2820 KDB_ENABLE_MEM_READ | KDB_REPEAT_NO_ARGS);
2821 kdb_register_flags("mds", kdb_md, "<vaddr>",
2822 "Display Memory Symbolically", 0,
2823 KDB_ENABLE_MEM_READ | KDB_REPEAT_NO_ARGS);
2824 kdb_register_flags("mm", kdb_mm, "<vaddr> <contents>",
2825 "Modify Memory Contents", 0,
2826 KDB_ENABLE_MEM_WRITE | KDB_REPEAT_NO_ARGS);
2827 kdb_register_flags("go", kdb_go, "[<vaddr>]",
2828 "Continue Execution", 1,
2829 KDB_ENABLE_REG_WRITE | KDB_ENABLE_ALWAYS_SAFE_NO_ARGS);
2830 kdb_register_flags("rd", kdb_rd, "",
2831 "Display Registers", 0,
2832 KDB_ENABLE_REG_READ);
2833 kdb_register_flags("rm", kdb_rm, "<reg> <contents>",
2834 "Modify Registers", 0,
2835 KDB_ENABLE_REG_WRITE);
2836 kdb_register_flags("ef", kdb_ef, "<vaddr>",
2837 "Display exception frame", 0,
2838 KDB_ENABLE_MEM_READ);
2839 kdb_register_flags("bt", kdb_bt, "[<vaddr>]",
2840 "Stack traceback", 1,
2841 KDB_ENABLE_MEM_READ | KDB_ENABLE_INSPECT_NO_ARGS);
2842 kdb_register_flags("btp", kdb_bt, "<pid>",
2843 "Display stack for process <pid>", 0,
2844 KDB_ENABLE_INSPECT);
2845 kdb_register_flags("bta", kdb_bt, "[D|R|S|T|C|Z|E|U|I|M|A]",
2846 "Backtrace all processes matching state flag", 0,
2847 KDB_ENABLE_INSPECT);
2848 kdb_register_flags("btc", kdb_bt, "",
2849 "Backtrace current process on each cpu", 0,
2850 KDB_ENABLE_INSPECT);
2851 kdb_register_flags("btt", kdb_bt, "<vaddr>",
2852 "Backtrace process given its struct task address", 0,
2853 KDB_ENABLE_MEM_READ | KDB_ENABLE_INSPECT_NO_ARGS);
2854 kdb_register_flags("env", kdb_env, "",
2855 "Show environment variables", 0,
2856 KDB_ENABLE_ALWAYS_SAFE);
2857 kdb_register_flags("set", kdb_set, "",
2858 "Set environment variables", 0,
2859 KDB_ENABLE_ALWAYS_SAFE);
2860 kdb_register_flags("help", kdb_help, "",
2861 "Display Help Message", 1,
2862 KDB_ENABLE_ALWAYS_SAFE);
2863 kdb_register_flags("?", kdb_help, "",
2864 "Display Help Message", 0,
2865 KDB_ENABLE_ALWAYS_SAFE);
2866 kdb_register_flags("cpu", kdb_cpu, "<cpunum>",
2867 "Switch to new cpu", 0,
2868 KDB_ENABLE_ALWAYS_SAFE_NO_ARGS);
2869 kdb_register_flags("kgdb", kdb_kgdb, "",
2870 "Enter kgdb mode", 0, 0);
2871 kdb_register_flags("ps", kdb_ps, "[<flags>|A]",
2872 "Display active task list", 0,
2873 KDB_ENABLE_INSPECT);
2874 kdb_register_flags("pid", kdb_pid, "<pidnum>",
2875 "Switch to another task", 0,
2876 KDB_ENABLE_INSPECT);
2877 kdb_register_flags("reboot", kdb_reboot, "",
2878 "Reboot the machine immediately", 0,
2879 KDB_ENABLE_REBOOT);
2880 #if defined(CONFIG_MODULES)
2881 kdb_register_flags("lsmod", kdb_lsmod, "",
2882 "List loaded kernel modules", 0,
2883 KDB_ENABLE_INSPECT);
2884 #endif
2885 #if defined(CONFIG_MAGIC_SYSRQ)
2886 kdb_register_flags("sr", kdb_sr, "<key>",
2887 "Magic SysRq key", 0,
2888 KDB_ENABLE_ALWAYS_SAFE);
2889 #endif
2890 #if defined(CONFIG_PRINTK)
2891 kdb_register_flags("dmesg", kdb_dmesg, "[lines]",
2892 "Display syslog buffer", 0,
2893 KDB_ENABLE_ALWAYS_SAFE);
2894 #endif
2895 if (arch_kgdb_ops.enable_nmi) {
2896 kdb_register_flags("disable_nmi", kdb_disable_nmi, "",
2897 "Disable NMI entry to KDB", 0,
2898 KDB_ENABLE_ALWAYS_SAFE);
2900 kdb_register_flags("defcmd", kdb_defcmd, "name \"usage\" \"help\"",
2901 "Define a set of commands, down to endefcmd", 0,
2902 KDB_ENABLE_ALWAYS_SAFE);
2903 kdb_register_flags("kill", kdb_kill, "<-signal> <pid>",
2904 "Send a signal to a process", 0,
2905 KDB_ENABLE_SIGNAL);
2906 kdb_register_flags("summary", kdb_summary, "",
2907 "Summarize the system", 4,
2908 KDB_ENABLE_ALWAYS_SAFE);
2909 kdb_register_flags("per_cpu", kdb_per_cpu, "<sym> [<bytes>] [<cpu>]",
2910 "Display per_cpu variables", 3,
2911 KDB_ENABLE_MEM_READ);
2912 kdb_register_flags("grephelp", kdb_grep_help, "",
2913 "Display help on | grep", 0,
2914 KDB_ENABLE_ALWAYS_SAFE);
2917 /* Execute any commands defined in kdb_cmds. */
2918 static void __init kdb_cmd_init(void)
2920 int i, diag;
2921 for (i = 0; kdb_cmds[i]; ++i) {
2922 diag = kdb_parse(kdb_cmds[i]);
2923 if (diag)
2924 kdb_printf("kdb command %s failed, kdb diag %d\n",
2925 kdb_cmds[i], diag);
2927 if (defcmd_in_progress) {
2928 kdb_printf("Incomplete 'defcmd' set, forcing endefcmd\n");
2929 kdb_parse("endefcmd");
2933 /* Initialize kdb_printf, breakpoint tables and kdb state */
2934 void __init kdb_init(int lvl)
2936 static int kdb_init_lvl = KDB_NOT_INITIALIZED;
2937 int i;
2939 if (kdb_init_lvl == KDB_INIT_FULL || lvl <= kdb_init_lvl)
2940 return;
2941 for (i = kdb_init_lvl; i < lvl; i++) {
2942 switch (i) {
2943 case KDB_NOT_INITIALIZED:
2944 kdb_inittab(); /* Initialize Command Table */
2945 kdb_initbptab(); /* Initialize Breakpoints */
2946 break;
2947 case KDB_INIT_EARLY:
2948 kdb_cmd_init(); /* Build kdb_cmds tables */
2949 break;
2952 kdb_init_lvl = lvl;