sys/ddb/db_examine.c

   1 /*
   2  * Mach Operating System
   3  * Copyright (c) 1991,1990 Carnegie Mellon University
   4  * All Rights Reserved.
   5  *
   6  * Permission to use, copy, modify and distribute this software and its
   7  * documentation is hereby granted, provided that both the copyright
   8  * notice and this permission notice appear in all copies of the
   9  * software, derivative works or modified versions, and any portions
  10  * thereof, and that both notices appear in supporting documentation.
  11  *
  12  * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS
  13  * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
  14  * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
  15  *
  16  * Carnegie Mellon requests users of this software to return to
  17  *
  18  *  Software Distribution Coordinator  or  Software.Distribution@CS.CMU.EDU
  19  *  School of Computer Science
  20  *  Carnegie Mellon University
  21  *  Pittsburgh PA 15213-3890
  22  *
  23  * any improvements or extensions that they make and grant Carnegie the
  24  * rights to redistribute these changes.
  25  *
  26  * $FreeBSD: src/sys/ddb/db_examine.c,v 1.27 1999/08/28 00:41:07 peter Exp $
  27  */
  28
  29 /*
  30  *      Author: David B. Golub, Carnegie Mellon University
  31  *      Date:   7/90
  32  */
  33
  34 #include <sys/param.h>
  35 #include <sys/systm.h>
  36
  37 #include <ddb/ddb.h>
  38
  39 #include <ddb/db_lex.h>
  40 #include <ddb/db_output.h>
  41 #include <ddb/db_command.h>
  42 #include <ddb/db_sym.h>
  43 #include <ddb/db_access.h>
  44
  45 static char     db_examine_format[TOK_STRING_SIZE] = "x";
  46
  47 static void     db_examine (db_addr_t, char *, int);
  48 static void     db_search (db_addr_t, int, db_expr_t, db_expr_t, u_int);
  49
  50 /*
  51  * Examine (print) data.
  52  */
  53 /*ARGSUSED*/
  54 void
  55 db_examine_cmd(db_expr_t addr, boolean_t have_addr, db_expr_t count,
  56                char *modif)
  57 {
  58         if (modif[0] != '\0')
  59             db_strcpy(db_examine_format, modif);
  60
  61         if (count == -1)
  62             count = 1;
  63
  64         db_examine((db_addr_t) addr, db_examine_format, count);
  65 }
  66
  67 /*
  68  * Parameters:
  69  *     fmt:     format string
  70  *     count:   repeat count
  71  */
  72 static void
  73 db_examine(db_addr_t addr, char *fmt, int count)
  74 {
  75         int             c;
  76         db_expr_t       value;
  77         int             size;
  78         int             width;
  79         char *          fp;
  80         char            tbuf[24];
  81
  82         while (--count >= 0) {
  83             fp = fmt;
  84             size = 4;
  85             width = 16;
  86             while ((c = *fp++) != 0) {
  87                 switch (c) {
  88                 case 'b':
  89                         size = 1;
  90                         width = 4;
  91                         break;
  92                 case 'h':
  93                         size = 2;
  94                         width = 8;
  95                         break;
  96                 case 'l':
  97                         size = 4;
  98                         width = 16;
  99                         break;
 100                 case 'g':
 101                         size = 8;
 102                         width = 32;
 103                         break;
 104                 default:
 105                         if (db_print_position() == 0) {
 106                             /* Print the address. */
 107                             db_printsym(addr, DB_STGY_ANY);
 108                             db_printf(":\t");
 109                             db_prev = addr;
 110                         }
 111
 112                         switch (c) {
 113                         case 'a':
 114                                 size = sizeof(void *);
 115                                 value = db_get_value(addr, size, TRUE);
 116                                 addr += size;
 117                                 db_printsym(value, DB_STGY_ANY);
 118                                 break;
 119                         case 'p':
 120                                 size = sizeof(void *);
 121                                 value = db_get_value(addr, size, TRUE);
 122                                 addr += size;
 123                                 db_printf("%p", (void *)value);
 124                                 break;
 125                         case 'r':       /* signed, current radix */
 126                                 value = db_get_value(addr, size, TRUE);
 127                                 addr += size;
 128                                 db_format_radix(tbuf, 24, value, FALSE);
 129                                 db_printf("%-*s", width, tbuf);
 130                                 break;
 131                         case 'x':       /* unsigned hex */
 132                                 value = db_get_value(addr, size, FALSE);
 133                                 addr += size;
 134                                 db_printf("%-*lx", width, (long)value);
 135                                 break;
 136                         case 'z':       /* signed hex */
 137                                 value = db_get_value(addr, size, TRUE);
 138                                 addr += size;
 139                                 db_format_hex(tbuf, 24, value, FALSE);
 140                                 db_printf("%-*s", width, tbuf);
 141                                 break;
 142                         case 'd':       /* signed decimal */
 143                                 value = db_get_value(addr, size, TRUE);
 144                                 addr += size;
 145                                 db_printf("%-*ld", width, (long)value);
 146                                 break;
 147                         case 'u':       /* unsigned decimal */
 148                                 value = db_get_value(addr, size, FALSE);
 149                                 addr += size;
 150                                 db_printf("%-*lu", width, (long)value);
 151                                 break;
 152                         case 'o':       /* unsigned octal */
 153                                 value = db_get_value(addr, size, FALSE);
 154                                 addr += size;
 155                                 db_printf("%-*lo", width, (long)value);
 156                                 break;
 157                         case 'c':       /* character */
 158                                 value = db_get_value(addr, 1, FALSE);
 159                                 addr += 1;
 160                                 if (value >= ' ' && value <= '~')
 161                                     db_printf("%c", (int)value);
 162                                 else
 163                                     db_printf("\\%03o", (int)value);
 164                                 break;
 165                         case 's':       /* null-terminated string */
 166                                 for (;;) {
 167                                     value = db_get_value(addr, 1, FALSE);
 168                                     addr += 1;
 169                                     if (value == 0)
 170                                         break;
 171                                     if (value >= ' ' && value <= '~')
 172                                         db_printf("%c", (int)value);
 173                                     else
 174                                         db_printf("\\%03o", (int)value);
 175                                 }
 176                                 break;
 177                         case 'i':       /* instruction */
 178                                 addr = db_disasm(addr, FALSE, NULL);
 179                                 break;
 180                         case 'I':       /* instruction, alternate form */
 181                                 addr = db_disasm(addr, TRUE, NULL);
 182                                 break;
 183                         default:
 184                                 break;
 185                         }
 186                         if (db_print_position() != 0 ||
 187                             c == 'a' || c == 'p') {
 188                                 db_end_line(1);
 189                         }
 190                         break;
 191                 }
 192             }
 193         }
 194         db_next = addr;
 195 }
 196
 197 /*
 198  * Print value.
 199  */
 200 static char     db_print_format = 'x';
 201
 202 /*ARGSUSED*/
 203 void
 204 db_print_cmd(db_expr_t addr, boolean_t have_addr, db_expr_t count, char *modif)
 205 {
 206         db_expr_t       value;
 207
 208         if (modif[0] != '\0')
 209             db_print_format = modif[0];
 210
 211         switch (db_print_format) {
 212             case 'a':
 213                 db_printsym((db_addr_t)addr, DB_STGY_ANY);
 214                 break;
 215             case 'r':
 216                 {
 217                     char tbuf[24];
 218
 219                     db_format_radix(tbuf, 24, addr, FALSE);
 220                     db_printf("%11s", tbuf);
 221                     break;
 222                 }
 223             case 'x':
 224                 db_printf("%8lx", (unsigned long)addr);
 225                 break;
 226             case 'z':
 227                 {
 228                     char tbuf[24];
 229
 230                     db_format_hex(tbuf, 24, addr, FALSE);
 231                     db_printf("%8s", tbuf);
 232                     break;
 233                 }
 234             case 'd':
 235                 db_printf("%11ld", (long)addr);
 236                 break;
 237             case 'u':
 238                 db_printf("%11lu", (unsigned long)addr);
 239                 break;
 240             case 'o':
 241                 db_printf("%16lo", (unsigned long)addr);
 242                 break;
 243             case 'c':
 244                 value = addr & 0xFF;
 245                 if (value >= ' ' && value <= '~')
 246                     db_printf("%c", (int)value);
 247                 else
 248                     db_printf("\\%03o", (int)value);
 249                 break;
 250         }
 251         db_printf("\n");
 252 }
 253
 254 void
 255 db_print_loc_and_inst(db_addr_t loc, db_regs_t *regs)
 256 {
 257         db_printsym(loc, DB_STGY_PROC);
 258         db_printf(":\t");
 259         db_disasm(loc, TRUE, regs);
 260 }
 261
 262 /*
 263  * Search for a value in memory.
 264  * Syntax: search [/bhl] addr value [mask] [,count]
 265  */
 266 void
 267 db_search_cmd(db_expr_t dummy1, boolean_t dummy2, db_expr_t dummy3,
 268               char *dummy4)
 269 {
 270         int             t;
 271         db_addr_t       addr;
 272         int             size;
 273         db_expr_t       value;
 274         db_expr_t       mask;
 275         db_expr_t       count;
 276
 277         t = db_read_token();
 278         if (t == tSLASH) {
 279             t = db_read_token();
 280             if (t != tIDENT) {
 281               bad_modifier:
 282                 db_printf("Bad modifier\n");
 283                 db_flush_lex();
 284                 return;
 285             }
 286
 287             if (!strcmp(db_tok_string, "b"))
 288                 size = 1;
 289             else if (!strcmp(db_tok_string, "h"))
 290                 size = 2;
 291             else if (!strcmp(db_tok_string, "l"))
 292                 size = 4;
 293             else
 294                 goto bad_modifier;
 295         } else {
 296             db_unread_token(t);
 297             size = 4;
 298         }
 299
 300         if (!db_expression((db_expr_t *)&addr)) {
 301             db_printf("Address missing\n");
 302             db_flush_lex();
 303             return;
 304         }
 305
 306         if (!db_expression(&value)) {
 307             db_printf("Value missing\n");
 308             db_flush_lex();
 309             return;
 310         }
 311
 312         if (!db_expression(&mask))
 313             mask = 0xffffffffUL;
 314
 315         t = db_read_token();
 316         if (t == tCOMMA) {
 317             if (!db_expression(&count)) {
 318                 db_printf("Count missing\n");
 319                 db_flush_lex();
 320                 return;
 321             }
 322         } else {
 323             db_unread_token(t);
 324             count = -1;         /* effectively forever */
 325         }
 326         db_skip_to_eol();
 327
 328         db_search(addr, size, value, mask, count);
 329 }
 330
 331 static void
 332 db_search(db_addr_t addr, int size, db_expr_t value, db_expr_t mask,
 333           unsigned int count)
 334 {
 335         while (count-- != 0) {
 336                 db_prev = addr;
 337                 if ((db_get_value(addr, size, FALSE) & mask) == value)
 338                         break;
 339                 addr += size;
 340         }
 341         db_next = addr;
 342 }