nbdkit - Daring di Awan

PROGRAM:

NAMA

nbdkit - Toolkit untuk membuat server NBD

RINGKASAN

nbdkit [--dump-config] [-f] [-g GROUP] [-i iPadDR]
[-P PIDFILE] [-p PORT] [-r] [--jalankan CMD] [-s]
[-U SOCKET] [-u PENGGUNA] [-v] [-V]
PLUGIN [kunci=nilai [kunci=nilai [...]]]

DESKRIPSI

Network Block Device (NBD) adalah protokol jaringan untuk mengakses perangkat blok melalui
jaringan. Perangkat blok adalah hard disk dan hal-hal yang berperilaku seperti hard disk seperti disk
gambar dan mesin virtual.

"nbdkit" adalah perangkat untuk membuat server NBD dari sumber "tidak konvensional" dan
nama server NBD.

Untuk membuat sumber Perangkat Blok Jaringan baru, yang perlu Anda lakukan hanyalah menulis beberapa lem
fungsi, mungkin dalam C, atau mungkin dalam bahasa tingkat tinggi seperti Perl atau Python. NS
lisensi liberal nbdkit dimaksudkan untuk memungkinkan Anda menautkan nbdkit dengan kepemilikan
perpustakaan atau untuk memasukkan nbdkit dalam kode kepemilikan.

Jika Anda ingin menulis plugin nbdkit, Anda harus membaca plugin nbdkit(3).

Beberapa plugin dapat ditemukan di "$libdir/nbdkit/plugins". Anda dapat memberikan jalur lengkap ke
pluginnya, seperti ini:

nbdkit $libdir/nbdkit/plugins/nbdkit-file-plugin.so [...]

tetapi biasanya lebih nyaman menggunakan sintaks yang setara ini:

file nbdkit [...]

$libdir diatur pada waktu kompilasi. Untuk mencetaknya, lakukan:

nbdkit --dump-config

CONTOH

Sajikan file "disk.img" pada port 10809:

file file nbdkit = disk.img

Jalankan plugin example1 dan sambungkan menggunakan ikan tamu(1):

contoh nbdkit1
ikan tamu --ro -a nbd://localhost

Jalankan plugin example3 dan sambungkan menggunakan ikan tamu(1):

contoh nbdkit3 ukuran = 1G
ikan tamu --ro -a nbd://localhost

Untuk menampilkan informasi penggunaan tentang plugin tertentu:

nbdkit --bantuan contoh1

GLOBAL PILIHAN

--membantu
Tampilkan informasi penggunaan baris perintah singkat dan keluar.

--dump-config
Buang nilai konfigurasi waktu kompilasi dan keluar.

-f
--latar depan
--tanpa-garpu
Jangan garpu ke latar belakang.

-g GROUP
--kelompok GROUP
Ubah grup menjadi "GROUP" setelah memulai. Nama grup atau ID grup numerik dapat berupa
bekas.

Server membutuhkan izin yang cukup untuk dapat melakukan ini. Biasanya ini akan
berarti memulai server sebagai root.

Lihat juga -u.

-i iPadDR
--ip-addr iPadDR
--ipaddr iPadDR
Dengarkan pada antarmuka yang ditentukan. Standarnya adalah mendengarkan di semua antarmuka. Lihat
juga -p.

-P FILE PID
--pid-file FILE PID
--pidfile FILE PID
Tulis "PIDFILE" (berisi ID proses server) setelah nbdkit siap
untuk menerima koneksi.

Jika file sudah ada, itu akan ditimpa. nbdkit tidak tidak hapus file ketika
itu keluar.

-p PORT
--Pelabuhan PORT
Ubah nomor port TCP/IP tempat nbdkit melayani permintaan. Standarnya adalah 10809.
Lihat juga -i.

-r
--hanya-baca
--hanya baca
Ekspor akan menjadi hanya-baca. Jika klien menulis, maka itu akan mendapatkan kesalahan.

Perhatikan bahwa beberapa plugin secara inheren tidak mendukung penulisan. Dengan plugin itu -r
opsi ditambahkan secara implisit.

Fungsi copy-on-write (atau "snapshot") tidak didukung oleh server ini. Namun
jika Anda menggunakan qemu sebagai klien (atau secara tidak langsung melalui libguestfs) maka itu mendukung
snapshot.

--Lari CMD
Jalankan nbdkit sebagai subproses captive dari "CMD". Ketika "CMD" keluar, nbdkit dimatikan. Lihat
"CAPTIVE NBDKIT" di bawah ini.

Opsi ini menyiratkan --latar depan.

-s
--Lajang
--stdin
Jangan garpu. Tangani satu koneksi NBD di stdin/stdout. Setelah stdin ditutup,
server keluar.

