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