busctl - Online w chmurze

PROGRAM:

IMIĘ

busctl - Introspekcja autobusu

STRESZCZENIE

busctl [OPCJE...] [POLECENIE] [IMIĘ...]

OPIS

busctl może być używany do introspekcji i monitorowania magistrali D-Bus.

OPCJE

Rozumie się następujące opcje:

--adres=ADRES
Połącz się z autobusem określonym przez ADRES zamiast używać odpowiednich wartości domyślnych dla obu
magistrala systemowa lub użytkownika (patrz --system i --użytkownik opcje).

--pokaż-maszynę
Wyświetlając listę peerów, pokaż kolumnę zawierającą nazwy kontenerów, które
należeć do. Widzieć systemd-machined.service(8).

--jedyny w swoim rodzaju
Pokazując listę rówieśników, pokaż tylko „unikalne” nazwy (w postaci
":numer.numer").

--nabyty
Przeciwieństwo --jedyny w swoim rodzaju — wyświetlane będą tylko „dobrze znane” nazwiska.

--do aktywacji
Wyświetlając listę peerów, pokaż tylko tych, którzy faktycznie nie zostali aktywowani
jeszcze, ale mogą być uruchamiane automatycznie, jeśli są dostępne.

--dopasuj=MATCH
Wyświetlając wymieniane wiadomości, pokaż tylko pasujący podzbiór MATCH.

--rozmiar=
W przypadku użycia z zdobyć polecenie, określa maksymalny rozmiar komunikatu magistrali do przechwycenia
("snaplen"). Domyślnie 4096 bajtów.

--lista
W przypadku użycia z drzewo pokazuje płaską listę ścieżek obiektów zamiast drzewa.

--cichy
W przypadku użycia z wezwanie polecenie, blokuje wyświetlanie ładunku komunikatu odpowiedzi.
Zauważ, że nawet jeśli ta opcja jest określona, ​​zwrócone błędy będą nadal drukowane i
narzędzie wskaże sukces lub niepowodzenie z kodem zakończenia procesu.

--gadatliwy
W przypadku użycia z wezwanie or pobierz własność polecenie, wyświetla dane wyjściowe w bardziej szczegółowej formie
Format.

--oczekuj-odpowiedz=BOOL
W przypadku użycia z wezwanie polecenie, określa, czy busctl czeka na zakończenie
wywołanie metody, wypisz zwrócone dane odpowiedzi metody i zwróć sukces lub
niepowodzenie poprzez kod zakończenia procesu. Jeśli jest ustawione na „nie”, wywołanie metody będzie
wydane, ale nie oczekuje się odpowiedzi, narzędzie kończy pracę natychmiast, a zatem nie
może zostać wyświetlona odpowiedź, a kod zakończenia nie zwraca powodzenia ani niepowodzenia. Do
Pomijaj tylko wyjście ładunku wiadomości zwrotnej, użyj --cichy nad. Domyślnie do
"tak".

--automatyczny start=BOOL
W przypadku użycia z wezwanie polecenie, określa, czy wywołanie metody powinno być niejawnie
aktywuj wywoływaną usługę, jeśli nie jest jeszcze uruchomiona, ale jest skonfigurowana tak, aby była
uruchomione automatycznie. Domyślnie "tak".

--allow-interaktywna-autoryzacja=BOOL
W przypadku użycia z wezwanie polecenie, określa, czy usługi mogą wymuszać
interaktywna autoryzacja podczas wykonywania operacji, jeśli polityka bezpieczeństwa jest
skonfigurowany do tego. Domyślnie "tak".

--limit czasu=SECS
W przypadku użycia z wezwanie polecenie, określa maksymalny czas oczekiwania na wywołanie metody
ukończenie. Jeśli nie określono jednostki czasu, przyjmuje się sekundy. Zwykłe inne jednostki to
również zrozumiałe (ms, us, s, min, h, d, w, month, y). Zauważ, że ten limit czasu nie
zastosuj, jeśli --oczekuj odpowiedzi=nie jest używany, ponieważ narzędzie nie czeka na żadną wiadomość zwrotną
następnie. Gdy nie jest określony lub gdy jest ustawiony na 0, przyjmowana jest wartość domyślna „25s”.

--augment-creds=BOOL
Kontroluje, czy dane poświadczeń zgłaszane przez podstęp or status zostanie uzupełniony o
dane z /proc. Po włączeniu wyświetlane dane są prawdopodobnie niespójne, ponieważ
dane odczytane z / proc może być nowszy niż reszta poświadczeń
Informacja. Domyślnie "tak".

