xref: /linux/Documentation/ABI/testing/sysfs-class-rtrs-server (revision 4f2c0a4acffbec01079c28f839422e64ddeff004)
1What:		/sys/class/rtrs-server
2Date:		Feb 2020
3KernelVersion:	5.7
4Contact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
5Description:	When a user of RTRS API creates a new session on a client side, a
6		directory entry with the name of that session is created in here.
7
8What:		/sys/class/rtrs-server/<session-name>/paths/
9Date:		Feb 2020
10KernelVersion:	5.7
11Contact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
12Description:	When new path is created by writing to "add_path" entry on client side,
13		a directory entry named as <source address>@<destination address> is created
14		on server.
15
16What:		/sys/class/rtrs-server/<session-name>/paths/<src@dst>/disconnect
17Date:		Feb 2020
18KernelVersion:	5.7
19Contact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
20Description:	When "1" is written to the file, the RTRS session is being disconnected.
21		Operations is non-blocking and returns control immediately to the caller.
22
23What:		/sys/class/rtrs-server/<session-name>/paths/<src@dst>/hca_name
24Date:		Feb 2020
25KernelVersion:	5.7
26Contact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
27Description:	RO, Contains the name of HCA the connection established on.
28
29What:		/sys/class/rtrs-server/<session-name>/paths/<src@dst>/hca_port
30Date:		Feb 2020
31KernelVersion:	5.7
32Contact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
33Description:	RO, Contains the port number of active port traffic is going through.
34
35What:		/sys/class/rtrs-server/<session-name>/paths/<src@dst>/src_addr
36Date:		Feb 2020
37KernelVersion:	5.7
38Contact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
39Description:	RO, Contains the source address of the path
40
41What:		/sys/class/rtrs-server/<session-name>/paths/<src@dst>/dst_addr
42Date:		Feb 2020
43KernelVersion:	5.7
44Contact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
45Description:	RO, Contains the destination address of the path
46
47What:		/sys/class/rtrs-server/<session-name>/paths/<src@dst>/stats/rdma
48Date:		Feb 2020
49KernelVersion:	5.7
50Contact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
51Description:	Contains statistics regarding rdma operations and inflight operations.
52		The output consists of 5 values:
53		<read-count> <read-total-size> <write-count> <write-total-size> <inflights>
54