本文档主要描述了如何使用 test_client 和 test_server 进行测试。
在运行 test_server 之前,需要先生成证书:
cd build
keyfile=server.key
certfile=server.crt
openssl req -newkey rsa:2048 -x509 -nodes -keyout "$keyfile" -new -out "$certfile" -subj /CN=test.xquic.com
运行 test_client 和 test_server:
./test_server -l d > /dev/null &
./test_client -a 127.0.0.1 -p 8443 -s 1024000 -E
注意:不同的服务端之间, session ticket 、传输参数、 token 可能是不兼容的。在使用 test_client 连接到一种服务端之后,需要连接到另外一种服务端,则需要删除 test_client 本地保存的 test_session 、 tp_localhost 、 xqc_token 文件,否则可能造成连接失败。 此外,同一个服务端上的不同域名,可能配置了不同的证书。因此,如果要使用 test_client 先后以不同域名连接到同一个服务端,也需要注意本地保存的 test_session 文件可能会造成连接失败。
以下参数都可以在 tests/test_client.c 和 tests/test_server.c 的 usage()
中找到对应说明,如本文档有更新滞后的情况,请以最新代码为准。
Option | Usage |
---|---|
-a | Server addr. |
-p | Server port. |
-P | Number of Parallel requests per single connection. Default 1. |
-n | Total number of requests to send. Defaults 1. |
-c | Congestion Control Algorithm. r:reno b:bbr c:cubic B:bbr2 bbr+ bbr2+ |
-C | Pacing on. |
-t | Connection timeout. Default 3 seconds. |
-T | Transport layer. No HTTP3. |
-1 | Force 1RTT. |
-s | Body size to send. |
-w | Write received body to file. |
-r | Read sending body from file. priority s > r |
-l | Log level. e:error d:debug. |
-E | Echo check on. Compare sent data with received data. |
-d | Drop rate ‰. |
-u | Url. default https://test.xquic.com/path/resource |
-H | Header. eg. key:value |
-h | Host & sni. eg. test.xquic.com |
-G | GET on. Default is POST |
-x | Test case ID |
-N | No encryption |
-6 | IPv6 |
-V | Force cert verification. 0: don't allow self-signed cert. 1: allow self-signed cert. |
-q | name-value pair num of request header, default and larger than 6 |
-o | Output log file path, default ./clog |
Option | Usage |
---|---|
-p | Server port. |
-e | Echo. Send received body. |
-c | Congestion Control Algorithm. r:reno b:bbr c:cubic B:bbr2 bbr+ bbr2+ |
-C | Pacing on. |
-s | Body size to send. |
-w | Write received body to file. |
-r | Read sending body from file. priority e > s > r |
-l | Log level. e:error d:debug. |
-u | Url. default https://test.xquic.com/path/resource |
-x | Test case ID |
-6 | IPv6 |
-b | batch |
-S | server sid |
-E | load balance id encryption on |
-K | load balance id encryption key |
-o | Output log file path, default ./slog |