From owner-p4-projects@FreeBSD.ORG Thu Oct 16 20:43:22 2008 Return-Path: Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id 53B76106569C; Thu, 16 Oct 2008 20:43:22 +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 15CD9106569A for ; Thu, 16 Oct 2008 20:43:22 +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 02C8B8FC1B for ; Thu, 16 Oct 2008 20:43:22 +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 m9GKhLXs094833 for ; Thu, 16 Oct 2008 20:43:21 GMT (envelope-from rene@FreeBSD.org) Received: (from perforce@localhost) by repoman.freebsd.org (8.14.3/8.14.3/Submit) id m9GKhLVN094831 for perforce@freebsd.org; Thu, 16 Oct 2008 20:43:21 GMT (envelope-from rene@FreeBSD.org) Date: Thu, 16 Oct 2008 20:43:21 GMT Message-Id: <200810162043.m9GKhLVN094831@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 151464 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: Thu, 16 Oct 2008 20:43:22 -0000 http://perforce.freebsd.org/chv.cgi?CH=151464 Change 151464 by rene@rene_self on 2008/10/16 20:42:42 Section 1 of DTrace is translated (rev 1.3). Checked build. Affected files ... .. //depot/projects/docproj_nl/nl_NL.ISO8859-1/books/handbook/dtrace/chapter.sgml#2 edit Differences ... ==== //depot/projects/docproj_nl/nl_NL.ISO8859-1/books/handbook/dtrace/chapter.sgml#2 (text+ko) ==== @@ -7,8 +7,11 @@ --> @@ -17,74 +20,83 @@ Tom Rhodes - Written by + Geschreven door + + + + + René + Ladan + Vertaald door DTrace - 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, - a debugging tool, but a tool for real time system analysis to - locate performance and other issues. - - DTrace is a remarkable profiling tool, with an impressive - array of features for diagnosing system issues. It may also be - used to run pre-written scripts to take advantage of its - capabilities. Users may even author their own utilities using - the DTrace D Language, allowing them to customize their profiling - based on specific needs. - - Synopsis + Overzicht DTrace + - DTrace support + DTrace-ondersteuning + DTrace - After reading this chapter, you will know: + 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 gereedscahp voor real-time analyse + om prestatie- en andere zaken op te sporen. + + 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 + profiling aan te passen aan hun specifieke behoeften. + + Na het lezen van dit hoofdstuk weet u: - What DTrace is and what features it provides. + Wat DTrace is en welke mogelijkheden het biedt. - Differences between the &solaris; DTrace implementation - and the one provided by &os;. + De verschillen tussen de DTrace-implementatie van + &solaris; en degene die door &os; wordt aangeboden. - How to enable and use DTrace on &os;. + Hoe DTrace op &os; aan te zetten en te gebruiken. - Before reading this chapter, you should: + Voordat u dit hoofdstuk leest, dient u: - Understand &unix; and &os; basics + De beginselen van &unix; en &os; te begrijpen (). - Be familiar with - the basics of kernel configuration/compilation - (). + Bekend te zijn met de beginselen van kernelconfiguratie en + -compilatie (). - Have some familiarity with security and how it - pertains to &os; (). + Wat bekendheid te hebben met beveiliging en hoe het zich + verhoudt tot &os; (). - Understand how to obtain and rebuild the &os; sources - (). + Te begrijpen hoe de broncode van &os; te verkrijgen en te + herbouwen (). @@ -93,11 +105,12 @@ and production versions of FreeBSD with this technology. --> - This feature is considered experimental. Some options - may be lacking in functionality, other parts may not work - at all. In time, this feature will be considered production - ready and this documentation will be altered to fit that - situation. + Deze mogelijkheid wordt als experimenteel beschouwd. Van + sommige opties kan er functionaliteit ontbreken, andere delen + kunnen in het geheel niet werken. In de loop der tijd zal deze + mogelijkheid als productierijp worden beschouwd en zal deze + documentatie worden aangepast om die situatie te + representeren. @@ -114,7 +127,7 @@ There is a DDB_CTF kernel option which is used to enable support for loading the CTF data from kernel modules and the kernel itself. - CTF is the &solaris; Compressed C Type format + 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 @@ -143,8 +156,7 @@ and Distribution License comes with &os;, see the /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 @@ -172,14 +184,14 @@ will be limited support for function boundary tracing. - All sources must be rebuilt and installed with CTF options. + All sources must be rebuilt and installed with CTF options. To accomplish this task, rebuild the &os; sources using: &prompt.root; cd /usr/src - &prompt.root; make WITH_CTF=1 buildworld - &prompt.root; make WITH_CFT=1 kernel - &prompt.root; make WITH_CFT=1 installworld - &prompt.root; mergemaster -Ui +&prompt.root; make WITH_CTF=1 buildworld +&prompt.root; make WITH_CFT=1 kernel +&prompt.root; make WITH_CFT=1 installworld +&prompt.root; mergemaster -Ui The system will need to be restarted. @@ -194,8 +206,7 @@ Finally, obtain the current DTrace toolkit. The current version is available at - - http://www.opensolaris.org/os/community/dtrace/dtracetoolkit/. + . There is an install mechanism included; however, installation is not required to make use of the bundled utilities. @@ -260,7 +271,6 @@ will produce output similar to the following: &prompt.root; ./hotkernel -localhost# ./hotkernel Sampling... Hit Ctrl-C to end. The system administrator must use the @@ -304,9 +314,7 @@ This script will also work with kernel modules. To use this feature, run the script with the flag: - &prompt.root; ./hotkernel -m - - localhost# ./hotkernel -m + &prompt.root; ./hotkernel -m Sampling... Hit Ctrl-C to end. ^C MODULE COUNT PCNT @@ -362,7 +370,7 @@ sigsuspend 6985124 read 3988049784 - As shown, the read system call seems to use the + As shown, the read() system call seems to use the most time in nanoseconds with the getpid() system call used the least amount of time.