| Jack Wang | aa4d16e | 2020-05-11 15:51:30 +0200 | [diff] [blame^] | 1 | What: /sys/block/rnbd<N>/rnbd/unmap_device |
| 2 | Date: Feb 2020 |
| 3 | KernelVersion: 5.7 |
| 4 | Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com> |
| 5 | Description: To unmap a volume, "normal" or "force" has to be written to: |
| 6 | /sys/block/rnbd<N>/rnbd/unmap_device |
| 7 | |
| 8 | When "normal" is used, the operation will fail with EBUSY if any process |
| 9 | is using the device. When "force" is used, the device is also unmapped |
| 10 | when device is in use. All I/Os that are in progress will fail. |
| 11 | |
| 12 | Example: |
| 13 | |
| 14 | # echo "normal" > /sys/block/rnbd0/rnbd/unmap_device |
| 15 | |
| 16 | What: /sys/block/rnbd<N>/rnbd/state |
| 17 | Date: Feb 2020 |
| 18 | KernelVersion: 5.7 |
| 19 | Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com> |
| 20 | Description: The file contains the current state of the block device. The state file |
| 21 | returns "open" when the device is successfully mapped from the server |
| 22 | and accepting I/O requests. When the connection to the server gets |
| 23 | disconnected in case of an error (e.g. link failure), the state file |
| 24 | returns "closed" and all I/O requests submitted to it will fail with -EIO. |
| 25 | |
| 26 | What: /sys/block/rnbd<N>/rnbd/session |
| 27 | Date: Feb 2020 |
| 28 | KernelVersion: 5.7 |
| 29 | Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com> |
| 30 | Description: RNBD uses RTRS session to transport the data between client and |
| 31 | server. The entry "session" contains the name of the session, that |
| 32 | was used to establish the RTRS session. It's the same name that |
| 33 | was passed as server parameter to the map_device entry. |
| 34 | |
| 35 | What: /sys/block/rnbd<N>/rnbd/mapping_path |
| 36 | Date: Feb 2020 |
| 37 | KernelVersion: 5.7 |
| 38 | Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com> |
| 39 | Description: Contains the path that was passed as "device_path" to the map_device |
| 40 | operation. |
| 41 | |
| 42 | What: /sys/block/rnbd<N>/rnbd/access_mode |
| 43 | Date: Feb 2020 |
| 44 | KernelVersion: 5.7 |
| 45 | Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com> |
| 46 | Description: Contains the device access mode: ro, rw or migration. |