nbd

Readme NBD

¡Bienvenido a los archivos de soporte de NBD Userland!

Este paquete contiene NBD-server y NBD-Client.

Para instalar el paquete, descargue la fuente y haga la danza de instalación de configure / make / make install normal. Deberá instalarlo tanto en el cliente como en el servidor.

Para compilar desde Git, haga un pago, instale las herramientas SGML (Docbook2man) y luego ejecute './autogen.sh' mientras está dentro de su pago. Entonces, ver arriba.

Que contribuye

Si desea enviar un parche, no abra una solicitud de extracción; En su lugar, envíelo a la lista de correo

Problemas de seguridad

Si cree que encontró un problema de seguridad en NBD, comuníquese con la Lista de correo. No solo presente un problema para esto (aunque también puede hacerlo si lo prefiere).

Para obtener problemas de embarcado, comuníquese con Wouter Verhelst [email protected]

Usando NBD

NBD es bastante fácil de usar. Primero, en el cliente, debe cargar el módulo y, si no está usando UDEV, para crear los nodos del dispositivo:

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

(Si necesita más de un dispositivo NBD, repita el comando anterior para NBD1, NBD2, ...)

A continuación, escriba un archivo de configuración para el servidor. Un ejemplo se ve así:

 # 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

El archivo de configuración se analiza con GKEYFILE de GLIB, que analiza los archivos clave como se especifican en la especificación de entrada de escritorio freedesktop.org, como se puede encontrar en http://freedesktop.org/standards/desktop-entry-spec. Si bien este formato no estaba destinado a usarse para los archivos de configuración, la API GLIB es lo suficientemente flexible como para que se use como tal.

Ahora inicie el servidor:

 nbd-server -C /path/to/configfile

Tenga en cuenta que el nombre de archivo debe ser una ruta absoluta; es decir, algo como /path/to/file , no ../file . Consulte la mano de mano NBD-Server para obtener detalles sobre cualquier opción disponible.

Finalmente, podrá iniciar el cliente:

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

p.ej,

 nbd-client 10.0.0.1 -N otherexport /dev/nbd0

Utilizará la segunda exportación en el ejemplo anterior (el que exporta /export/nbd/experiment )

nbd-client debe ejecutarse como root; Lo mismo no es cierto para NBD-server (pero asegúrese de que el servidor se ejecute por el servidor que ejecuta nbd-server como; de lo contrario, no obtendrá un archivo PID, aunque el servidor seguirá ejecutándose).

Hay paquetes (o similares) disponibles para la mayoría de los sistemas operativos actuales; Consulte la insignia "Estado de embalaje" a continuación para más detalles.

Para preguntas, utilice [email protected] MailingList.

Implementaciones alternativas

Además de este proyecto, el protocolo NBD ha sido implementado por varias otras personas. A Sigue una lista (probablemente incompleta):

• NBDKIT es un servidor NBD multiproceso con una arquitectura de complemento.
• libnbd es una biblioteca para ayudar a escribir clientes NBD
• QEMU contiene un servidor NBD integrado, un cliente NBD integrado y un servidor NBD independiente ( qemu-nbd ). Mantienen un documento de estado de su implementación NBD.
• Existe una implementación de cliente basada en Geom Gate para FreeBSD. No ha visto ninguna actualización desde 2018, y solo implementa el lado del cliente (sin embargo, cualquier servidor debe ejecutarse en FreeBSD sin modificar).
• Existe una implementación del cliente de Windows como parte de la implementación RBD de CEPH para Windows.
• LWNBD es una biblioteca de servidor NBD, un sistema de metal desnudo o un sistema integrado. Tiene una arquitectura de complemento.

Además, estas implementaciones alguna vez existieron, pero ahora ya no se mantienen:

• XNBD: Esta fue una implementación de NBD con algunos mensajes de protocolo adicionales que permitieron la migración en vivo. Su repositorio de código ha desaparecido.
• ENBD: Esta fue una implementación de NBD con algunos mensajes de protocolo adicionales que permitieron transmitir llamadas IOCTL adicionales (por ejemplo, el mensaje "expulsado" para un dispositivo CD-ROM que se estaba exportando a través de NBD). Parece que ya no se mantiene.
• Traductor de Hurd: Hubo una implementación de prueba de concepto del protocolo NBD una vez como traductor para el HURD. No sabemos cuál es su estado actual.
• Christoph Lohmann escribió una vez una implementación del cliente para el Plan 9. El enlace que nos proporcionó ahora es obsoleto; No sabemos cuál es su estado actual.

Insignias