From owner-svn-doc-all@FreeBSD.ORG  Thu Jun  4 17:03:17 2015
Return-Path: <owner-svn-doc-all@FreeBSD.ORG>
Delivered-To: svn-doc-all@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 767B0841;
 Thu,  4 Jun 2015 17:03:17 +0000 (UTC) (envelope-from bcr@FreeBSD.org)
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 631381A32;
 Thu,  4 Jun 2015 17:03:17 +0000 (UTC) (envelope-from bcr@FreeBSD.org)
Received: from svn.freebsd.org ([127.0.1.70])
 by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t54H3H58083214;
 Thu, 4 Jun 2015 17:03:17 GMT (envelope-from bcr@FreeBSD.org)
Received: (from bcr@localhost)
 by svn.freebsd.org (8.14.9/8.14.9/Submit) id t54H3HUY083213;
 Thu, 4 Jun 2015 17:03:17 GMT (envelope-from bcr@FreeBSD.org)
Message-Id: <201506041703.t54H3HUY083213@svn.freebsd.org>
X-Authentication-Warning: svn.freebsd.org: bcr set sender to bcr@FreeBSD.org
 using -f
From: Benedict Reuschling <bcr@FreeBSD.org>
Date: Thu, 4 Jun 2015 17:03:17 +0000 (UTC)
To: doc-committers@freebsd.org, svn-doc-all@freebsd.org,
 svn-doc-head@freebsd.org
Subject: svn commit: r46764 - head/de_DE.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.20
Precedence: list
List-Id: "SVN commit messages for the entire doc trees \(except for &quot;
 user&quot; , &quot; projects&quot; , and &quot; translations&quot;
 \)" <svn-doc-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-doc-all>,
 <mailto:svn-doc-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-all/>
List-Post: <mailto:svn-doc-all@freebsd.org>
List-Help: <mailto:svn-doc-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-all>,
 <mailto:svn-doc-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 04 Jun 2015 17:03:17 -0000

Author: bcr
Date: Thu Jun  4 17:03:16 2015
New Revision: 46764
URL: https://svnweb.freebsd.org/changeset/doc/46764

Log:
  Update to r44577:
  
  Finish the editorial edits for this chapter.
  
  Obtained from: The FreeBSD German Documentation Project

Modified:
  head/de_DE.ISO8859-1/books/handbook/dtrace/chapter.xml

Modified: head/de_DE.ISO8859-1/books/handbook/dtrace/chapter.xml
==============================================================================
--- head/de_DE.ISO8859-1/books/handbook/dtrace/chapter.xml	Thu Jun  4 15:43:11 2015	(r46763)
+++ head/de_DE.ISO8859-1/books/handbook/dtrace/chapter.xml	Thu Jun  4 17:03:16 2015	(r46764)
@@ -10,7 +10,7 @@ that might make this chapter too large.
      The FreeBSD Documentation Project
      $FreeBSD$
      $FreeBSDde: de-docproj/books/handbook/dtrace/chapter.xml,v 1.4 2009/08/22 18:54:15 bcr Exp $
-     basiert auf: r44565
+     basiert auf: r44577
 -->
 <!-- XXXTR: Should probably put links and resources here.  I'm
         nervous about this chapter as it may require a partial
@@ -213,7 +213,8 @@ that might make this chapter too large.
       übersetzen:</para>
 
     <programlisting>options         KDTRACE_HOOKS
-options         DDB_CTF</programlisting>
+options         DDB_CTF
+options         DEBUG=-g</programlisting>
 
     <para>Besitzer der AMD64-Architektur werden wahrscheinlich noch
       die folgende Zeile zur Kernelkonfigurationsdatei
@@ -228,22 +229,34 @@ options         DDB_CTF</programlisting>
 
     <para>Sobald &os; in den neuen Kernel gebootet oder die
       &dtrace;-Kernelmodule mittels <command>kldload
-      dtraceall</command> geladen wurden, besitzt das System
-      Unterstützung für die Korn-Shell.  Dies wird benötigt, da die
-      Sammlung von &dtrace;-Werkzeugen mehrere Dienstprogramme
-      enthält, die in <command>ksh</command> implementiert sind.
-      Vergewissern Sie sich, dass das Paket oder der Port
-      <package>shells/ksh93</package> installiert ist.  Es ist auch
-      möglich, diese Werkzeuge unter <package>shells/pdksh</package>
-      oder <package>shells/mksh</package> laufen zu lassen.</para>
+      dtraceall</command> geladen wurden, benötigt das System
+      Unterstützung für die Korn-Shell, da &dtrace; mehrere
+      Dienstprogramme enthält, die in <command>ksh</command>
+      implementiert sind.  Vergewissern Sie sich, dass das Paket oder
+      der Port <package>shells/ksh93</package> installiert ist.  Es
+      ist auch möglich, diese Werkzeuge unter
+      <package>shells/pdksh</package> oder
+      <package>shells/mksh</package> laufen zu lassen.</para>
 
     <para>Zum Schluss sollten Sie noch den aktuellen
