Release 960611
[wine] / 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 }