busctl - Online di Cloud

PROGRAM:

NAMA

busctl - Introspeksi bus

RINGKASAN

busctl [OPSI...] [PERINTAH] [NAMA...]

DESKRIPSI

busctl dapat digunakan untuk introspeksi dan memantau bus D-Bus.

PILIHAN

Opsi berikut dipahami:

--alamat=ALAMAT
Hubungkan ke bus yang ditentukan oleh ALAMAT alih-alih menggunakan default yang sesuai untuk keduanya
sistem atau bus pengguna (lihat --sistem dan --pengguna pilihan).

--show-mesin
Saat menampilkan daftar rekan, tunjukkan kolom yang berisi nama-nama wadah yang mereka
milik. Lihat systemd-machined.service(8).

--unik
Saat menampilkan daftar rekan, hanya tampilkan nama "unik" (dari formulir
":jumlah.jumlah").

--diperoleh
Lawan dari --unik — hanya nama "terkenal" yang akan ditampilkan.

--aktif
Saat menampilkan daftar rekan, hanya tampilkan rekan yang sebenarnya belum diaktifkan
belum, tetapi dapat dimulai secara otomatis jika diakses.

--pertandingan=MATCH
Saat menampilkan pesan yang sedang dipertukarkan, tampilkan hanya subset yang cocok MATCH.

--ukuran=
Saat digunakan dengan menangkap perintah, menentukan ukuran pesan bus maksimum untuk ditangkap
("snaple"). Default ke 4096 byte.

--Daftar
Saat digunakan dengan pohon perintah, menunjukkan daftar datar jalur objek alih-alih pohon.

--diam
Saat digunakan dengan panggilan perintah, menekan tampilan muatan pesan respons.
Perhatikan bahwa meskipun opsi ini ditentukan, kesalahan yang dikembalikan akan tetap dicetak dan
alat akan menunjukkan keberhasilan atau kegagalan dengan kode keluar proses.

--bertele-tele
Saat digunakan dengan panggilan or dapatkan-properti perintah, menunjukkan output dengan lebih verbose
Format.

--harap-balas=BOOL
Saat digunakan dengan panggilan perintah, menentukan apakah busctl akan menunggu selesainya
pemanggilan metode, menampilkan data respons metode yang dikembalikan, dan mengembalikan keberhasilan atau
kegagalan melalui kode keluar proses. Jika ini diatur ke "tidak", pemanggilan metode akan menjadi
dikeluarkan tetapi tidak ada tanggapan yang diharapkan, alat segera dihentikan, dan dengan demikian tidak ada
respons dapat ditampilkan, dan tidak ada keberhasilan atau kegagalan yang dikembalikan melalui kode keluar. Ke
hanya menekan output dari payload pesan balasan, gunakan --diam di atas. Default untuk
"Ya".

--mulai otomatis=BOOL
Saat digunakan dengan panggilan perintah, menentukan apakah pemanggilan metode harus secara implisit
aktifkan layanan yang dipanggil, jika belum berjalan tetapi dikonfigurasi untuk menjadi
otomatis dimulai. Default untuk "ya".

--izinkan-interaktif-otorisasi=BOOL
Saat digunakan dengan panggilan perintah, menentukan apakah layanan dapat menegakkan
otorisasi interaktif saat menjalankan operasi, jika kebijakan keamanannya
dikonfigurasi untuk ini. Default untuk "ya".

--waktu habis=DETIK
Saat digunakan dengan panggilan perintah, menentukan waktu maksimum untuk menunggu panggilan metode
penyelesaian. Jika tidak ada satuan waktu yang ditentukan, asumsikan detik. Unit lain yang biasa adalah
mengerti juga (ms, us, s, min, h, d, w, month, y). Perhatikan bahwa batas waktu ini tidak
berlaku jika --harap-balasan=tidak digunakan, karena alat tidak menunggu pesan balasan apa pun
kemudian. Bila tidak ditentukan atau bila diatur ke 0, default "25s" diasumsikan.

