Date: Fri, 10 Oct 2008 20:42:07 GMT From: Rene Ladan <rene@FreeBSD.org> To: Perforce Change Reviews <perforce@FreeBSD.org> Subject: PERFORCE change 151241 for review Message-ID: <200810102042.m9AKg7UK014812@repoman.freebsd.org>
next in thread | raw e-mail | index | archive | help
http://perforce.freebsd.org/chv.cgi?CH=151241 Change 151241 by rene@rene_self on 2008/10/10 20:41:32 IFC Affected files ... .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/dtrace/chapter.sgml#2 integrate .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/eresources/chapter.sgml#8 integrate Differences ... ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/dtrace/chapter.sgml#2 (text+ko) ==== @@ -8,7 +8,7 @@ <!-- The FreeBSD Documentation Project - $FreeBSD: doc/en_US.ISO8859-1/books/handbook/dtrace/chapter.sgml,v 1.1 2008/09/28 12:03:05 trhodes Exp $ + $FreeBSD: doc/en_US.ISO8859-1/books/handbook/dtrace/chapter.sgml,v 1.3 2008/10/10 15:37:53 pgj Exp $ --> <chapter id="dtrace"> @@ -24,6 +24,15 @@ <title>DTrace</title> + <sect1 id="dtrace-synopsis"> + <title>Synopsis</title> + + <indexterm><primary>DTrace</primary></indexterm> + <indexterm> + <primary>DTrace support</primary> + <see>DTrace</see> + </indexterm> + <para>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, @@ -37,15 +46,6 @@ the DTrace D Language, allowing them to customize their profiling based on specific needs.</para> - <sect1 id="dtrace-synopsis"> - <title>Synopsis</title> - - <indexterm><primary>DTrace</primary></indexterm> - <indexterm> - <primary>DTrace support</primary> - <see>DTrace</see> - </indexterm> - <para>After reading this chapter, you will know:</para> <itemizedlist> @@ -114,7 +114,7 @@ <para>There is a <literal>DDB_CTF</literal> kernel option which is used to enable support for loading the <acronym>CTF</acronym> data from kernel modules and the kernel itself. - <acronym>CTF</acronym> is the &solaris; Compressed C Type format + <acronym>CTF</acronym> is the &solaris; Compact C Type Format which encapsulates a reduced form of debugging information similar to <acronym>DWARF</acronym> and the venerable stabs. This <acronym>CTF</acronym> data is added to the binaries by the @@ -143,8 +143,7 @@ and Distribution License</literal> comes with &os;, see the <filename>/usr/src/cddl/contrib/opensolaris/OPENSOLARIS.LICENSE</filename> or view it online at - <ulink url="http://www.opensolaris.org/os/licensing">; - http://www.opensolaris.org/os/licensing</ulink>.</para>; + <ulink url="http://www.opensolaris.org/os/licensing"></ulink>.</para>; <para>This license means that a &os; kernel with the DTrace options is still <acronym>BSD</acronym> licensed; however the @@ -172,14 +171,14 @@ will be limited support for function boundary tracing.</para> </note> - <para>All sources must be rebuilt and installed with CTF options. + <para>All sources must be rebuilt and installed with <acronym>CTF</acronym> options. To accomplish this task, rebuild the &os; sources using:</para> <screen>&prompt.root; <userinput>cd /usr/src</userinput> - &prompt.root; <userinput>make WITH_CTF=1 buildworld</userinput> - &prompt.root; <userinput>make WITH_CFT=1 kernel</userinput> - &prompt.root; <userinput>make WITH_CFT=1 installworld</userinput> - &prompt.root; <userinput>mergemaster -Ui</userinput></screen> +&prompt.root; <userinput>make WITH_CTF=1 buildworld</userinput> +&prompt.root; <userinput>make WITH_CFT=1 kernel</userinput> +&prompt.root; <userinput>make WITH_CFT=1 installworld</userinput> +&prompt.root; <userinput>mergemaster -Ui</userinput></screen> <para>The system will need to be restarted.</para> @@ -194,8 +193,7 @@ <para>Finally, obtain the current DTrace toolkit. The current version is available at - <ulink url="http://www.opensolaris.org/os/community/dtrace/dtracetoolkit/">; - http://www.opensolaris.org/os/community/dtrace/dtracetoolkit/</ulink>. + <ulink url="http://www.opensolaris.org/os/community/dtrace/dtracetoolkit/"></ulink>. There is an install mechanism included; however, installation is not required to make use of the bundled utilities.</para> </sect1> @@ -260,7 +258,6 @@ will produce output similar to the following:</para> <screen>&prompt.root; <userinput>./hotkernel</userinput> -localhost# ./hotkernel Sampling... Hit Ctrl-C to end.</screen> <para>The system administrator must use the @@ -304,9 +301,7 @@ <para>This script will also work with kernel modules. To use this feature, run the script with the <option>-m</option> flag:</para> - <screen>&prompt.root; <userinput>./hotkernel -m</userinput></screen> - - <screen>localhost# <userinput>./hotkernel -m</userinput> + <screen>&prompt.root; <userinput>./hotkernel -m</userinput> Sampling... Hit Ctrl-C to end. ^C MODULE COUNT PCNT @@ -362,7 +357,7 @@ sigsuspend 6985124 read 3988049784</screen> - <para>As shown, the read system call seems to use the + <para>As shown, the <function>read()</function> system call seems to use the most time in nanoseconds with the <function>getpid()</function> system call used the least amount of time.</para> </sect1> ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/eresources/chapter.sgml#8 (text+ko) ==== @@ -1,7 +1,7 @@ <!-- The FreeBSD Documentation Project - $FreeBSD: doc/en_US.ISO8859-1/books/handbook/eresources/chapter.sgml,v 1.191 2008/10/08 17:51:04 keramida Exp $ + $FreeBSD: doc/en_US.ISO8859-1/books/handbook/eresources/chapter.sgml,v 1.193 2008/10/09 10:19:07 ceri Exp $ --> <appendix id="eresources"> @@ -688,7 +688,7 @@ </row> <row> - <entry>&a.svn-src-stable-6;</entry> + <entry>&a.svn-src-stable-6.name;</entry> <entry><filename>/usr/src</filename></entry> <entry>All changes to the <filename>stable/6</filename> branch of the src Subversion repository</entry> @@ -1937,38 +1937,6 @@ </tgroup> </informaltable> </sect1> - - <sect1 id="eresources-shell"> - <title>Shell Accounts</title> - - <para>The following user groups provide shell accounts for people who are - actively supporting the FreeBSD project. The listed administrator - reserves the right to cancel the account if it is abused in any - way.</para> - - <informaltable frame="none" pgwide="1"> - <tgroup cols="4"> - <thead> - <row> - <entry>Host</entry> - <entry>Access</entry> - <entry>Facilities</entry> - <entry>Administrator</entry> - </row> - </thead> - - <tbody> - <row> - <entry>dogma.freebsd-uk.eu.org</entry> - <entry>Telnet/FTP/SSH</entry> - <entry>Email, Web space, Anonymous FTP</entry> - <entry>Lee Johnston - <email>lee@uk.FreeBSD.org</email></entry> - </row> - </tbody> - </tgroup> - </informaltable> - </sect1> </appendix> <!--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200810102042.m9AKg7UK014812>