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

   1 .TH woof.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 woof.d \- Bark for new processes. Needs /dev/audio. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B woof.d &
   6 .SH DESCRIPTION
   7 This is an audio alert daemon for process creation. It is a virtual dog which
   8 barks when it sees new processes. If many processes are being created
   9 quickly, it will bark a lot (and become a nuisance - not just the noise,
  10 but also from consuming too much CPU).
  11
  12 This exists in the DTraceToolkit more for entertainment than
  13 practicality.
  14
  15 Since this uses DTrace, only the root user or users with the
  16 dtrace_kernel privilege can run this command.
  17 .SH OS
  18 Solaris
  19 .SH STABILITY
  20 stable - needs the proc provider, /usr/bin/audioplay, and bark.au.
  21 .SH EXAMPLES
  22 .TP
  23 Run the dog,
  24 #
  25 .B woof.d &
  26 .TP
  27 Hear the dog,
  28 $ find /etc -type f -exec grep localhost {} +
  29 .TP
  30 Drive the dog crazy,
  31 $ find /etc -type f -exec grep localhost {} \\;
  32 .PP
  33 .SH NOTES
  34 Beware of the dog!
  35 .PP
  36 .SH DOCUMENTATION
  37 See the DTraceToolkit for further documentation under the
  38 Docs directory. The DTraceToolkit docs may include full worked
  39 examples with verbose descriptions explaining the output.
  40 .SH EXIT
  41 woof.d will exit on Ctrl-C.
  42 .SH AUTHOR
  43 Brendan Gregg
  44 [Sydney, Australia]
  45 .SH SEE ALSO
  46 sdtaudiocontrol(1), dtrace(1M)