busctl - Dalam talian di Awan

JADUAL:

NAMA

busctl - Introspeksi bas

SINOPSIS

busctl [PILIHAN...] [PERINTAH] [NAMA...]

DESCRIPTION

busctl boleh digunakan untuk introspeksi dan memantau bas D-Bus.

PILIHAN

Pilihan berikut difahami:

--alamat=ALAMAT
Sambung ke bas yang ditentukan oleh ALAMAT bukannya menggunakan lalai yang sesuai untuk sama ada
sistem atau bas pengguna (lihat --sistem and --pengguna pilihan).

--mesin pameran
Apabila menunjukkan senarai rakan sebaya, tunjukkan lajur yang mengandungi nama bekas mereka
milik. Lihat systemd-machined.service(8).

--unik
Apabila menunjukkan senarai rakan sebaya, tunjukkan hanya nama "unik" (daripada borang
":nombor.nombor").

--diperolehi
Bertentangan dengan --unik — hanya nama "terkenal" akan ditunjukkan.

--boleh diaktifkan
Apabila menunjukkan senarai rakan sebaya, tunjukkan hanya rakan sebaya yang sebenarnya belum diaktifkan
belum, tetapi boleh dimulakan secara automatik jika diakses.

--perlawanan=MATCH
Apabila menunjukkan mesej yang ditukar, tunjukkan padanan subset sahaja MATCH.

--saiz=
Apabila digunakan dengan menangkap arahan, menentukan saiz mesej bas maksimum untuk ditangkap
("snaplen"). Lalai kepada 4096 bait.

--senarai
Apabila digunakan dengan pokok arahan, menunjukkan senarai rata laluan objek dan bukannya pokok.

--senyap
Apabila digunakan dengan memanggil arahan, menyekat paparan muatan mesej respons.
Ambil perhatian bahawa walaupun pilihan ini ditentukan, ralat yang dikembalikan masih akan dicetak dan
alat akan menunjukkan kejayaan atau kegagalan dengan kod keluar proses.

--verbose
Apabila digunakan dengan memanggil or dapatkan-harta arahan, menunjukkan output dalam bentuk yang lebih terperinci
format.

--jangka-balas=BOOL
Apabila digunakan dengan memanggil arahan, menentukan sama ada busctl hendaklah menunggu untuk siap
panggilan kaedah, keluarkan data tindak balas kaedah yang dikembalikan, dan kejayaan kembali atau
kegagalan melalui kod keluar proses. Jika ini ditetapkan kepada "tidak", panggilan kaedah akan menjadi
dikeluarkan tetapi tiada tindak balas dijangka, alat ditamatkan serta-merta, dan dengan itu tidak
respons boleh ditunjukkan, dan tiada kejayaan atau kegagalan dikembalikan melalui kod keluar. Kepada
hanya menekan output muatan mesej balasan, gunakan --senyap di atas. Lalai kepada
"ya".

--auto-mula=BOOL
Apabila digunakan dengan memanggil arahan, menentukan sama ada panggilan kaedah harus secara tersirat
aktifkan perkhidmatan yang dipanggil, sekiranya ia belum berjalan tetapi dikonfigurasikan untuk menjadi
dimulakan secara automatik. Lalai kepada "ya".

--allow-interactive-authorization=BOOL
Apabila digunakan dengan memanggil arahan, menentukan sama ada perkhidmatan boleh menguatkuasakan
kebenaran interaktif semasa melaksanakan operasi, jika dasar keselamatan adalah
dikonfigurasikan untuk ini. Lalai kepada "ya".

--masa tamat=Secs
Apabila digunakan dengan memanggil arahan, menentukan masa maksimum untuk menunggu panggilan kaedah
selesai. Jika tiada unit masa dinyatakan, andaikan saat. Unit lain yang biasa adalah
difahami juga (ms, kami, s, min, h, d, w, bulan, y). Ambil perhatian bahawa tamat masa ini tidak
memohon jika --expect-reply=tidak digunakan, kerana alat itu tidak menunggu sebarang mesej balasan
kemudian. Apabila tidak dinyatakan atau apabila ditetapkan kepada 0, lalai "25s" diandaikan.

--tambah-kred =BOOL
Mengawal sama ada data kelayakan dilaporkan oleh senarai or terkini hendaklah ditambah dengan
data daripada /proc. Apabila ini dihidupkan, data yang ditunjukkan mungkin tidak konsisten, seperti
data yang dibaca daripada / proc mungkin lebih terkini daripada kelayakan yang lain
maklumat. Lalai kepada "ya".

