cddl/contrib/dtracetoolkit/Man/man1m/lastwords.1m

   1 .TH lastwords 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 lastwords \- print syscalls before exit. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B lastwords command
   6 .SH DESCRIPTION
   7 This prints the last few system calls for processes matching
   8 the given name, when they exit. This makes use of a ring buffer
   9 so that the impact on the system is minimised.
  10
  11 Since this uses DTrace, only the root user or users with the
  12 dtrace_kernel privilege can run this command.
  13 .SH OS
  14 Solaris
  15 .SH STABILITY
  16 stable - needs the syscall and proc providers.
  17 .SH EXAMPLES
  18 .TP
  19 Catch last few syscalls for dying netscape processes,
  20 #
  21 .B lastwords netscape
  22 .PP
  23 .SH FIELDS
  24 .TP
  25 TIME
  26 time of syscall return, ns
  27 .TP
  28 PID
  29 process ID
  30 .TP
  31 EXEC
  32 process name (execname)
  33 .TP
  34 SYSCALL
  35 system call
  36 .TP
  37 RETURN
  38 return value for the system call
  39 .TP
  40 ERR
  41 errno for the system call
  42 .PP
  43 .SH BASED ON
  44 /usr/demo/dtrace/ring.d
  45 .PP
  46 .SH DOCUMENTATION
  47 DTrace Guide "Buffers and Buffering" chapter (docs.sun.com)
  48
  49 See the DTraceToolkit for further documentation under the
  50 Docs directory. The DTraceToolkit docs may include full worked
  51 examples with verbose descriptions explaining the output.
  52 .SH EXIT
  53 lastwords will sample until a command with that name exits.
  54 .SH SEE ALSO
  55 dtruss(1M), dtrace(1M)
  56