X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fdebug.texi;h=75d9b242a79b12dfbb0496d4d962e538a0259d98;hb=749088412dc35dfc51035c30b86dd0b86a6954f7;hp=cf8edc040029784e39feab449277678364e20cb5;hpb=7a3a3477d2001ebb9b8c73e4785f16d47788f52c;p=pintos-anon diff --git a/doc/debug.texi b/doc/debug.texi index cf8edc0..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 @@ -256,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}: