nbd

NBD README

مرحبًا بك في ملفات دعم Userland NBD!

تحتوي هذه الحزمة على NBD-Server و NBD-Client.

لتثبيت الحزمة ، قم بتنزيل المصدر وقم configure العادي / make / make install . ستحتاج إلى تثبيته على كل من العميل والخادم.

للتجميع من Git ، قم بإجراء الخروج ، وقم بتثبيت أدوات SGML (Docbook2Man) ، ثم قم بتشغيلها. ثم ، انظر أعلاه.

المساهمة

إذا كنت ترغب في إرسال تصحيح ، فالرجاء عدم فتح طلب سحب ؛ بدلاً من ذلك ، أرسلها إلى قائمة البريد

قضايا الأمن

إذا كنت تعتقد أنك عثرت على مشكلة أمان في NBD ، فيرجى الاتصال بـ Mailinglist. لا تقم فقط بتقديم مشكلة لهذا (على الرغم من أنك قد تفعل ذلك أيضًا إذا كنت تفضل).

للقضايا المحظورة ، يرجى الاتصال بـ Wouter Verhelst [email protected]

باستخدام NBD

NBD سهل الاستخدام. أولاً ، على العميل ، تحتاج إلى تحميل الوحدة ، وإذا كنت لا تستخدم UDEV ، لإنشاء عقد الجهاز:

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

(إذا كنت بحاجة إلى أكثر من جهاز NBD ، كرر الأمر أعلاه لـ NBD1 ، NBD2 ، ...)

بعد ذلك ، اكتب ملف تكوين للخادم. مثال يبدو هكذا:

 # 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

يتم تحليل ملف التكوين مع GKEYFILE من GLIB ، والذي يحلل الملفات الرئيسية كما هو محدد في مواصفات إدخال سطح المكتب freedesktop.org ، كما يمكن العثور عليها في http://freedesktop.org/standards/desktop-entry-pec. على الرغم من أن هذا التنسيق لم يكن مقصودًا لاستخدامه في ملفات التكوين ، إلا أن واجهة برمجة تطبيقات GLIB مرنة بما يكفي لاستخدامها على هذا النحو.

الآن ابدأ الخادم:

 nbd-server -C /path/to/configfile

لاحظ أن اسم الملف يجب أن يكون مسارًا مطلقًا ؛ أي شيء مثل /path/to/file ، وليس ../file . راجع Manpage NBD-Server للحصول على تفاصيل عن أي خيارات متاحة.

أخيرًا ، ستتمكن من بدء العميل:

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

على سبيل المثال ،

 nbd-client 10.0.0.1 -N otherexport /dev/nbd0

سيستخدم التصدير الثاني في المثال أعلاه (الذي يصدر /export/nbd/experiment )

يجب تشغيل nbd-client كجذر ؛ الشيء نفسه ليس صحيحًا بالنسبة لـ NBD-Server (ولكن تأكد من أن /var /run قابلة للكتابة بواسطة الخادم أن nbd-server يعمل على أنه ؛ وإلا ، فلن تحصل على ملف PID ، على الرغم من أن الخادم سيستمر في تشغيله).

هناك حزم (أو ما شابه) متاحة لمعظم أنظمة التشغيل الحالية ؛ راجع شارة "حالة التغليف" أدناه للحصول على التفاصيل.

للأسئلة ، يرجى استخدام [email protected] mailinglist.

تطبيقات بديلة

إلى جانب هذا المشروع ، تم تنفيذ بروتوكول NBD من قبل مختلف الأشخاص الآخرين. فيما يلي قائمة (ربما غير مكتملة):

• NBDKIT هو خادم NBD متعدد مؤشرات الترابط مع بنية البرنامج المساعد.
• Libnbd هي مكتبة للمساعدة في كتابة عملاء NBD
• يحتوي QEMU على خادم NBD مضمن ، وعميل NBD مضمن ، وخادم NBD مستقل ( qemu-nbd ). أنها تحافظ على وثيقة حالة لتنفيذ NBD.
• يوجد تنفيذ عميل قائم على بوابة Geom لـ FreeBSD. لم ير أي تحديثات منذ عام 2018 ، ويقوم فقط بتنفيذ جانب العميل (يجب أن يعمل أي خادم على FreeBSD غير المعدل ، ومع ذلك).
• يوجد تطبيق عميل Windows كجزء من تنفيذ RBD لـ CEPH لنظام التشغيل Windows.
• LWNBD هي مكتبة خادم NBD ، وتستهدف المعدن العاري أو نظام OS المدمج. لديها بنية البرنامج المساعد.

بالإضافة إلى ذلك ، كانت هذه التطبيقات موجودة مرة واحدة ولكن لم تعد محفوظة الآن:

• XNBD: كان هذا تطبيق NBD مع بعض رسائل البروتوكول الإضافية التي سمحت بالترحيل المباشر. اختفى مستودع الكود الخاص به.
• ENBD: كان هذا تطبيق NBD مع عدد قليل من رسائل البروتوكول الإضافية التي سمحت بتمرير مكالمات IOCTL إضافية (على سبيل المثال ، رسالة "الإخراج" لجهاز ROM CD الذي تم تصديره من خلال NBD). يبدو أنه لم يعد يتم الحفاظ عليه.
• مترجم Hurd: كان هناك تطبيق دليل على بروتوكول NBD مرة واحدة كمترجم لـ Hurd. نحن لا نعرف ما هو وضعه الحالي.
• كتب كريستوف لوهمان ذات مرة تنفيذ عميل للخطة 9. الرابط الذي قدمه لنا أصبح الآن قديمًا ؛ نحن لا نعرف ما هو وضعه الحالي.

شارات