0001 What: /sys/block/rnbd<N>/rnbd/unmap_device
0002 Date: Feb 2020
0003 KernelVersion: 5.7
0004 Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
0005 Description: To unmap a volume, "normal" or "force" has to be written to:
0006 /sys/block/rnbd<N>/rnbd/unmap_device
0007
0008 When "normal" is used, the operation will fail with EBUSY if any process
0009 is using the device. When "force" is used, the device is also unmapped
0010 when device is in use. All I/Os that are in progress will fail.
0011
0012 Example::
0013
0014 # echo "normal" > /sys/block/rnbd0/rnbd/unmap_device
0015
0016 What: /sys/block/rnbd<N>/rnbd/state
0017 Date: Feb 2020
0018 KernelVersion: 5.7
0019 Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
0020 Description: The file contains the current state of the block device. The state file
0021 returns "open" when the device is successfully mapped from the server
0022 and accepting I/O requests. When the connection to the server gets
0023 disconnected in case of an error (e.g. link failure), the state file
0024 returns "closed" and all I/O requests submitted to it will fail with -EIO.
0025
0026 What: /sys/block/rnbd<N>/rnbd/session
0027 Date: Feb 2020
0028 KernelVersion: 5.7
0029 Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
0030 Description: RNBD uses RTRS session to transport the data between client and
0031 server. The entry "session" contains the name of the session, that
0032 was used to establish the RTRS session. It's the same name that
0033 was passed as server parameter to the map_device entry.
0034
0035 What: /sys/block/rnbd<N>/rnbd/mapping_path
0036 Date: Feb 2020
0037 KernelVersion: 5.7
0038 Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
0039 Description: Contains the path that was passed as "device_path" to the map_device
0040 operation.
0041
0042 What: /sys/block/rnbd<N>/rnbd/access_mode
0043 Date: Feb 2020
0044 KernelVersion: 5.7
0045 Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
0046 Description: Contains the device access mode: ro, rw or migration.
0047
0048 What: /sys/block/rnbd<N>/rnbd/resize
0049 Date: Feb 2020
0050 KernelVersion: 5.7
0051 Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
0052 Description: Write the number of sectors to change the size of the disk.
0053
0054 What: /sys/block/rnbd<N>/rnbd/remap_device
0055 Date: Feb 2020
0056 KernelVersion: 5.7
0057 Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
0058 Description: Remap the disconnected device if the session is not destroyed yet.
0059
0060 What: /sys/block/rnbd<N>/rnbd/nr_poll_queues
0061 Date: Feb 2020
0062 KernelVersion: 5.7
0063 Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
0064 Description: Contains the number of poll-mode queues
