1/*	$NetBSD: db_examine.c,v 1.34 2009/03/07 22:02:17 ad 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.34 2009/03/07 22:02:17 ad 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
42static char	db_examine_format[TOK_STRING_SIZE] = "x";
43
44static void	db_examine(db_addr_t, char *, int);
45static 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*/
56void
57db_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
69static void
70db_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 'L':	/* implementation maximum */
105				size = sizeof value;
106				width = 12 * (sizeof value / 4);
107				break;
108			case 'a':	/* address */
109				db_printf("= 0x%lx\n", (long)addr);
110				break;
111			case 'r':	/* signed, current radix */
112				value = db_get_value(addr, size, true);
113				addr += size;
114				db_format_radix(tbuf, 24, value, false);
115				db_printf("%-*s", width, tbuf);
116				break;
117			case 'x':	/* unsigned hex */
118				value = db_get_value(addr, size, false);
119				addr += size;
120				db_printf("%-*" DDB_EXPR_FMT "x", width, value);
121				break;
122			case 'm':	/* hex dump */
123				/*
124				 * Print off in chunks of size. Try to print 16
125				 * bytes at a time into 4 columns. This
126				 * loops modify's count extra times in order
127				 * to get the nicely formatted lines.
128				 */
129
130				bytes = 0;
131				do {
132					for (i = 0; i < size; i++) {
133						value =
134 						    db_get_value(addr+bytes, 1,
135							false);
136						db_printf(
137						    "%02" DDB_EXPR_FMT "x",
138						    value);
139						bytes++;
140						if (!(bytes % 4))
141							db_printf(" ");
142					}
143				} while ((bytes != 16) && count--);
144				/* True up the columns before continuing */
145				for (i = 4; i >= (bytes / 4); i--)
146					db_printf ("\t");
147				/* Print chars,  use . for non-printable's. */
148				while (bytes--) {
149					value = db_get_value(addr, 1, false);
150					addr += 1;
151					if (value >= ' ' && value <= '~')
152						db_printf("%c", (char)value);
153					else
154						db_printf(".");
155				}
156				db_printf("\n");
157				break;
158			case 'z':	/* signed hex */
159				value = db_get_value(addr, size, true);
160				addr += size;
161				db_format_hex(tbuf, 24, value, false);
162				db_printf("%-*s", width, tbuf);
163				break;
164			case 'd':	/* signed decimal */
165				value = db_get_value(addr, size, true);
166				addr += size;
167				db_printf("%-*" DDB_EXPR_FMT "d", width, value);
168				break;
169			case 'u':	/* unsigned decimal */
170				value = db_get_value(addr, size, false);
171				addr += size;
172				db_printf("%-*" DDB_EXPR_FMT "u", width, value);
173				break;
174			case 'o':	/* unsigned octal */
175				value = db_get_value(addr, size, false);
176				addr += size;
177				db_printf("%-*" DDB_EXPR_FMT "o", width, value);
178				break;
179			case 'c':	/* character */
180				value = db_get_value(addr, 1, false);
181				addr += 1;
182				if (value >= ' ' && value <= '~')
183					db_printf("%c", (char)value);
184				else
185					db_printf("\\%03o", (int)value);
186				break;
187			case 's':	/* null-terminated string */
188				for (;;) {
189					value = db_get_value(addr, 1, false);
190					addr += 1;
191					if (value == 0)
192						break;
193					if (value >= ' ' && value <= '~')
194						db_printf("%c", (char)value);
195					else
196						db_printf("\\%03o", (int)value);
197				}
198				break;
199			case 'i':	/* instruction */
200				addr = db_disasm(addr, false);
201				break;
202			case 'I':	/* instruction, alternate form */
203				addr = db_disasm(addr, true);
204				break;
205			default:
206				break;
207			}
208			if (db_print_position() != 0)
209				db_end_line();
210		}
211	}
212	db_next = addr;
213}
214
215/*
216 * Print value.
217 */
218static char	db_print_format = 'x';
219
220/*ARGSUSED*/
221void
222db_print_cmd(db_expr_t addr, bool have_addr, db_expr_t count,
223    const char *modif)
224{
225	db_expr_t	value;
226
227	if (modif[0] != '\0')
228		db_print_format = modif[0];
229
230	switch (db_print_format) {
231	case 'a':
232		db_printsym((db_addr_t)addr, DB_STGY_ANY, db_printf);
233		break;
234	case 'r':
235		{
236			char tbuf[24];
237
238			db_format_radix(tbuf, 24, addr, false);
239			db_printf("%11s", tbuf);
240			break;
241		}
242	case 'x':
243		db_printf("%16" DDB_EXPR_FMT "x", addr);
244		break;
245	case 'z':
246		{
247			char tbuf[24];
248
249			db_format_hex(tbuf, 24, addr, false);
250			db_printf("%8s", tbuf);
251			break;
252		}
253	case 'd':
254		db_printf("%11" DDB_EXPR_FMT "d", addr);
255		break;
256	case 'u':
257		db_printf("%11" DDB_EXPR_FMT "u", addr);
258		break;
259	case 'o':
260		db_printf("%15" DDB_EXPR_FMT "o", addr);
261		break;
262	case 'c':
263		value = addr & 0xFF;
264		if (value >= ' ' && value <= '~')
265			db_printf("%c", (char)value);
266		else
267			db_printf("\\%03o", (int)value);
268		break;
269	}
270	db_printf("\n");
271}
272
273void
274db_print_loc_and_inst(db_addr_t loc)
275{
276
277	db_printsym(loc, DB_STGY_PROC, db_printf);
278	db_printf(":\t");
279	(void) db_disasm(loc, false);
280}
281
282/*
283 * Search for a value in memory.
284 * Syntax: search [/bhl] addr value [mask] [,count]
285 */
286/*ARGSUSED*/
287void
288db_search_cmd(db_expr_t daddr, bool have_addr,
289    db_expr_t dcount, const char *modif)
290{
291	int		t;
292	db_addr_t	addr;
293	int		size;
294	db_expr_t	value;
295	db_expr_t	mask;
296	db_expr_t	count;
297
298	t = db_read_token();
299	if (t == tSLASH) {
300		t = db_read_token();
301		if (t != tIDENT) {
302			bad_modifier:
303			db_printf("Bad modifier\n");
304			db_flush_lex();
305			return;
306		}
307
308		if (!strcmp(db_tok_string, "b"))
309			size = 1;
310		else if (!strcmp(db_tok_string, "h"))
311			size = 2;
312		else if (!strcmp(db_tok_string, "l"))
313			size = 4;
314		else
315			goto bad_modifier;
316	} else {
317		db_unread_token(t);
318		size = 4;
319	}
320
321	if (!db_expression(&value)) {
322		db_printf("Address missing\n");
323		db_flush_lex();
324		return;
325	}
326	addr = (db_addr_t) value;
327
328	if (!db_expression(&value)) {
329		db_printf("Value missing\n");
330		db_flush_lex();
331		return;
332	}
333
334	if (!db_expression(&mask))
335		mask = (int) ~0;
336
337	t = db_read_token();
338	if (t == tCOMMA) {
339		if (!db_expression(&count)) {
340			db_printf("Count missing\n");
341			db_flush_lex();
342			return;
343		}
344	} else {
345		db_unread_token(t);
346		count = -1;		/* effectively forever */
347	}
348	db_skip_to_eol();
349
350	db_search(addr, size, value, mask, count);
351}
352
353static void
354db_search(db_addr_t addr, int size, db_expr_t value, db_expr_t mask,
355    unsigned int count)
356{
357	while (count-- != 0) {
358		db_prev = addr;
359		if ((db_get_value(addr, size, false) & mask) == value)
360			break;
361		addr += size;
362	}
363	db_next = addr;
364}
365