hc
2024-10-12 a5969cabbb4660eab42b6ef0412cbbd1200cf14d
kernel/Documentation/ABI/testing/sysfs-bus-rbd
....@@ -7,6 +7,8 @@
77
88 Usage: <mon ip addr> <options> <pool name> <rbd image name> [<snap name>]
99
10
+ Example::
11
+
1012 $ echo "192.168.0.1 name=admin rbd foo" > /sys/bus/rbd/add
1113
1214 The snapshot name can be "-" or omitted to map the image
....@@ -22,6 +24,8 @@
2224 (WO) Remove rbd block device.
2325
2426 Usage: <dev-id> [force]
27
+
28
+ Example::
2529
2630 $ echo 2 > /sys/bus/rbd/remove
2731
....@@ -80,26 +84,29 @@
8084 KernelVersion: v2.6.37
8185 Contact: Sage Weil <sage@newdream.net>
8286 Description:
83
- size: (RO) The size (in bytes) of the mapped block
87
+
88
+ ============== ================================================
89
+ size (RO) The size (in bytes) of the mapped block
8490 device.
8591
86
- major: (RO) The block device major number.
92
+ major (RO) The block device major number.
8793
88
- client_id: (RO) The ceph unique client id that was assigned
94
+ client_id (RO) The ceph unique client id that was assigned
8995 for this specific session.
9096
91
- pool: (RO) The name of the storage pool where this rbd
97
+ pool (RO) The name of the storage pool where this rbd
9298 image resides. An rbd image name is unique
9399 within its pool.
94100
95
- name: (RO) The name of the rbd image.
101
+ name (RO) The name of the rbd image.
96102
97
- refresh: (WO) Writing to this file will reread the image
103
+ refresh (WO) Writing to this file will reread the image
98104 header data and set all relevant data structures
99105 accordingly.
100106
101
- current_snap: (RO) The current snapshot for which the device
107
+ current_snap (RO) The current snapshot for which the device
102108 is mapped.
109
+ ============== ================================================
103110
104111
105112 What: /sys/bus/rbd/devices/<dev-id>/pool_id
....@@ -117,11 +124,13 @@
117124 KernelVersion: v3.7
118125 Contact: Sage Weil <sage@newdream.net>
119126 Description:
120
- image_id: (RO) The unique id for the rbd image. (For rbd
127
+ ========= ===============================================
128
+ image_id (RO) The unique id for the rbd image. (For rbd
121129 image format 1 this is empty.)
122130
123
- features: (RO) A hexadecimal encoding of the feature bits
131
+ features (RO) A hexadecimal encoding of the feature bits
124132 for this image.
133
+ ========= ===============================================
125134
126135
127136 What: /sys/bus/rbd/devices/<dev-id>/parent
....@@ -149,14 +158,16 @@
149158 KernelVersion: v4.9
150159 Contact: Sage Weil <sage@newdream.net>
151160 Description:
152
- snap_id: (RO) The current snapshot's id.
161
+ ============ ================================================
162
+ snap_id (RO) The current snapshot's id.
153163
154
- config_info: (RO) The string written into
164
+ config_info (RO) The string written into
155165 /sys/bus/rbd/add{,_single_major}.
156166
157
- cluster_fsid: (RO) The ceph cluster UUID.
167
+ cluster_fsid (RO) The ceph cluster UUID.
158168
159
- client_addr: (RO) The ceph unique client
169
+ client_addr (RO) The ceph unique client
160170 entity_addr_t (address + nonce). The format is
161171 <address>:<port>/<nonce>: '1.2.3.4:1234/5678' or
162172 '[1:2:3:4:5:6:7:8]:1234/5678'.
173
+ ============ ================================================