-      &dtrace;-Werkzeugsatz beschaffen.  &os;&nbsp;10 enthält den
-      &dtrace;-Werkzeugsatz in <filename>/usr/share/dtrace</filename>.
-      Andernfalls können Sie den &dtrace;-Werkzeugsatz über das Paket
-      oder den Port <filename
-      role="package">sysutils/DTraceToolkit</filename>
-      installieren.</para>
+      &dtrace;-Werkzeugsatz beschaffen.  Die &dtrace;-Werkzeugsammlung
+      enthält gebrauchsfertige Skripte, um Systeminformationen zu
+      sammeln. Es gibt Skripte zum Überprüfen von offenen Dateien,
+      Speicher- und <acronym>CPU</acronym>-Gebrauch und noch viel
+      mehr.  &os; 10 installiert ein paar dieser Skripte in
+      <filename>/usr/share/dtrace</filename>.  Für andere
+      &os;-Versionen oder um die volle &dtrace;-Werkzeugsammlung zu
+      installieren, verwenden Sie den
+      <package>sysutils/DTraceToolkit</package> Port oder das
+      Paket.</para>
+
+    <note>
+      <para>Die Skripte in <filename>/usr/share/dtrace</filename>
+	wurden speziell für &os; portiert. Nicht alle Skripte
+	in der &dtrace;-Werkzeugsammlung werden in &os; unverändert
+	funktionieren und manche Skript benötigen einigen Aufwand,
+	damit diese auf &os; funktionieren.</para>
+    </note>
 
     <para>Der &dtrace;-Werkzeugsatz beinhaltet viele Skripte in der
       speziellen Sprache von &dtrace;. Diese Sprache wird die
@@ -257,58 +270,46 @@ options         DDB_CTF</programlisting>
   <sect1 xml:id="dtrace-using">
     <title>&dtrace; verwenden</title>
 
+    <para>&dtrace;-Skripte bestehen aus einer Liste von einer oder
+      mehreren <firstterm>Sonden</firstterm> oder
+      Instrumentationspunkten, an denen jede Sonde mit einer Aktion
+      verknüpft ist. Jedesmal, wenn die Bedingung für eine Sonde
+      zutrifft, wird die verknüpfte Aktion ausgeführt. Beispielsweise
+      könnte eine Aktion ausgeführt werden, wenn eine Datei geöffnet,
+      ein Prozess gestartet oder eine Codezeile ausgeführt wird.  Die
+      Aktion könnte die Protokollierung von Informationen sein oder
+      die Änderung von Kontextvariablen. Das Lesen und Schreiben von
+      Kontextvariablen erlaubt es den Sonden, Informationen
+      auszutauschen und kooperativ die Korrelation bestimmter
+      Ereignisse zu analysieren.</para>
+
     <para>Um alle Sonden anzuzeigen, kann der Administrator nun den
       folgenden Befehl eingeben:</para>
 
     <screen>&prompt.root; <userinput>dtrace -l | more</userinput></screen>
 