--użytkownik
Porozmawiaj z kierownikiem serwisu użytkownika dzwoniącego, a nie z kierownikiem serwisu
system.

--system
Porozmawiaj z kierownikiem serwisu systemu. To jest domniemana wartość domyślna.

-H, --gospodarz=
Wykonaj operację zdalnie. Podaj nazwę hosta lub nazwę użytkownika i nazwę hosta
oddzielone znakiem „@”, aby się połączyć. Nazwa hosta może opcjonalnie być poprzedzona przyrostkiem
nazwa kontenera, oddzielona ":", która łączy się bezpośrednio z konkretnym kontenerem on
określonego hosta. Spowoduje to użycie SSH do rozmowy z instancją menedżera komputera zdalnego.
Nazwy kontenerów mogą być wyliczane za pomocą maszyna -H HOST.

-M, --maszyna=
Wykonaj operację na lokalnym kontenerze. Podaj nazwę kontenera, z którym chcesz się połączyć.

--bez pagera
Nie przesyłaj danych wyjściowych do pagera.

--no-legenda
Nie drukuj legendy, czyli nagłówków kolumn i stopki z podpowiedziami.

-h, --help
Wydrukuj krótki tekst pomocy i wyjdź.

--wersja
Wydrukuj krótki ciąg wersji i zakończ.

POLECENIA

Zrozumiane są następujące polecenia:

podstęp
Pokaż wszystkich partnerów w autobusie według ich nazw usług. Domyślnie pokazuje zarówno unikalne, jak i
znane nazwiska, ale można to zmienić za pomocą --jedyny w swoim rodzaju i --nabyty przełączniki.
Jest to operacja domyślna, jeśli nie określono żadnego polecenia.

status [SERWIS]
Pokaż informacje o procesie i dane uwierzytelniające usługi autobusowej (jeśli jest to określone przez jego
unikalna lub dobrze znana nazwa), proces (jeśli jest określony przez jego numeryczny PID) lub
właściciel magistrali (jeśli nie określono parametru).

monitor [SERWIS...]
Zrzuć wymieniane wiadomości. Gdyby SERWIS jest określony, pokaż wiadomości do lub z tego
równorzędny, identyfikowany przez jego dobrze znaną lub unikalną nazwę. W przeciwnym razie pokaż wszystkie wiadomości na
autobus. Użyj Ctrl-C, aby zakończyć zrzut.

