smcd-stats - Print statistics about SMC-D usage

show (default)
              Display statistics on respective SMC mode usage. Values displayed are cumulative since last reset,
              unless option -a/--absolute is specified.

       reset  Display current statistics and reset all counters to zero.

       json   Display current statistics in JSON format.

       The smcd stats and smcr stats commands display statistics about SMC-D and SMC-R, respectively. Data
       includes number of connections, number of failed connections, buffer information, and special calls.
       Statistics are collected at various data points in the smc kernel module.  Therefore, minor
       inconsistencies in the data can occur and are to be expected.

       1. Show SMC-D statistics:
         #smcdstats

       2. Show detailed SMC-R statistics:
         #smcr-dstatsshow

       3. Show detailed SMC-R statistics and reset SMC-R statistics counters:
         #smcr-dstatsreset

       4. Show detailed SMC-D statistics since module load in JSON format:
         #smcd-dastatsjson

       5. Show SMC-R statistics since module load:
         #smcr-astats

       smcd-stats - Print statistics about SMC-D usage

       smcr-stats - Print statistics about SMC-R usage

-d,--details
              Display additional fields and information in the output.

       -a,--absolute
              Display values since smc module load, ignoring any resets.

       The  -d/--details  option  displays a number of additional fields as indicated in the following.  It also
       breaks up a number of counters in section ConnectionsSummary into separate counts for client and server.

   Totalconnectionshandled
       Total number of connections handled by the SMC module. Includes  TCPfallback  connections  as  well  as
       handshakeerrors.

   SMCconnections
       Number  of  connections  that  successfully  entered  the  respective  SMC  mode.  -d/--details breaks up
       connections by SMC versions.

   Handshakeerrors
       Number of connections that failed due to errors  during  the  handshaking  phase,  e.g.  peer  no  longer
       responding.

   AvgrequestsperSMCconn
       Average number of requests sent and received (including specialsocketcalls) per SMC connection.

   TCPfallback
       Number of connections that fell back to TCP/IP.

   Datatransmitted
       Amount of data sent (TX) or received (RX) in Bytes.

   Totalrequests
       Total number of individual send (TX) or receive (RX) requests handled.  Includes requests that ended with
       errors or did not transfer any data.

   Bufferfull
       Number of occurrences where the respective send buffer (TX) could not contain all data to be sent, or did
       not contain as much data as requested in a receive call (RX).

   Bufferfull(remote)(--detailsonly)
       Number  of  occurrences  where  the peer's receive buffer was exceeded by writing data. That is, requests
       that fill the buffer up to the last bit are not included in the count.

   Buffertoosmall(--detailsonly)
       Number of occurrences where a send request was larger than the local send buffer's total capacity.

   Buffertoosmall(remote)(--detailsonly)
       Number of occurrences where a send request exceeded the total capacity of the peer's receive buffer.

   Bufferdowngrades(--detailsonly)
       Number of occurrences where a buffer of the requested size could not be allocated for a  new  connection,
       and a smaller buffer was used.

   Bufferreuses(--detailsonly)
       Number  of  occurrences where a buffer was provided as requested for a new connection by reusing a buffer
       from a previous connection.

   Bufs
       Histogram of buffer sizes for all connections,  including  bufferdowngrades  and  bufferreuses.   The
       histogram scale presents exact buffer sizes.

   Reqs
       Histogram  of  request  sizes.  The  histogram  scale  includes upper boundaries of request sizes. Counts
       reflect requested send sizes for TX, and actual receive sizes for RX. Difference to Totalrequests is due
       to requests not transferring any data and/or erroneous requests.

   Specialsocketcalls
       Summarizes the total number of sockets calls that require special handling in SMC.  To  categorize  these
       calls into individual counters as follows, use the -d/--details option.

       cork   Counts  occurrences  of sockopt TCP_CORK enablements. That is, does not reflect the number of send
              requests with TCP_CORK enabled.

       nodelay
              Counts occurrences of sockopt TCP_NODELAY enablements. That is, does not  reflect  the  number  of
              send requests with TCP_CORK enabled.

       sendpage
              Counts occurrences of the AF_SMC implementation of the sendpage call.

       splice Counts number of calls of the splice() system call.

       urgentdata
              Counts number of send and receive calls with MSG_OOB set.

smcd(8), smcr(8)

smc-tools                                           June 2021                                      SMCD-STATS(8)

smcd [ OPTIONS ] stats  { COMMAND | help }

       smcr [ OPTIONS ] stats  { COMMAND | help }