Admin: /* Sidslut */

2026-05-01T06:04:31Z

Sidslut

← Äldre version		Versionen från 1 maj 2026 kl. 06.04
Rad 657:		Rad 657:
	= Sidslut =		= Sidslut =

	Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/~~asa~~.1p.html		Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/babeltrace2-convert.1.html
	Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på		Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på
	https://www.linux.se/kontaka-linux-se/		https://www.linux.se/kontaka-linux-se/

Admin: /* Källinformation */

2026-05-01T06:04:15Z

Källinformation

@@ Rad 652: / Rad 652: @@
 Om du upptäcker renderingsproblem i denna HTML-version av sidan, eller om du anser att det finns en bättre eller mer uppdaterad källa för sidan, eller om du har rättelser eller förbättringar till informationen i denna källinformation (som ''inte'' är en del av den ursprungliga manualsidan), skicka e-post till:
 man-pages@man7.org
-</pre>

Admin: /* Se även */

2026-05-01T06:03:42Z

Se även

← Äldre version		Versionen från 1 maj 2026 kl. 06.03
Rad 626:		Rad 626:
	== Se även ==		== Se även ==

	~~<code>~~babeltrace2-intro(7)~~</code>~~, ~~<code>~~babeltrace2(1)~~</code>~~, ~~<code>~~babeltrace2-run(1)~~</code>~~		[[babeltrace2-intro(7)]], [[babeltrace2(1)]], [[babeltrace2-run(1)]].

	== Källinformation ==		== Källinformation ==

