lrbd man page

lrbd — configures iSCSI access to Ceph rbd images


lrbd [OPTION] ...


lrbd without any options will read the configuration from Ceph and  apply the changes to the host.  The configuration is detailed  in lrbd.conf(5). Changes are executed via targetcli(8).

The options are as follows:


-e, --edit

edit the global configuration.  If the EDITOR environment variable is set, uses the specified editor.

-E editor, --edit editor

edit the global configuration with the program specified.

-c name, --config name

sets the object name in Ceph to name.  The default is lrbd.conf

--ceph ceph

set the Ceph configuration file.  The default is /etc/ceph/ceph.conf.

-H host, --host host

specify the hostname which defaults to gethostname().

-o, --output

display the global configuration

-l, --local

display the host configuration

-f file, --file file

import the configuration from a file

-a file, --add file

add the configuration from a file

-u, --unmap

unmap the rbd images.  Images in use will fail to unmap.

-v, --verbose

print INFO messages

-d, --debug

print DEBUG messages

-I, --iblock

use an iblock backstore for images, default to rbd

-R, --rbd

use an rbd backstore for images, can override -I

-W, --wipe

remove all configuration objects from all pools.  Use with care.

-C, --clear

remove the current targetcli configuration from the host.

Some options may be combined, such as -Cu to first clear the configuration and then unmap the images.  




The environment file for customizing options for the lrbd.service


The service file to apply the configuration during boot.  


Eric Jackson <>

See Also

lrbd.conf(5), targetcli(8),