--pengguna
Bercakap dengan pengurus perkhidmatan pengguna yang memanggil, bukannya pengurus perkhidmatan
sistem.

--sistem
Bercakap dengan pengurus perkhidmatan sistem. Ini ialah lalai tersirat.

-H, --tuan rumah=
Jalankan operasi dari jauh. Tentukan nama hos, atau nama pengguna dan nama hos
dipisahkan dengan "@", untuk disambungkan. Nama hos secara pilihan boleh diakhiri dengan a
nama bekas, dipisahkan dengan ":", yang bersambung terus ke bekas tertentu pada
hos yang ditentukan. Ini akan menggunakan SSH untuk bercakap dengan contoh pengurus mesin jauh.
Nama bekas boleh disenaraikan dengan machinectl -H HOST.

-M, --mesin=
Jalankan operasi pada bekas tempatan. Tentukan nama bekas untuk disambungkan.

--tiada-halaman muka surat
Jangan paipkan output ke dalam pager.

--tiada-legenda
Jangan cetak legenda, iaitu pengepala lajur dan pengaki dengan petunjuk.

-h, - membantu
Cetak teks bantuan pendek dan keluar.

--versi
Cetak rentetan dan keluar versi pendek.

PERINTAH

Perintah berikut difahami:

senarai
Tunjukkan semua rakan sebaya di dalam bas, dengan nama perkhidmatan mereka. Secara lalai, menunjukkan kedua-dua unik dan
nama yang terkenal, tetapi ini boleh ditukar dengan --unik and --diperolehi suis.
Ini adalah operasi lalai jika tiada arahan ditentukan.

terkini [PERKHIDMATAN]
Tunjukkan maklumat proses dan bukti kelayakan perkhidmatan bas (jika dinyatakan oleh perkhidmatan bas
nama unik atau terkenal), proses (jika dinyatakan oleh PID berangkanya), atau
pemilik bas (jika tiada parameter dinyatakan).

memantau [PERKHIDMATAN...]
Buang mesej yang sedang ditukar. Jika PERKHIDMATAN ditentukan, tunjukkan mesej kepada atau daripada ini
rakan sebaya, dikenal pasti dengan nama yang terkenal atau unik. Jika tidak, tunjukkan semua mesej pada
bas. Gunakan Ctrl-C untuk menamatkan pembuangan.

