X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fdebug.texi;h=75d9b242a79b12dfbb0496d4d962e538a0259d98;hb=7a3dff52c8a44deeadd071ea93f19b9cee2a67fa;hp=f36ae4a8bc30d4d2fd8793bc84fea5a87547c9dc;hpb=eb5ba83c314e0074e2b280516e3e30b8626c638f;p=pintos-anon diff --git a/doc/debug.texi b/doc/debug.texi index f36ae4a..75d9b24 100644 --- a/doc/debug.texi +++ b/doc/debug.texi @@ -7,7 +7,6 @@ introduces you to a few of them. @menu * printf:: * ASSERT:: -* DEBUG:: * UNUSED NO_RETURN NO_INLINE PRINTF_FORMAT:: * Backtraces:: * i386-elf-gdb:: @@ -53,31 +52,6 @@ When an assertion proves untrue, the kernel panics. The panic message should help you to find the problem. See the description of backtraces below for more information. -@node DEBUG -@section @code{DEBUG} - -The @code{DEBUG} macro, also defined in @file{}, is a sort of -conditional @func{printf}. It takes as its arguments the name of a -``message class'' and a @func{printf}-like format string and -arguments. The message class is used to filter the messages that are -actually displayed. You select the messages to display on the Pintos -command line using the @option{-d} option. This allows you to easily -turn different types of messages on and off while you debug, without -the need to recompile. - -For example, suppose you want to output thread debugging messages. To -use a class named @code{thread}, you could invoke @code{DEBUG} like -this: -@example -DEBUG(thread, "thread id: %d\n", id); -@end example -@noindent -and then to start Pintos with @code{thread} messages enable you'd use -a command line like this: -@example -pintos run -d thread -@end example - @node UNUSED NO_RETURN NO_INLINE PRINTF_FORMAT @section UNUSED, NO_RETURN, NO_INLINE, and PRINTF_FORMAT @@ -198,7 +172,7 @@ tree used for this example, line 405 of @file{filesys/file.c} is the assertion @example -ASSERT (file_ofs >= )0; +ASSERT (file_ofs >= 0); @end example @noindent @@ -221,9 +195,8 @@ panicked, you can re-run @command{backtrace} on the user program, like so: (typing the command on a single line, of course): @example -~/cs140/pintos/src/utils/backtrace grow-too-big 0xc0106eff 0xc01102fb -0xc010dc22 0xc010cf67 0xc0102319 0xc010325a 0x804812c 0x8048a96 -0x8048ac8 +backtrace grow-too-big 0xc0106eff 0xc01102fb 0xc010dc22 0xc010cf67 +0xc0102319 0xc010325a 0x804812c 0x8048a96 0x8048ac8 @end example The results look like this: @@ -257,7 +230,7 @@ backtrace kernel.o Call stack: 0xc0106eff 0xc01102fb 0xc010dc22 You can run the Pintos kernel under the supervision of the @command{i386-elf-gdb} debugger.@footnote{If you're using an 80@var{x}86 system for development, it's probably just called -@command{addr2line}.} There are two steps in the process. First, +@command{gdb}.} There are two steps in the process. First, start Pintos with the @option{--gdb} option, e.g.@: @command{pintos --gdb run}. Second, in a second terminal, invoke @command{gdb} on @file{kernel.o}: