1dfc5606dSYehuda SadehWhat: /sys/bus/rbd/ 2dfc5606dSYehuda SadehDate: November 2010 355b00baeSSage WeilContact: Yehuda Sadeh <yehuda@newdream.net>, 4dfc5606dSYehuda Sadeh Sage Weil <sage@newdream.net> 5dfc5606dSYehuda SadehDescription: 6dfc5606dSYehuda Sadeh 7dfc5606dSYehuda SadehBeing used for adding and removing rbd block devices. 8dfc5606dSYehuda Sadeh 9dfc5606dSYehuda SadehUsage: <mon ip addr> <options> <pool name> <rbd image name> [snap name] 10dfc5606dSYehuda Sadeh 11dfc5606dSYehuda Sadeh $ echo "192.168.0.1 name=admin rbd foo" > /sys/bus/rbd/add 12dfc5606dSYehuda Sadeh 13dfc5606dSYehuda SadehThe snapshot name can be "-" or omitted to map the image read/write. A <dev-id> 14dfc5606dSYehuda Sadehwill be assigned for any registered block device. If snapshot is used, it will 15dfc5606dSYehuda Sadehbe mapped read-only. 16dfc5606dSYehuda Sadeh 17dfc5606dSYehuda SadehRemoval of a device: 18dfc5606dSYehuda Sadeh 19dfc5606dSYehuda Sadeh $ echo <dev-id> > /sys/bus/rbd/remove 20dfc5606dSYehuda Sadeh 21dfc5606dSYehuda SadehEntries under /sys/bus/rbd/devices/<dev-id>/ 22dfc5606dSYehuda Sadeh-------------------------------------------- 23dfc5606dSYehuda Sadeh 24dfc5606dSYehuda Sadehclient_id 25dfc5606dSYehuda Sadeh 26dfc5606dSYehuda Sadeh The ceph unique client id that was assigned for this specific session. 27dfc5606dSYehuda Sadeh 28*34b13184SAlex Elderfeatures 29*34b13184SAlex Elder 30*34b13184SAlex Elder A hexadecimal encoding of the feature bits for this image. 31*34b13184SAlex Elder 32dfc5606dSYehuda Sadehmajor 33dfc5606dSYehuda Sadeh 34dfc5606dSYehuda Sadeh The block device major number. 35dfc5606dSYehuda Sadeh 36dfc5606dSYehuda Sadehname 37dfc5606dSYehuda Sadeh 38dfc5606dSYehuda Sadeh The name of the rbd image. 39dfc5606dSYehuda Sadeh 40589d30e0SAlex Elderimage_id 41589d30e0SAlex Elder 42589d30e0SAlex Elder The unique id for the rbd image. (For rbd image format 1 43589d30e0SAlex Elder this is empty.) 44589d30e0SAlex Elder 45dfc5606dSYehuda Sadehpool 46dfc5606dSYehuda Sadeh 479bb2f334SAlex Elder The name of the storage pool where this rbd image resides. 489bb2f334SAlex Elder An rbd image name is unique within its pool. 499bb2f334SAlex Elder 509bb2f334SAlex Elderpool_id 519bb2f334SAlex Elder 529bb2f334SAlex Elder The unique identifier for the rbd image's pool. This is 539bb2f334SAlex Elder a permanent attribute of the pool. A pool's id will never 549bb2f334SAlex Elder change. 55dfc5606dSYehuda Sadeh 56dfc5606dSYehuda Sadehsize 57dfc5606dSYehuda Sadeh 58dfc5606dSYehuda Sadeh The size (in bytes) of the mapped block device. 59dfc5606dSYehuda Sadeh 60dfc5606dSYehuda Sadehrefresh 61dfc5606dSYehuda Sadeh 62dfc5606dSYehuda Sadeh Writing to this file will reread the image header data and set 63dfc5606dSYehuda Sadeh all relevant datastructures accordingly. 64dfc5606dSYehuda Sadeh 65dfc5606dSYehuda Sadehcurrent_snap 66dfc5606dSYehuda Sadeh 67dfc5606dSYehuda Sadeh The current snapshot for which the device is mapped. 68dfc5606dSYehuda Sadeh 69dfc5606dSYehuda Sadehsnap_* 70dfc5606dSYehuda Sadeh 71dfc5606dSYehuda Sadeh A directory per each snapshot 72dfc5606dSYehuda Sadeh 73dfc5606dSYehuda Sadeh 74dfc5606dSYehuda SadehEntries under /sys/bus/rbd/devices/<dev-id>/snap_<snap-name> 75dfc5606dSYehuda Sadeh------------------------------------------------------------- 76dfc5606dSYehuda Sadeh 77b7f6519eSJosh Durginsnap_id 78dfc5606dSYehuda Sadeh 79dfc5606dSYehuda Sadeh The rados internal snapshot id assigned for this snapshot 80dfc5606dSYehuda Sadeh 81b7f6519eSJosh Durginsnap_size 82dfc5606dSYehuda Sadeh 83dfc5606dSYehuda Sadeh The size of the image when this snapshot was taken. 84dfc5606dSYehuda Sadeh 85*34b13184SAlex Eldersnap_features 86*34b13184SAlex Elder 87*34b13184SAlex Elder A hexadecimal encoding of the feature bits for this snapshot. 88dfc5606dSYehuda Sadeh 89