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