Anda dapat menggunakan opsi ini untuk menjalankan nbdkit dari inetd, systemd, atau superserver serupa; atau
hanya untuk pengujian; atau jika Anda ingin menjalankan nbdkit dengan cara yang tidak konvensional.

Opsi ini menyiratkan --latar depan.

-U STOPKONTAK
--unix STOPKONTAK
-U -
--unix -
Terima koneksi pada soket domain Unix "SOCKET" (yang merupakan jalur).

nbdkit membuat soket ini, tetapi mungkin memiliki izin yang salah (juga
permisif). Jika itu adalah masalah bahwa beberapa pengguna yang tidak sah dapat terhubung ke ini
soket antara waktu nbdkit dimulai dan pengguna yang berwenang terhubung, lalu
letakkan soket ke direktori yang memiliki izin terbatas.

nbdkit tidak tidak hapus file soket saat keluar. Penelepon harus menghapus
socket file setelah digunakan (jika tidak, jika Anda mencoba memulai nbdkit lagi, Anda akan mendapatkan
Kesalahan "Alamat sudah digunakan").

Jika nama soketnya adalah - kemudian nbdkit menghasilkan soket pribadi yang dinamai secara acak. Ini
berguna dengan "CAPTIVE NBDKIT".

-u PENGGUNA
--pengguna PENGGUNA
Ubah pengguna menjadi "USER" setelah memulai. Nama pengguna atau ID pengguna numerik dapat digunakan.

Server membutuhkan izin yang cukup untuk dapat melakukan ini. Biasanya ini akan
berarti memulai server sebagai root.

Lihat juga -g.

-v
--bertele-tele
Aktifkan pesan verbose.

Ini adalah ide yang baik untuk digunakan -f juga agar prosesnya tidak bercabang ke latar belakang
(tetapi tidak wajib).

-V
--Versi: kapan
Cetak nomor versi nbdkit dan keluar.

PLUGIN KONFIGURASI

Setelah menentukan nama plugin yang Anda dapat (opsional, itu tergantung pada plugin) berikan
konfigurasi plugin pada command line berupa "key=value". Sebagai contoh:

file file nbdkit = disk.img

Untuk membuat daftar semua opsi yang didukung oleh plugin, lakukan:

nbdkit --file bantuan

TAWANAN NBDKIT

Anda dapat menjalankan nbdkit sebagai "proses tawanan", menggunakan --Lari pilihan. Ini berarti bahwa nbdkit
berjalan selama (misalnya) qemu(1) atau ikan tamu(1) sedang berjalan. Saat mereka keluar, nbdkit
terbunuh.

Beberapa contoh harus memperjelas hal ini.

Untuk menjalankan nbdkit captive di bawah qemu:

nbdkit file file=disk.img --jalankan 'qemu -drive file=$nbd,if=virtio'

Pada baris perintah qemu, $nbd diganti secara otomatis dengan jalur NBD yang benar sehingga
dapat terhubung ke nbdkit. Ketika qemu keluar, nbdkit dimatikan dan dibersihkan secara otomatis.

Menjalankan nbdkit captive di bawah guestfish:

nbdkit file file=disk.img --run 'guestfish --format=raw -a $nbd -i'

Saat guestfish keluar, nbdkit dimatikan.

Variabel shell berikut tersedia di: --Lari argumen:

$nbd
URL yang merujuk ke port atau soket nbdkit.

Perhatikan ada beberapa keajaiban di sini, karena URL qemu dan guestfish memiliki format yang berbeda,
jadi nbdkit mencoba menebak yang Anda jalankan. Jika sihirnya tidak berhasil, coba gunakan
variabel di bawah ini sebagai gantinya.

$pelabuhan
Jika "", nomor port yang mendengarkan nbdkit.

$unixsocket
Jika "", soket domain Unix yang mendengarkan nbdkit.

--Lari menyiratkan --latar depan. Tidak mungkin, dan mungkin tidak diinginkan, untuk memiliki
garpu nbdkit ke latar belakang saat menggunakan --Lari.

Bahkan saat menjalankan captive, nbdkit masih mendengarkan pada port TCP/IP biasa, kecuali jika Anda
tentukan -p/-U pilihan. Jika Anda menginginkan nbdkit tawanan yang benar-benar pribadi, maka Anda harus
buat soket Unix acak pribadi, seperti ini:

nbdkit -U - plugin [args] --run '...'

SINYAL

"nbdkit" merespons sinyal berikut:

"MASUK"
"SIGQUIT"
"SIGTERM"
Server keluar dengan bersih.

"SIGPIPE"
Sinyal ini diabaikan.

Gunakan nbdkit online menggunakan layanan onworks.net