PERFORCE change 151241 for review
Rene Ladan
rene at FreeBSD.org
Fri Oct 10 20:42:08 UTC 2008
http://perforce.freebsd.org/chv.cgi?CH=151241
Change 151241 by rene at 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 at uk.FreeBSD.org</email></entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </sect1>
</appendix>
<!--
More information about the p4-projects
mailing list