Documentation/ABI/testing/sysfs-class-rnbd-client

Source file repositories/reference/linux-study-clean/Documentation/ABI/testing/sysfs-class-rnbd-client

File Facts

System
Linux kernel
Corpus path
Documentation/ABI/testing/sysfs-class-rnbd-client
Extension
[no extension]
Size
5254 bytes
Lines
134
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: Documentation
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

What:		/sys/class/rnbd-client
Date:		Feb 2020
KernelVersion:	5.7
Contact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
Description:	Provide information about RNBD-client.
		All sysfs files that are not read-only provide the usage information on read:

		Example::

		    # cat /sys/class/rnbd-client/ctl/map_device

		    > Usage: echo "sessname=<name of the rtrs session> path=<[srcaddr,]dstaddr>
		    > [path=<[srcaddr,]dstaddr>] device_path=<full path on remote side>
		    > [access_mode=<ro|rw|migration>] > map_device
		    >
		    > addr ::= [ ip:<ipv4> | ip:<ipv6> | gid:<gid> ]

What:		/sys/class/rnbd-client/ctl/map_device
Date:		Feb 2020
KernelVersion:	5.7
Contact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
Description:	Expected format is the following::

		    sessname=<name of the rtrs session>
		    path=<[srcaddr,]dstaddr> [path=<[srcaddr,]dstaddr> ...]
		    device_path=<full path on remote side>
		    [access_mode=<ro|rw|migration>]

		Where:

		sessname:
		    accepts a string not bigger than 256 chars, which identifies
		    a given session on the client and on the server.
		    I.e. "clt_hostname-srv_hostname" could be a natural choice.

		path:
		    describes a connection between the client and the server by
		    specifying destination and, when required, the source address.
		    The addresses are to be provided in the following format::

			ip:<IPv6>
			ip:<IPv4>
			gid:<GID>

		for example::

		    path=ip:10.0.0.66

		The single addr is treated as the destination.
		The connection will be established to this server from any client IP address.

		::

		    path=ip:10.0.0.66,ip:10.0.1.66

		First addr is the source address and the second is the destination.

		If multiple "path=" options are specified multiple connection
		will be established and data will be sent according to
		the selected multipath policy (see RTRS mp_policy sysfs entry description).

		device_path:
		    Path to the block device on the server side. Path is specified
		    relative to the directory on server side configured in the
		    'dev_search_path' module parameter of the rnbd_server.
		    The rnbd_server prepends the <device_path> received from client
		    with <dev_search_path> and tries to open the
		    <dev_search_path>/<device_path> block device.  On success,
		    a /dev/rnbd<N> device file, a /sys/block/rnbd<N>/
		    directory and an entry in /sys/class/rnbd-client/ctl/devices

Annotation

Implementation Notes