Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

handbook/dtrace: fix minor link and markup defects #395

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions documentation/content/de/books/handbook/dtrace/_index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ DTrace, auch bekannt als Dynamic Tracing, wurde von Sun(TM) als ein Werkzeug zur

DTrace ist ein bemerkenswertes Werkzeug zur Profilerstellung, mit einer beeindruckenden Palette von Eigenschaften zur Diagnose von Systemereignissen. Es kann auch dazu verwendet werden, bestehende Skripte ablaufen zu lassen, um einen Nutzen aus deren Möglichkeiten zu ziehen. Nutzer können mittels der Programmiersprache D von DTrace ihre eigenen Hilfsmittel schreiben, was es ermöglicht, die eigenen Profile nach Ihren Bedürfnissen anzupassen.

Die DTrace-Implementierung in FreeBSD bietet experimentelle Unterstützung für DTrace im Userland. Userland DTrace erlaubt es Anwendern, function boundary tracing für Anwendungsprogramme über den `pid`-Provider hinweg vorzunehmen und um statische Sonden in Anwendungsprogramme für die spätere Aufzeichnung einzufügen. Manche Ports, wie beispielsweise package:databases/postgresql12-server[] und package:lang/php74[] besitzen eine DTrace-Option, um statische Sonden zu aktivieren.
Die DTrace-Implementierung in FreeBSD bietet experimentelle Unterstützung für DTrace im Userland. Userland DTrace erlaubt es Anwendern, function boundary tracing für Anwendungsprogramme über den `pid`-Provider hinweg vorzunehmen und um statische Sonden in Anwendungsprogramme für die spätere Aufzeichnung einzufügen. Manche Ports, wie beispielsweise package:databases/memcached[] und package:net-mgmt/lldpd[] besitzen eine DTrace-Option, um statische Sonden zu aktivieren.

Eine offizielle Anleitung für DTrace wird vom Illumos Projekt im http://dtrace.org/guide[DTrace Guide] bereitgestellt.

Expand Down Expand Up @@ -125,7 +125,7 @@ Zum Schluss sollten Sie noch den aktuellen DTrace-Werkzeugsatz beschaffen. Die D
Die Skripte in [.filename]#/usr/shared/dtrace# wurden speziell für FreeBSD portiert. Nicht alle Skripte in der DTrace-Werkzeugsammlung werden in FreeBSD unverändert funktionieren und manche Skript benötigen einigen Aufwand, damit diese auf FreeBSD funktionieren.
====

Der DTrace-Werkzeugsatz beinhaltet viele Skripte in der speziellen Sprache von DTrace. Diese Sprache wird die D-Sprache genannt und ist sehr ähnlich zu C++. Eine detaillierte Beschreibung dieser Sprache würde den Rahmen dieses Dokuments sprengen. Im http://www.dtrace.org/guide[Illumos Dynamic Tracing Guide] wird diese Sprache ausführlich beschrieben.
Der DTrace-Werkzeugsatz beinhaltet viele Skripte in der speziellen Sprache von DTrace. Diese Sprache wird die D-Sprache genannt und ist sehr ähnlich zu C++. Eine detaillierte Beschreibung dieser Sprache würde den Rahmen dieses Dokuments sprengen. Im http://dtrace.org/guide[Illumos Dynamic Tracing Guide] wird diese Sprache ausführlich beschrieben.

[[dtrace-using]]
== DTrace verwenden
Expand Down
6 changes: 3 additions & 3 deletions documentation/content/en/books/handbook/dtrace/_index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ Users can author their own utilities using the DTrace D Language, allowing them

The FreeBSD implementation provides full support for kernel DTrace and experimental support for userland DTrace.
Userland DTrace allows users to perform function boundary tracing for userland programs using the `pid` provider, and to insert static probes into userland programs for later tracing.
Some ports, such as package:databases/postgresql12-server[] and package:lang/php74[] have a DTrace option to enable static probes.
Some ports, such as package:databases/memcached[] and package:net-mgmt/lldpd[] have a DTrace option to enable static probes.

The official guide to DTrace is maintained by the Illumos project at http://dtrace.org/guide[DTrace Guide].

