Import sources from 2011-03-30 iso image - sys/man

1 files changed, 57 insertions, 0 deletions

diff --git a/sys/man/1/ratrace b/sys/man/1/ratrace
new file mode 100755
index 000000000..515b5214f
--- /dev/null
+++ b/sys/man/1/ratrace
@@ -0,0 +1,57 @@
+.TH RATRACE 1
+.SH NAME
+ratrace \- trace process system calls
+.SH SYNOPSIS
+.B ratrace
+[
+.I pid
+] | [
+.I -c command
+]
+.SH DESCRIPTION
+.I Ratrace
+shows the system calls executed by a process,
+either the one with
+.I pid
+or a fresh invocation of
+.IR command .
+.PP
+Trace output is determined by the kernel, not
+.IR 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
+.IB pointer /\c
+"\fIstring\fP",
+where the
+.I string
+is the first 32 bytes of the data, with
+.L \&.
+replacing non-printing ASCII characters
+(printing characters are those between ASCII space (SP) and delete (DEL), exclusive).
+Return values follow an
+.LR = ,
+and include the integer return value,
+the
+.I errstr
+(with "" if there is no
+.IR errstr ),
+and
+the start and stop times for the system call in nanoseconds.
+The times are exclusive of the overhead for tracing.
+.SH FILES
+.BI /proc/ pid /syscalltrace
+.br
+.BI /proc/ pid /ctl
+.SH SOURCE
+.B /sys/src/cmd/ratrace.c
+.SH "SEE ALSO"
+.IR acid (1),
+.IR db (1),
+.IR proc (3)
+.SH BUGS
+The printing of the data is too limited in length;
+printing
+.L \&.
+instead of something more sensible is limiting.