1*dfc5606dSYehuda SadehWhat: /sys/bus/rbd/ 2*dfc5606dSYehuda SadehDate: November 2010 3*dfc5606dSYehuda SadehContact: Yehuda Sadeh <yehuda@hq.newdream.net>, 4*dfc5606dSYehuda Sadeh Sage Weil <sage@newdream.net> 5*dfc5606dSYehuda SadehDescription: 6*dfc5606dSYehuda Sadeh 7*dfc5606dSYehuda SadehBeing used for adding and removing rbd block devices. 8*dfc5606dSYehuda Sadeh 9*dfc5606dSYehuda SadehUsage: <mon ip addr> <options> <pool name> <rbd image name> [snap name] 10*dfc5606dSYehuda Sadeh 11*dfc5606dSYehuda Sadeh $ echo "192.168.0.1 name=admin rbd foo" > /sys/bus/rbd/add 12*dfc5606dSYehuda Sadeh 13*dfc5606dSYehuda SadehThe snapshot name can be "-" or omitted to map the image read/write. A <dev-id> 14*dfc5606dSYehuda Sadehwill be assigned for any registered block device. If snapshot is used, it will 15*dfc5606dSYehuda Sadehbe mapped read-only. 16*dfc5606dSYehuda Sadeh 17*dfc5606dSYehuda SadehRemoval of a device: 18*dfc5606dSYehuda Sadeh 19*dfc5606dSYehuda Sadeh $ echo <dev-id> > /sys/bus/rbd/remove 20*dfc5606dSYehuda Sadeh 21*dfc5606dSYehuda SadehEntries under /sys/bus/rbd/devices/<dev-id>/ 22*dfc5606dSYehuda Sadeh-------------------------------------------- 23*dfc5606dSYehuda Sadeh 24*dfc5606dSYehuda Sadehclient_id 25*dfc5606dSYehuda Sadeh 26*dfc5606dSYehuda Sadeh The ceph unique client id that was assigned for this specific session. 27*dfc5606dSYehuda Sadeh 28*dfc5606dSYehuda Sadehmajor 29*dfc5606dSYehuda Sadeh 30*dfc5606dSYehuda Sadeh The block device major number. 31*dfc5606dSYehuda Sadeh 32*dfc5606dSYehuda Sadehname 33*dfc5606dSYehuda Sadeh 34*dfc5606dSYehuda Sadeh The name of the rbd image. 35*dfc5606dSYehuda Sadeh 36*dfc5606dSYehuda Sadehpool 37*dfc5606dSYehuda Sadeh 38*dfc5606dSYehuda Sadeh The pool where this rbd image resides. The pool-name pair is unique 39*dfc5606dSYehuda Sadeh per rados system. 40*dfc5606dSYehuda Sadeh 41*dfc5606dSYehuda Sadehsize 42*dfc5606dSYehuda Sadeh 43*dfc5606dSYehuda Sadeh The size (in bytes) of the mapped block device. 44*dfc5606dSYehuda Sadeh 45*dfc5606dSYehuda Sadehrefresh 46*dfc5606dSYehuda Sadeh 47*dfc5606dSYehuda Sadeh Writing to this file will reread the image header data and set 48*dfc5606dSYehuda Sadeh all relevant datastructures accordingly. 49*dfc5606dSYehuda Sadeh 50*dfc5606dSYehuda Sadehcurrent_snap 51*dfc5606dSYehuda Sadeh 52*dfc5606dSYehuda Sadeh The current snapshot for which the device is mapped. 53*dfc5606dSYehuda Sadeh 54*dfc5606dSYehuda Sadehcreate_snap 55*dfc5606dSYehuda Sadeh 56*dfc5606dSYehuda Sadeh Create a snapshot: 57*dfc5606dSYehuda Sadeh 58*dfc5606dSYehuda Sadeh $ echo <snap-name> > /sys/bus/rbd/devices/<dev-id>/snap_create 59*dfc5606dSYehuda Sadeh 60*dfc5606dSYehuda Sadehrollback_snap 61*dfc5606dSYehuda Sadeh 62*dfc5606dSYehuda Sadeh Rolls back data to the specified snapshot. This goes over the entire 63*dfc5606dSYehuda Sadeh list of rados blocks and sends a rollback command to each. 64*dfc5606dSYehuda Sadeh 65*dfc5606dSYehuda Sadeh $ echo <snap-name> > /sys/bus/rbd/devices/<dev-id>/snap_rollback 66*dfc5606dSYehuda Sadeh 67*dfc5606dSYehuda Sadehsnap_* 68*dfc5606dSYehuda Sadeh 69*dfc5606dSYehuda Sadeh A directory per each snapshot 70*dfc5606dSYehuda Sadeh 71*dfc5606dSYehuda Sadeh 72*dfc5606dSYehuda SadehEntries under /sys/bus/rbd/devices/<dev-id>/snap_<snap-name> 73*dfc5606dSYehuda Sadeh------------------------------------------------------------- 74*dfc5606dSYehuda Sadeh 75*dfc5606dSYehuda Sadehid 76*dfc5606dSYehuda Sadeh 77*dfc5606dSYehuda Sadeh The rados internal snapshot id assigned for this snapshot 78*dfc5606dSYehuda Sadeh 79*dfc5606dSYehuda Sadehsize 80*dfc5606dSYehuda Sadeh 81*dfc5606dSYehuda Sadeh The size of the image when this snapshot was taken. 82*dfc5606dSYehuda Sadeh 83*dfc5606dSYehuda Sadeh 84