nbd

NBD ReadMe

Selamat datang di NBD Userland Support Files!

Paket ini berisi NBD-Server dan NBD-Client.

Untuk menginstal paket, unduh sumbernya dan lakukan Normal configure / make / make install Dance. Anda harus menginstalnya di klien dan server.

Untuk menyusun dari git, lakukan checkout, instal alat SGML (DocBook2MAN), dan kemudian jalankan './autogen.sh' saat berada di dalam checkout Anda. Kemudian, lihat di atas.

Berkontribusi

Jika Anda ingin mengirim tambalan, jangan buka permintaan tarik; Sebaliknya, kirimkan ke daftar surat

Masalah keamanan

Jika Anda pikir Anda menemukan masalah keamanan di NBD, silakan hubungi MailingList. Jangan hanya mengajukan masalah untuk ini (meskipun Anda dapat melakukannya juga jika Anda mau).

Untuk masalah embargo, silakan hubungi Wouter Verhelst [email protected]

Menggunakan NBD

NBD cukup mudah digunakan. Pertama, pada klien, Anda perlu memuat modul dan, jika Anda tidak menggunakan udev, untuk membuat node perangkat:

 # modprobe nbd
# cd /dev
# ./MAKEDEV nbd0

(Jika Anda membutuhkan lebih dari satu perangkat NBD, ulangi perintah di atas untuk NBD1, NBD2, ...)

Selanjutnya, tulis file konfigurasi untuk server. Contoh terlihat seperti ini:

 # This is a comment
[generic]
    # The [generic] section is required, even if nothing is specified
    # there.
    # When either of these options are specified, nbd-server drops
    # privileges to the given user and group after opening ports, but
    # _before_ opening files.
    user = nbd
    group = nbd
[export1]
    exportname = /export/nbd/export1-file
    authfile = /export/nbd/export1-authfile
    timeout = 30
    filesize = 10000000
    readonly = false
    multifile = false
    copyonwrite = false
    prerun = dd if=/dev/zero of=%s bs=1k count=500
    postrun = rm -f %s
[otherexport]
    exportname = /export/nbd/experiment
    # The other options are all optional

File konfigurasi diuraikan dengan GKEYFILE GLIB, yang mem-parses file-file kunci seperti yang ditentukan dalam spesifikasi entri desktop freedesktop.org, seperti yang dapat ditemukan di http://freedesktop.org/standards/desktop-pec-spec. Meskipun format ini tidak dimaksudkan untuk digunakan untuk file konfigurasi, API glib cukup fleksibel untuk digunakan seperti itu.

Sekarang mulai server:

 nbd-server -C /path/to/configfile

Perhatikan bahwa nama file harus menjadi jalur absolut; yaitu, sesuatu seperti /path/to/file , bukan ../file . Lihat NBD-Server Manpage untuk detail tentang opsi yang tersedia.

Akhirnya, Anda dapat memulai klien:

 nbd-client <hostname> -N <export name> <nbd device>

misalnya,

 nbd-client 10.0.0.1 -N otherexport /dev/nbd0

akan menggunakan ekspor kedua dalam contoh di atas (yang ekspor /export/nbd/experiment )

nbd-client harus dijalankan sebagai root; Hal yang sama tidak berlaku untuk NBD-Server (tetapi pastikan /var /run ditulis oleh server yang dijalankan nbd-server sebagai; jika tidak, Anda tidak akan mendapatkan file PID, meskipun server akan terus berjalan).

Ada paket (atau serupa) yang tersedia untuk sebagian besar sistem operasi saat ini; Lihat lencana "Status Pengemasan" di bawah ini untuk detailnya.

Untuk pertanyaan, silakan gunakan [email protected] Mailinglist.

Implementasi Alternatif

Selain proyek ini, protokol NBD telah diterapkan oleh berbagai orang lain. Daftar (mungkin tidak lengkap) mengikuti:

• NBDKIT adalah server NBD multithreaded dengan arsitektur plugin.
• Libnbd adalah perpustakaan untuk membantu dalam menulis klien NBD
• QEMU berisi server NBD tertanam, klien NBD tertanam, dan server NBD mandiri ( qemu-nbd ). Mereka mempertahankan dokumen status implementasi NBD mereka.
• Implementasi klien berbasis gerbang geom untuk FreeBSD ada. Ia belum melihat pembaruan apa pun sejak 2018, dan hanya mengimplementasikan sisi klien (server apa pun harus berjalan pada FreeBSD yang tidak dimodifikasi, namun).
• Implementasi klien Windows ada sebagai bagian dari implementasi RBD CEPH untuk Windows.
• LWNBD adalah pustaka server NBD, menargetkan sistem tertanam atau os. Ini memiliki arsitektur plugin.

Selain itu, implementasi ini pernah ada tetapi sekarang tidak lagi dipelihara:

• XNBD: Ini adalah implementasi NBD dengan beberapa pesan protokol tambahan yang memungkinkan migrasi langsung. Repositori kode telah menghilang.
• ENBD: Ini adalah implementasi NBD dengan beberapa pesan protokol tambahan yang memungkinkan panggilan IOCTL tambahan untuk dilewati (misalnya, pesan "ect" untuk perangkat CD-ROM yang sedang diekspor melalui NBD). Tampaknya tidak lagi dipertahankan.
• Hurd Translator: Ada implementasi bukti-konsep dari protokol NBD sekali sebagai penerjemah untuk Hurd. Kami tidak tahu apa statusnya saat ini.
• Christoph Lohmann pernah menulis implementasi klien untuk Rencana 9. Tautan yang dia berikan kepada kami sekarang basi; Kami tidak tahu apa statusnya saat ini.

Lencana