cddl/contrib/dtracetoolkit/Man/man1m/dnlcstat.1m

   1 .TH dnlcstat 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 dnlcstat \- DNLC statistics. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B dnlcstat
   6 [interval [count]]
   7 .SH DESCRIPTION
   8 The DNLC is the Directory Name Lookup Cache. Filename lookups often
   9 return a hit from here, before needing to traverse the regular file
  10 system cache or go to disk.
  11
  12 Since this uses DTrace, only the root user or users with the
  13 dtrace_kernel privilege can run this command.
  14 .SH OS
  15 Solaris
  16 .SH STABILITY
  17 unstable - this script uses fbt provider probes which may change for
  18 future updates of the OS, invalidating this script. Please read
  19 Docs/Notes/ALLfbt_notes.txt for further details about these fbt scripts.
  20 .SH EXAMPLES
  21 .TP
  22 Print DNLC statistics every second,
  23 #
  24 .B dnlcstat
  25 .TP
  26 Print every 5 seconds, 6 times,
  27 #
  28 .B dnlcstat
  29 5 6
  30 .PP
  31 .SH FIELDS
  32 .TP
  33 %hit
  34 hit percentage for this sample
  35 .TP
  36 hit
  37 number of DNLC hits in this sample
  38 .TP
  39 miss
  40 number of DNLC misses in this sample
  41 .PP
  42 .SH NOTES
  43 See the CacheKit, http://www.brendangregg.com/cachekit.html for a version
  44 of dnlcstat written in Perl (Kstat) that uses much less CPU.
  45 .PP
  46 .SH DOCUMENTATION
  47 See the DTraceToolkit for further documentation under the
  48 Docs directory. The DTraceToolkit docs may include full worked
  49 examples with verbose descriptions explaining the output.
  50 .SH EXIT
  51 dnlcstat will run until Ctrl\-C is hit, or until the count argument
  52 has been satisfied.
  53 .SH AUTHOR
  54 Brendan Gregg
  55 [Sydney, Australia]
  56 .SH SEE ALSO
  57 dtrace(1M)