1RBD-NBD(8)                           Ceph                           RBD-NBD(8)
2
3
4

NAME

6       rbd-nbd - map rbd images to nbd device
7

SYNOPSIS

9       rbd-nbd [-c conf] [--read-only] [--device nbd device] [--nbds_max limit] [--max_part limit] [--exclusive] [--encryption-format format] [--encryption-passphrase-file passphrase-file] [--io-timeout seconds] [--reattach-timeout seconds] map image-spec | snap-spec
10       rbd-nbd unmap nbd device | image-spec | snap-spec
11       rbd-nbd list-mapped
12       rbd-nbd attach --device nbd device image-spec | snap-spec
13       rbd-nbd detach nbd device | image-spec | snap-spec
14
15

DESCRIPTION

17       rbd-nbd is a client for RADOS block device (rbd) images like rbd kernel
18       module.  It will map a rbd image to a nbd (Network  Block  Device)  de‐
19       vice, allowing access it as regular local block device.
20

OPTIONS

22       -c ceph.conf
23              Use   ceph.conf   configuration  file  instead  of  the  default
24              /etc/ceph/ceph.conf  to  determine  monitor   addresses   during
25              startup.
26
27       --read-only
28              Map read-only.
29
30       --nbds_max *limit*
31              Override  the  parameter nbds_max of NBD kernel module when mod‐
32              probe, used to limit the count of nbd device.
33
34       --max_part *limit*
35              Override for module param max_part.
36
37       --exclusive
38              Forbid writes by other clients.
39
40       --encryption-format
41              Image encryption format.  Possible values: luks1, luks2
42
43       --encryption-passphrase-file
44              Path of file containing a passphrase for unlocking image encryp‐
45              tion.
46
47       --io-timeout *seconds*
48              Override  device timeout. Linux kernel will default to a 30 sec‐
49              ond request timeout.  Allow the user to  optionally  specify  an
50              alternate timeout.
51
52       --reattach-timeout *seconds*
53              Specify timeout for the kernel to wait for a new rbd-nbd process
54              is attached after the old process is detached. The default is 30
55              second.
56

IMAGE AND SNAP SPECS

58       image-spec is [pool-name]/image-name
59       snap-spec  is [pool-name]/image-name@snap-name
60
61
62       The  default for pool-name is "rbd".  If an image name contains a slash
63       character ('/'), pool-name is required.
64

AVAILABILITY

66       rbd-nbd is part of Ceph, a massively scalable, open-source, distributed
67       storage   system.   Please   refer   to   the   Ceph  documentation  at
68       http://ceph.com/docs for more information.
69

SEE ALSO

71       rbd(8)
72
74       2010-2021, Inktank Storage, Inc. and contributors. Licensed under  Cre‐
75       ative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
76
77
78
79
80dev                              Sep 28, 2021                       RBD-NBD(8)
Impressum