Documentation/ABI/testing/sysfs-class-rtrs-server

   1 What:           /sys/class/rtrs-server
   2 Date:           Feb 2020
   3 KernelVersion:  5.7
   4 Contact:        Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
   5 Description:    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
   8 What:           /sys/class/rtrs-server/<session-name>/paths/
   9 Date:           Feb 2020
  10 KernelVersion:  5.7
  11 Contact:        Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
  12 Description:    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
  16 What:           /sys/class/rtrs-server/<session-name>/paths/<src@dst>/disconnect
  17 Date:           Feb 2020
  18 KernelVersion:  5.7
  19 Contact:        Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
  20 Description:    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
  23 What:           /sys/class/rtrs-server/<session-name>/paths/<src@dst>/hca_name
  24 Date:           Feb 2020
  25 KernelVersion:  5.7
  26 Contact:        Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
  27 Description:    RO, Contains the the name of HCA the connection established on.
  28
  29 What:           /sys/class/rtrs-server/<session-name>/paths/<src@dst>/hca_port
  30 Date:           Feb 2020
  31 KernelVersion:  5.7
  32 Contact:        Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
  33 Description:    RO, Contains the port number of active port traffic is going through.
  34
  35 What:           /sys/class/rtrs-server/<session-name>/paths/<src@dst>/src_addr
  36 Date:           Feb 2020
  37 KernelVersion:  5.7
  38 Contact:        Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
  39 Description:    RO, Contains the source address of the path
  40
  41 What:           /sys/class/rtrs-server/<session-name>/paths/<src@dst>/dst_addr
  42 Date:           Feb 2020
  43 KernelVersion:  5.7
  44 Contact:        Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
  45 Description:    RO, Contains the destination address of the path
  46
  47 What:           /sys/class/rtrs-server/<session-name>/paths/<src@dst>/stats/rdma
  48 Date:           Feb 2020
  49 KernelVersion:  5.7
  50 Contact:        Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
  51 Description:    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>