KSYM(3)
NAME
ksym − kernel symbols
SYNOPSIS
bind -a ’#N’ /dev
/dev/ksym
DESCRIPTION
Ksym is intended to aid native kernel and emu(1) monitoring and debugging. It maps kernel addresses to symbolic names obtained from the symbol table of a kernel executable. It also arranges that the format if used by the kernel print(10.2) will produce a symbolic address instead of a hexadecimal number when a known address is printed.
Ksym serves a directory containing a single file, ksym.
A write to the file must provide UTF-encoded lines containing commands or map entries, each line ended by a newline character. A line may be split across two writes to allow a symbol file to be copied into the device by cat(1) or cp(1). There are two commands:
clear Empty the current map. The map is also emptied by each write to file offset 0.
kernel
Make entries for and representing the start and end of the kernel text segment.
Each map entry has the form:
address name
where address is an 8 digit unsigned hexadecimal number and name is a UTF encoded string giving the symbolic name to be associated with that address in the current map.
The file may be read to see the contents of the current map. Each read returns as many lines of the following form as will fit in the caller’s buffer:
address name
where address and name are as defined above for a write request.
SOURCE
/emu/devksym.c
/os/port/devksym.c