xref: /openbmc/linux/Documentation/ABI/testing/sysfs-class-rtrs-server (revision 4f2c0a4acffbec01079c28f839422e64ddeff004)
1745b6a3dSJack WangWhat:		/sys/class/rtrs-server
2745b6a3dSJack WangDate:		Feb 2020
3745b6a3dSJack WangKernelVersion:	5.7
4745b6a3dSJack WangContact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
5745b6a3dSJack WangDescription:	When a user of RTRS API creates a new session on a client side, a
6745b6a3dSJack Wang		directory entry with the name of that session is created in here.
7745b6a3dSJack Wang
8745b6a3dSJack WangWhat:		/sys/class/rtrs-server/<session-name>/paths/
9745b6a3dSJack WangDate:		Feb 2020
10745b6a3dSJack WangKernelVersion:	5.7
11745b6a3dSJack WangContact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
12745b6a3dSJack WangDescription:	When new path is created by writing to "add_path" entry on client side,
13745b6a3dSJack Wang		a directory entry named as <source address>@<destination address> is created
14745b6a3dSJack Wang		on server.
15745b6a3dSJack Wang
16745b6a3dSJack WangWhat:		/sys/class/rtrs-server/<session-name>/paths/<src@dst>/disconnect
17745b6a3dSJack WangDate:		Feb 2020
18745b6a3dSJack WangKernelVersion:	5.7
19745b6a3dSJack WangContact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
20745b6a3dSJack WangDescription:	When "1" is written to the file, the RTRS session is being disconnected.
21745b6a3dSJack Wang		Operations is non-blocking and returns control immediately to the caller.
22745b6a3dSJack Wang
23745b6a3dSJack WangWhat:		/sys/class/rtrs-server/<session-name>/paths/<src@dst>/hca_name
24745b6a3dSJack WangDate:		Feb 2020
25745b6a3dSJack WangKernelVersion:	5.7
26745b6a3dSJack WangContact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
27*b18ee4a4SSlark XiaoDescription:	RO, Contains the name of HCA the connection established on.
28745b6a3dSJack Wang
29745b6a3dSJack WangWhat:		/sys/class/rtrs-server/<session-name>/paths/<src@dst>/hca_port
30745b6a3dSJack WangDate:		Feb 2020
31745b6a3dSJack WangKernelVersion:	5.7
32745b6a3dSJack WangContact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
33745b6a3dSJack WangDescription:	RO, Contains the port number of active port traffic is going through.
34745b6a3dSJack Wang
35745b6a3dSJack WangWhat:		/sys/class/rtrs-server/<session-name>/paths/<src@dst>/src_addr
36745b6a3dSJack WangDate:		Feb 2020
37745b6a3dSJack WangKernelVersion:	5.7
38745b6a3dSJack WangContact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
39745b6a3dSJack WangDescription:	RO, Contains the source address of the path
40745b6a3dSJack Wang
41745b6a3dSJack WangWhat:		/sys/class/rtrs-server/<session-name>/paths/<src@dst>/dst_addr
42745b6a3dSJack WangDate:		Feb 2020
43745b6a3dSJack WangKernelVersion:	5.7
44745b6a3dSJack WangContact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
45745b6a3dSJack WangDescription:	RO, Contains the destination address of the path
46745b6a3dSJack Wang
47745b6a3dSJack WangWhat:		/sys/class/rtrs-server/<session-name>/paths/<src@dst>/stats/rdma
48745b6a3dSJack WangDate:		Feb 2020
49745b6a3dSJack WangKernelVersion:	5.7
50745b6a3dSJack WangContact:	Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
51745b6a3dSJack WangDescription:	Contains statistics regarding rdma operations and inflight operations.
52745b6a3dSJack Wang		The output consists of 5 values:
53745b6a3dSJack Wang		<read-count> <read-total-size> <write-count> <write-total-size> <inflights>
54