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

   1 .TH whatexec.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 whatexec.d \- Examine the type of files exec'd. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B whatexec.d
   6 .SH DESCRIPTION
   7 This prints the first four chacacters of files that are executed.
   8 This traces the kernel function findexec_by_hdr(), which checks for
   9 a known magic number in the file's header.
  10
  11 The idea came from a demo I heard about from the UK, where a
  12 "blue screen of death" was displayed for "MZ" files (although I
  13 haven't seen the script or the demo).
  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 unstable - this script uses fbt provider probes which may change for
  21 future updates of the OS, invalidating this script. Please read
  22 Docs/Notes/ALLfbt_notes.txt for further details about these fbt scripts.
  23 .SH EXAMPLES
  24 .TP
  25 Trace execs as they occur,
  26 #
  27 .B whatexec.d
  28 .PP
  29 .SH FIELDS
  30 .TP
  31 PEXEC
  32 parent command name
  33 .TP
  34 EXEC
  35 pathname to file exec'd
  36 .TP
  37 OK
  38 is type runnable, Y/N
  39 .TP
  40 TYPE
  41 first four characters from file
  42 .PP
  43 .SH DOCUMENTATION
  44 See the DTraceToolkit for further documentation under the
  45 Docs directory. The DTraceToolkit docs may include full worked
  46 examples with verbose descriptions explaining the output.
  47 .SH EXIT
  48 whatexec.d will trace until Ctrl\-C is hit.
  49 .SH AUTHOR
  50 Brendan Gregg
  51 [Sydney, Australia]
  52 .SH SEE ALSO
  53 dtrace(1M)