babeltrace2(1): Skillnad mellan sidversioner

Från Wiki.linux.se -Linux wikipedia på Svenska.
Hoppa till navigering Hoppa till sök
Ingen redigeringssammanfattning
Märke: Ersättning
Rad 1: Rad 1:
= babeltrace2(1) – Linux manualsida =
== Namn ==
'''babeltrace2''' – konvertera eller bearbeta ett eller flera spår, med mera.
== Synopsis ==
<syntaxhighlight lang="bash">
babeltrace2 [--debug | --verbose | --log-level=NIVÅ]
            [--omit-home-plugin-path] [--omit-system-plugin-path]
            [--plugin-path=SÖKVÄG[:SÖKVÄG]...] [KOMMANDO] [KOMMANDOARGUMENT]
</syntaxhighlight>
== Beskrivning ==
'''babeltrace2''' är ett kommandoradsprogram med öppen källkod för att konvertera och bearbeta spår.
Verktyget kan öppna ett eller flera spår och konvertera mellan flera format, eventuellt med ett eller flera filter i konverteringsvägen. Det kan även utföra andra åtgärder beroende på kommandot ''KOMMANDO''. Se avsnittet [[#Kommandon|Kommandon]].
{{Obs|
Du kanske letar efter manualsidan för '''babeltrace2-convert(1)'''.
Kommandot '''convert''' är standardkommandot för '''babeltrace2''' och är bakåtkompatibelt med '''babeltrace(1)'''.
Se [[#Exempel|Exempel]] för exempel på kommandot '''convert'''.
}}
Se '''babeltrace2-intro(7)''' för att läsa mer om Babeltrace 2-projektet och dess grundläggande begrepp.
De flesta '''babeltrace2'''-kommandon läser in Babeltrace 2-insticksmoduler för att utföra sina operationer. Sökvägen för Babeltrace 2-insticksmoduler är, i denna ordning:
# Den kolonseparerade listan, eller semikolonseparerade listan på Windows, över kataloger i miljövariabeln '''BABELTRACE_PLUGIN_PATH'''.
# Den kolonseparerade listan, eller semikolonseparerade listan på Windows, över kataloger i flaggan '''--plugin-path'''.
# '''$HOME/.local/lib/babeltrace2/plugins'''
# '''/usr/local/lib/babeltrace2/plugins'''
Du kan använda kommandot '''babeltrace2-list-plugins(1)''' för att dynamiskt lista tillgängliga insticksmoduler och vad de erbjuder.
Se [[#Projektets insticksmoduler|Projektets insticksmoduler]] för en lista över insticksmoduler som levereras med Babeltrace 2.
== Flaggor ==
; '''-d''', '''--debug'''
: Äldre flagga. Motsvarar:
<syntaxhighlight lang="bash">
--log-level=TRACE
</syntaxhighlight>
; '''-l''' ''NIVÅ'', '''--log-level='''...
: Anger loggnivån för alla kända Babeltrace 2-loggare till ''NIVÅ'', inklusive enskilda komponenter för kommandona '''babeltrace2-convert(1)''' och '''babeltrace2-run(1)'''.
:
: Du kan åsidosätta loggnivån för en specifik komponent med flaggan '''--log-level''' för kommandona '''babeltrace2-convert(1)''' eller '''babeltrace2-run(1)'''.
:
: Du kan åsidosätta loggnivån för biblioteket med miljövariabeln '''LIBBABELTRACE2_INIT_LOG_LEVEL'''.
:
: Du kan åsidosätta loggnivån för CLI:t med miljövariabeln '''BABELTRACE_CLI_LOG_LEVEL'''.
:
: Du kan åsidosätta loggnivån för Babeltrace 2 Python-bindningarna med miljövariabeln '''BABELTRACE_PYTHON_BT2_LOG_LEVEL'''.
:
: Tillgängliga värden för ''NIVÅ'':
:
:* '''NONE''', '''N'''
:: Loggning är inaktiverad.
:
:* '''FATAL''', '''F'''
:: Allvarliga fel som leder till att körningen avbryts omedelbart.
::
:: Den här nivån bör vara aktiverad i produktion.
:
:* '''ERROR''', '''E'''
:: Fel som eventuellt fortfarande gör att körningen kan fortsätta.
::
:: När ett eller flera fel rapporteras på denna nivå kommer programmet, insticksmodulen eller biblioteket vanligtvis inte längre att utföra någon användbar uppgift, men bör ändå avslutas korrekt.
::
:: Den här nivån bör vara aktiverad i produktion.
:
:* '''WARN''', '''WARNING''', '''W'''
:: Oväntade situationer som ändå tillåter körningen att fortsätta.
::
:: Den här nivån bör vara aktiverad i produktion.
:
:* '''INFO''', '''I'''
:: Informationsmeddelanden som visar framsteg eller viktiga tillstånd i programmet, insticksmodulerna eller biblioteket.
::
:: Den här nivån kan vara aktiverad i produktion.
:
:* '''DEBUG''', '''D'''
:: Felsökningsinformation med högre detaljnivå än nivån '''TRACE'''.
::
:: Den här nivån bör inte vara aktiverad i produktion.
:
:* '''TRACE''', '''T'''
:: Lågnivåinformation för felsökning.
::
:: Den här nivån bör inte vara aktiverad i produktion.
; '''--omit-home-plugin-path'''
: Sök inte efter insticksmoduler i:
<syntaxhighlight lang="bash">
$HOME/.local/lib/babeltrace2/plugins
</syntaxhighlight>
; '''--omit-system-plugin-path'''
: Sök inte efter insticksmoduler i:
<syntaxhighlight lang="bash">
/usr/local/lib/babeltrace2/plugins
</syntaxhighlight>
; '''--plugin-path='''...
: Lägg till ''SÖKVÄG'' i listan över sökvägar där insticksmoduler kan hittas.
:
<syntaxhighlight lang="bash">
--plugin-path=SÖKVÄG[:SÖKVÄG]...
</syntaxhighlight>
; '''-v''', '''--verbose'''
: Äldre flagga. Motsvarar:
<syntaxhighlight lang="bash">
--log-level=INFO
</syntaxhighlight>
:
: Om ''KOMMANDO'' är '''convert''', eller saknas, sätter detta också parametern '''verbose''' för den implicita komponenten '''sink.text.pretty''' till true.
:
: Se även '''babeltrace2-sink.text.pretty(7)'''.
; '''-h''', '''--help'''
: Visa hjälp och avsluta.
; '''-V''', '''--version'''
: Visa version och avsluta.
== Kommandon ==
Följande kommandon har även en egen flagga '''--help'''.
; '''convert'''
: Konvertera ett eller flera spår till ett givet format, eventuellt med filter i konverteringsvägen.
:
: Detta är standardkommandot. Du behöver inte uttryckligen ange kommandonamnet för att använda det.
:
: Kommandot är bakåtkompatibelt med programmet '''babeltrace(1)'''.
:
: Se '''babeltrace2-convert(1)'''.
; '''help'''
: Hämta hjälp för en specifik insticksmodul eller komponentklass.
:
: Se '''babeltrace2-help(1)'''.
; '''list-plugins'''
: Lista tillgängliga Babeltrace 2-insticksmoduler och deras komponentklasser.
:
: Se '''babeltrace2-list-plugins(1)'''.
; '''query'''
: Fråga efter ett objekt från en komponentklass.
:
: Se '''babeltrace2-query(1)'''.
; '''run'''
: Bygg en spårbearbetningsgraf och kör den.
:
: Se '''babeltrace2-run(1)'''.
== Projektets insticksmoduler ==
Följande insticksmoduler tillhandahålls av Babeltrace 2-projektet självt.
; '''babeltrace2-plugin-ctf(7)'''
: CTF-spårinmatning från filsystemet och från LTTng-live-protokollet, samt utmatning till filsystemet.
:
: Komponentklasser:
:
:* '''babeltrace2-source.ctf.fs(7)'''
:* '''babeltrace2-source.ctf.lttng-live(7)'''
:* '''babeltrace2-sink.ctf.fs(7)'''
; '''babeltrace2-plugin-lttng-utils(7)'''
: Verktyg för spårbearbetningsgrafer för LTTng-spår.
:
: Komponentklass:
:
:* '''babeltrace2-filter.lttng-utils.debug-info(7)'''
; '''babeltrace2-plugin-text(7)'''
: Inmatning och utmatning i klartext.
:
: Komponentklasser:
:
:* '''babeltrace2-source.text.dmesg(7)'''
:* '''babeltrace2-sink.text.details(7)'''
:* '''babeltrace2-sink.text.pretty(7)'''
; '''babeltrace2-plugin-utils(7)'''
: Verktyg för spårbearbetningsgrafer.
:
: Komponentklasser:
:
:* '''babeltrace2-filter.utils.muxer(7)'''
:* '''babeltrace2-filter.utils.trimmer(7)'''
:* '''babeltrace2-sink.utils.counter(7)'''
:* '''babeltrace2-sink.utils.dummy(7)'''
== Exempel ==
Följande exempel är samma som i manualsidan '''babeltrace2-convert(1)''', eftersom '''convert''' är standardkommandot för programmet '''babeltrace2'''.
=== Exempel 1: Skriv ut händelserna i ordning från ett eller flera CTF-spår ===
<syntaxhighlight lang="bash">
babeltrace2 my-ctf-traces
babeltrace2 my-ctf-traces
babeltrace2 my-ctf-trace-1 my-ctf-trace-2 my-ctf-trace-3
</syntaxhighlight>
=== Exempel 2: Trimma ett CTF-spår och skriv ut händelserna ===
<syntaxhighlight lang="bash">
babeltrace2 my-ctf-trace --begin=22:55:43.658582931 \
                        --end=22:55:46.967687564
babeltrace2 my-trace --begin=22:55:43.658582931
babeltrace2 my-trace --end=22:55:46.967687564
babeltrace2 my-trace --timerange=22:55:43,22:55:46.967687564
</syntaxhighlight>
=== Exempel 3: Trimma ett CTF-spår, aktivera strömkorsningsläge och skriv ett CTF-spår ===
<syntaxhighlight lang="bash">
babeltrace2 my-ctf-trace --stream-intersection \
            --timerange=22:55:43,22:55:46.967687564 \
            --output-format=ctf --output=out-ctf-trace
</syntaxhighlight>
=== Exempel 4: Skriv ut tillgängliga fjärr-LTTng-sessioner via LTTng live ===
<syntaxhighlight lang="bash">
babeltrace2 --input-format=lttng-live net://localhost
</syntaxhighlight>
=== Exempel 5: Skriv ut LTTng live-händelser ===
<syntaxhighlight lang="bash">
babeltrace2 net://localhost/host/myhostname/my-session-name
</syntaxhighlight>
=== Exempel 6: Spela in LTTng live-spår till filsystemet som CTF 1.8-spår ===
<syntaxhighlight lang="bash">
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"'
</syntaxhighlight>
=== Exempel 7: Läs ett CTF-spår så snabbt som möjligt med dummy-utmatning ===
<syntaxhighlight lang="bash">
babeltrace2 my-trace --output-format=dummy
</syntaxhighlight>
=== Exempel 8: Läs tre CTF-spår i strömkorsningsläge, lägg till felsökningsinformation och skriv ut dem till en fil ===
<syntaxhighlight lang="bash">
babeltrace2 ctf-trace1 ctf-trace2 ctf-trace3 --stream-intersection \
            --debug-info --output=pretty-out
</syntaxhighlight>
=== Exempel 9: Skriv ut ett CTF-spår och spår från en uttrycklig källkomponent med händelsetider visade i sekunder sedan Unix-epoken ===
<syntaxhighlight lang="bash">
babeltrace2 ctf-trace --component=src.my-plugin.my-src \
            --params='path="spec-trace",output-some-event-type=yes' \
            --clock-seconds
</syntaxhighlight>
=== Exempel 10: Skicka LTTng live-händelser till en uttrycklig sink-komponent ===
<syntaxhighlight lang="bash">
babeltrace2 net://localhost/host/myhostname/mysession \
            --component=sink.my-plugin.my-sink
</syntaxhighlight>
=== Exempel 11: Trimma ett CTF-spår, lägg till felsökningsinformation, använd en uttrycklig filterkomponent och skriv som ett CTF-spår ===
<syntaxhighlight lang="bash">
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
</syntaxhighlight>
=== Exempel 12: Skriv ut metadatatxten för ett CTF-spår ===
<syntaxhighlight lang="bash">
babeltrace2 /path/to/ctf/trace --output-format=ctf-metadata
</syntaxhighlight>
== Miljövariabler ==
=== Babeltrace 2-biblioteket ===
; '''BABELTRACE_EXEC_ON_ABORT='''...
: Kör kommandoraden ''KOMMANDORAD'', tolkad som av ett UNIX 98-skal, när någon del av Babeltrace 2-projektet oväntat avbryts.
:
: Programmet avbryts först när det körda kommandot returnerar, och dess avslutningsstatus ignoreras.
:
: Den här miljövariabeln ignoreras när programmet har åtkomsträttighetsflaggan '''setuid''' eller '''setgid''' satt.
; '''BABELTRACE_TERM_COLOR='''('''AUTO''' | '''NEVER''' | '''ALWAYS''')
: Tvingar terminalfärgstöd för programmet '''babeltrace2(1)''' och projektets insticksmoduler.
:
: Tillgängliga värden:
:
:* '''AUTO'''
:: Skicka endast terminalfärgkoder när standardutmatning och standardfel är anslutna till en färgkapabel terminal.
:
:* '''NEVER'''
:: Skicka aldrig terminalfärgkoder.
:
:* '''ALWAYS'''
:: Skicka alltid terminalfärgkoder.
; '''BABELTRACE_TERM_COLOR_BRIGHT_MEANS_BOLD=0'''
: Sätt till '''0''' för att skicka SGR-koderna 90 till 97 för ljusa färger i stället för fetstil, det vill säga SGR-kod 1, och vanliga färgkoder, det vill säga SGR-koderna 30 till 37.
:
: Se även: https://en.wikipedia.org/wiki/ANSI_escape_code
; '''BABELTRACE_PLUGIN_PATH='''...
: Anger listan över kataloger, i ordning, där dynamiska insticksmoduler kan hittas innan andra kataloger beaktas.
:
: Värdet är kolonseparerat, eller semikolonseparerat på Windows.
; '''LIBBABELTRACE2_DISABLE_PYTHON_PLUGINS=1'''
: Inaktiverar inläsning av alla Babeltrace 2 Python-insticksmoduler.
; '''LIBBABELTRACE2_FORCE_COMPONENT_LOG_LEVEL='''...
: Tvingar loggnivån för alla eller specifika komponenter som läggs till i någon spårbearbetningsgraf.
:
: ''SPEC'' är ett av följande:
:
:* Ett enda loggnivåvärde, ''NIVÅ''.
:: I detta fall åsidosätter libbabeltrace2 loggnivån som anges när ''vilken komponent som helst'' läggs till i någon spårbearbetningsgraf.
:
:* En semikolonavgränsad lista med specifikationer på formen:
<syntaxhighlight lang="text">
MÖNSTER:NIVÅ
</syntaxhighlight>
:
:: ''MÖNSTER'' är ett globbningsmönster där endast jokertecknet '''*''' är specialtecken. Det matchar noll eller fler tecken.
:
:: Du måste skydda tecknen '''*''', '''?''', '''[''' och '''\''' med '''\'''.
:
:: ''NIVÅ'' är ett loggnivåvärde.
:
:: I detta fall åsidosätter libbabeltrace2 loggnivån som anges när en komponent vars namn matchar ''MÖNSTER'' läggs till i någon spårbearbetningsgraf.
:
: libbabeltrace2 kontrollerar denna miljövariabel dynamiskt innan en komponent läggs till i en spårbearbetningsgraf. Det betyder att du kan ändra den när som helst med '''setenv(3)'''.
:
: Tillgängliga värden för ''NIVÅ'':
:
:* '''NONE''', '''N'''
:: Loggning är inaktiverad.
:
:* '''FATAL''', '''F'''
:: Allvarliga fel som leder till att körningen avbryts omedelbart. Den här nivån bör vara aktiverad i produktion.
:
:* '''ERROR''', '''E'''
:: Fel som eventuellt fortfarande gör att körningen kan fortsätta. Den här nivån bör vara aktiverad i produktion.
:
:* '''WARN''', '''WARNING''', '''W'''
:: Oväntade situationer som ändå tillåter körningen att fortsätta. Den här nivån bör vara aktiverad i produktion.
:
:* '''INFO''', '''I'''
:: Informationsmeddelanden som visar framsteg eller viktiga tillstånd. Den här nivån kan vara aktiverad i produktion.
:
:* '''DEBUG''', '''D'''
:: Felsökningsinformation med högre detaljnivå än '''TRACE'''. Den här nivån bör inte vara aktiverad i produktion.
:
:* '''TRACE''', '''T'''
:: Lågnivåinformation för felsökning. Den här nivån bör inte vara aktiverad i produktion.
:
: Exempel:
:
<syntaxhighlight lang="text">
*ctf*:I;my-sink:D;*:W
</syntaxhighlight>
; '''LIBBABELTRACE2_INIT_LOG_LEVEL='''...
: Tvingar den initiala loggnivån för Babeltrace 2-biblioteket till ''NIVÅ''.
:
: Om denna miljövariabel är satt åsidosätter den loggnivån som angetts med flaggan '''--log-level''' för Babeltrace 2-bibliotekets loggare.
:
: Tillgängliga värden för ''NIVÅ'' är:
:
:* '''NONE''', '''N'''
:* '''FATAL''', '''F'''
:* '''ERROR''', '''E'''
:* '''WARN''', '''WARNING''', '''W'''
:* '''INFO''', '''I'''
:* '''DEBUG''', '''D'''
:* '''TRACE''', '''T'''
; '''LIBBABELTRACE2_NO_DLCLOSE=1'''
: Gör att Babeltrace 2-biblioteket lämnar dynamiskt inlästa moduler, det vill säga insticksmoduler och insticksmodulsleverantörer, öppna vid avslut.
:
: Detta kan vara användbart vid felsökning.
; '''LIBBABELTRACE2_PLUGIN_PROVIDER_DIR='''...
: Anger katalogen från vilken Babeltrace 2-biblioteket dynamiskt läser in delade objekt för insticksmodulsleverantörer.
:
: Om denna miljövariabel är satt åsidosätter den den förvalda katalogen för insticksmodulsleverantörer.
=== Babeltrace 2 Python-bindningar ===
; '''BABELTRACE_PYTHON_BT2_LOG_LEVEL='''...
: Tvingar loggnivån för Babeltrace 2 Python-bindningarna till ''NIVÅ''.
:
: Om denna miljövariabel är satt åsidosätter den loggnivån som angetts med flaggan '''--log-level''' för Python-bindningarnas loggare.
:
: Tillgängliga värden för ''NIVÅ'' är:
:
:* '''NONE''', '''N'''
:* '''FATAL''', '''F'''
:* '''ERROR''', '''E'''
:* '''WARN''', '''WARNING''', '''W'''
:* '''INFO''', '''I'''
:* '''DEBUG''', '''D'''
:* '''TRACE''', '''T'''
=== Kommandoradsgränssnitt ===
; '''BABELTRACE_CLI_LOG_LEVEL='''...
: Tvingar loggnivån för kommandoradsprogrammet '''babeltrace2''' till ''NIVÅ''.
:
: Om denna miljövariabel är satt åsidosätter den loggnivån som angetts med flaggan '''--log-level''' för CLI-loggaren.
:
: Tillgängliga värden för ''NIVÅ'' är:
:
:* '''NONE''', '''N'''
:* '''FATAL''', '''F'''
:* '''ERROR''', '''E'''
:* '''WARN''', '''WARNING''', '''W'''
:* '''INFO''', '''I'''
:* '''DEBUG''', '''D'''
:* '''TRACE''', '''T'''
; '''BABELTRACE_CLI_WARN_COMMAND_NAME_DIRECTORY_CLASH=0'''
: Inaktiverar varningsmeddelandet som '''babeltrace2-convert(1)''' skriver ut när du konverterar ett spår med en relativ sökväg som också är namnet på ett '''babeltrace2'''-kommando.
; '''BABELTRACE_DEBUG=1'''
: Äldre variabel. Motsvarar att sätta flaggan '''--log-level''' till '''TRACE'''.
; '''BABELTRACE_VERBOSE=1'''
: Äldre variabel. Motsvarar att sätta flaggan '''--log-level''' till '''INFO'''.
== Filer ==
; '''$HOME/.local/lib/babeltrace2/plugins'''
: Användarens katalog för insticksmoduler.
; '''/usr/local/lib/babeltrace2/plugins'''
: Systemkatalog för insticksmoduler.
; '''/usr/local/lib/babeltrace2/plugin-providers'''
: Systemkatalog för insticksmodulsleverantörer.
== Avslutningsstatus ==
; '''0'''
: Vid lyckad körning.
; '''1'''
: I övriga fall.
== Felrapporter ==
Om du stöter på ett problem eller ett användbarhetsproblem, rapportera det i Babeltrace-felhanteraren:
* https://bugs.lttng.org/projects/babeltrace
== Resurser ==
Babeltrace-projektet delar vissa kommunikationskanaler med LTTng-projektet.
* Babeltrace-webbplats: https://babeltrace.org/
* LTTng-webbplats: https://lttng.org/
* E-postlista för support och utveckling: '''lttng-dev@lists.lttng.org'''
* E-postlistans webbplats: https://lists.lttng.org
* IRC-kanal: '''#lttng''' på '''irc.oftc.net'''
* Felhanterare: https://bugs.lttng.org/projects/babeltrace
* Git-arkiv: https://git.efficios.com/?p=babeltrace.git
* GitHub-projekt: https://github.com/efficios/babeltrace
* Kontinuerlig integration: https://ci.lttng.org/view/Babeltrace/
* Kodgranskning: https://review.lttng.org/q/project:babeltrace
== Författare ==
Babeltrace 2-projektet är resultatet av hårt arbete av många regelbundna utvecklare och tillfälliga bidragsgivare.
Den nuvarande projektunderhållaren är Jérémie Galarneau:
* mailto:jeremie.galarneau@efficios.com
== Upphovsrätt ==
Detta program är en del av Babeltrace 2-projektet.
Babeltrace distribueras under MIT-licensen:
* https://opensource.org/licenses/MIT
== Se även ==
* '''babeltrace2-intro(7)'''
* '''babeltrace2-convert(1)'''
* '''babeltrace2-help(1)'''
* '''babeltrace2-list-plugins(1)'''
* '''babeltrace2-query(1)'''
* '''babeltrace2-run(1)'''
== Kolofon ==
Den här sidan är en del av projektet '''babeltrace''', som innehåller bibliotek för att läsa och skriva spår samt en spårkonverterare.
Information om projektet finns på:
* http://www.efficios.com/babeltrace
Om du har en felrapport för denna manualsida, skicka den till:
* '''lttng-dev@lists.lttng.org'''
Denna sida hämtades från projektets uppströms Git-arkiv:
* git://git.efficios.com/babeltrace.git
Sidan hämtades den '''16 januari 2026'''. Vid den tidpunkten var datumet för den senaste commit som hittades i arkivet '''4 december 2025'''.
Om du upptäcker renderingsproblem i HTML-versionen av sidan, känner till en bättre eller mer uppdaterad källa, eller har rättelser eller förbättringar av informationen i denna kolofon, skicka e-post till:
* '''man-pages@man7.org'''


== Sidor som hänvisar till denna sida ==
== Sidor som hänvisar till denna sida ==

Versionen från 3 maj 2026 kl. 06.23