babeltrace2-run(1)

Namn

babeltrace2-query – fråga efter ett objekt från en Babeltrace 2-komponentklass.

Synopsis

babeltrace2 [ALLMÄNNA FLAGGOR] query [--params=PARAMETRAR]
            KOMPONENTKLASSTYP.INSTICKSMODULSNAMN.KOMPONENTKLASSNAMN OBJEKT

Beskrivning

Kommandot query frågar efter objektet med namnet OBJEKT från komponentklassen med namnet KOMPONENTKLASSNAMN, av typen KOMPONENTKLASSTYP, som finns i Babeltrace 2-insticksmodulen med namnet INSTICKSMODULSNAMN. Därefter skrivs resultatet ut.

Se babeltrace2-intro(7) för att läsa mer om Babeltrace 2-projektet och dess grundläggande begrepp.

Tillgängliga värden för KOMPONENTKLASSTYP är:

source, src

Källkomponentklass.

filter, flt

Filterkomponentklass.

sink

Sink-komponentklass.

De exakta objektnamnen och parametrarna som en viss komponentklass förväntar sig beskrivs i dess egen dokumentation. babeltrace2-help(1) kan vanligtvis ge denna information.

Du kan använda flaggan --params för att skicka parametrar till komponentklassens frågeoperation.

Utmatningen från kommandot query kan se ut som YAML, men den garanteras inte vara YAML-kompatibel.

Se Exempel för användningsexempel.

Flaggor

Allmänt

Du kan använda dessa flaggor före kommandonamnet.

Se babeltrace2(1) för mer information.

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

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

Frågeparametrar

-p PARAMETRAR, --params=...

Anger frågeparametrarna till PARAMETRAR.

Formatet för PARAMETRAR är en kommaseparerad lista med tilldelningar på formen NAMN=VÄRDE:

NAMN=VÄRDE[,NAMN=VÄRDE]...

NAMN

Parameternamn. Det får vara en C-identifierare plus tecknen ':, ., och -.

VÄRDE

Ett av följande:

• null, nul, NULL: nullvärde.
• true, TRUE, yes, YES: sant booleskt värde.
• false, FALSE, no, NO: falskt booleskt värde.
• Binärt, oktalt, decimalt eller hexadecimalt 64-bitars heltal, utan tecken eller med tecken.
• Flyttal med dubbel precision. Vetenskaplig notation accepteras.
• Osträngad text utan specialtecken, som inte matchar något av null- eller boolesymbolerna ovan.
• Dubbelt citerad sträng. Escape-tecken accepteras.
• Fält, formaterat som ett inledande [, en kommaseparerad lista med VÄRDE, och ett avslutande ].
• Mapp, formaterad som ett inledande {, en kommaseparerad lista med NAMN=VÄRDE-tilldelningar, och ett avslutande }.

Du kan använda blanktecken runt de enskilda tecknen = för tilldelning, , som separator, [ och ] för fält, samt { och } för mappar.

Exempel:

--params='many=null, fresh=yes, condition=false, squirrel=-782329,
          play=+23, observe=3.14, simple=beef,
          needs-quotes="some string",
          escape.chars-are:allowed="a \" quote",
          things=[1, "hello", 2.71828],
          frog={slow=2, bath=[bike, 23], blind=NO}'

Viktigt: Som i exemplet ovan bör du omge hela argumentet med enkla citattecken när du kör kommandot från ett skal, eftersom det kan innehålla många specialtecken.

Kommandoinformation

-h, --help

Visa kommandohjälpen och avsluta.

Exempel

Exempel 1: Fråga efter tillgängliga spårningssessioner från en lokal LTTng-relädemon

babeltrace2 query src.ctf.lttng-live sessions \
            --params='url="net://localhost"'

Exempel 2: Fråga efter metadatainformation för ett CTF-spår i det lokala filsystemet

Detta inkluderar den avkodade klartexten.

babeltrace2 query src.ctf.fs metadata-info \
            --params='inputs=["/path/to/trace"]'

Exempel 3: Fråga efter spårinformation för ett CTF-spår i det lokala filsystemet

babeltrace2 query src.ctf.fs babeltrace.trace-infos \
            --params='inputs=["/path/to/trace"]'

Exempel 4: Fråga efter ett objekt från en sink-komponentklass utan parametrar

babeltrace2 query sink.my-plugin.my-sink some-object

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:

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

• jeremie.galarneau@efficios.com

Upphovsrätt

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

Babeltrace distribueras under MIT-licensen:

• https://opensource.org/licenses/MIT

Se även

• babeltrace2-intro(7)
• babeltrace2(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

Sidfot

Babeltrace 2.2.0rc1         14 september 2019        BABELTRACE2-QUERY(1)

Sidor som hänvisar till denna sida

• babeltrace2(1)
• babeltrace2-intro(7)
• babeltrace2-query-babeltrace.support-info(7)
• babeltrace2-query-babeltrace.trace-infos(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/

Tack till Datorhjälp som har sponsrat Linux.se med webbhotell.