nbd

NBD ReadMe

Bem -vindo aos arquivos de suporte da NBD Userland!

Este pacote contém NBD-Server e NBD-Client.

Para instalar o pacote, faça o download da fonte e faça a configure normal / make / make install . Você precisará instalá -lo no cliente e no servidor.

Para compilar a partir do Git, faça uma compra, instale as ferramentas SGML (DocBook2man) e execute './autogen.sh' enquanto estiver dentro do seu checkout. Então, veja acima.

Contribuindo

Se você deseja enviar um patch, não abra uma solicitação de tração; Em vez disso, envie -o para a lista de correio

Questões de segurança

Se você acha que encontrou um problema de segurança na NBD, entre em contato com a lista de malas. Não apenas registre um problema para isso (embora você possa fazê -lo também, se preferir).

Para problemas de embargo, entre em contato com Wouter Verhelst [email protected]

Usando NBD

NBD é muito fácil de usar. Primeiro, no cliente, você precisa carregar o módulo e, se não estiver usando o UDEV, para criar os nós do dispositivo:

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

(Se você precisar de mais de um dispositivo NBD, repita o comando acima para NBD1, NBD2, ...)

Em seguida, escreva um arquivo de configuração para o servidor. Um exemplo se parece com o seguinte:

 # 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

O arquivo de configuração é analisado com o Gkeyfile do Glib, que analisa os arquivos das chaves, como são especificados na especificação de entrada da área de trabalho Freedesktop.org, como pode ser encontrado em http://freedesktop.org/standards/desktop-entry-spec. Embora esse formato não tenha se destinado a ser usado para arquivos de configuração, a API GLIB é flexível o suficiente para ser usado como tal.

Agora comece o servidor:

 nbd-server -C /path/to/configfile

Observe que o nome do arquivo deve ser um caminho absoluto; ou seja, algo como /path/to/file , não ../file . Consulte a Manpage NBD-Server para obter detalhes sobre quaisquer opções disponíveis.

Por fim, você poderá iniciar o cliente:

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

por exemplo,

 nbd-client 10.0.0.1 -N otherexport /dev/nbd0

usará a segunda exportação no exemplo acima (aquele que exporta /export/nbd/experiment )

nbd-client deve ser executado como raiz; O mesmo não se aplica ao NBD-Server (mas certifique-se de que /var /run seja escrito pelo servidor que nbd-server executa como; caso contrário, você não receberá um arquivo PID, embora o servidor continue em execução).

Existem pacotes (ou similares) disponíveis para a maioria dos sistemas operacionais atuais; Consulte o crachá "Status da embalagem" abaixo para obter detalhes.

Para perguntas, use [email protected] MailingList.

Implementações alternativas

Além deste projeto, o protocolo NBD foi implementado por várias outras pessoas. Uma lista (provavelmente incompleta) segue:

• O NBDKIT é um servidor NBD multithread com uma arquitetura de plug -in.
• Libnbd é uma biblioteca para ajudar na redação de clientes da NBD
• O QEMU contém um servidor NBD incorporado, um cliente NBD incorporado e um servidor NBD independente ( qemu-nbd ). Eles mantêm um documento de status de sua implementação da NBD.
• Existe uma implementação do cliente baseada no GEOM GATE para FreeBSD. Ele não viu atualizações desde 2018 e implementa apenas o lado do cliente (qualquer servidor deve ser executado no FreeBSD não modificado).
• Existe uma implementação do cliente do Windows como parte da implementação do RBD do CEPH para Windows.
• O LWNBD é uma biblioteca de servidor NBD, direcionando o sistema bare metal ou o sistema operacional. Tem uma arquitetura de plug -in.

Além disso, essas implementações já existiram, mas agora não são mais mantidas:

• XNBD: Esta foi uma implementação da NBD com algumas mensagens de protocolo extras que permitiram a migração ao vivo. Seu repositório de código desapareceu.
• ENBD: Esta foi uma implementação da NBD com algumas mensagens de protocolo extras que permitiram que as chamadas extras de IOCTL fossem transmitidas (por exemplo, a mensagem "Ejeção" para um dispositivo de CD-ROM que estava sendo exportado através da NBD). Parece não ser mais mantido.
• Tradutor Hurd: Houve uma implementação de prova de conceito do protocolo NBD uma vez como tradutor para o Hurd. Não sabemos qual é o seu status atual.
• Christoph Lohmann escreveu uma implementação do cliente para o Plano 9. O link que ele nos forneceu agora é obsoleto; Não sabemos qual é o seu status atual.

Crachás