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

   1 .TH pgpginbyproc.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 pgpginbyproc.d \- pages pagedin by process name. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B pgpginbyproc.d
   6 .SH DESCRIPTION
   7 pgpginbyproc.d is a DTrace OneLiner to a report the number of pages
   8 paged in by process name.
   9
  10 This may be one way to help identify the process responsible for
  11 causing heavy read traffic to the disks.
  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 vminfo provider.
  23 .SH EXAMPLES
  24 .TP
  25 This samples until Ctrl\-C is hit.
  26 #
  27 .B pgpginbyproc.d
  28 .PP
  29 .SH FIELDS
  30 .TP
  31 first field
  32 The process name. There may be several PIDs that have the
  33 same process name, for example with numerous instances of "bash". The
  34 value reported will be the sum of them all.
  35 .TP
  36 second field
  37 The number of pages paged in
  38 .PP
  39 .SH DOCUMENTATION
  40 See the DTraceToolkit for further documentation under the
  41 Docs directory. The DTraceToolkit docs may include full worked
  42 examples with verbose descriptions explaining the output.
  43 .SH EXIT
  44 pgpginbyproc.d will sample until Ctrl\-C is hit.
  45 .SH AUTHOR
  46 Brendan Gregg
  47 [Sydney, Australia]
  48 .SH SEE ALSO
  49 iosnoop(1m), dtrace(1M), truss(1)
  50