MIPS: Yosemite, Emma: Fix off-by-two in arcs_cmdline buffer size check
[linux-2.6/linux-mips.git] / Documentation / ABI / testing / sysfs-bus-rbd
blobfa72ccb2282e77c879c0a7a135f6d86828a143cc
1 What:           /sys/bus/rbd/
2 Date:           November 2010
3 Contact:        Yehuda Sadeh <yehuda@newdream.net>,
4                 Sage Weil <sage@newdream.net>
5 Description:
7 Being used for adding and removing rbd block devices.
9 Usage: <mon ip addr> <options> <pool name> <rbd image name> [snap name]
11  $ echo "192.168.0.1 name=admin rbd foo" > /sys/bus/rbd/add
13 The snapshot name can be "-" or omitted to map the image read/write. A <dev-id>
14 will be assigned for any registered block device. If snapshot is used, it will
15 be mapped read-only.
17 Removal of a device:
19   $ echo <dev-id> > /sys/bus/rbd/remove
21 Entries under /sys/bus/rbd/devices/<dev-id>/
22 --------------------------------------------
24 client_id
26         The ceph unique client id that was assigned for this specific session.
28 major
30         The block device major number.
32 name
34         The name of the rbd image.
36 pool
38         The pool where this rbd image resides. The pool-name pair is unique
39         per rados system.
41 size
43         The size (in bytes) of the mapped block device.
45 refresh
47         Writing to this file will reread the image header data and set
48         all relevant datastructures accordingly.
50 current_snap
52         The current snapshot for which the device is mapped.
54 create_snap
56         Create a snapshot:
58          $ echo <snap-name> > /sys/bus/rbd/devices/<dev-id>/snap_create
60 rollback_snap
62         Rolls back data to the specified snapshot. This goes over the entire
63         list of rados blocks and sends a rollback command to each.
65          $ echo <snap-name> > /sys/bus/rbd/devices/<dev-id>/snap_rollback
67 snap_*
69         A directory per each snapshot
72 Entries under /sys/bus/rbd/devices/<dev-id>/snap_<snap-name>
73 -------------------------------------------------------------
77         The rados internal snapshot id assigned for this snapshot
79 size
81         The size of the image when this snapshot was taken.