From owner-svn-doc-head@FreeBSD.ORG Sat Jan 19 21:28:39 2013 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 08EE2869; Sat, 19 Jan 2013 21:28:39 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id D377AEB; Sat, 19 Jan 2013 21:28:38 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.5/8.14.5) with ESMTP id r0JLScqK094785; Sat, 19 Jan 2013 21:28:38 GMT (envelope-from bcr@svn.freebsd.org) Received: (from bcr@localhost) by svn.freebsd.org (8.14.5/8.14.5/Submit) id r0JLScC6094784; Sat, 19 Jan 2013 21:28:38 GMT (envelope-from bcr@svn.freebsd.org) Message-Id: <201301192128.r0JLScC6094784@svn.freebsd.org> From: Benedict Reuschling Date: Sat, 19 Jan 2013 21:28:38 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r40686 - head/en_US.ISO8859-1/books/handbook/dtrace X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 19 Jan 2013 21:28:39 -0000 Author: bcr Date: Sat Jan 19 21:28:38 2013 New Revision: 40686 URL: http://svnweb.freebsd.org/changeset/doc/40686 Log: This is a whitespace cleanup for the DTrace chapter. No content changes, so translators can ignore it. Submitted by: Dru Lavigne Modified: head/en_US.ISO8859-1/books/handbook/dtrace/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/dtrace/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/dtrace/chapter.xml Sat Jan 19 21:09:11 2013 (r40685) +++ head/en_US.ISO8859-1/books/handbook/dtrace/chapter.xml Sat Jan 19 21:28:38 2013 (r40686) @@ -34,18 +34,18 @@ that might make this chapter too large. &dtrace; - &dtrace;, also known as Dynamic Tracing, was developed by - &sun; as a tool for locating performance bottlenecks - in production and pre-production systems. It is not, in any way, - a debugging tool, but a tool for real time system analysis to - locate performance and other issues. - - &dtrace; is a remarkable profiling tool, with an impressive - array of features for diagnosing system issues. It may also be - used to run pre-written scripts to take advantage of its - capabilities. Users may even author their own utilities using - the &dtrace; D Language, allowing them to customize their profiling - based on specific needs. + &dtrace;, also known as Dynamic Tracing, was developed by + &sun; as a tool for locating performance bottlenecks in + production and pre-production systems. It is not, in any way, + a debugging tool, but a tool for real time system analysis to + locate performance and other issues. + + &dtrace; is a remarkable profiling tool, with an impressive + array of features for diagnosing system issues. It may also + be used to run pre-written scripts to take advantage of its + capabilities. Users may even author their own utilities using + the &dtrace; D Language, allowing them to customize their + profiling based on specific needs. After reading this chapter, you will know: @@ -55,8 +55,8 @@ that might make this chapter too large. - Differences between the &solaris; &dtrace; implementation - and the one provided by &os;. + Differences between the &solaris; &dtrace; + implementation and the one provided by &os;. @@ -136,20 +136,22 @@ that might make this chapter too large. Only root may use &dtrace; on &os;. This is related to security differences, &solaris; has a few low level security checks which do not yet exist in &os;. As - such, the /dev/dtrace/dtrace is strictly - limited to root users only. + such, the /dev/dtrace/dtrace is + strictly limited to root users only. Finally, the &dtrace; software falls under &sun;'s - CDDL license. The Common Development - and Distribution License comes with &os;, see the + CDDL license. The Common + Development and Distribution License comes with &os;, + see the /usr/src/cddl/contrib/opensolaris/OPENSOLARIS.LICENSE or view it online at - . + . - This license means that a &os; kernel with the &dtrace; options - is still BSD licensed; however the - CDDL kicks in when the modules are distributed - in binary form, or the binaries are loaded. + This license means that a &os; kernel with the &dtrace; + options is still BSD licensed; however + the CDDL kicks in when the modules are + distributed in binary form, or the binaries are loaded. @@ -167,12 +169,14 @@ options DDB_CTF options KDTRACE_FRAME - This option provides support for the FBT - feature. &dtrace; will work without this option; however, there - will be limited support for function boundary tracing. - + This option provides support for the + FBT feature. &dtrace; will work without + this option; however, there will be limited support for + function boundary tracing. + - All sources must be rebuilt and installed with CTF options. + All sources must be rebuilt and installed with + CTF options. To accomplish this task, rebuild the &os; sources using: This script will also work with kernel modules. To use this - feature, run the script with the flag: + feature, run the script with the + flag: &prompt.root; ./hotkernel -m Sampling... Hit Ctrl-C to end. @@ -366,20 +373,22 @@ Elapsed Times for processes csh, sigsuspend 6985124 read 3988049784 - As shown, the read() system call seems to use the - most time in nanoseconds with the getpid() - system call used the least amount of time. + As shown, the read() system call + seems to use the most time in nanoseconds with the + getpid() system call used the least amount + of time. The D Language - The &dtrace; Toolkit includes many scripts in the special language of - &dtrace;. This language is called the D language by &sun; - documentation, and it is very similar to C++. An in depth - discussion of the language is beyond the scope of this document. It is - extensively discussed - at . + The &dtrace; Toolkit includes many scripts in the special + language of &dtrace;. This language is called the D + language by &sun; documentation, and it is very similar + to C++. An in depth discussion of the language is beyond the + scope of this document. It is extensively discussed + at .