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

   1 .TH errinfo 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 errinfo \- print errno for syscall fails. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B errinfo
   6 [\-a|\-A|\-hsvZ] [\-c command]
   7 .SH DESCRIPTION
   8 errinfo snoops syscall failures and prints the errno value and
   9 description of the error number.
  10
  11 This program can help determine if applications are silently
  12 failing, providing some details on the cause.
  13
  14 Since this uses DTrace, only the root user or users with the
  15 dtrace_kernel privilege can run this command.
  16 .SH OS
  17 Solaris
  18 .SH STABILITY
  19 stable - needs the syscall provider.
  20 .SH OPTIONS
  21 .TP
  22 \-c
  23 counts - print an aggregate style report containing a
  24 frequency count of errors
  25 .TP
  26 \-p PID
  27 examine this PID only
  28 .TP
  29 \-n name
  30 examine processes with ths name only (eg, "ls")
  31 .SH EXAMPLES
  32 .TP
  33 Default output, print errors as they occur,
  34 #
  35 .B errinfo
  36 .PP
  37 .TP
  38 Print a frequency count report,
  39 #
  40 .B errinfo
  41 \-c
  42 .PP
  43 .TP
  44 Snoop errors as they occur for "ssh" processes,
  45 #
  46 .B errinfo
  47 \-n ssh
  48 PP
  49 .TP
  50 Snoop errors for PID 81 only,
  51 #
  52 .B errinfo
  53 \-p 81
  54 .PP
  55 .SH FIELDS
  56 .TP
  57 EXEC
  58 Program name (truncated)
  59 .TP
  60 SYSCALL
  61 System call name
  62 .TP
  63 ERR
  64 Value of errno
  65 .TP
  66 DESC
  67 Description of errno message
  68 .PP
  69 .SH DOCUMENTATION
  70 See the DTraceToolkit for further documentation under the
  71 Docs directory. The DTraceToolkit docs may include full worked
  72 examples with verbose descriptions explaining the output.
  73 .SH EXIT
  74 errinfo will run forever until Ctrl\-C is hit.
  75 .SH FILES
  76 .TP
  77 /usr/include/sys/errno.h
  78 Contains the full descriptions for the error numbers.
  79 .PP
  80 .SH AUTHOR
  81 Brendan Gregg
  82 [Sydney, Australia]
  83 .SH SEE ALSO
  84 dtrace(1M), truss(1)
  85