babeltrace2(1): Skillnad mellan sidversioner

Från Wiki.linux.se -Linux wikipedia på Svenska.
Hoppa till navigering Hoppa till sök
(Skapade sidan med '= 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 öpp...')
 
Ingen redigeringssammanfattning
 
(3 mellanliggande sidversioner av samma användare visas inte)
Rad 7: Rad 7:
== Synopsis ==
== Synopsis ==


<syntaxhighlight lang="bash">
<pre>
babeltrace2 [--debug | --verbose | --log-level=NIVÅ]
babeltrace2 [--debug | --verbose | --log-level=NIVÅ]
             [--omit-home-plugin-path] [--omit-system-plugin-path]
             [--omit-home-plugin-path] [--omit-system-plugin-path]
             [--plugin-path=SÖKVÄG[:SÖKVÄG]...] [KOMMANDO] [KOMMANDOARGUMENT]
             [--plugin-path=SÖKVÄG[:SÖKVÄG]...] [KOMMANDO] [KOMMANDOARGUMENT]
</syntaxhighlight>
</pre>


== Beskrivning ==
== Beskrivning ==
Rad 19: Rad 19:
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]].
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|
'''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)'''.
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 [[#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.
Se '''babeltrace2-intro(7)''' för att läsa mer om Babeltrace 2-projektet och dess grundläggande begrepp.
Rad 43: Rad 39:


; '''-d''', '''--debug'''
; '''-d''', '''--debug'''
: Äldre flagga. Motsvarar:
: Äldre flagga. Detta motsvarar:
<syntaxhighlight lang="bash">
<pre>
--log-level=TRACE
--log-level=TRACE
</syntaxhighlight>
</pre>


; '''-l''' ''NIVÅ'', '''--log-level='''...  
; '''-l''' ''NIVÅ'', '''--log-level='''...  
Rad 98: Rad 94:
; '''--omit-home-plugin-path'''
; '''--omit-home-plugin-path'''
: Sök inte efter insticksmoduler i:
: Sök inte efter insticksmoduler i:
<syntaxhighlight lang="bash">
<pre>
$HOME/.local/lib/babeltrace2/plugins
$HOME/.local/lib/babeltrace2/plugins
</syntaxhighlight>
</pre>


; '''--omit-system-plugin-path'''
; '''--omit-system-plugin-path'''
: Sök inte efter insticksmoduler i:
: Sök inte efter insticksmoduler i:
<syntaxhighlight lang="bash">
<pre>
/usr/local/lib/babeltrace2/plugins
/usr/local/lib/babeltrace2/plugins
</syntaxhighlight>
</pre>


; '''--plugin-path='''...
; '''--plugin-path='''...
: Lägg till ''SÖKVÄG'' i listan över sökvägar där insticksmoduler kan hittas.
: Lägg till ''SÖKVÄG'' i listan över sökvägar där insticksmoduler kan hittas.
:
:
<syntaxhighlight lang="bash">
<pre>
--plugin-path=SÖKVÄG[:SÖKVÄG]...
--plugin-path=SÖKVÄG[:SÖKVÄG]...
</syntaxhighlight>
</pre>


; '''-v''', '''--verbose'''
; '''-v''', '''--verbose'''
: Äldre flagga. Motsvarar:
: Äldre flagga. Detta motsvarar:
<syntaxhighlight lang="bash">
<pre>
--log-level=INFO
--log-level=INFO
</syntaxhighlight>
</pre>
:
:
: Om ''KOMMANDO'' är '''convert''', eller saknas, sätter detta också parametern '''verbose''' för den implicita komponenten '''sink.text.pretty''' till true.
: Om ''KOMMANDO'' är '''convert''', eller saknas, sätter detta också parametern '''verbose''' för den implicita komponenten '''sink.text.pretty''' till true.
Rad 209: Rad 205:
=== Exempel 1: Skriv ut händelserna i ordning från ett eller flera CTF-spår ===
=== Exempel 1: Skriv ut händelserna i ordning från ett eller flera CTF-spår ===


<syntaxhighlight lang="bash">
<pre>
babeltrace2 my-ctf-traces
babeltrace2 my-ctf-traces


Rad 215: Rad 211:


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


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


<syntaxhighlight lang="bash">
<pre>
babeltrace2 my-ctf-trace --begin=22:55:43.658582931 \
babeltrace2 my-ctf-trace --begin=22:55:43.658582931 \
                         --end=22:55:46.967687564
                         --end=22:55:46.967687564
Rad 228: Rad 224:


babeltrace2 my-trace --timerange=22:55:43,22:55:46.967687564
babeltrace2 my-trace --timerange=22:55:43,22:55:46.967687564
</syntaxhighlight>
</pre>


=== Exempel 3: Trimma ett CTF-spår, aktivera strömkorsningsläge och skriv ett CTF-spår ===
=== Exempel 3: Trimma ett CTF-spår, aktivera strömkorsningsläge och skriv ett CTF-spår ===


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


=== Exempel 4: Skriv ut tillgängliga fjärr-LTTng-sessioner via LTTng live ===
=== Exempel 4: Skriv ut tillgängliga fjärr-LTTng-sessioner via LTTng live ===


<syntaxhighlight lang="bash">
<pre>
babeltrace2 --input-format=lttng-live net://localhost
babeltrace2 --input-format=lttng-live net://localhost
</syntaxhighlight>
</pre>


=== Exempel 5: Skriv ut LTTng live-händelser ===
=== Exempel 5: Skriv ut LTTng live-händelser ===


<syntaxhighlight lang="bash">
<pre>
babeltrace2 net://localhost/host/myhostname/my-session-name
babeltrace2 net://localhost/host/myhostname/my-session-name
</syntaxhighlight>
</pre>


=== Exempel 6: Spela in LTTng live-spår till filsystemet som CTF 1.8-spår ===
=== Exempel 6: Spela in LTTng live-spår till filsystemet som CTF 1.8-spår ===


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


=== Exempel 7: Läs ett CTF-spår så snabbt som möjligt med dummy-utmatning ===
=== Exempel 7: Läs ett CTF-spår så snabbt som möjligt med dummy-utmatning ===


<syntaxhighlight lang="bash">
<pre>
babeltrace2 my-trace --output-format=dummy
babeltrace2 my-trace --output-format=dummy
</syntaxhighlight>
</pre>


=== Exempel 8: Läs tre CTF-spår i strömkorsningsläge, lägg till felsökningsinformation och skriv ut dem till en fil ===
=== 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">
<pre>
babeltrace2 ctf-trace1 ctf-trace2 ctf-trace3 --stream-intersection \
babeltrace2 ctf-trace1 ctf-trace2 ctf-trace3 --stream-intersection \
             --debug-info --output=pretty-out
             --debug-info --output=pretty-out
</syntaxhighlight>
</pre>


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


=== Exempel 10: Skicka LTTng live-händelser till en uttrycklig sink-komponent ===
=== Exempel 10: Skicka LTTng live-händelser till en uttrycklig sink-komponent ===


<syntaxhighlight lang="bash">
<pre>
babeltrace2 net://localhost/host/myhostname/mysession \
babeltrace2 net://localhost/host/myhostname/mysession \
             --component=sink.my-plugin.my-sink
             --component=sink.my-plugin.my-sink
</syntaxhighlight>
</pre>


=== Exempel 11: Trimma ett CTF-spår, lägg till felsökningsinformation, använd en uttrycklig filterkomponent och skriv som ett CTF-spår ===
=== 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">
<pre>
babeltrace2 /path/to/ctf/trace --timerange=22:14:38,22:15:07 \
babeltrace2 /path/to/ctf/trace --timerange=22:14:38,22:15:07 \
             --debug-info --component=filter.my-plugin.my-filter \
             --debug-info --component=filter.my-plugin.my-filter \
             --params=criteria=xyz,ignore-abc=yes \
             --params=criteria=xyz,ignore-abc=yes \
             --output-format=ctf --output=out-ctf-trace
             --output-format=ctf --output=out-ctf-trace
</syntaxhighlight>
</pre>


=== Exempel 12: Skriv ut metadatatxten för ett CTF-spår ===
=== Exempel 12: Skriv ut metadatatxten för ett CTF-spår ===


<syntaxhighlight lang="bash">
<pre>
babeltrace2 /path/to/ctf/trace --output-format=ctf-metadata
babeltrace2 /path/to/ctf/trace --output-format=ctf-metadata
</syntaxhighlight>
</pre>


== Miljövariabler ==
== Miljövariabler ==
Rad 306: Rad 302:
=== Babeltrace 2-biblioteket ===
=== Babeltrace 2-biblioteket ===


; '''BABELTRACE_EXEC_ON_ABORT='''...  
; '''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.
: Kör kommandoraden ''KOMMANDORAD'', tolkad som av ett UNIX 98-skal, när någon del av Babeltrace 2-projektet oväntat avbryts.
:
:
Rad 332: Rad 328:
: Se även: https://en.wikipedia.org/wiki/ANSI_escape_code
: Se även: https://en.wikipedia.org/wiki/ANSI_escape_code


; '''BABELTRACE_PLUGIN_PATH='''...  
; '''BABELTRACE_PLUGIN_PATH='''...
: Anger listan över kataloger, i ordning, där dynamiska insticksmoduler kan hittas innan andra kataloger beaktas.
: Anger listan över kataloger, i ordning, där dynamiska insticksmoduler kan hittas innan andra kataloger beaktas.
:
:
Rad 340: Rad 336:
: Inaktiverar inläsning av alla Babeltrace 2 Python-insticksmoduler.
: Inaktiverar inläsning av alla Babeltrace 2 Python-insticksmoduler.


; '''LIBBABELTRACE2_FORCE_COMPONENT_LOG_LEVEL='''...  
; '''LIBBABELTRACE2_FORCE_COMPONENT_LOG_LEVEL='''...
: Tvingar loggnivån för alla eller specifika komponenter som läggs till i någon spårbearbetningsgraf.
: Tvingar loggnivån för alla eller specifika komponenter som läggs till i någon spårbearbetningsgraf.
:
:
Rad 349: Rad 345:
:
:
:* En semikolonavgränsad lista med specifikationer på formen:
:* En semikolonavgränsad lista med specifikationer på formen:
<syntaxhighlight lang="text">
<pre>
MÖNSTER:NIVÅ
MÖNSTER:NIVÅ
</syntaxhighlight>
</pre>
:
:
:: ''MÖNSTER'' är ett globbningsmönster där endast jokertecknet '''*''' är specialtecken. Det matchar noll eller fler tecken.
:: ''MÖNSTER'' är ett globbningsmönster där endast jokertecknet '''*''' är specialtecken. Det matchar noll eller fler tecken.
Rad 369: Rad 365:
:
:
:* '''FATAL''', '''F'''
:* '''FATAL''', '''F'''
:: Allvarliga fel som leder till att körningen avbryts omedelbart. Den här nivån bör vara aktiverad i produktion.
:: Allvarliga fel som leder till att körningen avbryts omedelbart.
::
:: Den här nivån bör vara aktiverad i produktion.
:
:
:* '''ERROR''', '''E'''
:* '''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.
:: 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'''
:* '''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.
:: 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'''
:* '''INFO''', '''I'''
:: Informationsmeddelanden som visar framsteg eller viktiga tillstånd. Den här nivån kan vara aktiverad i produktion.
:: 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'''
:* '''DEBUG''', '''D'''
:: Felsökningsinformation med högre detaljnivå än '''TRACE'''. Den här nivån bör inte vara aktiverad i produktion.
:: Felsökningsinformation med högre detaljnivå än nivån '''TRACE'''.
::
:: Den här nivån bör inte vara aktiverad i produktion.
:
:
:* '''TRACE''', '''T'''
:* '''TRACE''', '''T'''
:: Lågnivåinformation för felsökning. Den här nivån bör inte vara aktiverad i produktion.
:: Lågnivåinformation för felsökning.
::
:: Den här nivån bör inte vara aktiverad i produktion.
:
:
: Exempel:
: Exempel:
:
:
<syntaxhighlight lang="text">
<pre>
*ctf*:I;my-sink:D;*:W
*ctf*:I;my-sink:D;*:W
</syntaxhighlight>
</pre>


; '''LIBBABELTRACE2_INIT_LOG_LEVEL='''...  
; '''LIBBABELTRACE2_INIT_LOG_LEVEL='''...
: Tvingar den initiala loggnivån för Babeltrace 2-biblioteket till ''NIVÅ''.
: 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.
: 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:
: Tillgängliga värden för ''NIVÅ'':
:
:
:* '''NONE''', '''N'''
:* '''NONE''', '''N'''
:: Loggning är inaktiverad.
:
:* '''FATAL''', '''F'''
:* '''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'''
:* '''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'''
:* '''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'''
:* '''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'''
:* '''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'''
:* '''TRACE''', '''T'''
:: Lågnivåinformation för felsökning.
::
:: Den här nivån bör inte vara aktiverad i produktion.


; '''LIBBABELTRACE2_NO_DLCLOSE=1'''
; '''LIBBABELTRACE2_NO_DLCLOSE=1'''
Rad 412: Rad 449:
: Detta kan vara användbart vid felsökning.
: Detta kan vara användbart vid felsökning.


; '''LIBBABELTRACE2_PLUGIN_PROVIDER_DIR='''...  
; '''LIBBABELTRACE2_PLUGIN_PROVIDER_DIR='''...
: Anger katalogen från vilken Babeltrace 2-biblioteket dynamiskt läser in delade objekt för insticksmodulsleverantörer.
: Anger katalogen från vilken Babeltrace 2-biblioteket dynamiskt läser in delade objekt för insticksmodulsleverantörer.
:
:
Rad 419: Rad 456:
=== Babeltrace 2 Python-bindningar ===
=== Babeltrace 2 Python-bindningar ===


; '''BABELTRACE_PYTHON_BT2_LOG_LEVEL='''...  
; '''BABELTRACE_PYTHON_BT2_LOG_LEVEL='''...
: Tvingar loggnivån för Babeltrace 2 Python-bindningarna till ''NIVÅ''.
: 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.
: 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:
: Tillgängliga värden för ''NIVÅ'':
:
:
:* '''NONE''', '''N'''
:* '''NONE''', '''N'''
:: Loggning är inaktiverad.
:
:* '''FATAL''', '''F'''
:* '''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'''
:* '''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'''
:* '''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'''
:* '''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'''
:* '''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'''
:* '''TRACE''', '''T'''
:: Lågnivåinformation för felsökning.
::
:: Den här nivån bör inte vara aktiverad i produktion.


=== Kommandoradsgränssnitt ===
=== Kommandoradsgränssnitt ===


; '''BABELTRACE_CLI_LOG_LEVEL='''...  
; '''BABELTRACE_CLI_LOG_LEVEL='''...
: Tvingar loggnivån för kommandoradsprogrammet '''babeltrace2''' till ''NIVÅ''.
: 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.
: 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:
: Tillgängliga värden för ''NIVÅ'':
:
:
:* '''NONE''', '''N'''
:* '''NONE''', '''N'''
:: Loggning är inaktiverad.
:
:* '''FATAL''', '''F'''
:* '''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'''
:* '''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'''
:* '''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'''
:* '''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'''
:* '''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'''
:* '''TRACE''', '''T'''
:: Lågnivåinformation för felsökning.
::
:: Den här nivån bör inte vara aktiverad i produktion.


; '''BABELTRACE_CLI_WARN_COMMAND_NAME_DIRECTORY_CLASH=0'''
; '''BABELTRACE_CLI_WARN_COMMAND_NAME_DIRECTORY_CLASH=0'''
Rad 546: Rad 637:


* '''man-pages@man7.org'''
* '''man-pages@man7.org'''
== Sidfot ==
<syntaxhighlight lang="text">
Babeltrace 2.2.0rc1        14 september 2019              BABELTRACE2(1)
</syntaxhighlight>


== Sidor som hänvisar till denna sida ==
== Sidor som hänvisar till denna sida ==
Rad 564: Rad 649:
* [[babeltrace2-sink.text.details(7)]]
* [[babeltrace2-sink.text.details(7)]]
* [[babeltrace2-sink.text.pretty(7)]]
* [[babeltrace2-sink.text.pretty(7)]]
= Sidslut =
Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/babeltrace2.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å
https://www.linux.se/kontaka-linux-se/
<BR><BR>Tack till [https://dataservice.pcbutiken.se/ Datorservice] som har  sponsrat [https://www.linux.se Linux.se] med webbhotell.
[[Kategori:Linuxmanual grupp 1]]
[[Kategori:Linuxmanual]]

Nuvarande version från 3 maj 2026 kl. 06.25

babeltrace2(1) – Linux manualsida

Namn

babeltrace2 – konvertera eller bearbeta ett eller flera spår, med mera.

Synopsis

babeltrace2 [--debug | --verbose | --log-level=NIVÅ]
            [--omit-home-plugin-path] [--omit-system-plugin-path]
            [--plugin-path=SÖKVÄG[:SÖKVÄG]...] [KOMMANDO] [KOMMANDOARGUMENT]

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.

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 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:

  1. Den kolonseparerade listan, eller semikolonseparerade listan på Windows, över kataloger i miljövariabeln BABELTRACE_PLUGIN_PATH.
  2. Den kolonseparerade listan, eller semikolonseparerade listan på Windows, över kataloger i flaggan --plugin-path.
  3. $HOME/.local/lib/babeltrace2/plugins
  4. /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 för en lista över insticksmoduler som levereras med Babeltrace 2.

Flaggor

-d, --debug
Äldre flagga. Detta motsvarar:
--log-level=TRACE
-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:
$HOME/.local/lib/babeltrace2/plugins
--omit-system-plugin-path
Sök inte efter insticksmoduler i:
/usr/local/lib/babeltrace2/plugins
--plugin-path=...
Lägg till SÖKVÄG i listan över sökvägar där insticksmoduler kan hittas.
--plugin-path=SÖKVÄG[:SÖKVÄG]...
-v, --verbose
Äldre flagga. Detta motsvarar:
--log-level=INFO
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

babeltrace2 my-ctf-traces

babeltrace2 my-ctf-traces

babeltrace2 my-ctf-trace-1 my-ctf-trace-2 my-ctf-trace-3

Exempel 2: Trimma ett CTF-spår och skriv ut händelserna

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

Exempel 3: Trimma ett CTF-spår, aktivera strömkorsningsläge och skriv ett CTF-spår

babeltrace2 my-ctf-trace --stream-intersection \
            --timerange=22:55:43,22:55:46.967687564 \
            --output-format=ctf --output=out-ctf-trace

Exempel 4: Skriv ut tillgängliga fjärr-LTTng-sessioner via LTTng live

babeltrace2 --input-format=lttng-live net://localhost

Exempel 5: Skriv ut LTTng live-händelser

babeltrace2 net://localhost/host/myhostname/my-session-name

Exempel 6: Spela in LTTng live-spår till filsystemet som CTF 1.8-spår

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"'

Exempel 7: Läs ett CTF-spår så snabbt som möjligt med dummy-utmatning

babeltrace2 my-trace --output-format=dummy

Exempel 8: Läs tre CTF-spår i strömkorsningsläge, lägg till felsökningsinformation och skriv ut dem till en fil

babeltrace2 ctf-trace1 ctf-trace2 ctf-trace3 --stream-intersection \
            --debug-info --output=pretty-out

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

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

Exempel 10: Skicka LTTng live-händelser till en uttrycklig sink-komponent

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

Exempel 11: Trimma ett CTF-spår, lägg till felsökningsinformation, använd en uttrycklig filterkomponent och skriv som ett CTF-spår

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

Exempel 12: Skriv ut metadatatxten för ett CTF-spår

babeltrace2 /path/to/ctf/trace --output-format=ctf-metadata

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:
MÖNSTER:NIVÅ
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.
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.
Exempel:
*ctf*:I;my-sink:D;*:W
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Å:
  • 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.
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Å:
  • 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.

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Å:
  • 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.
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:

Resurser

Babeltrace-projektet delar vissa kommunikationskanaler med LTTng-projektet.

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:

Upphovsrätt

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

Babeltrace distribueras under MIT-licensen:

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å:

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:

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

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/babeltrace2.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å https://www.linux.se/kontaka-linux-se/

Tack till Datorservice som har sponsrat Linux.se med webbhotell.

Hämtad från "https://wiki.linux.se/index.php?title=babeltrace2(1)&oldid=9223"