debugger/info.c

   1 /*
   2  * Wine debugger utility routines
   3  *
   4  * Copyright 1993 Eric Youngdale
   5  * Copyright 1995 Alexandre Julliard
   6  */
   7
   8 #include <stdio.h>
   9 #include <stdlib.h>
  10 #include "debugger.h"
  11
  12 /***********************************************************************
  13  *           DEBUG_Print
  14  *
  15  * Implementation of the 'print' command.
  16  */
  17 void DEBUG_Print( const DBG_ADDR *addr, int count, char format )
  18 {
  19     if (count != 1)
  20     {
  21         fprintf( stderr, "Count other than 1 is meaningless in 'print' command\n" );
  22         return;
  23     }
  24
  25     if (addr->seg && (addr->seg != 0xffffffff))
  26     {
  27         switch(format)
  28         {
  29         case 'x':
  30             fprintf( stderr, "0x%04lx:", addr->seg );
  31             break;
  32
  33         case 'd':
  34             fprintf( stderr, "%ld:", addr->seg );
  35             break;
  36
  37         case 'c':
  38             break;  /* No segment to print */
  39
  40         case 'i':
  41         case 's':
  42         case 'w':
  43         case 'b':
  44             break;  /* Meaningless format */
  45         }
  46     }
  47
  48     switch(format)
  49     {
  50     case 'x':
  51         if (addr->seg) fprintf( stderr, "0x%04lx\n", addr->off );
  52         else fprintf( stderr, "0x%08lx\n", addr->off );
  53         break;
  54
  55     case 'd':
  56         fprintf( stderr, "%ld\n", addr->off );
  57         break;
  58
  59     case 'c':
  60         fprintf( stderr, "%d = '%c'\n",
  61                  (char)(addr->off & 0xff), (char)(addr->off & 0xff) );
  62         break;
  63
  64     case 'i':
  65     case 's':
  66     case 'w':
  67     case 'b':
  68         fprintf( stderr, "Format specifier '%c' is meaningless in 'print' command\n", format );
  69         break;
  70     }
  71 }
  72
  73
  74 /***********************************************************************
  75  *           DEBUG_PrintAddress
  76  *
  77  * Print an 16- or 32-bit address, with the nearest symbol if any.
  78  */
  79 void DEBUG_PrintAddress( const DBG_ADDR *addr, int addrlen )
  80 {
  81     const char *name = DEBUG_FindNearestSymbol( addr );
  82
  83     if (addr->seg) fprintf( stderr, "0x%04lx:", addr->seg );
  84     if (addrlen == 16) fprintf( stderr, "0x%04lx", addr->off );
  85     else fprintf( stderr, "0x%08lx", addr->off );
  86     if (name) fprintf( stderr, " (%s)", name );
  87 }
  88
  89
  90 /***********************************************************************
  91  *           DEBUG_Help
  92  *
  93  * Implementation of the 'help' command.
  94  */
  95 void DEBUG_Help(void)
  96 {
  97     int i = 0;
  98     static const char * const helptext[] =
  99 {
 100 "The commands accepted by the Wine debugger are a small subset",
 101 "of the commands that gdb would accept.  The commands currently",
 102 "are:\n",
 103 "  break [*<addr>]                      delete break bpnum",
 104 "  disable bpnum                        enable bpnum",
 105 "  help                                 quit",
 106 "  x <addr>                             cont",
 107 "  step                                 next",
 108 "  mode [16,32]                         print <expr>",
 109 "  set <reg> = <expr>                   set *<addr> = <expr>",
 110 "  walk [wnd] <expr>                     dump [wnd, queue] <expr>",
 111 "  info [reg,stack,break,segments]      bt",
 112 "  symbolfile <filename>                define <identifier> <addr>",
 113 "  list <addr> ",
 114 "",
 115 "The 'x' command accepts repeat counts and formats (including 'i') in the",
 116 "same way that gdb does.",
 117 "",
 118 " The following are examples of legal expressions:",
 119 " $eax     $eax+0x3   0x1000   ($eip + 256)  *$eax   *($esp + 3)",
 120 " Also, a nm format symbol table can be read from a file using the",
 121 " symbolfile command.  Symbols can also be defined individually with",
 122 " the define command.",
 123 "",
 124 NULL
 125 };
 126
 127     while(helptext[i]) fprintf(stderr,"%s\n", helptext[i++]);
 128 }
 129
 130
 131
 132 /***********************************************************************
 133  *           DEBUG_List
 134  *
 135  * Implementation of the 'list' command.
 136  */
 137 void DEBUG_List( DBG_ADDR *addr, int count )
 138 {
 139     static DBG_ADDR lasttime = { 0xffffffff, 0 };
 140
 141     if (addr == NULL) addr = &lasttime;
 142     DBG_FIX_ADDR_SEG( addr, CS_reg(DEBUG_context) );
 143     while (count-- > 0)
 144     {
 145         DEBUG_PrintAddress( addr, dbg_mode );
 146         fprintf( stderr, ":  " );
 147         if (!DBG_CHECK_READ_PTR( addr, 1 )) return;
 148         DEBUG_Disasm( addr );
 149         fprintf (stderr, "\n");
 150     }
 151     lasttime = *addr;
 152 }