Documentation / ABI / testing / sysfs-bus-rbd


Based on kernel version 6.8. Page generated on 2024-03-11 21:26 EST.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173
What:		/sys/bus/rbd/add
Date:		Oct, 2010
KernelVersion:	v2.6.37
Contact:	Sage Weil <sage@newdream.net>
Description:
		(WO) Add rbd block device.

		Usage: <mon ip addr> <options> <pool name> <rbd image name> [<snap name>]

		Example::

		 $ echo "192.168.0.1 name=admin rbd foo" > /sys/bus/rbd/add

		The snapshot name can be "-" or omitted to map the image
		read/write. A <dev-id> will be assigned for any registered block
		device. If snapshot is used, it will be mapped read-only.


What:		/sys/bus/rbd/remove
Date:		Oct, 2010
KernelVersion:	v2.6.37
Contact:	Sage Weil <sage@newdream.net>
Description:
		(WO) Remove rbd block device.

		Usage: <dev-id> [force]

		Example::

		 $ echo 2 > /sys/bus/rbd/remove

		Optional "force" argument which when passed will wait for
		running requests and then unmap the image. Requests sent to the
		driver after initiating the removal will be failed. (August
		2016, since 4.9.)


What:		/sys/bus/rbd/add_single_major
Date:		Dec, 2013
KernelVersion:	v3.14
Contact:	Sage Weil <sage@newdream.net>
Description:
		(WO) Available only if rbd module is inserted with single_major
		parameter set to true.

		Usage is the same as for /sys/bus/rbd/add. If present, this
		should be used instead of the latter: any attempts to use
		/sys/bus/rbd/add if /sys/bus/rbd/add_single_major is available
		will fail for backwards compatibility reasons.


What:		/sys/bus/rbd/remove_single_major
Date:		Dec, 2013
KernelVersion:	v3.14
Contact:	Sage Weil <sage@newdream.net>
Description:
		(WO) Available only if rbd module is inserted with single_major
		parameter set to true.

		Usage is the same as for /sys/bus/rbd/remove. If present, this
		should be used instead of the latter: any attempts to use
		/sys/bus/rbd/remove if /sys/bus/rbd/remove_single_major is
		available will fail for backwards compatibility reasons.


What:		/sys/bus/rbd/supported_features
Date:		Mar, 2017
KernelVersion:	v4.11
Contact:	Sage Weil <sage@newdream.net>
Description:
		(RO) Displays the features supported by the rbd module so that
		userspace can generate meaningful error messages and spell out
		unsupported features that need to be disabled.


What:		/sys/bus/rbd/devices/<dev-id>/size
What:		/sys/bus/rbd/devices/<dev-id>/major
What:		/sys/bus/rbd/devices/<dev-id>/client_id
What:		/sys/bus/rbd/devices/<dev-id>/pool
What:		/sys/bus/rbd/devices/<dev-id>/name
What:		/sys/bus/rbd/devices/<dev-id>/refresh
What:		/sys/bus/rbd/devices/<dev-id>/current_snap
Date:		Oct, 2010
KernelVersion:	v2.6.37
Contact:	Sage Weil <sage@newdream.net>
Description:

		==============	================================================
		size		(RO) The size (in bytes) of the mapped block
				device.

		major		(RO) The block device major number.

		client_id	(RO) The ceph unique client id that was assigned
				for this specific session.

		pool		(RO) The name of the storage pool where this rbd
				image resides. An rbd image name is unique
				within its pool.

		name		(RO) The name of the rbd image.

		refresh		(WO) Writing to this file will reread the image
				header data and set all relevant data structures
				accordingly.

		current_snap	(RO) The current snapshot for which the device
				is mapped.
		==============	================================================


What:		/sys/bus/rbd/devices/<dev-id>/pool_id
Date:		Jul, 2012
KernelVersion:	v3.6
Contact:	Sage Weil <sage@newdream.net>
Description:
		(RO) The unique identifier for the rbd image's pool. This is a
		permanent attribute of the pool. A pool's id will never change.


What:		/sys/bus/rbd/devices/<dev-id>/image_id
What:		/sys/bus/rbd/devices/<dev-id>/features
Date:		Oct, 2012
KernelVersion:	v3.7
Contact:	Sage Weil <sage@newdream.net>
Description:
		=========	===============================================
		image_id	(RO) The unique id for the rbd image. (For rbd
				image format 1 this is empty.)

		features	(RO) A hexadecimal encoding of the feature bits
				for this image.
		=========	===============================================


What:		/sys/bus/rbd/devices/<dev-id>/parent
Date:		Nov, 2012
KernelVersion:	v3.8
Contact:	Sage Weil <sage@newdream.net>
Description:
		(RO) Information identifying the chain of parent images in a
		layered rbd image. Entries are separated by empty lines.


What:		/sys/bus/rbd/devices/<dev-id>/minor
Date:		Dec, 2013
KernelVersion:	v3.14
Contact:	Sage Weil <sage@newdream.net>
Description:
		(RO) The block device minor number.


What:		/sys/bus/rbd/devices/<dev-id>/snap_id
What:		/sys/bus/rbd/devices/<dev-id>/config_info
What:		/sys/bus/rbd/devices/<dev-id>/cluster_fsid
What:		/sys/bus/rbd/devices/<dev-id>/client_addr
Date:		Aug, 2016
KernelVersion:	v4.9
Contact:	Sage Weil <sage@newdream.net>
Description:
		============	================================================
		snap_id		(RO) The current snapshot's id.

		config_info	(RO) The string written into
				/sys/bus/rbd/add{,_single_major}.

		cluster_fsid	(RO) The ceph cluster UUID.

		client_addr	(RO) The ceph unique client
				entity_addr_t (address + nonce). The format is
				<address>:<port>/<nonce>: '1.2.3.4:1234/5678' or
				'[1:2:3:4:5:6:7:8]:1234/5678'.
		============	================================================