1262601SimpWhat: /sys/bus/rbd/add 2262601SimpDate: Oct, 2010 3262601SimpKernelVersion: v2.6.37 4262601SimpContact: Sage Weil <sage@newdream.net> 5262601SimpDescription: 6262601Simp (WO) Add rbd block device. 7262601Simp 8262601Simp Usage: <mon ip addr> <options> <pool name> <rbd image name> [<snap name>] 9262601Simp 10262601Simp Example:: 11262601Simp 12262601Simp $ echo "192.168.0.1 name=admin rbd foo" > /sys/bus/rbd/add 13262601Simp 14262601Simp The snapshot name can be "-" or omitted to map the image 15262601Simp read/write. A <dev-id> will be assigned for any registered block 16262601Simp device. If snapshot is used, it will be mapped read-only. 17262601Simp 18262601Simp 19262601SimpWhat: /sys/bus/rbd/remove 20262601SimpDate: Oct, 2010 21262601SimpKernelVersion: v2.6.37 22262601SimpContact: Sage Weil <sage@newdream.net> 23262601SimpDescription: 24262601Simp (WO) Remove rbd block device. 25262601Simp 26262601Simp Usage: <dev-id> [force] 27262601Simp 28262601Simp Example:: 29262601Simp 30262601Simp $ echo 2 > /sys/bus/rbd/remove 31262601Simp 32262601Simp Optional "force" argument which when passed will wait for 33262601Simp running requests and then unmap the image. Requests sent to the 34262601Simp driver after initiating the removal will be failed. (August 35262601Simp 2016, since 4.9.) 36262601Simp 37262601Simp 38262601SimpWhat: /sys/bus/rbd/add_single_major 39262601SimpDate: Dec, 2013 40262601SimpKernelVersion: v3.14 41262601SimpContact: Sage Weil <sage@newdream.net> 42262601SimpDescription: 43262601Simp (WO) Available only if rbd module is inserted with single_major 44262601Simp parameter set to true. 45262601Simp 46262601Simp Usage is the same as for /sys/bus/rbd/add. If present, this 47262601Simp should be used instead of the latter: any attempts to use 48262601Simp /sys/bus/rbd/add if /sys/bus/rbd/add_single_major is available 49262601Simp will fail for backwards compatibility reasons. 50262601Simp 51262601Simp 52262601SimpWhat: /sys/bus/rbd/remove_single_major 53262601SimpDate: Dec, 2013 54262601SimpKernelVersion: v3.14 55262601SimpContact: Sage Weil <sage@newdream.net> 56262601SimpDescription: 57262601Simp (WO) Available only if rbd module is inserted with single_major 58262601Simp parameter set to true. 59262601Simp 60262601Simp Usage is the same as for /sys/bus/rbd/remove. If present, this 61262601Simp should be used instead of the latter: any attempts to use 62262601Simp /sys/bus/rbd/remove if /sys/bus/rbd/remove_single_major is 63262601Simp available will fail for backwards compatibility reasons. 64262601Simp 65262601Simp 66262601SimpWhat: /sys/bus/rbd/supported_features 67262601SimpDate: Mar, 2017 68262601SimpKernelVersion: v4.11 69262601SimpContact: Sage Weil <sage@newdream.net> 70262601SimpDescription: 71262601Simp (RO) Displays the features supported by the rbd module so that 72262601Simp userspace can generate meaningful error messages and spell out 73262601Simp unsupported features that need to be disabled. 74262601Simp 75262601Simp 76262601SimpWhat: /sys/bus/rbd/devices/<dev-id>/size 77262601SimpWhat: /sys/bus/rbd/devices/<dev-id>/major 78262601SimpWhat: /sys/bus/rbd/devices/<dev-id>/client_id 79262601SimpWhat: /sys/bus/rbd/devices/<dev-id>/pool 80262601SimpWhat: /sys/bus/rbd/devices/<dev-id>/name 81262601SimpWhat: /sys/bus/rbd/devices/<dev-id>/refresh 82262601SimpWhat: /sys/bus/rbd/devices/<dev-id>/current_snap 83262601SimpDate: Oct, 2010 84262601SimpKernelVersion: v2.6.37 85262601SimpContact: Sage Weil <sage@newdream.net> 86262601SimpDescription: 87262601Simp 88262601Simp ============== ================================================ 89262601Simp size (RO) The size (in bytes) of the mapped block 90262601Simp device. 91262601Simp 92262601Simp major (RO) The block device major number. 93262601Simp 94262601Simp client_id (RO) The ceph unique client id that was assigned 95262601Simp for this specific session. 96262601Simp 97262601Simp pool (RO) The name of the storage pool where this rbd 98262601Simp image resides. An rbd image name is unique 99262601Simp within its pool. 100262601Simp 101262601Simp name (RO) The name of the rbd image. 102276717Shselasky 103262601Simp refresh (WO) Writing to this file will reread the image 104262601Simp header data and set all relevant data structures 105262601Simp accordingly. 106262601Simp 107262601Simp current_snap (RO) The current snapshot for which the device 108262601Simp is mapped. 109262601Simp ============== ================================================ 110262601Simp 111262601Simp 112262601SimpWhat: /sys/bus/rbd/devices/<dev-id>/pool_id 113262601SimpDate: Jul, 2012 114262601SimpKernelVersion: v3.6 115262601SimpContact: Sage Weil <sage@newdream.net> 116262601SimpDescription: 117262601Simp (RO) The unique identifier for the rbd image's pool. This is a 118262601Simp permanent attribute of the pool. A pool's id will never change. 119262601Simp 120262601Simp 121262601SimpWhat: /sys/bus/rbd/devices/<dev-id>/image_id 122262601SimpWhat: /sys/bus/rbd/devices/<dev-id>/features 123262601SimpDate: Oct, 2012 124262601SimpKernelVersion: v3.7 125262601SimpContact: Sage Weil <sage@newdream.net> 126262601SimpDescription: 127262601Simp ========= =============================================== 128262601Simp image_id (RO) The unique id for the rbd image. (For rbd 129262601Simp image format 1 this is empty.) 130262601Simp 131262601Simp features (RO) A hexadecimal encoding of the feature bits 132262601Simp for this image. 133262601Simp ========= =============================================== 134262601Simp 135262601Simp 136262601SimpWhat: /sys/bus/rbd/devices/<dev-id>/parent 137262601SimpDate: Nov, 2012 138262601SimpKernelVersion: v3.8 139262601SimpContact: Sage Weil <sage@newdream.net> 140262601SimpDescription: 141262601Simp (RO) Information identifying the chain of parent images in a 142262601Simp layered rbd image. Entries are separated by empty lines. 143262601Simp 144262601Simp 145262601SimpWhat: /sys/bus/rbd/devices/<dev-id>/minor 146262601SimpDate: Dec, 2013 147262601SimpKernelVersion: v3.14 148262601SimpContact: Sage Weil <sage@newdream.net> 149262601SimpDescription: 150262601Simp (RO) The block device minor number. 151262601Simp 152262601Simp 153262601SimpWhat: /sys/bus/rbd/devices/<dev-id>/snap_id 154262601SimpWhat: /sys/bus/rbd/devices/<dev-id>/config_info 155262601SimpWhat: /sys/bus/rbd/devices/<dev-id>/cluster_fsid 156262601SimpWhat: /sys/bus/rbd/devices/<dev-id>/client_addr 157262601SimpDate: Aug, 2016 158262601SimpKernelVersion: v4.9 159262601SimpContact: Sage Weil <sage@newdream.net> 160262601SimpDescription: 161262601Simp ============ ================================================ 162262601Simp snap_id (RO) The current snapshot's id. 163262601Simp 164262601Simp config_info (RO) The string written into 165262601Simp /sys/bus/rbd/add{,_single_major}. 166262601Simp 167262601Simp cluster_fsid (RO) The ceph cluster UUID. 168262601Simp 169262601Simp client_addr (RO) The ceph unique client 170262601Simp entity_addr_t (address + nonce). The format is 171262601Simp <address>:<port>/<nonce>: '1.2.3.4:1234/5678' or 172262601Simp '[1:2:3:4:5:6:7:8]:1234/5678'. 173262601Simp ============ ================================================ 174262601Simp