zdobyć [SERWIS...]
Podobny do monitor ale zapisuje dane wyjściowe w formacie pcap (szczegóły można znaleźć w Libpcap
filet utworzony[1] opis. Pamiętaj, aby przekierować dane wyjściowe do STDOUT do pliku.
Narzędzia takie jak Wireshark(1) może służyć do analizy i przeglądania wygenerowanych plików.

drzewo [SERWIS...]
Pokazuje drzewo obiektów jednej lub więcej usług. Gdyby SERWIS jest określony, pokaż obiekt
drzewo tylko określonych usług. W przeciwnym razie pokaż wszystkie drzewa obiektów wszystkich usług
w autobusie, który zyskał co najmniej jedno znane nazwisko.

analizować własne myśli i uczucia SERWIS OBIEKT [INTERFACE]
Pokaż interfejsy, metody, właściwości i sygnały określonego obiektu (zidentyfikowanego
przez jego ścieżkę) w określonej usłudze. Jeśli argument interfejsu zostanie przekazany, dane wyjściowe
jest ograniczony do członków określonego interfejsu.

wezwanie SERWIS OBIEKT INTERFACE SPOSÓB [PODPIS [ARGUMENT...]]
Wywołaj metodę i pokaż odpowiedź. Przyjmuje nazwę usługi, ścieżkę obiektu, interfejs
nazwa i nazwa metody. Jeśli parametry mają być przekazane do wywołania metody, podpis
wymagany jest ciąg, po którym następują argumenty, indywidualnie sformatowane jako ciągi. Do
szczegóły dotyczące zastosowanego formatowania, patrz poniżej. Aby wstrzymać wyprowadzanie zwróconych danych,
użyć --cichy opcja.

pobierz własność SERWIS OBIEKT INTERFACE NIERUCHOMOŚĆ...
Pobierz bieżącą wartość co najmniej jednej właściwości obiektu. Przyjmuje nazwę usługi,
ścieżka obiektu, nazwa interfejsu i nazwa właściwości. Wiele właściwości można określić w
raz, w takim przypadku ich wartości będą wyświetlane jedna po drugiej, oddzielone
nowe wiersze. Dane wyjściowe są domyślnie w zwięzłym formacie. Posługiwać się --gadatliwy po więcej
rozbudowany format wyjściowy.

zestaw-właściwość SERWIS OBIEKT INTERFACE NIERUCHOMOŚĆ PODPIS ARGUMENT...
Ustaw bieżącą wartość właściwości obiektu. Przyjmuje nazwę usługi, ścieżkę obiektu,
nazwa interfejsu, nazwa właściwości, podpis właściwości, a następnie lista parametrów
sformatowane jako ciągi.

pomoc
Pokaż pomoc dotyczącą składni poleceń.

PARAMETR FORMATOWANIE

Połączenia wezwanie i zestaw-właściwość polecenia przyjmują ciąg podpisu, po którym następuje lista
parametry sformatowane jako ciąg (szczegółowe informacje na temat ciągów podpisu D-Bus można znaleźć w Rodzaj Nieruchomości
system publikacji naukowej of dotychczasowy autobus D specyfikacja[2]). W przypadku prostych typów każdy parametr następuje po
podpis powinien być po prostu wartością parametru sformatowaną jako łańcuch. Pozytywna wartość logiczna
wartości mogą być sformatowane jako „prawda”, „tak”, „wł.” lub „1”; ujemne wartości logiczne mogą być
określony jako „fałsz”, „nie”, „wyłączony” lub „0”. W przypadku tablic argument liczbowy dla liczby
wpisów, po których następują wpisy. W przypadku wariantów podpis
należy określić treść, a następnie treść. W przypadku słowników i struktur
ich treść powinna być bezpośrednio określona.

Na przykład,

Jawoll

jest formatowaniem pojedynczego ciągu „jawoll”.

jako 3 hello world foobar

to formatowanie tablicy ciągów z trzema wpisami: „hello”, „world” i „foobar”.

a{sv} 3 Jeden s Eins Dwa u 2 Tak b prawda

jest formatowaniem tablicy słownika, która odwzorowuje ciągi na warianty, składającej się z trzech
wpisy. Ciąg „Jeden” ma przypisany ciąg „Eins”. Ciąg „Dwa” jest przypisany
32-bitowa liczba całkowita bez znaku 2. Łańcuchowi „Tak” jest przypisywana dodatnia wartość logiczna.

Zauważ, że wezwanie, pobierz własność, analizować własne myśli i uczucia polecenia również wygenerują dane wyjściowe w tym
format zwracanych danych. Ponieważ ten format jest czasami zbyt zwięzły, aby był łatwy
zrozumiałe, wezwanie i pobierz własność polecenia mogą generować bardziej szczegółowe, wielowierszowe
wyjście po przekazaniu --gadatliwy opcja.

PRZYKŁADY

Przykład 1. Pisać i Czytaj a Nieruchomość

Poniższe dwa polecenia najpierw zapisują właściwość, a następnie ją odczytują. Nieruchomość jest
znaleziony w obiekcie „/org/freedesktop/systemd1” usługi „org.freedesktop.systemd1”.
Nazwa właściwości to „LogLevel” w „org.freedesktop.systemd1.Manager”
berło. Właściwość zawiera pojedynczy ciąg:

# busctl set-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Debug poziomu logów menedżera
# busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Poziom dziennika menedżera
s „debugowanie”

Przykład 2. Lakoniczny i Gadatliwy Wydajność

Poniższe dwa polecenia odczytują właściwość, która zawiera tablicę ciągów, a najpierw
pokaż go w zwięzłym formacie, a następnie w formacie pełnym:

$ busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Menedżer Środowisko
jako 2 „LANG=en_US.UTF-8” „PATH=/ usr / local / sbin:/ usr / local / bin:/ usr / sbin:/ usr / bin"
$ busctl get-property --verbose org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Menedżer Środowisko
TABLICA "s" {
STRING "LANG=en_US.UTF-8";
STRING „ŚCIEŻKA=/ usr / local / sbin:/ usr / local / bin:/ usr / sbin:/ usr / bin";
};

Przykład 3. Przywoływanie a Metoda wykonania

Następujące polecenie wywołuje metodę „StartUnit” na
Interfejs „org.freedesktop.systemd1.Manager” obiektu „/org/freedesktop/systemd1”
usługę „org.freedesktop.systemd1” i przekazuje jej dwa ciągi „cups.service” i
"wymienić". W wyniku wywołania metody odbierany jest pojedynczy parametr ścieżki obiektu i
pokazane:

# busctl call org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager StartUnit ss „cups.service” „replace”
o „/org/freedesktop/systemd1/job/42684”

Korzystaj z busctl online za pomocą usług onworks.net