KSYM(3) 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 `%N' 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 contain-
ing 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 `_kzero' and `etext', 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
Page 1 Plan 9 (printed 12/21/24)
KSYM(3) KSYM(3)
/emu/devksym.c
/os/port/devksym.c
SEE ALSO
kprof(3), acid(10.1), nm(10.1)
Page 2 Plan 9 (printed 12/21/24)