OS Manuals

/usr/bin/io_demo

ucx utilities

From ucx-utils 1.22.0-r5 (enterprise-packages), captured 2026-11-09 by running io_demo --help (exit 255). permalink

[1794237722.611112] [DEMO] Starting io_demo pid 2 on localhost
[1794237722.611183] [DEMO] Command line: /usr/bin/io_demo --help
[1794237722.611201] [DEMO] UCX library path: /usr/lib/libucp.so.0
/usr/bin/io_demo: invalid option -- '-'
Usage: io_demo [options] [server_address[:port:[repeat_count]]]
Server repeat_count should be in the range [1.. 64512]

Supported options are:
  -p <port>                   TCP port number to use
  -n <connect timeout>        Timeout for connecting to the peer (or "inf")
  -o <op1,op2,...,opN>        Comma-separated string of IO operations [read|write]
                              NOTE: if using several IO operations, performance
                                    measurements may be inaccurate
  -d <min>:<max>              Range that should be used to get data
                              size of IO payload. Values can use
                              B, K, M, G or T suffixes; for example:
                              -d 64K:1M
  -b <number of buffers>      Number of offcache IO buffers
  -i <iterations-count>       Number of iterations to run communication
  -w <window-size>            Number of outstanding requests
  -a <conn-window-size>       Number of outstanding requests per connection
  -k <chunk-size>             Split the data transfer to chunks of this size
  -r <io-request-size>        Size of IO request packet
  -t <client timeout>         Client timeout (or "inf")
  -c <retries>                Number of connection retries on client or
                              listen retries on server
                              (or "inf") for failure
  -y <retry interval>         Retry interval
  -l <client run-time limit>  Time limit to run the IO client (or "inf")
                              Examples: -l 17.5s; -l 10m; 15.5h
  -s <random seed>            Random seed to use for randomizing
  -v                          Set verbose mode
  -q                          Enable data integrity and transaction check
  -A                          Use UCP Active Messages API (use TAG API otherwise)
  -C <client-id>              Send client id during connection establishment, must be != 0
  -D                          Enable debugging mode for IO operation timeouts
  -H                          Use human-readable timestamps
  -P <interval>               Set report printing interval

  -m <memory_type>            Memory type to use. Possible values: host
  -L <progress_count>         Maximal number of consecutive ucp_worker_progress invocations
  -I <src_addr>               Set source IP address to select network interface on client side
  -z                          Enable pre-register buffers for zero-copy
  -V                          Print per-connection info
Options (27)
OptionDescriptionSource
-p portTCP port number to usehelp
-n connectTimeout for connecting to the peer (or "inf")help
-o op1Comma-separated string of IO operations [read|write] NOTE: if using several IO operations, performance measurements may be inaccuratehelp
-d min>:<maxRange that should be used to get data size of IO payload.help
-b numberNumber of offcache IO buffershelp
-i iterations-countNumber of iterations to run communicationhelp
-w window-sizeNumber of outstanding requestshelp
-a conn-window-sizeNumber of outstanding requests per connectionhelp
-k chunk-sizeSplit the data transfer to chunks of this sizehelp
-r io-request-sizeSize of IO request packethelp
-t clientClient timeout (or "inf")help
-c retriesNumber of connection retries on client or listen retries on server (or "inf") for failurehelp
-y retryRetry intervalhelp
-l clientTime limit to run the IO client (or "inf") Examples: -l 17.5s;help
-s randomRandom seed to use for randomizinghelp
-vSet verbose modehelp
-qEnable data integrity and transaction checkhelp
-AUse UCP Active Messages API (use TAG API otherwise)help
-C client-idSend client id during connection establishment, must be != 0help
-DEnable debugging mode for IO operation timeoutshelp
-HUse human-readable timestampshelp
-P intervalSet report printing intervalhelp
-m memory_typeMemory type to use.help
-L progress_countMaximal number of consecutive ucp_worker_progress invocationshelp
-I src_addrSet source IP address to select network interface on client sidehelp
-zEnable pre-register buffers for zero-copyhelp
-VPrint per-connection infohelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.