cddl/contrib/dtracetoolkit/Man/man1m/newproc.d.1m

   1 .TH newproc.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 newproc.d \- snoop new processes. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B newproc.d
   6 .SH DESCRIPTION
   7 newproc.d is a DTrace OneLiner to snoop new processes as they are run.
   8 The argument listing is printed.
   9
  10 This is useful to identify short lived processes that are usually
  11 difficult to spot using traditional tools.
  12
  13 Docs/oneliners.txt and Docs/Examples/oneliners_examples.txt
  14 in the DTraceToolkit contain this as a oneliner that can be cut-n-paste
  15 to run.
  16
  17 Since this uses DTrace, only the root user or users with the
  18 dtrace_kernel privilege can run this command.
  19 .SH OS
  20 Solaris
  21 .SH STABILITY
  22 stable - needs the proc provider.
  23 .SH EXAMPLES
  24 .TP
  25 This prints new processes until Ctrl\-C is hit.
  26 #
  27 .B newproc.d
  28 .PP
  29 .SH FIELDS
  30 .TP
  31 CPU
  32 The CPU that recieved the event
  33 .TP
  34 ID
  35 A DTrace probe ID for the event
  36 .TP
  37 FUNCTION:NAME
  38 The DTrace probe name for the event
  39 .TP
  40 remaining fields
  41 These contains the argument listing for the new process
  42 .PP
  43 .SH DOCUMENTATION
  44 See the DTraceToolkit for further documentation under the
  45 Docs directory. The DTraceToolkit docs may include full worked
  46 examples with verbose descriptions explaining the output.
  47 .SH EXIT
  48 newproc.d will run forever until Ctrl\-C is hit.
  49 .SH AUTHOR
  50 Brendan Gregg
  51 [Sydney, Australia]
  52 .SH SEE ALSO
  53 execsnoop(1M), dtrace(1M), truss(1)
  54