--tambahan-kredit=BOOL
Mengontrol apakah data kredensial dilaporkan oleh daftar or status akan ditambah dengan
data dari /proc. Saat ini diaktifkan, data yang ditampilkan mungkin tidak konsisten, karena
data yang dibaca dari / proc mungkin lebih baru daripada kredensial lainnya
informasi. Default untuk "ya".

--pengguna
Bicaralah dengan manajer layanan dari pengguna yang menelepon, bukan dengan manajer layanan
sistem.

--sistem
Bicaralah dengan manajer layanan sistem. Ini adalah default tersirat.

-H, --tuan rumah=
Jalankan operasi dari jarak jauh. Tentukan nama host, atau nama pengguna dan nama host
dipisahkan oleh "@", untuk terhubung. Nama host secara opsional dapat diakhiri dengan a
nama wadah, dipisahkan oleh ":", yang menghubungkan langsung ke wadah tertentu di
tuan rumah yang ditentukan. Ini akan menggunakan SSH untuk berbicara dengan instance manajer mesin jarak jauh.
Nama kontainer dapat disebutkan dengan mesinctl -H HOST.

-M, --mesin=
Jalankan operasi pada wadah lokal. Tentukan nama penampung yang akan dihubungkan.

--tanpa-halaman
Jangan menyalurkan output ke pager.

--tidak ada legenda
Jangan mencetak legenda, yaitu header kolom dan footer dengan petunjuk.

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

--Versi: kapan
Cetak string versi singkat dan keluar.

PERINTAH

Perintah berikut dipahami:

daftar
Tunjukkan semua rekan di bus, dengan nama layanan mereka. Secara default, menampilkan unik dan
nama-nama terkenal, tetapi ini dapat diubah dengan --unik dan --diperoleh switch.
Ini adalah operasi default jika tidak ada perintah yang ditentukan.

status [LAYANAN]
Tampilkan informasi proses dan kredensial layanan bus (jika ada yang ditentukan olehnya
nama unik atau terkenal), suatu proses (jika ditentukan oleh PID numeriknya), atau
pemilik bus (jika tidak ada parameter yang ditentukan).

Monitor [LAYANAN...]
Membuang pesan yang sedang dipertukarkan. Jika LAYANAN ditentukan, tampilkan pesan ke atau dari ini
rekan, diidentifikasi dengan namanya yang terkenal atau unik. Jika tidak, tampilkan semua pesan di
bis. Gunakan Ctrl-C untuk menghentikan dump.

