格式说明符

%%

列显 '%' 符号。

%a

以符号形式列显地址。与 %a 关联的值的最小大小是 uintptr_t；不需要指定 %la。如果打开地址到符号的转换，则调试器会尝试将地址转换为符号名称后跟当前输出中的偏移，并列显此字符串；否则，在缺省输出基数中列显值。 如果使用 %#a，则替换格式会将 ':' 后缀添加到输出。

%A

此格式与 %a 相同，只不过无法将地址转换为符号名称以及偏移时，不列显任何内容。如果使用 %#A，则在地址转换失败时替换格式列显 '?'。

%b

以符号形式解码并列显位字段。此说明符需要两个连续参数：位字段值（对于 %b 为 int，对于 %lb 为 long，等等）和一个指向 mdb_bitmask_t 结构的数组的指针：

typedef struct mdb_bitmask {

		const char *bm_name;       /* String name to print */

		u_longlong_t bm_mask;      /* Mask for bits */

		u_longlong_t bm_bits;      /* Result for value & mask */

} mdb_bitmask_t;

数组应该以其 bm_name 字段设置为 NULL 的结构结尾。使用 %b 时，调试器读取值参数，然后循环检查每个 mdb_bitmask 结构以查看是否为以下情况：

(value & bitmask->bm_mask) == bitmask->bm_bits

如果此表达式为真，则列显 bm_name 字符串。列显的每个字符串由逗号分隔。以下示例说明如何使用 %b 解码 kthread_t 中的 t_flag 字段：

const mdb_bitmask_t t_flag_bits[] = {

		{ "T_INTR_THREAD", T_INTR_THREAD, T_INTR_THREAD },

		{ "T_WAKEABLE", T_WAKEABLE, T_WAKEABLE },

		{ "T_TOMASK", T_TOMASK, T_TOMASK },

		{ "T_TALLOCSTK", T_TALLOCSTK, T_TALLOCSTK },

			...

		{ NULL, 0, 0 }

};



void

thr_dump(kthread_t *t)

{

		mdb_printf("t_flag = <%hb>\n", t->t_flag, t_flag_bits);



		...

}

如果 t_flag 设置为 0x000a，则该函数将列显：

t_flag = <T_WAKEABLE,T_TALLOCSTK>

如果指定 %#b，则会将与位掩码数组中的元素不匹配的所有位的联合列显为已解码名称后面的十六进制值。

%c

将指定的整数列显为 ASCII 字符。

%d

将指定的整数列显为带符号十进制值。与 %i 相同。如果指定 %#d，则替换格式将为值添加前缀 '0t'。

%e

以浮点格式 [+/-]d.ddddddde[+/-]dd 列显指定的双精度数，其中在基数字符前有一位，精度为七位，在指数后至少有两位。

%E

使用与 %e 相同的规则列显指定的双精度数，但指数字符将是 'E' 而不是 'e'。

%g

以与 %e 相同的浮点格式列显指定的双精度数，但精度为十六位。如果指定 %llg，则参数应为 long double 类型（四精度浮点值）。

%G

使用与 %g 相同的规则列显指定的双精度数，但指数字符将是 'E' 而不是 'e'。

%i

将指定的整数列显为带符号十进制值。与 %d 相同。如果指定 %#i，则替换格式将为值添加前缀 '0t'。

%I

将指定的 32 位无符号整数列显为点分十进制格式的 Internet IPv4 地址（例如，十六进制值 0xffffffff 将列显为 255.255.255.255）。

%m

列显由空格组成的边距。如果未指定字段，则使用缺省的输出边距宽度；否则，字段宽度确定列显的空格字符数。

%o

将指定的整数列显为无符号八进制值。如果使用 %#o，则替换格式将为输出添加前缀 '0'。

%p

将指定的指针 (void *) 列显为十六进制值。

%q

将指定的整数列显为带符号八进制值。如果使用 %#o，则替换格式将为输出添加前缀 '0'。

%r

在当前输出基数中将指定的整数列显为无符号值。用户可以使用 $d dcmd 更改输出基数。如果指定 %#r，则替换格式将为值添加相应的基数前缀： '0i'（用于二进制）、'0o'（用于八进制）、'0t'（用于十进制）或 '0x'（用于十六进制）。

%R

在当前输出基数中将指定的整数列显为带符号值。如果指定 %#R，则替换格式将为值添加相应的基数前缀。

%s

列显指定的字符串 (char *)。如果字符串指针为 NULL，则列显字符串 '<NULL>'。

%t

前移一个或多个制表停止位置。如果未指定宽度，则输出前移到下一个制表停止位置；否则，字段宽度确定前移多少个制表停止位置。

%T

将输出列前移到字段宽度的下一个倍数。如果未指定字段宽度，则不执行操作。如果当前输出列不是字段宽度的倍数，则将添加空格以前移输出列。

%u

将指定的整数列显为无符号十进制值。如果指定 %#u，则替换格式将为值添加前缀 '0t'。

%x

将指定的整数列显为十六进制值。字符 a-f 用作代表值 10-15 的符号。如果指定 %#x，则替换格式将为值添加前缀 '0x'。

%X

将指定的整数列显为十六进制值。字符 A-F 用作值 10-15 的位。如果指定 %#X，则替换格式将为值添加前缀 '0X'。

%Y

将指定的 time_t 列显为字符串 'year month day HH:MM:SS'。