Expand Down Expand Up @@ -92,7 +92,7 @@ Beginning with FreeBSD 10.0-RELEASE, the modules are automatically loaded when `
FreeBSD uses the `DDB_CTF` kernel option to enable support for loading `CTF` data from kernel modules and the kernel itself.
`CTF` is the Solaris(TM) Compact C Type Format which encapsulates a reduced form of debugging information similar to `DWARF` and the venerable stabs.
`CTF` data is added to binaries by the `ctfconvert` and `ctfmerge` build tools.
The `ctfconvert` utility parses `DWARF``ELF` debug sections created by the compiler and `ctfmerge` merges `CTF``ELF` sections from objects into either executables or shared libraries.
The `ctfconvert` utility parses `DWARF` `ELF` debug sections created by the compiler and `ctfmerge` merges `CTF` `ELF` sections from objects into either executables or shared libraries.

Some different providers exist for FreeBSD than for Solaris(TM).
Most notable is the `dtmalloc` provider, which allows tracing `malloc()` by type in the FreeBSD kernel.
Expand Down Expand Up @@ -151,7 +151,7 @@ Not all of the scripts found in the DTrace Toolkit will work as-is on FreeBSD an
The DTrace Toolkit includes many scripts in the special language of DTrace.
This language is called the D language and it is very similar to C++.
An in depth discussion of the language is beyond the scope of this document.
It is covered extensively in the http://www.dtrace.org/guide[Illumos Dynamic Tracing Guide].
It is covered extensively in the http://dtrace.org/guide[Illumos Dynamic Tracing Guide].

[[dtrace-out-of-kernel]]
== Enabling DTrace in Out-of-Kernel Modules
Expand Down
8 changes: 4 additions & 4 deletions documentation/content/en/books/handbook/dtrace/_index.po
Original file line number Diff line number Diff line change
Expand Up @@ -73,8 +73,8 @@ msgid ""
"experimental support for userland DTrace. Userland DTrace allows users to "
"perform function boundary tracing for userland programs using the `pid` "
"provider, and to insert static probes into userland programs for later "
"tracing. Some ports, such as package:databases/postgresql12-server[] and "
"package:lang/php74[] have a DTrace option to enable static probes."
"tracing. Some ports, such as package:databases/memcached[] and "
"package:net-mgmt/lldpd[] have a DTrace option to enable static probes."
msgstr ""

#. type: Plain text
Expand Down Expand Up @@ -161,8 +161,8 @@ msgid ""
"Compact C Type Format which encapsulates a reduced form of debugging "
"information similar to `DWARF` and the venerable stabs. `CTF` data is added "
"to binaries by the `ctfconvert` and `ctfmerge` build tools. The "
"`ctfconvert` utility parses `DWARF``ELF` debug sections created by the "
"compiler and `ctfmerge` merges `CTF``ELF` sections from objects into either "
"`ctfconvert` utility parses `DWARF` `ELF` debug sections created by the "
"compiler and `ctfmerge` merges `CTF` `ELF` sections from objects into either "
"executables or shared libraries."
msgstr ""

Expand Down
6 changes: 3 additions & 3 deletions documentation/content/pl/books/handbook/dtrace/_index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ DTrace, also known as Dynamic Tracing, was developed by Sun(TM) as a tool for lo

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 can author their own utilities using the DTrace D Language, allowing them to customize their profiling based on specific needs.

The FreeBSD implementation provides full support for kernel DTrace and experimental support for userland DTrace. Userland DTrace allows users to perform function boundary tracing for userland programs using the `pid` provider, and to insert static probes into userland programs for later tracing. Some ports, such as package:databases/postgresql12-server[] and package:lang/php74[] have a DTrace option to enable static probes.
The FreeBSD implementation provides full support for kernel DTrace and experimental support for userland DTrace. Userland DTrace allows users to perform function boundary tracing for userland programs using the `pid` provider, and to insert static probes into userland programs for later tracing. Some ports, such as package:databases/memcached[] and package:net-mgmt/lldpd[] have a DTrace option to enable static probes.

The official guide to DTrace is maintained by the Illumos project at http://dtrace.org/guide[DTrace Guide].

Expand All @@ -80,7 +80,7 @@ While the DTrace in FreeBSD is similar to that found in Solaris(TM), differences

Beginning with FreeBSD 10.0-RELEASE, the modules are automatically loaded when `dtrace` is run.

FreeBSD uses the `DDB_CTF` kernel option to enable support for loading `CTF` data from kernel modules and the kernel itself. `CTF` is the Solaris(TM) Compact C Type Format which encapsulates a reduced form of debugging information similar to `DWARF` and the venerable stabs. `CTF` data is added to binaries by the `ctfconvert` and `ctfmerge` build tools. The `ctfconvert` utility parses `DWARF``ELF` debug sections created by the compiler and `ctfmerge` merges `CTF``ELF` sections from objects into either executables or shared libraries.
FreeBSD uses the `DDB_CTF` kernel option to enable support for loading `CTF` data from kernel modules and the kernel itself. `CTF` is the Solaris(TM) Compact C Type Format which encapsulates a reduced form of debugging information similar to `DWARF` and the venerable stabs. `CTF` data is added to binaries by the `ctfconvert` and `ctfmerge` build tools. The `ctfconvert` utility parses `DWARF` `ELF` debug sections created by the compiler and `ctfmerge` merges `CTF` `ELF` sections from objects into either executables or shared libraries.

Some different providers exist for FreeBSD than for Solaris(TM). Most notable is the `dtmalloc` provider, which allows tracing `malloc()` by type in the FreeBSD kernel. Some of the providers found in Solaris(TM), such as `cpc` and `mib`, are not present in FreeBSD. These may appear in future versions of FreeBSD. Moreover, some of the providers available in both operating systems are not compatible, in the sense that their probes have different argument types. Thus, `D` scripts written on Solaris(TM) may or may not work unmodified on FreeBSD, and vice versa.

Expand Down Expand Up @@ -119,7 +119,7 @@ Finally, install the current DTrace Toolkit, a collection of ready-made scripts
The scripts found in [.filename]#/usr/shared/dtrace# have been specifically ported to FreeBSD. Not all of the scripts found in the DTrace Toolkit will work as-is on FreeBSD and some scripts may require some effort in order for them to work on FreeBSD.
====

The DTrace Toolkit includes many scripts in the special language of DTrace. This language is called the D language and it is very similar to C++. An in depth discussion of the language is beyond the scope of this document. It is covered extensively in the http://www.dtrace.org/guide[Illumos Dynamic Tracing Guide].
The DTrace Toolkit includes many scripts in the special language of DTrace. This language is called the D language and it is very similar to C++. An in depth discussion of the language is beyond the scope of this document. It is covered extensively in the http://dtrace.org/guide[Illumos Dynamic Tracing Guide].

[[dtrace-using]]
== Using DTrace
Expand Down
4 changes: 2 additions & 2 deletions documentation/content/pt-br/books/handbook/dtrace/_index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ O DTrace, também conhecido como Dynamic Tracing, foi desenvolvido pela Sun(TM)

O DTrace é uma ferramenta de criação de perfil notável, com uma impressionante variedade de recursos para diagnosticar problemas do sistema. Ele também pode ser usado para executar scripts pré-escritos para aproveitar seus recursos. Os usuários podem criar seus próprios utilitários usando a DTrace D Language, permitindo que eles personalizem seus perfis com base em necessidades específicas.

A implementação do FreeBSD fornece suporte completo para o DTrace do kernel e suporte experimental para o DTrace da userland. O Userland DTrace permite que os usuários executem o rastreio de limite de função para programas de área de trabalho usando o provedor `pid` e insiram investigações estáticas em programas da userland para rastreamento posterior. Alguns ports, como package:databases/postgresql12-server[] e package:lang/php74[], possuem uma opção do DTrace para ativar testes estáticos.
A implementação do FreeBSD fornece suporte completo para o DTrace do kernel e suporte experimental para o DTrace da userland. O Userland DTrace permite que os usuários executem o rastreio de limite de função para programas de área de trabalho usando o provedor `pid` e insiram investigações estáticas em programas da userland para rastreamento posterior. Alguns ports, como package:databases/memcached[] e package:net-mgmt/lldpd[], possuem uma opção do DTrace para ativar testes estáticos.

O guia oficial do DTrace é mantido pelo projeto Illumos no http://dtrace.org/guide[Guia do DTrace].

Expand Down Expand Up @@ -119,7 +119,7 @@ Por fim, instale o DTrace Toolkit atual, uma coleção de scripts prontos para c
Os scripts encontrados em [.filename]#/usr/shared/dtrace# foram especificamente portados para o FreeBSD. Nem todos os scripts encontrados no DTrace Toolkit funcionarão no FreeBSD e alguns scripts podem exigir algum esforço para que funcionem no FreeBSD.
====

O DTrace Toolkit inclui muitos scripts no idioma especial do DTrace. Esta linguagem é chamada de linguagem D e é muito semelhante ao C++. Uma discussão aprofundada da linguagem está além do escopo deste documento. Ele é abordado extensivamente no http://www.dtrace.org/guide[Illumos Dynamic Tracing Guide].
O DTrace Toolkit inclui muitos scripts no idioma especial do DTrace. Esta linguagem é chamada de linguagem D e é muito semelhante ao C++. Uma discussão aprofundada da linguagem está além do escopo deste documento. Ele é abordado extensivamente no http://dtrace.org/guide[Illumos Dynamic Tracing Guide].

[[dtrace-using]]
== Usando o DTrace
Expand Down
6 changes: 3 additions & 3 deletions documentation/content/zh-tw/books/handbook/dtrace/_index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ DTrace 是一個卓越的分析工具,具有一系列令人驚豔、用於診

FreeBSD 實做提供對核心層級的 DTrace 全面的支援,以及對使用者層級的 DTrace 實驗性的支援。
使用者層級的 DTrace 允許使用者使用 `pid` 執行函式邊界追蹤 (function boundary tracing),並將 static probes 插入到使用者程式以供之後追蹤。
一些 ports,像是 package:databases/postgresql12-server[] 和 package:lang/php74[] 提供 DTrace 選項,以提供 static probes 功能。
一些 ports,像是 package:databases/memcached[] 和 package:net-mgmt/lldpd[] 提供 DTrace 選項,以提供 static probes 功能。

DTrace 的官方指南由 Illumos 維護,在 http://dtrace.org/guide[DTrace Guide]。

Expand Down Expand Up @@ -93,7 +93,7 @@ DTrace 的官方指南由 Illumos 維護,在 http://dtrace.org/guide[DTrace Gu
FreeBSD 使用 `DDB_CTF` 核心選項來支援從核心模組和核心本身載入 `CTF` 資料。
`CTF` 是 Solaris(TM) Compact C Type Format,它封裝了一種簡化形式的除錯資訊,類似於 `DWARF` 和 古老的 stabs。
`CTF` 資料通過`ctfconvert` and `ctfmerge` 建構工具,加入到二進制文件中。
`ctfconvert` 工具分析編譯器創建的 `DWARF``ELF` 除錯部份,而 `ctfmerge` 將目標的 `CTF``ELF` 部份合併到執行檔或函式庫中。
`ctfconvert` 工具分析編譯器創建的 `DWARF` `ELF` 除錯部份,而 `ctfmerge` 將目標的 `CTF` `ELF` 部份合併到執行檔或函式庫中。

與 Solaris(TM) 相比,FreeBSD 存在一些不同的 providers。
最值得注意的是 `dtmalloc` provider 允許在 FreeBSD 核心中按照類型 (type) 追蹤 `malloc()`。
Expand Down Expand Up @@ -152,7 +152,7 @@ FreeBSD 10 將其中一些腳本安裝在 [.filename]#/usr/share/dtrace# 中。
DTrace 工具箱包含許多使用 DTrace 特殊語言的腳本,
這種語言被稱為 D 語言,它與 C++ 非常類似,
對於該語言的深度討論超出了此文件的範圍,
他在 http://www.dtrace.org/guide[Illumos Dynamic Tracing Guide] 有廣泛的介紹。
他在 http://dtrace.org/guide[Illumos Dynamic Tracing Guide] 有廣泛的介紹。

[[dtrace-using]]
== 使用 DTrace
Expand Down
Loading