freebsd-dev/cddl/contrib/dtracetoolkit
Ed Maste 24d2e21d9b Restore r211786 by rpaulo:
Port dtruss to FreeBSD.

  Sponsored by:   The FreeBSD Foundation

It appears the change was reverted by r235380.
2012-07-05 00:52:23 +00:00
..
Apps Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Bin Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Code Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Cpu Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Disk Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Docs Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Examples Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
FS Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Include Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Java Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
JavaScript Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Kernel Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Locks Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Man Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Mem Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Misc Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Net Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Notes Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Perl Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Php Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Proc Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Python Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Ruby Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Shell Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Snippits Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
System Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Tcl Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
User Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Zones Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
dexplorer Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
dtruss Restore r211786 by rpaulo: 2012-07-05 00:52:23 +00:00
dvmstat Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
errinfo Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
execsnoop Fix execsnoop by changing exece and exec to be FreeBSD's execve. 2012-05-14 21:59:47 +00:00
Guide Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
hotkernel Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
hotuser Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
install Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
iopattern Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
iosnoop Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
iotop Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
License Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
opensnoop Fix opensnoop for FreeBSD by removing probes with 64 at the end as 2012-05-14 21:58:22 +00:00
procsystime Move sh to the correct location for FreeBS (/bin/sh) 2012-05-14 22:00:24 +00:00
README Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
rwsnoop Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
rwtop Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
statsnoop Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00
Version Import dtracetoolkit into cddl/contrib 2012-05-12 21:25:48 +00:00

Guide - Guide to the DTraceToolkit

    How to get started, and a table of contents.

QuickStart

	1. The top most useful scripts are in this directory.
	2. Try running them with "-h". Eg, "./execsnoop -h".
	3. Read Docs/Contents for a full list of scripts.

QuickStart-by-Screenshot

	1. Look through the examples in the Examples directory until
	   you see an output you like
	2. Find the script and run it
	3. Look for its man page in Man

Not-so-QuickStart
	
	1. Welcome!
	2. Check the Table of Contents below to become famaliar with the
	   directory structure of the DTraceToolkit.
	3. See Docs/Faq for any initial questions.
	4. Read Docs/Contents for a list of scripts.
	5. Read Docs/Readme to see where scripts are documented.
	6. Check Docs/Links for further DTrace.
	7. Once famaliar with the toolkit, the following may be useful to
	   add to your shell initialisation file,
		PATH=$PATH:/opt/DTT/Bin
		MANPATH=$MANPATH:/opt/DTT/Man
	   in this case assuming the toolkit was installed in /opt/DTT.

Installation

	1. Run ./install
	   This will replace any existing version of the DTraceToolkit
	   with this one. It will prompt. Final install location is
	   printed by this install script.

Table of Contents

   DTraceToolkit-X.XX/
	Bin/			Symlinks to all the scripts
	Apps/			Application specific scripts
	Cpu/			Scripts for CPU analysis
	Code/			Example code to practise on
	Disk/			Scripts for disk I/O analysis
	Docs/			Documentation
	   Contents		Command list for the Toolkit
	   Faq			Frequently asked questions
	   Links		Further DTrace links
	   Readme		Readme for using the docs
	Examples/		Examples of command usage
	Guide			This file!
	Include/		DTrace include files
	Java/			Scripts for tracing Java
	JavaScript/		Scripts for tracing JavaScript
	Kernel/			Scripts for kernel analysis
	License			The CDDL license
	Locks/			Scripts for lock analysis
	Man/			Man pages
	   man1m/		Man pages for the Toolkit commands
	Mem/			Scripts for memory analysis
	Misc/			Misc scripts
	Net/			Scripts for network analysis
	Notes/			Notes on Toolkit commands
	Perl/			Scripts for tracing Perl
	Php/			Scripts for tracing Php
	Proc/			Scripts for process analysis
	Python/			Scripts for tracing Python
	Ruby/			Scripts for tracing Ruby
	Shell/			Scripts for tracing Shell languages
	Snippits/		Snippits of D scripting
	System/			Scripts for system analysis
	Tcl/			Scripts for tracing Tcl
	User/			Scripts for user based activity analysis
	Zones/			Scripts for analysis by zone
	Version			DTraceToolkit version
	install			Install script, use for installs only

When you type ls in the DTraceToolkit, you will be looking at the top ten 
or so most useful scripts plus the top level directories. Other scripts have
been placed in meaningful subdirectories, such as Disk, Kernel, Proc, etc.

An optional Bin directory has been provided that links to all the scripts.

The DTraceToolkit is released under the CDDL license. It's the same open
source license that OpenSolaris has been released under.

Thank you for using the DTraceToolkit!