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

   1 .TH creatbyproc.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 creatbyproc.d \- snoop creat()s by process name. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B creatbyproc.d
   6 .SH DESCRIPTION
   7 creatbyproc.d is a DTrace OneLiner to print file creations as it
   8 occurs, including the name of the process calling the open.
   9
  10 This matches file creates from the creat() system call; not all
  11 file creation occurs in this way, sometimes it is through open()
  12 with a O_CREAT flag, this script will not monitor that activity.
  13
  14 Docs/oneliners.txt and Docs/Examples/oneliners_examples.txt
  15 in the DTraceToolkit contain this as a oneliner that can be cut-n-paste
  16 to run.
  17
  18 Since this uses DTrace, only the root user or users with the
  19 dtrace_kernel privilege can run this command.
  20 .SH OS
  21 Solaris
  22 .SH STABILITY
  23 stable - needs the syscall provider.
  24 .SH EXAMPLES
  25 .TP
  26 This prints process names and new pathnames until Ctrl\-C is hit.
  27 #
  28 .B creatbyproc.d
  29 .PP
  30 .SH FIELDS
  31 .TP
  32 CPU
  33 The CPU that recieved the event
  34 .TP
  35 ID
  36 A DTrace probe ID for the event
  37 .TP
  38 FUNCTION:NAME
  39 The DTrace probe name for the event
  40 .TP
  41 remaining fields
  42 The first is the name of the process, the second is the file pathname.
  43 .PP
  44 .SH DOCUMENTATION
  45 See the DTraceToolkit for further documentation under the
  46 Docs directory. The DTraceToolkit docs may include full worked
  47 examples with verbose descriptions explaining the output.
  48 .SH EXIT
  49 creatbyproc.d will run forever until Ctrl\-C is hit.
  50 .SH AUTHOR
  51 Brendan Gregg
  52 [Sydney, Australia]
  53 .SH SEE ALSO
  54 dtrace(1M)
  55