1 files changed, 57 insertions, 0 deletions
diff --git a/usr.bin/truss/truss.1 b/usr.bin/truss/truss.1
new file mode 100644
index 0000000..878398e
--- /dev/null
+++ b/usr.bin/truss/truss.1
@@ -0,0 +1,57 @@
+.Dd Nov 23, 1997
+.Dt TRUSS 1
+.Os FreeBSD
+.Sh NAME
+.Nm \&truss
+.Nd trace system calls
+.Sh Synopsis
+.Nm \&truss
+.Op Fl S
+.Op Fl p Ar pid
+.Op Fl o Ar file
+command
+.Sh DESCRIPTION
+.Nm \&truss
+traces the system calls called by the specified process or program.
+Output is to the specified output file, or standard error by default.
+It does this by stopping and restarting the process being monitored via
+.Xr procfs 5 .
+.Pp
+The options are as follows:
+.Bl -tag -width command
+.It Fl S
+Do not display information about signals received by the process.
+(Normally,
+.Nm \&ps
+displays signal as well as system call events.)
+.It Fl p
+Follow the process specified by 
+.Ar pid
+instead of a new command.
+.It Fl o
+Print the output to the specified file instead of standard error.
+.It Ar command
+Execute
+.Ar command
+and trace the system calls of it.
+(The
+.Fl p
+and
+.Ar command
+options are mutually exclusive.)
+.Sh EXAMPLES
+# Follow the system calls used in echoing "hello"
+.Dl $ truss /bin/echo hello
+# Do the same, but put the output into a file
+.Dl $ truss -o /tmp/truss.out /bin/echo hello
+# Follow an already-running process
+.Dl $ truss -p 1
+.Sh SEE ALSO
+.Xr procfs 5 ,
+.Xr ktrace 1 ,
+.Xr kdump 1
+.Sh HISTORY
+The
+.Nm truss
+command was written by Sean Eric Fagan for FreeBSD; it was modeled after
+similar commands available for System V Release 4 and SunOS.