babeltrace2-query(1): Skillnad mellan sidversioner

Från Wiki.linux.se -Linux wikipedia på Svenska.
Hoppa till navigering Hoppa till sök
Rad 456: Rad 456:
Den nuvarande projektunderhållaren är Jérémie Galarneau:
Den nuvarande projektunderhållaren är Jérémie Galarneau:


* [[mailto:jeremie.galarneau@efficios.com|jeremie.galarneau@efficios.com]]
* [mailto:jeremie.galarneau@efficios.com|jeremie.galarneau@efficios.com]


== Upphovsrätt ==
== Upphovsrätt ==

Versionen från 3 maj 2026 kl. 06.52

babeltrace2-query(1) – Linux manualsida

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:

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 kommando är en del av Babeltrace 2-projektet.

Babeltrace distribueras under MIT-licensen:

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

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

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