From owner-svn-doc-all@FreeBSD.ORG Mon Apr 7 15:12:06 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id AC37138B; Mon, 7 Apr 2014 15:12:06 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 8B85CBC3; Mon, 7 Apr 2014 15:12:06 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s37FC6GU000349; Mon, 7 Apr 2014 15:12:06 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s37FC6wR000348; Mon, 7 Apr 2014 15:12:06 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201404071512.s37FC6wR000348@svn.freebsd.org> From: Dru Lavigne Date: Mon, 7 Apr 2014 15:12:06 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44464 - 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-all@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 07 Apr 2014 15:12:06 -0000 Author: dru Date: Mon Apr 7 15:12:06 2014 New Revision: 44464 URL: http://svnweb.freebsd.org/changeset/doc/44464 Log: Editorial review of Implementation Differences in DTrace. Need to collaborate with someone who knows more about DTrace to finish the review of the rest of this chapter. Sponsored by: iXsystems 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 Mon Apr 7 10:08:43 2014 (r44463) +++ head/en_US.ISO8859-1/books/handbook/dtrace/chapter.xml Mon Apr 7 15:12:06 2014 (r44464) @@ -103,52 +103,50 @@ that might make this chapter too large. Implementation Differences - While the &dtrace; in &os; is very similar to that found - in &solaris;, differences exist that should be explained before - continuing. The primary difference users will notice is that - on &os;, &dtrace; needs to be specifically enabled. There are - kernel options and modules which must be enabled for &dtrace; to - work properly. These will be explained later. + While the &dtrace; in &os; is similar to that found + in &solaris;, differences do exist. + The primary difference is that + on &os;, &dtrace; needs to be specifically enabled by loading + kernel modules or by compiling a custom kernel with specific + options. - There is a DDB_CTF kernel option which - is used to enable support for loading the CTF + &os; uses the DDB_CTF kernel option + to enable support for loading CTF data from kernel modules and the kernel itself. CTF is the &solaris; Compact C Type Format which encapsulates a reduced form of debugging information similar to DWARF and the venerable stabs. - This CTF data is added to the binaries by the + CTF data is added to binaries by the ctfconvert and ctfmerge build tools. The ctfconvert utility parses DWARF ELF debug sections created by the compiler and ctfmerge merges CTF ELF sections from - objects into either executables or shared libraries. More on - how to enable this for the kernel and &os; build is - forthcoming. + objects into either executables or shared libraries. Some different providers exist for &os; than for &solaris;. Most notable is the dtmalloc provider, which allows tracing malloc() by type in the &os; kernel. - Only root may use &dtrace; on &os;. - This is related to security differences, &solaris; has a few + Due to security differences, only root may use &dtrace; on &os;. + &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. + strictly limited to root. - Finally, the &dtrace; software falls under &sun;'s - CDDL license. The Common - Development and Distribution License comes with &os;, - see the + &dtrace; falls under &sun;'s Common + Development and Distribution License + (CDDL) license. To view this license on &os;, + see /usr/src/cddl/contrib/opensolaris/OPENSOLARIS.LICENSE or view it online at - http://www.opensolaris.org/os/licensing. - - 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. + http://www.opensolaris.org/os/licensing. + While a &os; kernel with &dtrace; support + is BSD licensed, + the CDDL is used when the modules are + distributed in binary form or the binaries are loaded.