-    <para>Die &dtrace;-Werkzeugsammlung enthält gebrauchsfertige
-      Skripte, um Systeminformationen zu sammeln. Es gibt Skripte zum
-      Überprüfen von offenen Dateien, Speicher- und
-      <acronym>CPU</acronym>-Gebrauch und noch viel mehr.  Entpacken
-      Sie die Skripte mit dem folgenden Kommando:</para>
-
-    <para>Der Werkzeugsatz ist eine Sammlung von vorgefertigten
-      Skripten, die von &dtrace; ausgeführt werden können, um
-      Systeminformationen zu sammeln.  Es gibt Skripte, die offene
-      Dateien überprüfen, den Speicher,
-      <acronym>CPU</acronym>-Verbrauch und noch viel mehr.  Entpacken
-      Sie die Skripte mit dem folgenden Befehl:</para>
-
-    <screen>&prompt.root; <userinput>gunzip -c DTraceToolkit* | tar xvf -</userinput></screen>
-
-    <para>Wechseln Sie mit dem <command>cd</command>-Kommando in
-      dieses Verzeichnis und ändern Sie die Berechtigung zum Ausführen
-      von allen Dateien, deren Name klein geschrieben ist, auf
-      <literal>755</literal>.</para>
-
-    <para>All diese Skripte müssen inhaltlich verändert werden.
-      Diejenigen, die auf <filename>/usr/bin/ksh</filename> verweisen,
-      müssen in <filename>/usr/local/bin/ksh</filename> geändert
-      werden und die Anderen, welche <filename>/usr/bin/sh</filename>
-      verwenden, müssen so angepasst werden, dass sie
-      <filename>/bin/sh</filename> verwenden.  Schliesslich müssen
-      noch diejenigen, die <filename>/usr/bin/perl</filename>
-      enthalten, auf <filename>/usr/local/bin/perl</filename>
-      umgeschrieben werden.</para>
-
-    <para>Zum Zeitpunkt, an dem dieses Dokument geschrieben wurde,
-      existieren nur zwei Skripte im &dtrace;-Werkzeugsatz, die von
-      &os; komplett unterstützt werden: die Skripte
+    <para>Jede Sonde besitzt eine <literal>ID</literal>, einen
+      <literal>PROVIDER</literal> (dtrace oder fbt), ein
+      <literal>MODULE</literal> und einen <literal>FUNCTION
+      NAME</literal>. Lesen Sie für weitere Informationen zu diesem
+      Kommando &man.dtrace.1;.</para>
+
+    <para>Die Beispiele in diesem Abschnitt geben einen Überblick, wie
+      man zwei dieser voll funktionsfähigen Skripte aus der
+      &dtrace;-Werkzeugsammlung verwendet: die Skripte
       <filename>hotkernel</filename> und
-      <filename>procsystime</filename>.  Diese beiden werden in den
-      folgenden Teilen dieses Abschnitts genauer untersucht.</para>
+      <filename>procsystime</filename>.</para>
 
-    <para><filename>hotkernel</filename> wurde entworfen, um zu
-      identifizieren, welche Funktion die meiste Kernelzeit
-      beansprucht.  Normal ausgeführt, wird es Ausgaben ähnlich der
-      Folgenden produzieren:</para>
+    <para>Das <filename>hotkernel</filename> Skript wurde entworfen,
+      um zu identifizieren, welche Funktion die meiste Kernelzeit
+      beansprucht.  Es wird es Ausgaben ähnlich der Folgenden
+      produzieren:</para>
 
     <screen>&prompt.root; <userinput>cd /usr/share/dtrace/toolkit</userinput>
 &prompt.root; <userinput>./hotkernel</userinput>
 Sampling... Hit Ctrl-C to end.</screen>
 
-    <para>Der Systemadministrator muss die Tastenkombination <keycombo
+    <para>Verwenden Sie wie angegeben die Tastenkombination <keycombo
       action="simul"><keycap>Ctrl</keycap><keycap>C</keycap></keycombo>
       drücken, um den Prozess zu stoppen.  Nach dem Abbruch wird das
       Skript eine Liste von Kernelfunktionen und Zeitmessungen
@@ -346,8 +347,8 @@ kernel`sched_idletd                     
 	how we should look that up. -->
 
     <para>Dieses Skript funktioniert auch mit Kernelmodulen.  Um diese
-      Eigenschaft zu verwenden, starten Sie das Skript mit dem
-      Parameter <option>-m</option>:</para>
+      Eigenschaft zu verwenden, starten Sie das Skript mit
+      <option>-m</option>:</para>
 
     <screen>&prompt.root; <userinput>./hotkernel -m</userinput>
 Sampling... Hit Ctrl-C to end.
@@ -371,13 +372,13 @@ kernel                                  
 	seriously obvious.  It is 5AM btw. -->
 
     <para>Das <filename>procsystime</filename> Skript fängt die
-      Systemaufruf-Zeiten ab und zeigt diese für eine gegebene
-      <acronym>PID</acronym> oder einen Prozessnamen an.  Im folgenden
-      Beispiel wurde eine neue Instanz von
-      <filename>/bin/csh</filename> erzeugt.
-      <filename>procsystime</filename> wurde ausgeführt und verbleibt
-      so, während ein paar Befehle in die andere Instanz von
-      <command>csh</command> eingegeben werden.  Dies sind die
+      Systemaufruf-Zeiten für eine gegebene
+      Prozess-<acronym>ID</acronym> (<acronym>PID</acronym>) oder
+      einen Prozessnamen ab und gibt diese aus.  Im folgenden Beispiel
+      wurde eine neue Instanz von <filename>/bin/csh</filename>
+      erzeugt. Dann wurde <filename>procsystime</filename> ausgeführt
+      und verbleibt so, während ein paar Befehle in die andere Instanz
+      von <command>csh</command> eingegeben werden.  Dies sind die
       Ergebnisse dieses Versuchs:</para>
 
     <screen>&prompt.root; <userinput>./procsystime -n csh</userinput>