Testing XQUIC

本文档主要描述了如何使用 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() 中找到对应说明，如本文档有更新滞后的情况，请以最新代码为准。

test_client

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+ P:copa
-C	Pacing on.
-t	Connection timeout. Default 3 seconds.
-T	Transport layer. No HTTP3.
-1	Force 1RTT.
-s	Body size to send.
-F	Abs_timeout to close conn. >=0.
-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
-M	Enable multi-path on.
-i	Multi-path interface. e.g. -i interface1 -i interface2.
-R	Enable reinjection. Default is 0, no reinjection
-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
-f	Debug endless loop.
-e	Epoch, default is 0.
-D	Process num. default is 2.
-b	Create connection per second. default is 100.
-B	Max connection num. default is 1000.
-J	Random CID. default is 0.
-Q	Multipath backup path standby, set backup_mode on(1). default backup_mode is 0(off).
-A	Multipath request accelerate on. default is 0(off).

test_server

Option	Usage
-a	Server addr.
-p	Server port.
-e	Echo. Send received body.
-c	Congestion Control Algorithm. r:reno b:bbr c:cubic B:bbr2 bbr+ bbr2+ P:copa
-C	Pacing on.
-L	Endless_sending on. default is off.
-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
-M	Enable multi-path on.
-R	Enable reinjection. Default is 0, no reinjection
-E	load balance id encryption on
-K	load balance id encryption key
-o	Output log file path, default ./slog
-m	Set mpshell on
-Q	Multipath backup path standby, set backup_mode on(1). default backup_mode is 0(off).

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!