term% cat index.txt RATRACE(1) General Commands Manual RATRACE(1)
NAME
ratrace - trace process system calls
SYNOPSIS
ratrace [ pid ] | [ -c command ]
DESCRIPTION
Ratrace shows the system calls executed by a process, either the one
with pid or a fresh invocation of command.
Trace output is determined by the kernel, not ratrace. Certain fixed
rules apply. The first four fields of the output are pid, text name,
system call name, and the PC of the user program. Data is always
printed as pointer/"string", where the string is the first 32 bytes of
the data, with replacing non-printing ASCII characters (printing char‐
acters are those between ASCII space (SP) and delete (DEL), exclusive).
Return values follow an and include the integer return value, the
errstr (with "" if there is no errstr), and the start and stop times
for the system call in nanoseconds. The times are exclusive of the
overhead for tracing.
FILES
/proc/pid/syscall
/proc/pid/ctl
SOURCE
/sys/src/cmd/ratrace.c
SEE ALSO
acid(1), db(1), proc(3)
BUGS
The printing of the data is too limited in length; printing instead of
something more sensible is limiting.
RATRACE(1)