--- /dev/null
+create
+=======
+ $ rbd create -s 1024 foo
+ $ rbd create -s 512 --image-format 2 bar
+ $ rbd create -s 2048 --image-format 2 baz
+ $ rbd create -s 1 quux
+
+snapshot
+========
+ $ rbd snap create bar@snap
+ $ rbd resize -s 1024 bar
+
+ Resizing image: 100% complete...done.
+ $ rbd snap create bar@snap2
+ $ rbd snap create foo@snap
+
+clone
+=====
+ $ rbd snap protect bar@snap
+ $ rbd clone bar@snap data/child
+ $ rbd snap create data/child@snap
+ $ rbd flatten data/child > /dev/null
+
+lock
+====
+ $ rbd lock add quux id
+ $ rbd lock add baz id1 --shared tag
+ $ rbd lock add baz id2 --shared tag
+ $ rbd lock add baz id3 --shared tag
+
+test formatting
+===============
+ $ rbd children foo@snap
+ $ rbd children bar@snap
+ data/child
+ $ rbd children bar@snap2
+TODO: figure out why .* does not match the block_name_prefix line in rbd info.
+For now, use a more inclusive regex.
+ $ rbd info foo
+ rbd image 'foo':
+ \tsize 1024 MB in 256 objects (esc)
+ \torder 22 (4096 KB objects) (esc)
+ [^^]+ (re)
+ \tformat: 1 (esc)
+ $ rbd info foo --format json | python -mjson.tool
+ {
+ "block_name_prefix": "rb.0.*", (glob)
+ "format": 1,
+ "name": "foo",
+ "object_size": 4194304,
+ "objects": 256,
+ "order": 22,
+ "size": 1073741824
+ }
+The version of xml_pp included in ubuntu precise always prints a 'warning'
+whenever it is run. grep -v to ignore it, but still work on other distros.
+ $ rbd info foo --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <image>
+ <name>foo</name>
+ <size>1073741824</size>
+ <objects>256</objects>
+ <order>22</order>
+ <object_size>4194304</object_size>
+ <block_name_prefix>rb.0.*</block_name_prefix> (glob)
+ <format>1</format>
+ </image>
+ $ rbd info foo@snap
+ rbd image 'foo':
+ \tsize 1024 MB in 256 objects (esc)
+ \torder 22 (4096 KB objects) (esc)
+ [^^]+ (re)
+ \tformat: 1 (esc)
+ \tprotected: False (esc)
+ $ rbd info foo@snap --format json | python -mjson.tool
+ {
+ "block_name_prefix": "rb.0.*", (glob)
+ "format": 1,
+ "name": "foo",
+ "object_size": 4194304,
+ "objects": 256,
+ "order": 22,
+ "protected": "false",
+ "size": 1073741824
+ }
+ $ rbd info foo@snap --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <image>
+ <name>foo</name>
+ <size>1073741824</size>
+ <objects>256</objects>
+ <order>22</order>
+ <object_size>4194304</object_size>
+ <block_name_prefix>rb.0*</block_name_prefix> (glob)
+ <format>1</format>
+ <protected>false</protected>
+ </image>
+ $ rbd info bar
+ rbd image 'bar':
+ \tsize 1024 MB in 256 objects (esc)
+ \torder 22 (4096 KB objects) (esc)
+ [^^]+ (re)
+ \tformat: 2 (esc)
+ \tfeatures: layering, striping (esc)
+ \tstripe unit: 4096 KB (esc)
+ \tstripe count: 1 (esc)
+ $ rbd info bar --format json | python -mjson.tool
+ {
+ "block_name_prefix": "rbd_data.*", (glob)
+ "features": [
+ "layering",
+ "striping"
+ ],
+ "format": 2,
+ "name": "bar",
+ "object_size": 4194304,
+ "objects": 256,
+ "order": 22,
+ "size": 1073741824,
+ "stripe_count": 1,
+ "stripe_unit": 4194304
+ }
+ $ rbd info bar --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <image>
+ <name>bar</name>
+ <size>1073741824</size>
+ <objects>256</objects>
+ <order>22</order>
+ <object_size>4194304</object_size>
+ <block_name_prefix>rbd_data.*</block_name_prefix> (glob)
+ <format>2</format>
+ <features>
+ <feature>layering</feature>
+ <feature>striping</feature>
+ </features>
+ <stripe_unit>4194304</stripe_unit>
+ <stripe_count>1</stripe_count>
+ </image>
+ $ rbd info bar@snap
+ rbd image 'bar':
+ \tsize 512 MB in 128 objects (esc)
+ \torder 22 (4096 KB objects) (esc)
+ [^^]+ (re)
+ \tformat: 2 (esc)
+ \tfeatures: layering, striping (esc)
+ \tprotected: True (esc)
+ \tstripe unit: 4096 KB (esc)
+ \tstripe count: 1 (esc)
+ $ rbd info bar@snap --format json | python -mjson.tool
+ {
+ "block_name_prefix": "rbd_data.*", (glob)
+ "features": [
+ "layering",
+ "striping"
+ ],
+ "format": 2,
+ "name": "bar",
+ "object_size": 4194304,
+ "objects": 128,
+ "order": 22,
+ "protected": "true",
+ "size": 536870912,
+ "stripe_count": 1,
+ "stripe_unit": 4194304
+ }
+ $ rbd info bar@snap --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <image>
+ <name>bar</name>
+ <size>536870912</size>
+ <objects>128</objects>
+ <order>22</order>
+ <object_size>4194304</object_size>
+ <block_name_prefix>rbd_data.*</block_name_prefix> (glob)
+ <format>2</format>
+ <features>
+ <feature>layering</feature>
+ <feature>striping</feature>
+ </features>
+ <protected>true</protected>
+ <stripe_unit>4194304</stripe_unit>
+ <stripe_count>1</stripe_count>
+ </image>
+ $ rbd info bar@snap2
+ rbd image 'bar':
+ \tsize 1024 MB in 256 objects (esc)
+ \torder 22 (4096 KB objects) (esc)
+ [^^]+ (re)
+ \tformat: 2 (esc)
+ \tfeatures: layering, striping (esc)
+ \tprotected: False (esc)
+ \tstripe unit: 4096 KB (esc)
+ \tstripe count: 1 (esc)
+ $ rbd info bar@snap2 --format json | python -mjson.tool
+ {
+ "block_name_prefix": "rbd_data.*", (glob)
+ "features": [
+ "layering",
+ "striping"
+ ],
+ "format": 2,
+ "name": "bar",
+ "object_size": 4194304,
+ "objects": 256,
+ "order": 22,
+ "protected": "false",
+ "size": 1073741824,
+ "stripe_count": 1,
+ "stripe_unit": 4194304
+ }
+ $ rbd info bar@snap2 --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <image>
+ <name>bar</name>
+ <size>1073741824</size>
+ <objects>256</objects>
+ <order>22</order>
+ <object_size>4194304</object_size>
+ <block_name_prefix>rbd_data.*</block_name_prefix> (glob)
+ <format>2</format>
+ <features>
+ <feature>layering</feature>
+ <feature>striping</feature>
+ </features>
+ <protected>false</protected>
+ <stripe_unit>4194304</stripe_unit>
+ <stripe_count>1</stripe_count>
+ </image>
+ $ rbd info baz
+ rbd image 'baz':
+ \tsize 2048 MB in 512 objects (esc)
+ \torder 22 (4096 KB objects) (esc)
+ [^^]+ (re)
+ \tformat: 2 (esc)
+ \tfeatures: layering, striping (esc)
+ \tstripe unit: 4096 KB (esc)
+ \tstripe count: 1 (esc)
+ $ rbd info baz --format json | python -mjson.tool
+ {
+ "block_name_prefix": "rbd_data.*", (glob)
+ "features": [
+ "layering",
+ "striping"
+ ],
+ "format": 2,
+ "name": "baz",
+ "object_size": 4194304,
+ "objects": 512,
+ "order": 22,
+ "size": 2147483648,
+ "stripe_count": 1,
+ "stripe_unit": 4194304
+ }
+ $ rbd info baz --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <image>
+ <name>baz</name>
+ <size>2147483648</size>
+ <objects>512</objects>
+ <order>22</order>
+ <object_size>4194304</object_size>
+ <block_name_prefix>rbd_data.*</block_name_prefix> (glob)
+ <format>2</format>
+ <features>
+ <feature>layering</feature>
+ <feature>striping</feature>
+ </features>
+ <stripe_unit>4194304</stripe_unit>
+ <stripe_count>1</stripe_count>
+ </image>
+ $ rbd info quux
+ rbd image 'quux':
+ \tsize 1024 KB in 1 objects (esc)
+ \torder 22 (4096 KB objects) (esc)
+ [^^]+ (re)
+ \tformat: 1 (esc)
+ $ rbd info quux --format json | python -mjson.tool
+ {
+ "block_name_prefix": "rb.0.*", (glob)
+ "format": 1,
+ "name": "quux",
+ "object_size": 4194304,
+ "objects": 1,
+ "order": 22,
+ "size": 1048576
+ }
+ $ rbd info quux --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <image>
+ <name>quux</name>
+ <size>1048576</size>
+ <objects>1</objects>
+ <order>22</order>
+ <object_size>4194304</object_size>
+ <block_name_prefix>rb.0.*</block_name_prefix> (glob)
+ <format>1</format>
+ </image>
+ $ rbd info data/child
+ rbd image 'child':
+ \tsize 512 MB in 128 objects (esc)
+ \torder 22 (4096 KB objects) (esc)
+ [^^]+ (re)
+ \tformat: 2 (esc)
+ \tfeatures: layering, striping (esc)
+ $ rbd info data/child --format json | python -mjson.tool
+ {
+ "block_name_prefix": "rbd_data.*", (glob)
+ "features": [
+ "layering",
+ "striping"
+ ],
+ "format": 2,
+ "name": "child",
+ "object_size": 4194304,
+ "objects": 128,
+ "order": 22,
+ "size": 536870912
+ }
+ $ rbd info data/child --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <image>
+ <name>child</name>
+ <size>536870912</size>
+ <objects>128</objects>
+ <order>22</order>
+ <object_size>4194304</object_size>
+ <block_name_prefix>rbd_data.*</block_name_prefix> (glob)
+ <format>2</format>
+ <features>
+ <feature>layering</feature>
+ <feature>striping</feature>
+ </features>
+ </image>
+ $ rbd info data/child@snap
+ rbd image 'child':
+ \tsize 512 MB in 128 objects (esc)
+ \torder 22 (4096 KB objects) (esc)
+ [^^]+ (re)
+ \tformat: 2 (esc)
+ \tfeatures: layering, striping (esc)
+ \tprotected: False (esc)
+ \tparent: rbd/bar@snap (esc)
+ \toverlap: 512 MB (esc)
+ $ rbd info data/child@snap --format json | python -mjson.tool
+ {
+ "block_name_prefix": "rbd_data.*", (glob)
+ "features": [
+ "layering",
+ "striping"
+ ],
+ "format": 2,
+ "name": "child",
+ "object_size": 4194304,
+ "objects": 128,
+ "order": 22,
+ "parent": {
+ "image": "bar",
+ "overlap": 536870912,
+ "pool": "rbd",
+ "snapshot": "snap"
+ },
+ "protected": "false",
+ "size": 536870912
+ }
+ $ rbd info data/child@snap --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <image>
+ <name>child</name>
+ <size>536870912</size>
+ <objects>128</objects>
+ <order>22</order>
+ <object_size>4194304</object_size>
+ <block_name_prefix>rbd_data.*</block_name_prefix> (glob)
+ <format>2</format>
+ <features>
+ <feature>layering</feature>
+ <feature>striping</feature>
+ </features>
+ <protected>false</protected>
+ <parent>
+ <pool>rbd</pool>
+ <image>bar</image>
+ <snapshot>snap</snapshot>
+ <overlap>536870912</overlap>
+ </parent>
+ </image>
+ $ rbd list
+ foo
+ quux
+ bar
+ baz
+ $ rbd list --format json | python -mjson.tool
+ [
+ "foo",
+ "quux",
+ "bar",
+ "baz"
+ ]
+ $ rbd list --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <images>
+ <name>foo</name>
+ <name>quux</name>
+ <name>bar</name>
+ <name>baz</name>
+ </images>
+ $ rbd list -l
+ NAME SIZE PARENT FMT PROT LOCK
+ foo 1024M 1
+ foo@snap 1024M 1
+ quux 1024K 1 excl
+ bar 1024M 2
+ bar@snap 512M 2 yes
+ bar@snap2 1024M 2
+ baz 2048M 2 shr
+ $ rbd list -l --format json | python -mjson.tool
+ [
+ {
+ "format": 1,
+ "image": "foo",
+ "size": 1073741824
+ },
+ {
+ "format": 1,
+ "image": "foo",
+ "protected": "false",
+ "size": 1073741824,
+ "snapshot": "snap"
+ },
+ {
+ "format": 1,
+ "image": "quux",
+ "lock_type": "exclusive",
+ "size": 1048576
+ },
+ {
+ "format": 2,
+ "image": "bar",
+ "size": 1073741824
+ },
+ {
+ "format": 2,
+ "image": "bar",
+ "protected": "true",
+ "size": 536870912,
+ "snapshot": "snap"
+ },
+ {
+ "format": 2,
+ "image": "bar",
+ "protected": "false",
+ "size": 1073741824,
+ "snapshot": "snap2"
+ },
+ {
+ "format": 2,
+ "image": "baz",
+ "lock_type": "shared",
+ "size": 2147483648
+ }
+ ]
+ $ rbd list -l --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <images>
+ <image>
+ <image>foo</image>
+ <size>1073741824</size>
+ <format>1</format>
+ </image>
+ <snapshot>
+ <image>foo</image>
+ <snapshot>snap</snapshot>
+ <size>1073741824</size>
+ <format>1</format>
+ <protected>false</protected>
+ </snapshot>
+ <image>
+ <image>quux</image>
+ <size>1048576</size>
+ <format>1</format>
+ <lock_type>exclusive</lock_type>
+ </image>
+ <image>
+ <image>bar</image>
+ <size>1073741824</size>
+ <format>2</format>
+ </image>
+ <snapshot>
+ <image>bar</image>
+ <snapshot>snap</snapshot>
+ <size>536870912</size>
+ <format>2</format>
+ <protected>true</protected>
+ </snapshot>
+ <snapshot>
+ <image>bar</image>
+ <snapshot>snap2</snapshot>
+ <size>1073741824</size>
+ <format>2</format>
+ <protected>false</protected>
+ </snapshot>
+ <image>
+ <image>baz</image>
+ <size>2147483648</size>
+ <format>2</format>
+ <lock_type>shared</lock_type>
+ </image>
+ </images>
+ $ rbd list data
+ child
+ $ rbd list data --format json | python -mjson.tool
+ [
+ "child"
+ ]
+ $ rbd list data --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <images>
+ <name>child</name>
+ </images>
+ $ rbd list data -l
+ NAME SIZE PARENT FMT PROT LOCK
+ child 512M 2
+ child@snap 512M rbd/bar@snap 2
+ $ rbd list data -l --format json | python -mjson.tool
+ [
+ {
+ "format": 2,
+ "image": "child",
+ "size": 536870912
+ },
+ {
+ "format": 2,
+ "image": "child",
+ "parent": {
+ "image": "bar",
+ "pool": "rbd",
+ "snapshot": "snap"
+ },
+ "protected": "false",
+ "size": 536870912,
+ "snapshot": "snap"
+ }
+ ]
+ $ rbd list data -l --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <images>
+ <image>
+ <image>child</image>
+ <size>536870912</size>
+ <format>2</format>
+ </image>
+ <snapshot>
+ <image>child</image>
+ <snapshot>snap</snapshot>
+ <size>536870912</size>
+ <parent>
+ <pool>rbd</pool>
+ <image>bar</image>
+ <snapshot>snap</snapshot>
+ </parent>
+ <format>2</format>
+ <protected>false</protected>
+ </snapshot>
+ </images>
+ $ rbd lock list foo
+ $ rbd lock list foo --format json | python -mjson.tool
+ {}
+ $ rbd lock list foo --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <locks></locks>
+ $ rbd lock list quux
+ There is 1 exclusive lock on this image.
+ Locker*ID*Address* (glob)
+ client.* id * (glob)
+ $ rbd lock list quux --format json | python -mjson.tool
+ {
+ "id": {
+ "address": "*", (glob)
+ "locker": "client.*" (glob)
+ }
+ }
+ $ rbd lock list quux --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <locks>
+ <id>
+ <locker>client.*</locker> (glob)
+ <address>*</address> (glob)
+ </id>
+ </locks>
+ $ rbd lock list baz
+ There are 3 shared locks on this image.
+ Lock tag: tag
+ Locker*ID*Address* (glob)
+ client.*id[123].* (re)
+ client.*id[123].* (re)
+ client.*id[123].* (re)
+ $ rbd lock list baz --format json | python -mjson.tool
+ {
+ "id1": {
+ "address": "*", (glob)
+ "locker": "client.*" (glob)
+ },
+ "id2": {
+ "address": "*", (glob)
+ "locker": "client.*" (glob)
+ },
+ "id3": {
+ "address": "*", (glob)
+ "locker": "client.*" (glob)
+ }
+ }
+ $ rbd lock list baz --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <locks>
+ <id*> (glob)
+ <locker>client.*</locker> (glob)
+ <address>*</address> (glob)
+ </id*> (glob)
+ <id*> (glob)
+ <locker>client.*</locker> (glob)
+ <address>*</address> (glob)
+ </id*> (glob)
+ <id*> (glob)
+ <locker>client.*</locker> (glob)
+ <address>*</address> (glob)
+ </id*> (glob)
+ </locks>
+ $ rbd snap list foo
+ SNAPID NAME SIZE
+ *snap*1024*MB* (glob)
+ $ rbd snap list foo --format json | python -mjson.tool
+ [
+ {
+ "id": *, (glob)
+ "name": "snap",
+ "size": 1073741824
+ }
+ ]
+ $ rbd snap list foo --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <snapshots>
+ <snapshot>
+ <id>*</id> (glob)
+ <name>snap</name>
+ <size>1073741824</size>
+ </snapshot>
+ </snapshots>
+ $ rbd snap list bar
+ SNAPID NAME SIZE
+ *snap*512*MB* (glob)
+ *snap2*1024*MB* (glob)
+ $ rbd snap list bar --format json | python -mjson.tool
+ [
+ {
+ "id": *, (glob)
+ "name": "snap",
+ "size": 536870912
+ },
+ {
+ "id": *, (glob)
+ "name": "snap2",
+ "size": 1073741824
+ }
+ ]
+ $ rbd snap list bar --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <snapshots>
+ <snapshot>
+ <id>*</id> (glob)
+ <name>snap</name>
+ <size>536870912</size>
+ </snapshot>
+ <snapshot>
+ <id>*</id> (glob)
+ <name>snap2</name>
+ <size>1073741824</size>
+ </snapshot>
+ </snapshots>
+ $ rbd snap list baz
+ $ rbd snap list baz --format json | python -mjson.tool
+ []
+ $ rbd snap list baz --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <snapshots></snapshots>
+ $ rbd snap list data/child
+ SNAPID NAME SIZE
+ *snap*512*MB* (glob)
+ $ rbd snap list data/child --format json | python -mjson.tool
+ [
+ {
+ "id": *, (glob)
+ "name": "snap",
+ "size": 536870912
+ }
+ ]
+ $ rbd snap list data/child --format xml | xml_pp 2>&1 | grep -v '^new version at /usr/bin/xml_pp'
+ <snapshots>
+ <snapshot>
+ <id>*</id> (glob)
+ <name>snap</name>
+ <size>536870912</size>
+ </snapshot>
+ </snapshots>
+
+# cleanup
+ $ rbd snap remove data/child@snap
+ $ rbd snap unprotect bar@snap
+ $ rbd snap purge bar > /dev/null
+ $ rbd snap purge foo > /dev/null
+ $ rbd rm data/child > /dev/null
+ $ rbd rm foo > /dev/null
+ $ rbd rm bar > /dev/null
+ $ rbd rm quux > /dev/null
+ $ rbd rm baz > /dev/null
projects / ceph.git / commitdiff