147 lines
6.4 KiB
Plaintext
147 lines
6.4 KiB
Plaintext
What: /sys/class/rtrs-client
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: When a user of RTRS API creates a new session, a directory entry with
|
|
the name of that session is created under /sys/class/rtrs-client/<session-name>/
|
|
|
|
What: /sys/class/rtrs-client/<session-name>/add_path
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: RW, adds a new path (connection) to an existing session. Expected format is the
|
|
following::
|
|
|
|
<[source addr,]destination addr>
|
|
*addr ::= [ ip:<ipv4|ipv6> | gid:<gid> ]
|
|
|
|
What: /sys/class/rtrs-client/<session-name>/max_reconnect_attempts
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: Maximum number reconnect attempts the client should make before giving up
|
|
after connection breaks unexpectedly.
|
|
|
|
What: /sys/class/rtrs-client/<session-name>/mp_policy
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: Multipath policy specifies which path should be selected on each IO:
|
|
|
|
round-robin (0):
|
|
select path in per CPU round-robin manner.
|
|
|
|
min-inflight (1):
|
|
select path with minimum inflights.
|
|
|
|
min-latency (2):
|
|
select path with minimum latency.
|
|
|
|
What: /sys/class/rtrs-client/<session-name>/paths/
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: Each path belonging to a given session is listed here by its source and
|
|
destination address. When a new path is added to a session by writing to
|
|
the "add_path" entry, a directory <src@dst> is created.
|
|
|
|
What: /sys/class/rtrs-client/<session-name>/paths/<src@dst>/state
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: RO, Contains "connected" if the session is connected to the peer and fully
|
|
functional. Otherwise the file contains "disconnected"
|
|
|
|
What: /sys/class/rtrs-client/<session-name>/paths/<src@dst>/reconnect
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: Write "1" to the file in order to reconnect the path.
|
|
Operation is blocking and returns 0 if reconnect was successful.
|
|
|
|
What: /sys/class/rtrs-client/<session-name>/paths/<src@dst>/disconnect
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: Write "1" to the file in order to disconnect the path.
|
|
Operation blocks until RTRS path is disconnected.
|
|
|
|
What: /sys/class/rtrs-client/<session-name>/paths/<src@dst>/remove_path
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: Write "1" to the file in order to disconnected and remove the path
|
|
from the session. Operation blocks until the path is disconnected
|
|
and removed from the session.
|
|
|
|
What: /sys/class/rtrs-client/<session-name>/paths/<src@dst>/hca_name
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: RO, Contains the name of HCA the connection established on.
|
|
|
|
What: /sys/class/rtrs-client/<session-name>/paths/<src@dst>/hca_port
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: RO, Contains the port number of active port traffic is going through.
|
|
|
|
What: /sys/class/rtrs-client/<session-name>/paths/<src@dst>/src_addr
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: RO, Contains the source address of the path
|
|
|
|
What: /sys/class/rtrs-client/<session-name>/paths/<src@dst>/dst_addr
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: RO, Contains the destination address of the path
|
|
|
|
What: /sys/class/rtrs-client/<session-name>/paths/<src@dst>/cur_latency
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: RO, Contains the latency time calculated by the heart-beat messages.
|
|
Whenever the client sends heart-beat message, it checks the time gap
|
|
between sending the heart-beat message and receiving the ACK.
|
|
This value can be changed regularly.
|
|
|
|
What: /sys/class/rtrs-client/<session-name>/paths/<src@dst>/stats/reset_all
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: RW, Read will return usage help, write 0 will clear all the statistics.
|
|
|
|
What: /sys/class/rtrs-client/<session-name>/paths/<src@dst>/stats/cpu_migration
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: RTRS expects that each HCA IRQ is pinned to a separate CPU. If it's
|
|
not the case, the processing of an I/O response could be processed on a
|
|
different CPU than where it was originally submitted. This file shows
|
|
how many interrupts where generated on a non expected CPU.
|
|
|
|
"from:"
|
|
is the CPU on which the IRQ was expected, but not generated.
|
|
"to:"
|
|
is the CPU on which the IRQ was generated, but not expected.
|
|
|
|
What: /sys/class/rtrs-client/<session-name>/paths/<src@dst>/stats/reconnects
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: Contains 2 unsigned int values, the first one records number of successful
|
|
reconnects in the path lifetime, the second one records number of failed
|
|
reconnects in the path lifetime.
|
|
|
|
What: /sys/class/rtrs-client/<session-name>/paths/<src@dst>/stats/rdma
|
|
Date: Feb 2020
|
|
KernelVersion: 5.7
|
|
Contact: Jack Wang <jinpu.wang@cloud.ionos.com> Danil Kipnis <danil.kipnis@cloud.ionos.com>
|
|
Description: Contains statistics regarding rdma operations and inflight operations.
|
|
The output consists of 6 values::
|
|
|
|
<read-count> <read-total-size> <write-count> \
|
|
<write-total-size> <inflights> <failovered>
|