From owner-p4-projects@FreeBSD.ORG Mon Nov 24 22:04:50 2008 Return-Path: Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id D59CF1065677; Mon, 24 Nov 2008 22:04:49 +0000 (UTC) Delivered-To: perforce@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 815041065673 for ; Mon, 24 Nov 2008 22:04:49 +0000 (UTC) (envelope-from rene@FreeBSD.org) Received: from repoman.freebsd.org (repoman.freebsd.org [IPv6:2001:4f8:fff6::29]) by mx1.freebsd.org (Postfix) with ESMTP id 733138FC1B for ; Mon, 24 Nov 2008 22:04:49 +0000 (UTC) (envelope-from rene@FreeBSD.org) Received: from repoman.freebsd.org (localhost [127.0.0.1]) by repoman.freebsd.org (8.14.3/8.14.3) with ESMTP id mAOM4nnF082681 for ; Mon, 24 Nov 2008 22:04:49 GMT (envelope-from rene@FreeBSD.org) Received: (from perforce@localhost) by repoman.freebsd.org (8.14.3/8.14.3/Submit) id mAOM4nJb082679 for perforce@freebsd.org; Mon, 24 Nov 2008 22:04:49 GMT (envelope-from rene@FreeBSD.org) Date: Mon, 24 Nov 2008 22:04:49 GMT Message-Id: <200811242204.mAOM4nJb082679@repoman.freebsd.org> X-Authentication-Warning: repoman.freebsd.org: perforce set sender to rene@FreeBSD.org using -f From: Rene Ladan To: Perforce Change Reviews Cc: Subject: PERFORCE change 153476 for review X-BeenThere: p4-projects@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: p4 projects tree changes List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 24 Nov 2008 22:04:50 -0000 http://perforce.freebsd.org/chv.cgi?CH=153476 Change 153476 by rene@rene_self on 2008/11/24 22:04:30 MFen: use &dtrace; instead of DTrace where appropiate. Rewrap lines in handbook/dtrace which became too long. Checked build, whitespace. Affected files ... .. //depot/projects/docproj_nl/nl_NL.ISO8859-1/books/handbook/dtrace/chapter.sgml#8 edit .. //depot/projects/docproj_nl/nl_NL.ISO8859-1/books/handbook/preface/preface.sgml#8 edit Differences ... ==== //depot/projects/docproj_nl/nl_NL.ISO8859-1/books/handbook/dtrace/chapter.sgml#8 (text+ko) ==== @@ -11,7 +11,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/handbook/dtrace/chapter.sgml,v 1.3 2008/10/10 15:37:53 pgj Exp $ %SOURCE% en_US.ISO8859-1/books/handbook/dtrace/chapter.sgml - %SRCID% 1.5 + %SRCID% 1.6 --> @@ -32,47 +32,47 @@ - DTrace + &dtrace; Overzicht - DTrace + &dtrace; - DTrace-ondersteuning + &dtrace;-ondersteuning - DTrace + &dtrace; - DTrace, ook bekend als Dynamic Tracing, was ontwikkeld door + &dtrace;, ook bekend als Dynamic Tracing, was ontwikkeld door &sun; als een gereedschap om prestatie-bottlenecks in productie- en preproductiesystemen op te sporen. Het is in geen enkel opzicht een debug-gereedschap, maar een gereedschap voor real-time analyse om prestatie- en andere zaken op te sporen. - DTrace is een opmerkelijk profileringsgereedschap, met een + &dtrace; is een opmerkelijk profileringsgereedschap, met een indrukwekkende verzameling mogelijkheden om systeemzaken te diagnosticeren. Het kan ook worden gebruikt om vooraf geschreven scripts te draaien om zo voordeel te halen uit de mogelijkheden. Gebruikers kunnen zelfs hun eigen middelen schrijven door gebruik - te maken van de DTrace D Language, wat ze in staat stelt om hun + te maken van de &dtrace; D Language, wat ze in staat stelt om hun profilering aan te passen aan hun specifieke behoeften. Na het lezen van dit hoofdstuk weet u: - Wat DTrace is en welke mogelijkheden het biedt. + Wat &dtrace; is en welke mogelijkheden het biedt. - De verschillen tussen de DTrace-implementatie van + De verschillen tussen de &dtrace;-implementatie van &solaris; en degene die door &os; wordt aangeboden. - Hoe DTrace op &os; aan te zetten en te gebruiken. + Hoe &dtrace; op &os; aan te zetten en te gebruiken. @@ -117,12 +117,13 @@ Implementatieverschillen - Hoewel DTrace in &os; erg lijkt op degene die in &solaris; + Hoewel &dtrace; in &os; erg lijkt op degene die in &solaris; zit, zijn er verschillen die uitgelegd moeten worden voordat er verder wordt gegaan. Het primaire verschil dat gebruikers zullen - zien is dat DTrace specifiek moet worden aangezet op &os;. Er - zijn kernelopties en modulen die aangezet moeten worden om DTrace - juist te laten werken. Deze zullen later worden uitgelegd. + zien is dat &dtrace; specifiek moet worden aangezet op &os;. Er + zijn kernelopties en modulen die aangezet moeten worden om + &dtrace; juist te laten werken. Deze zullen later worden + uitgelegd. Er is een kerneloptie DDB_CTF die gebruikt wordt om ondersteuning voor het laden van @@ -147,13 +148,14 @@ malloc() op soort in de &os;-kernel toestaat. - Alleen root mag DTrace op &os; gebruiken. - Dit heeft te maken met beveiligingsverschillen, &solaris; heeft - enkele beveiligingscontroles op laag niveau die nog niet bestaan - in &os;. Hierom is /dev/dtrace/dtrace - strikt beperkt tot root. + Alleen root mag &dtrace; op &os; + gebruiken. Dit heeft te maken met beveiligingsverschillen, + &solaris; heeft enkele beveiligingscontroles op laag niveau die + nog niet bestaan in &os;. Hierom is + /dev/dtrace/dtrace strikt beperkt tot + root. - Tenslotte valt de DTrace-software onder de + Tenslotte valt de &dtrace;-software onder de CDDL-licentie van &sun;. De Common Development and Distribution License wordt bij &os; geleverd, zie @@ -162,17 +164,17 @@ . Deze licentie houdt in dat een &os;-kernel met de - DTrace-opties nog steeds onder de BSD-licentie - valt; de CDDL komt echter op de proppen wanneer - de modulen in binaire vorm worden verspreid, of wanneer de - binairen zijn geladen. + &dtrace;-opties nog steeds onder de + BSD-licentie valt; de CDDL + komt echter op de proppen wanneer de modulen in binaire vorm + worden verspreid, of wanneer de binairen zijn geladen. - Ondersteuning voor DTrace aanzetten + Ondersteuning voor &dtrace; aanzetten Voeg de volgende regels toe aan het kernelinstellingenbestand - om ondersteuning voor DTrace aan te zetten: + om ondersteuning voor &dtrace; aan te zetten: options KDTRACE_HOOKS options DDB_CTF @@ -184,7 +186,7 @@ options KDTRACE_FRAME Deze optie biedt ondersteuning voor de mogelijkheid - FBT. DTrace zal zonder deze optie werken; + FBT. &dtrace; zal zonder deze optie werken; er zal echter beperkte ondersteuning zijn voor het volgen van functiegrenzen. @@ -210,29 +212,29 @@ Nadat opnieuw is opgestart en de nieuwe kernel in het geheugen is geladen, dient ondersteuning voor de Korn-shell te worden toegevoegd. Dit is nodig omdat de verschillende hulpmiddelen van - DTrace in ksh zijn geschreven. Installeer + &dtrace; in ksh zijn geschreven. Installeer shells/ksh93. Het is ook mogelijk om deze hulpmiddelen in shells/pdksh of shells/mksh te draaien. - Als laatste dient de huidige DTrace-gereedschapskist verkregen - te worden. De huidige versie is beschikbaar op + Als laatste dient de huidige &dtrace;-gereedschapskist + verkregen te worden. De huidige versie is beschikbaar op . Het bevat een installatiemechanisme; om gebruik te maken van de bijgeleverde hulpmiddelen is installatie echter niet nodig. - DTrace gebruiken + &dtrace; gebruiken Voordat er gebruik wordt gemaakt van de functionaliteit van - DTrace, moet het DTrace-apparaat bestaan. Geef het volgende + &dtrace;, moet het &dtrace;-apparaat bestaan. Geef het volgende commando om het apparaat te laten: &prompt.root; kldload dtraceall - Ondersteuning van DTrace zou nu beschikbaar moeten zijn. De + Ondersteuning van &dtrace; zou nu beschikbaar moeten zijn. De beheerder kan het volgende commando uitvoeren om alle sondes te bekijken: @@ -240,11 +242,11 @@ Alle uitvoer wordt aan het hulpmiddel more doorgegeven omdat het snel de schermbuffer zal laten overstromen. - DTrace kan nu als werkend worden beschouwd. Het is nu tijd om de - gereedschapskist te bekijken. + &dtrace; kan nu als werkend worden beschouwd. Het is nu tijd om + de gereedschapskist te bekijken. De gereedschapskist is een verzameling van kant-en-klare - scripts die met DTrace gedraaid kunnen worden om informatie over + scripts die met &dtrace; gedraaid kunnen worden om informatie over het systeem te verzamelen. Er zijn scripts om open bestanden, geheugen, CPU-gebruik, en nog veel meer te controleren. Pak de scripts uit met het volgende commando: @@ -266,7 +268,7 @@ Op dit moment is het voorzichtig om de lezer eraan te - herinneren dat de ondersteuning voor DTrace in &os; + herinneren dat de ondersteuning voor &dtrace; in &os; niet compleet en experimenteel is. Veel van deze scripts zullen niet werken omdat ze of te &solaris;-specifiek zijn of @@ -275,7 +277,7 @@ Op het moment van schrijven worden slechts twee scripts van de - DTrace Toolkit volledig ondersteund in &os;: de scripts + &dtrace; Toolkit volledig ondersteund in &os;: de scripts hotkernel en procsystime. Dit zijn de twee die we in de volgende gedeelten van deze sectie zullen bekijken. @@ -395,12 +397,12 @@ De taal D - De DTrace-gereedschapskist bevat vele scripts in de speciale - taal van DTrace. Deze taal wordt de taal D genoemd - door de documentatie van &sun;, en lijkt sterk op C++. Een - diepgaande discussie over de taal valt buiten het bereik van dit - document. Het wordt uitgebreid behandeld op - . + De &dtrace;-gereedschapskist bevat vele scripts in de speciale + taal van &dtrace;. Deze taal wordt de taal D + genoemd door de documentatie van &sun;, en lijkt sterk op C++. + Een diepgaande discussie over de taal valt buiten het bereik van + dit document. Het wordt uitgebreid behandeld op + . ==== //depot/projects/docproj_nl/nl_NL.ISO8859-1/books/handbook/preface/preface.sgml#8 (text+ko) ==== @@ -6,7 +6,7 @@ Vertaald door: Remko Lodder %SOURCE% en_US.ISO8859-1/books/handbook/preface/preface.sgml - %SRCID% 1.41 + %SRCID% 1.43 --> @@ -540,10 +540,10 @@ - , DTrace + , &dtrace; - Beschrijft hoe het gereedschap DTrace van &sun; te + Beschrijft hoe het gereedschap &dtrace; van &sun; te configureren en gebruiken in &os;. Dynamisch tracen kan helpen bij het lokaliseren van prestatieproblemen, door real-time systeemanalyse uit te voeren.