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

   1 .TH modcalls.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 modcalls.d \- kernel function calls by module. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B modcalls.d
   6 .SH DESCRIPTION
   7 modcalls.d is a DTrace OneLiner to a report of the number of
   8 kernel function calls by module.
   9
  10 This script may be useful to determine whether drivers are "thinking" when
  11 troubleshooting driver issues.
  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 Any
  21 .SH STABILITY
  22 stable - while this script uses the unstable fbt provider, it does so
  23 in a stable way.
  24 .SH EXAMPLES
  25 .TP
  26 This samples until Ctrl\-C is hit.
  27 #
  28 .B modcalls.d
  29 .PP
  30 .SH FIELDS
  31 .TP
  32 first field
  33 This is the module name, or kernel driver name. if a name is
  34 unfamiliar to you there may be a man page to explain what it is.
  35 .TP
  36 second field
  37 This is the number of function calls by this module.
  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 modcalls.d will sample until Ctrl\-C is hit.
  45 .SH AUTHOR
  46 Brendan Gregg
  47 [Sydney, Australia]
  48 .SH SEE ALSO
  49 dtrace(1M)
  50