This document is for a development version of Ceph.
rbd-nbd – map rbd images to nbd device¶
rbd-nbd is a client for RADOS block device (rbd) images like rbd kernel module. It will map a rbd image to a nbd (Network Block Device) device, allowing access it as regular local block device.
Use ceph.conf configuration file instead of the default
/etc/ceph/ceph.confto determine monitor addresses during startup.
Override the parameter nbds_max of NBD kernel module when modprobe, used to limit the count of nbd device.
Override for module param max_part.
Forbid writes by other clients.
Image encryption format. Possible values: luks1, luks2
Path of file containing a passphrase for unlocking image encryption.
Override device timeout. Linux kernel will default to a 30 second request timeout. Allow the user to optionally specify an alternate timeout.
Specify timeout for the kernel to wait for a new rbd-nbd process is attached after the old process is detached. The default is 30 second.
Image and snap specs¶
The default for pool-name is “rbd”. If an image name contains a slash character (‘/’), pool-name is required.
rbd-nbd is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer to the Ceph documentation at http://ceph.com/docs for more information.