menangkap [LAYANAN...]
Mirip dengan Monitor tetapi menulis output dalam format pcap (untuk detailnya, lihat Libcap
File dibentuk[1] deskripsi. Pastikan untuk mengarahkan output ke STDOUT ke file.
Alat-alat seperti wireshark(1) dapat digunakan untuk membedah dan melihat file yang dihasilkan.

pohon [LAYANAN...]
Memperlihatkan pohon objek dari satu atau lebih layanan. Jika LAYANAN ditentukan, tampilkan objek
pohon dari layanan tertentu saja. Jika tidak, tampilkan semua pohon objek dari semua layanan
di bus yang memperoleh setidaknya satu nama terkenal.

mengintrospeksi LAYANAN OBYEK [INTERFACE]
Tampilkan antarmuka, metode, properti, dan sinyal dari objek yang ditentukan (diidentifikasi
dengan jalurnya) pada layanan yang ditentukan. Jika argumen antarmuka dilewatkan, output
terbatas pada anggota antarmuka yang ditentukan.

panggilan LAYANAN OBYEK INTERFACE METODE [TANDA TANGAN [ARGUMEN...]]
Panggil metode dan tunjukkan responsnya. Mengambil nama layanan, jalur objek, antarmuka
nama dan nama metode. Jika parameter harus diteruskan ke pemanggilan metode, tanda tangan
string diperlukan, diikuti oleh argumen, diformat secara individual sebagai string. Untuk
detail tentang format yang digunakan, lihat di bawah. Untuk menekan output dari data yang dikembalikan,
gunakan --diam .

dapatkan-properti LAYANAN OBYEK INTERFACE PROPERTI...
Ambil nilai saat ini dari satu atau lebih properti objek. Mengambil nama layanan,
jalur objek, nama antarmuka, dan nama properti. Beberapa properti dapat ditentukan di
sekali, dalam hal ini nilainya akan ditampilkan satu demi satu, dipisahkan oleh
baris baru. Outputnya, secara default, dalam format singkat. Menggunakan --bertele-tele untuk lebih
format keluaran yang rumit.

set-properti LAYANAN OBYEK INTERFACE PROPERTI TANDA TANGAN ARGUMEN...
Tetapkan nilai properti objek saat ini. Mengambil nama layanan, jalur objek,
nama antarmuka, nama properti, tanda tangan properti, diikuti dengan daftar parameter
diformat sebagai string.

membantu
Tampilkan bantuan sintaks perintah.

PARAMETER FORMAT

Grafik panggilan dan set-properti perintah mengambil string tanda tangan diikuti oleh daftar
parameter yang diformat sebagai string (untuk detail tentang string tanda tangan D-Bus, lihat: Tipe
sistem bab of itu D bis spesifikasi[2]). Untuk tipe sederhana, setiap parameter berikut:
tanda tangan harus berupa nilai parameter yang diformat sebagai string. Boolean positif
nilai dapat diformat sebagai "benar", "ya", "aktif", atau "1"; nilai boolean negatif mungkin
ditentukan sebagai "salah", "tidak", "mati", atau "0". Untuk array, argumen numerik untuk nomor
entri diikuti oleh entri harus ditentukan. Untuk varian, tanda tangan dari
isi harus ditentukan, diikuti dengan isinya. Untuk kamus dan struct,
isinya harus ditentukan secara langsung.

Sebagai contoh,

s rahang

adalah format string tunggal "jawoll".

sebagai 3 halo dunia foobar

adalah pemformatan larik string dengan tiga entri, "halo", "dunia" dan "foobar".

a{sv} 3 Satu detik Dua u 2 Ya b benar

adalah pemformatan larik kamus yang memetakan string ke varian, terdiri dari tiga
entri. String "Satu" diberi string "Eins". String "Dua" diberikan
32-bit unsigned integer 2. String "Ya" diberi nilai boolean positif.

Perhatikan bahwa panggilan, dapatkan-properti, mengintrospeksi perintah juga akan menghasilkan output dalam hal ini
format untuk data yang dikembalikan. Karena format ini terkadang terlalu singkat untuk menjadi mudah
mengerti, itu panggilan dan dapatkan-properti perintah dapat menghasilkan lebih verbose, multi-baris
keluaran saat melewati --bertele-tele .

CONTOH

Contoh 1. Menulis dan Baca a Milik

Dua perintah berikut pertama menulis properti dan kemudian membacanya kembali. Properti adalah
ditemukan pada objek "/org/freedesktop/systemd1" dari layanan "org.freedesktop.systemd1".
Nama propertinya adalah "LogLevel" di "org.freedesktop.systemd1.Manager"
antarmuka. Properti berisi satu string:

# busctl set-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager LogLevel debug
# busctl dapatkan-properti org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager LogLevel
s "debug"

Contoh 2. Pendek dan Bertele-tele Keluaran

Dua perintah berikut membaca properti yang berisi larik string, dan pertama
tunjukkan dalam format singkat, diikuti dengan format verbose:

$ busctl dapatkan-properti org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager Lingkungan
sebagai 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.Manager Environment
ARRAY "s" {
STRING "LANG=en_US.UTF-8";
STRING "JALAN=/ usr / local / sbin:/ usr / local / bin:/ usr / sbin:/ usr / bin";
};

Contoh 3. Memohon a metode

Perintah berikut memanggil metode "StartUnit" pada
Antarmuka "org.freedesktop.systemd1.Manager" dari objek "/org/freedesktop/systemd1" dari
layanan "org.freedesktop.systemd1", dan meneruskannya dua string "cups.service" dan
"mengganti". Sebagai hasil dari pemanggilan metode, parameter jalur objek tunggal diterima dan
ditampilkan:

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

Gunakan busctl online menggunakan layanan onworks.net