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