Commit 7578d5cd authored by Gioh Kim's avatar Gioh Kim Committed by Jens Axboe

Documentation/ABI/rnbd-clt: session name is appended to the device path

When mapping a device,
/sys/devices/virtual/rnbd-client/ctl/devices/<device_id> was created.
But we found out that it had a problem when mapping the same file
on different servers. So we append the session name after the
device_id as below.
/sys/devices/virtual/rnbd-client/ctl/devices/<device_id>@<session_name>
Signed-off-by: default avatarGioh Kim <gi-oh.kim@cloud.ionos.com>
Signed-off-by: default avatarJack Wang <jinpu.wang@cloud.ionos.com>
Signed-off-by: default avatarJens Axboe <axboe@kernel.dk>
parent 47479b79
...@@ -95,12 +95,12 @@ Description: Expected format is the following:: ...@@ -95,12 +95,12 @@ Description: Expected format is the following::
--------------------------------- ---------------------------------
After mapping, the device file can be found by: After mapping, the device file can be found by:
o The symlink /sys/class/rnbd-client/ctl/devices/<device_id> o The symlink /sys/class/rnbd-client/ctl/devices/<device_id>@<session_name>
points to /sys/block/<dev-name>. The last part of the symlink destination points to /sys/block/<dev-name>. The last part of the symlink destination
is the same as the device name. By extracting the last part of the is the same as the device name. By extracting the last part of the
path the path to the device /dev/<dev-name> can be build. path the path to the device /dev/<dev-name> can be build.
* /dev/block/$(cat /sys/class/rnbd-client/ctl/devices/<device_id>/dev) * /dev/block/$(cat /sys/class/rnbd-client/ctl/devices/<device_id>@<session_name>/dev)
How to find the <device_id> of the device is described on the next How to find the <device_id> of the device is described on the next
section. section.
...@@ -110,7 +110,7 @@ Date: Feb 2020 ...@@ -110,7 +110,7 @@ Date: Feb 2020
KernelVersion: 5.7 KernelVersion: 5.7
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com> Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
Description: For each device mapped on the client a new symbolic link is created as Description: For each device mapped on the client a new symbolic link is created as
/sys/class/rnbd-client/ctl/devices/<device_id>, which points /sys/class/rnbd-client/ctl/devices/<device_id>@<session_name>, which points
to the block device created by rnbd (/sys/block/rnbd<N>/). to the block device created by rnbd (/sys/block/rnbd<N>/).
The <device_id> of each device is created as follows: The <device_id> of each device is created as follows:
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment