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

   1 .TH filebyproc.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 filebyproc.d \- snoop opens by process name. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B filebyproc.d
   6 .SH DESCRIPTION
   7 filebyproc.d is a DTrace OneLiner to print file pathnames as they are
   8 opened, including the name of the process calling the open.
   9 A line will be printed regardless of whether the open is actually
  10 successful or not.
  11
  12 This is useful to learn which files applications are attempting to
  13 open, such as config files, database files, log files, etc.
  14
  15 Docs/oneliners.txt and Docs/Examples/oneliners_examples.txt
  16 in the DTraceToolkit contain this as a oneliner that can be cut-n-paste
  17 to run.
  18
  19 Since this uses DTrace, only the root user or users with the
  20 dtrace_kernel privilege can run this command.
  21 .SH OS
  22 Solaris
  23 .SH STABILITY
  24 stable - needs the syscall provider.
  25 .SH EXAMPLES
  26 .TP
  27 This prints new process name and pathnames until Ctrl\-C is hit.
  28 #
  29 .B filebyproc.d
  30 .PP
  31 .SH FIELDS
  32 .TP
  33 CPU
  34 The CPU that recieved the event
  35 .TP
  36 ID
  37 A DTrace probe ID for the event
  38 .TP
  39 FUNCTION:NAME
  40 The DTrace probe name for the event
  41 .TP
  42 remaining fields
  43 The first is the name of the process, the second is the file pathname.
  44 .PP
  45 .SH DOCUMENTATION
  46 See the DTraceToolkit for further documentation under the
  47 Docs directory. The DTraceToolkit docs may include full worked
  48 examples with verbose descriptions explaining the output.
  49 .SH EXIT
  50 filebyproc.d will run forever until Ctrl\-C is hit.
  51 .SH AUTHOR
  52 Brendan Gregg
  53 [Sydney, Australia]
  54 .SH SEE ALSO
  55 opensnoop(1M), dtrace(1M), truss(1)
  56