Admin: Skapade sidan med '= babeltrace2-convert = '''babeltrace2-convert''' – konvertera en eller flera spårningar till ett givet format == Namn == '''babeltrace2-convert''' – konvertera en eller flera spårningar till ett givet format == Synopsis == === Skriv ut händelserna i en eller flera spårningar som vanlig text ===

 babeltrace2 [ALLMÄNNA FLAGGOR] [convert] [--retry-duration=TID-US]             [--allowed-mip-versions=VERSION] SPÅR-SÖKVÄG...

=== Konvertera en e...'

2026-05-01T06:02:39Z

Skapade sidan med '= babeltrace2-convert = '''babeltrace2-convert''' – konvertera en eller flera spårningar till ett givet format == Namn == '''babeltrace2-convert''' – konvertera en eller flera spårningar till ett givet format == Synopsis == === Skriv ut händelserna i en eller flera spårningar som vanlig text === <pre> babeltrace2 [ALLMÄNNA FLAGGOR] [convert] [--retry-duration=TID-US] [--allowed-mip-versions=VERSION] SPÅR-SÖKVÄG... </pre> === Konvertera en e...'

Ny sida

= babeltrace2-convert =

'''babeltrace2-convert''' – konvertera en eller flera spårningar till ett givet format

== Namn ==

'''babeltrace2-convert''' – konvertera en eller flera spårningar till ett givet format

== Synopsis ==

=== Skriv ut händelserna i en eller flera spårningar som vanlig text ===

<pre>
babeltrace2 [ALLMÄNNA FLAGGOR] [convert] [--retry-duration=TID-US]
[--allowed-mip-versions=VERSION] SPÅR-SÖKVÄG...
</pre>

=== Konvertera en eller flera spårningar till ett givet format ===

<pre>
babeltrace2 [ALLMÄNNA FLAGGOR] [convert] [--retry-duration=TID-US]
[--allowed-mip-versions=VERSION] KONVERTERINGSARGUMENT
</pre>

=== Visa motsvarande kommandoradsargument för babeltrace2-run för en konvertering ===

<pre>
babeltrace2 [ALLMÄNNA FLAGGOR] [convert] [--retry-duration=TID-US]
[--allowed-mip-versions=VERSION]
(--run-args | --run-args-0) KONVERTERINGSARGUMENT
</pre>

=== Skriv ut metadata-texten för ett CTF-spår ===

<pre>
babeltrace2 [ALLMÄNNA FLAGGOR] [convert] [--output=UTSÖKVÄG]
--output-format=ctf-metadata SPÅR-SÖKVÄG
</pre>

=== Visa tillgängliga fjärrsessioner för LTTng ===

<pre>
babeltrace2 [ALLMÄNNA FLAGGOR] [convert] [--output=UTSÖKVÄG]
--input-format=lttng-live URL
</pre>

== Beskrivning ==

Kommandot '''convert''' konverterar en eller flera spårningar till ett givet format, eventuellt med filter i konverteringskedjan.

Se <code>babeltrace2-intro(7)</code> för mer information om Babeltrace 2 och dess grundbegrepp.

'''Obs'''

<code>convert</code> är standardkommandot för <code>babeltrace2(1)</code>. Därför behöver du normalt inte ange namnet uttryckligen. Följande kommandon är likvärdiga om delen <code>...</code> inte börjar med namnet på ett annat <code>babeltrace2</code>-kommando, som <code>run</code> eller <code>list-plugins</code>:

<pre>
$ babeltrace2 convert ...
$ babeltrace2 ...
</pre>

Om du vill vara säker på att just <code>convert</code>-kommandot körs, använd uttryckligen:

<pre>
babeltrace2 convert
</pre>

Mer specifikt skapar kommandot '''convert''' en konverteringsgraf.

En konverteringsgraf är en specialiserad spårbearbetningsgraf med fokus på att omvandla en eller flera spårningar till ett annat format, eventuellt genom att filtrera eller ändra deras händelser och andra meddelanden under vägen. När källströmmarna har slagits samman är grafen linjär.

En implicit komponent är en komponent som skapas och läggs till i konverteringsgrafen utan att uttryckligen instansieras med flaggan <code>--component</code>. En implicit komponent är enklare att skapa än en explicit komponent, och det är därför kommandot <code>convert</code> finns.

Exempelvis kan du ange en eller flera CTF-spårsökvägar som icke-flaggeargument för att skriva ut de sammanslagna händelserna till standardutmatningen:

<pre>
$ babeltrace2 /path/to/trace /path/to/other/trace
</pre>

Detta motsvarar att skapa och koppla ihop:

* en eller flera <code>source.ctf.fs</code>-komponenter
* en <code>filter.utils.muxer</code>-komponent
* en <code>sink.text.pretty</code>-komponent

Du kan använda flaggan <code>--run-args</code> för att låta <code>convert</code> skriva ut motsvarande argument till kommandot <code>run</code> i stället för att skapa och köra grafen.

== Skapa explicita komponenter ==

För att uttryckligen skapa en komponent, använd flaggan:

<pre>
--component
</pre>

Den anger:

* valfritt: komponentens namn
* typen av komponentklass att instansiera: källa, filter eller sink
* namnet på insticksmodulen där komponentklassen finns
* namnet på komponentklassen att instansiera

Du kan ange <code>--component</code> flera gånger för att skapa flera komponenter.

Flaggorna nedan gäller för den aktuella explicita komponenten:

; <code>--log-level=LVL</code>
: sätt loggnivån för den aktuella komponenten till ''LVL''

; <code>--params=PARAMS</code>
: lägg till ''PARAMS'' till initialiseringsparametrarna för den aktuella komponenten

== Skapa implicita komponenter från argument utan flagga ==

När du anger ett argument utan flagga försöker <code>convert</code> hitta en eller flera komponenter som kan hantera detta argument.

Exempel:

<pre>
$ babeltrace2 /path/to/trace
</pre>

Om <code>/path/to/trace</code> är en CTF-spårkatalog skapas en implicit <code>source.ctf.fs</code>-komponent.

Om argumentet är en katalog och ingen komponent direkt kan hantera den, traverserar <code>convert</code> katalogen rekursivt och försöker hitta kompatibla komponenter för varje fil och underkatalog.

Följande flaggor gäller för alla implicita komponenter som skapats från det senaste argumentet utan flagga:

; <code>--log-level=LVL</code>
: sätt loggnivån till ''LVL''

; <code>--params=PARAMS</code>
: lägg till initialiseringsparametrar

Av bakåtkompatibilitet med <code>babeltrace(1)</code> ignorerar <code>convert</code> argument utan flagga som inte leder till att någon komponent skapas. I så fall skrivs en varning till loggen och körningen fortsätter.

== Skapa implicita komponenter från flaggor ==

Det finns flera sätt att skapa implicita komponenter via flaggor:

=== Implicit filter.utils.trimmer ===

Om du anger någon av dessa flaggor skapas en implicit <code>filter.utils.trimmer</code>-komponent:

* <code>--begin</code>
* <code>--end</code>
* <code>--timerange</code>

=== Implicit filter.lttng-utils.debug-info ===

Om du anger någon av dessa flaggor skapas en implicit <code>filter.lttng-utils.debug-info</code>-komponent:

* <code>--debug-info</code>
* <code>--debug-info-dir</code>
* <code>--debug-info-full-path</code>
* <code>--debug-info-target-prefix</code>

=== Implicit sink.text.pretty ===

Om ingen annan sink-komponent anges skapas som standard en implicit <code>sink.text.pretty</code>-komponent.

Följande flaggor påverkar den:

* <code>--clock-cycles</code>
* <code>--clock-date</code>
* <code>--clock-gmt</code>
* <code>--clock-seconds</code>
* <code>--color</code>
* <code>--fields</code>
* <code>--names</code>
* <code>--no-delta</code>

=== Implicit sink.utils.dummy ===

För att skapa en implicit <code>sink.utils.dummy</code>-komponent:

<pre>
--output-format=dummy
</pre>

=== Implicit sink.ctf.fs ===

För att skapa en implicit <code>sink.ctf.fs</code>-komponent:

<pre>
--output-format=ctf --output=KATALOG
</pre>

Från och med denna version skapar <code>sink.ctf.fs</code> som standard CTF 2-spår.

== Alternativ ==

=== Allmänna ===

Dessa flaggor kan användas före kommandonamnet.

; <code>-d</code>, <code>--debug</code>
: äldre flagga; motsvarar <code>--log-level=TRACE</code>

; <code>-l LVL</code>, <code>--log-level=LVL</code>
: sätt loggnivån för alla kända Babeltrace 2-loggare till ''LVL''

; <code>--omit-home-plugin-path</code>
: sök inte efter insticksmoduler i <code>$HOME/.local/lib/babeltrace2/plugins</code>

; <code>--omit-system-plugin-path</code>
: sök inte efter insticksmoduler i <code>/usr/local/lib/babeltrace2/plugins</code>

; <code>--plugin-path=PATH[:PATH]...</code>
: lägg till ''PATH'' i sökvägslistan för insticksmoduler

; <code>-v</code>, <code>--verbose</code>
: äldre flagga; motsvarar <code>--log-level=INFO</code>

=== Explicit komponentskapelse ===

; <code>-c [NAMN:]TYP.PLUGIN.KLASS</code>, <code>--component=[NAMN:]TYP.PLUGIN.KLASS</code>
: skapa en komponent från den angivna komponentklassen och gör den till aktuell komponent

Tillgängliga typer:

* <code>source</code>, <code>src</code>
* <code>filter</code>, <code>flt</code>
* <code>sink</code>

=== Gemensamma alternativ för komponentskapelse ===

; <code>-l LVL</code>, <code>--log-level=LVL</code>
: sätt loggnivån för aktuell komponent eller aktuella implicita komponenter

Möjliga nivåer:

* <code>NONE</code>, <code>N</code>
* <code>FATAL</code>, <code>F</code>
* <code>ERROR</code>, <code>E</code>
* <code>WARN</code>, <code>WARNING</code>, <code>W</code>
* <code>INFO</code>, <code>I</code>
* <code>DEBUG</code>, <code>D</code>
* <code>TRACE</code>, <code>T</code>

; <code>-p PARAMS</code>, <code>--params=PARAMS</code>
: lägg till initialiseringsparametrar

Format:

<pre>
NAMN=VÄRDE[,NAMN=VÄRDE]...
</pre>

Värden kan vara:

* null
* boolean
* heltal
* flyttal
* sträng
* array
* map

=== Äldre flaggor för implicita komponenter ===

; <code>-i FORMAT</code>, <code>--input-format=FORMAT</code>
: tvinga <code>convert</code> att skapa komponenter från en viss komponentklass för argument utan flagga, eller visa tillgängliga fjärrsessioner för LTTng

Tillgängliga värden:

* <code>ctf</code>
* <code>lttng-live</code>

; <code>-o FORMAT</code>, <code>--output-format=FORMAT</code>
: skapa en implicit sink-komponent med formatet ''FORMAT'' eller skriv ut metadata-texten för ett CTF-spår

Tillgängliga värden:

* <code>text</code>
* <code>ctf</code>
* <code>dummy</code>
* <code>ctf-metadata</code>

=== Implicit source.ctf.fs ===

; <code>--clock-force-correlate</code>
: sätter parametern <code>force-clock-class-origin-unix-epoch</code> till true

; <code>--clock-offset=SEK</code>
: lägg till ''SEK'' sekunder till klockklassernas offset

; <code>--clock-offset-ns=NS</code>
: lägg till ''NS'' nanosekunder till klockklassernas offset

=== Implicit filter.utils.trimmer ===

; <code>--begin=TID</code>
: sätt starttid

; <code>--end=TID</code>
: sätt sluttid

; <code>--timerange=START,SLUT</code>
: motsvarar både <code>--begin</code> och <code>--end</code>

Formatet för ''TID'' kan vara:

<pre>
YYYY-MM-DD HH:MM[:SS[.NANO]]
HH:MM[:SS[.NANO]]
[-]SEK[.NANO]
</pre>

=== Implicit filter.lttng-utils.debug-info ===

; <code>--debug-info</code>
: skapa en implicit felsökningsinformationskomponent

; <code>--debug-info-dir=KAT</code>
: ange katalog för felsökningsinformation

; <code>--debug-info-full-path</code>
: använd fullständiga sökvägar i stället för korta filnamn

; <code>--debug-info-target-prefix=PREFIX</code>
: lägg till ''PREFIX'' före körbarfilssökvägar från spåret

=== Implicit sink.text.pretty ===

; <code>--clock-cycles</code>
: skriv ut händelsetid i klockcykler

; <code>--clock-date</code>
: skriv ut datum och tid

; <code>--clock-gmt</code>
: använd inte lokal tidszon

; <code>--clock-seconds</code>
: skriv ut tider i sekunder sedan Unix-epoken

; <code>--color=WHEN</code>
: styr terminalfärger

Värden:

* <code>auto</code>
* <code>never</code>
* <code>always</code>

; <code>--fields=FIELD[,FIELD]...</code>
: aktivera visning av vissa fält

; <code>--names=NAME[,NAME]...</code>
: aktivera visning av vissa namn

; <code>--no-delta</code>
: skriv inte ut tidsdelta sedan senaste händelse

=== Delade alternativ ===

; <code>-w PATH</code>, <code>--output=PATH</code>
: skriv text till filen ''PATH'', eller ange utdatakatalog för CTF-utmatning

=== Motsvarande babeltrace2 run-argument ===

; <code>--run-args</code>
: skriv ut motsvarande argument till <code>babeltrace2-run</code>, skal-escapade och blankstegsseparerade

; <code>--run-args-0</code>
: skriv ut motsvarande argument till <code>babeltrace2-run</code>, nullseparerade och utan skal-escaping

=== Konfiguration av konverteringsgraf ===

; <code>-m VERSION</code>, <code>--allowed-mip-versions=VERSION</code>
: tillåt endast MIP-version ''VERSION''

; <code>--retry-duration=TID-US</code>
: sätt längden för ett enskilt försök till ''TID-US'' mikrosekunder

Standard: <code>100000</code> (100 ms)

; <code>--stream-intersection</code>
: aktivera strömsnittsläge, där endast meddelanden inom den tidsperiod där alla strömmar i ett spår är aktiva tas med

=== Övriga äldre flaggor ===

; <code>-d</code>, <code>--debug</code>
: äldre varianten av felsökningsloggning

; <code>-v</code>, <code>--verbose</code>
: äldre varianten av informationsloggning; sätter även <code>verbose</code>-parametern för implicit <code>sink.text.pretty</code>

=== Kommandoinformation ===

; <code>-h</code>, <code>--help</code>
: visa hjälp för kommandot och avsluta

== Exempel ==

=== 1. Skriv ut händelserna från ett eller flera CTF-spår ===

<pre>
$ babeltrace2 my-ctf-traces
$ babeltrace2 my-ctf-trace-1 my-ctf-trace-2 my-ctf-trace-3
</pre>

=== 2. Trimma ett CTF-spår och skriv ut händelserna ===

<pre>
$ babeltrace2 my-ctf-trace --begin=22:55:43.658582931 \
--end=22:55:46.967687564
</pre>

=== 3. Trimma ett CTF-spår, aktivera stream intersection och skriv ett nytt CTF-spår ===

<pre>
$ babeltrace2 my-ctf-trace --stream-intersection \
--timerange=22:55:43,22:55:46.967687564 \
--output-format=ctf --output=out-ctf-trace
</pre>

=== 4. Visa tillgängliga fjärrsessioner för LTTng ===

<pre>
$ babeltrace2 --input-format=lttng-live net://localhost
</pre>

=== 5. Skriv ut LTTng live-händelser ===

<pre>
$ babeltrace2 net://localhost/host/myhostname/my-session-name
</pre>

=== 6. Spara LTTng live-spår till filsystemet som CTF 1.8 ===

<pre>
$ babeltrace2 net://localhost/host/myhostname/my-session-name \
--params=session-not-found-action=end \
--component=sink.ctf.fs \
--params='path="out-ctf-traces",ctf-version="1"'
</pre>

=== 7. Läs ett CTF-spår så snabbt som möjligt med dummy-utdata ===

<pre>
$ babeltrace2 my-trace --output-format=dummy
</pre>

=== 8. Läs tre CTF-spår, lägg till felsökningsinformation och skriv ut dem till en fil ===

<pre>
$ babeltrace2 ctf-trace1 ctf-trace2 ctf-trace3 --stream-intersection \
--debug-info --output=pretty-out
</pre>

=== 9. Skriv ut ett CTF-spår och ett explicit källspår med tider i sekunder sedan Unix-epoken ===

<pre>
$ babeltrace2 ctf-trace --component=src.my-plugin.my-src \
--params='path="spec-trace",output-some-event-type=yes' \
--clock-seconds
</pre>

=== 10. Skicka LTTng live-händelser till en explicit sink-komponent ===

<pre>
$ babeltrace2 net://localhost/host/myhostname/mysession \
--component=sink.my-plugin.my-sink
</pre>

=== 11. Trimma ett CTF-spår, lägg till felsökningsinformation, använd ett explicit filter och skriv som CTF ===

<pre>
$ babeltrace2 /path/to/ctf/trace --timerange=22:14:38,22:15:07 \
--debug-info --component=filter.my-plugin.my-filter \
--params=criteria=xyz,ignore-abc=yes \
--output-format=ctf --output=out-ctf-trace
</pre>

=== 12. Skriv ut metadata-texten för ett CTF-spår ===

<pre>
$ babeltrace2 /path/to/ctf/trace --output-format=ctf-metadata
</pre>

== Miljövariabler ==

=== Babeltrace 2-biblioteket ===

; <code>BABELTRACE_EXEC_ON_ABORT=CMDLINE</code>
: kör kommandoraden ''CMDLINE'' när någon del av Babeltrace 2 avbryts oväntat

; <code>BABELTRACE_TERM_COLOR=(AUTO|NEVER|ALWAYS)</code>
: tvinga stöd för terminalfärger

; <code>BABELTRACE_TERM_COLOR_BRIGHT_MEANS_BOLD=0</code>
: använd ljusa färgkoder i stället för fetstil

; <code>BABELTRACE_PLUGIN_PATH=PATHS</code>
: ange sökvägar för dynamiska insticksmoduler

; <code>LIBBABELTRACE2_DISABLE_PYTHON_PLUGINS=1</code>
: inaktivera laddning av Python-insticksmoduler

; <code>LIBBABELTRACE2_FORCE_COMPONENT_LOG_LEVEL=SPEC</code>
: tvinga loggnivå för alla eller vissa komponenter

; <code>LIBBABELTRACE2_INIT_LOG_LEVEL=LVL</code>
: tvinga initial loggnivå för biblioteket

; <code>LIBBABELTRACE2_NO_DLCLOSE=1</code>
: lämna dynamiskt laddade moduler öppna vid avslut

; <code>LIBBABELTRACE2_PLUGIN_PROVIDER_DIR=DIR</code>
: katalog för dynamiskt laddade plugin-provider-objekt

=== Babeltrace 2 Python-bindningar ===

; <code>BABELTRACE_PYTHON_BT2_LOG_LEVEL=LVL</code>
: tvinga loggnivån för Python-bindningarna

=== Kommandoradsgränssnittet ===

; <code>BABELTRACE_CLI_LOG_LEVEL=LVL</code>
: tvinga loggnivån för CLI:t

; <code>BABELTRACE_CLI_WARN_COMMAND_NAME_DIRECTORY_CLASH=0</code>
: inaktivera varningen om att en relativ spårsökväg krockar med ett kommandonamn

; <code>BABELTRACE_DEBUG=1</code>
: äldre variabel; motsvarar <code>--log-level=TRACE</code>

; <code>BABELTRACE_VERBOSE=1</code>
: äldre variabel; motsvarar <code>--log-level=INFO</code>

== Filer ==

<pre>
$HOME/.local/lib/babeltrace2/plugins
</pre>
Användarkatalog för insticksmoduler.

<pre>
/usr/local/lib/babeltrace2/plugins
</pre>
Systemkatalog för insticksmoduler.

<pre>
/usr/local/lib/babeltrace2/plugin-providers
</pre>
Systemkatalog för plugin-providers.

== Avslutsstatus ==

; <code>0</code>
: lyckades

; <code>1</code>
: fel uppstod

== Fel ==

Om du stöter på problem eller användbarhetsproblem, rapportera dem till Babeltraces felspårare:

<pre>
https://bugs.lttng.org/projects/babeltrace
</pre>

== Resurser ==

Babeltrace-projektet delar vissa kommunikationskanaler med LTTng-projektet.

* Babeltraces webbplats:
<pre>
https://babeltrace.org/
</pre>

* E-postlista för stöd och utveckling:
<pre>
lttng-dev@lists.lttng.org
</pre>

* IRC-kanal:
<pre>
#lttng på irc.oftc.net
</pre>

* Felspårare:
<pre>
https://bugs.lttng.org/projects/babeltrace
</pre>

* Git-arkiv:
<pre>
https://git.efficios.com/?p=babeltrace.git
</pre>

* GitHub-projekt:
<pre>
https://github.com/efficios/babeltrace
</pre>

* Kontinuerlig integration:
<pre>
https://ci.lttng.org/view/Babeltrace/
</pre>

* Kodgranskning:
<pre>
https://review.lttng.org/q/project:babeltrace
</pre>

== Författare ==

Babeltrace 2-projektet är resultatet av arbete från många regelbundna utvecklare och tillfälliga bidragsgivare.

Nuvarande projektansvarig är Jérémie Galarneau.

== Upphovsrätt ==

Detta kommando är en del av Babeltrace 2-projektet.

Babeltrace distribueras under MIT-licensen:

<pre>
https://opensource.org/licenses/MIT
</pre>

== Se även ==

<code>babeltrace2-intro(7)</code>, <code>babeltrace2(1)</code>, <code>babeltrace2-run(1)</code>

== Källinformation ==

Denna sida är en del av projektet ''babeltrace'' (bibliotek för att läsa och skriva spår samt en spårkonverterare). Information om projektet finns på:

<pre>
http://www.efficios.com/babeltrace
</pre>

Om du har en felrapport för denna manualsida, skicka den till:

<pre>
lttng-dev@lists.lttng.org
</pre>

Denna sida hämtades från projektets uppströms Git-arkiv:

<pre>
git://git.efficios.com/babeltrace.git
</pre>

den 2026-01-16. Vid den tidpunkten var datumet för den senaste commit som hittades i arkivet 2025-12-04.

Om du upptäcker renderingsproblem i denna HTML-version av sidan, eller om du anser att det finns en bättre eller mer uppdaterad källa för sidan, eller om du har rättelser eller förbättringar till informationen i denna källinformation (som ''inte'' är en del av den ursprungliga manualsidan), skicka e-post till:

<pre>
man-pages@man7.org
</pre>

babeltrace2-convert(1) - Versionshistorik

Admin: /* Sidslut */

Admin: /* Källinformation */

Admin: /* Se även */