menangkap [PERKHIDMATAN...]
Sama seperti memantau tetapi menulis output dalam format pcap (untuk butiran, lihat Libpcap
File format[1] penerangan. Pastikan anda mengubah hala output ke STDOUT ke fail.
Alatan seperti wireshark(1) boleh digunakan untuk membedah dan melihat fail yang dihasilkan.

pokok [PERKHIDMATAN...]
Menunjukkan pokok objek bagi satu atau lebih perkhidmatan. Jika PERKHIDMATAN ditentukan, tunjukkan objek
pokok perkhidmatan yang ditentukan sahaja. Jika tidak, tunjukkan semua pokok objek bagi semua perkhidmatan
dalam bas yang memperoleh sekurang-kurangnya satu nama yang terkenal.

introspeksi diri PERKHIDMATAN OBJEK [INTERFACE]
Tunjukkan antara muka, kaedah, sifat dan isyarat objek yang ditentukan (dikenal pasti
melalui laluannya) pada perkhidmatan yang ditentukan. Jika hujah antara muka diluluskan, output
terhad kepada ahli antara muka yang ditentukan.

memanggil PERKHIDMATAN OBJEK INTERFACE KAEDAH [TANDATANGAN [ARGUMEN...]]
Guna kaedah dan tunjukkan respons. Mengambil nama perkhidmatan, laluan objek, antara muka
nama dan nama kaedah. Jika parameter hendaklah dihantar kepada panggilan kaedah, tandatangan
rentetan diperlukan, diikuti dengan hujah, diformat secara individu sebagai rentetan. Untuk
butiran tentang pemformatan yang digunakan, lihat di bawah. Untuk menyekat output data yang dikembalikan,
menggunakan --senyap pilihan.

dapatkan-harta PERKHIDMATAN OBJEK INTERFACE HARTANAH...
Dapatkan nilai semasa satu atau lebih sifat objek. Mengambil nama perkhidmatan,
laluan objek, nama antara muka dan nama harta. Berbilang sifat boleh ditentukan di
sekali, dalam hal ini nilai mereka akan ditunjukkan satu demi satu, dipisahkan oleh
baris baharu. Outputnya, secara lalai, dalam format singkat. guna --verbose untuk lebih
format output yang terperinci.

set-harta benda PERKHIDMATAN OBJEK INTERFACE HARTANAH TANDATANGAN ARGUMEN...
Tetapkan nilai semasa harta objek. Mengambil nama perkhidmatan, laluan objek,
nama antara muka, nama harta, tandatangan harta, diikuti dengan senarai parameter
diformatkan sebagai rentetan.

membantu
Tunjukkan bantuan sintaks arahan.

PARAMETER MEMformat

. memanggil and set-harta benda arahan mengambil rentetan tandatangan diikuti dengan senarai
parameter diformat sebagai rentetan (untuk butiran tentang rentetan tandatangan D-Bus, lihat Jenis
sistem bab of yang Bas-D spesifikasi[2]). Untuk jenis mudah, setiap parameter berikut
tandatangan mestilah nilai parameter yang diformatkan sebagai rentetan. Boolean positif
nilai boleh diformatkan sebagai "benar", "ya", "pada", atau "1"; nilai boolean negatif mungkin
dinyatakan sebagai "palsu", "tidak", "mati", atau "0". Untuk tatasusunan, hujah berangka untuk nombor
penyertaan yang diikuti dengan penyertaan hendaklah dinyatakan. Untuk varian, tandatangan daripada
kandungan hendaklah dinyatakan, diikuti dengan kandungan. Untuk kamus dan struct, the
kandungannya hendaklah dinyatakan secara langsung.

Sebagai contoh,

s jawoll

ialah pemformatan rentetan tunggal "jawoll".

sebagai 3 hello world foobar

ialah pemformatan tatasusunan rentetan dengan tiga entri, "hello", "world" dan "foobar".

a{sv} 3 One s Eins Two u 2 Ya b benar

ialah pemformatan tatasusunan kamus yang memetakan rentetan kepada varian, yang terdiri daripada tiga
entri. Rentetan "Satu" diberikan rentetan "Eins". Rentetan "Dua" diberikan
Integer tidak bertanda 32-bit 2. Rentetan "Ya" diberikan boolean positif.

Ambil perhatian bahawa memanggil, dapatkan-harta, introspeksi diri arahan juga akan menghasilkan output dalam ini
format untuk data yang dikembalikan. Memandangkan format ini kadangkala terlalu ringkas untuk menjadi mudah
difahami, yang memanggil and dapatkan-harta arahan boleh menjana lebih verbose, berbilang baris
output apabila lulus --verbose pilihan.

CONTOH

Contoh 1. Tulis and Baca a Harta

Dua arahan berikut mula-mula menulis harta dan kemudian membacanya kembali. Harta tersebut adalah
ditemui pada objek "/org/freedesktop/systemd1" perkhidmatan "org.freedesktop.systemd1".
Nama harta itu ialah "LogLevel" pada "org.freedesktop.systemd1.Manager"
antara muka. Harta ini mengandungi satu rentetan:

# busctl set-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager LogLevel s debug
# busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager LogLevel
s "nyahpepijat"

Contoh 2. Tersembunyi and Kata Kerja Output

Dua arahan berikut membaca sifat yang mengandungi tatasusunan rentetan, dan pertama
tunjukkan dalam format ringkas, diikuti dengan format bertele-tele:

$ busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Persekitaran Pengurus
sebagai 2 "LANG=en_US.UTF-8" "PATH=/ usr / tempatan / sbin:/ usr / local / bin:/ usr / sbin:/ usr / bin"
$ busctl get-property --verbose org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Persekitaran Pengurus
ARRAY "s" {
STRING "LANG=en_US.UTF-8";
STRING "LALUAN=/ usr / tempatan / sbin:/ usr / local / bin:/ usr / sbin:/ usr / bin";
};

Contoh 3. Menyerang a kaedah

Perintah berikut menggunakan kaedah "StartUnit" pada
Antara muka "org.freedesktop.systemd1.Manager" bagi objek "/org/freedesktop/systemd1"
perkhidmatan "org.freedesktop.systemd1" dan menghantarnya dua rentetan "cups.service" dan
"ganti". Hasil daripada panggilan kaedah, parameter laluan objek tunggal diterima dan
ditunjukkan:

# busctl panggil org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager StartUnit ss "cups.service" "replace"
o "/org/freedesktop/systemd1/job/42684"

Gunakan busctl dalam talian menggunakan perkhidmatan onworks.net