[Feature]: specify stream priority to enable network slicing qos

XQUIC

简体中文文档 README-zh-CN

Introduction

XQUIC Library released by Alibaba is …

… a client and server implementation of QUIC and HTTP/3 as specified by the IETF. Currently supported QUIC versions are v1 and draft-29.

… OS and platform agnostic. It currently supports Android, iOS, HarmonyOS, Linux, macOS and Windows(v1.2.0). Most of the code is used in our own products, and has been tested at scale on android, iOS apps, as well as servers.

… still in active development. Interoperability is regularly tested with other QUIC implementations.

Features

Standardized Features

All big features conforming with RFC 9000, RFC9001, RFC9002, RFC9114 and RFC9204, including the interface between QUIC and TLS, 0-RTT connection establishment, HTTP/3 and QPACK.
ALPN Extension conforming with RFC7301

Not Yet Standardized Features

Library Features

Pluggable congestion control: NewReno, Cubic, BBR and BBRv2, ...
Pluggable cryptography, integration with BoringSSL and BabaSSL
Cross-platform implementation, support Android, iOS, HarmonyOS, Linux, macOS and Windows(v1.2.0)

Requirements

To build XQUIC, you need

CMake
BoringSSL or BabaSSL

To run test cases, you need

libevent
CUnit

QuickStart Guide

XQUIC can be built with Tongsuo(BabaSSL) or BoringSSL.

Build with BoringSSL

# get XQUIC source code
git clone https://github.com/alibaba/xquic.git
cd xquic

# get and build BoringSSL
git clone https://github.com/google/boringssl.git ./third_party/boringssl
cd ./third_party/boringssl
mkdir -p build && cd build
cmake -DBUILD_SHARED_LIBS=0 -DCMAKE_C_FLAGS="-fPIC" -DCMAKE_CXX_FLAGS="-fPIC" ..
make ssl crypto
cd ..
SSL_TYPE_STR="boringssl"
SSL_PATH_STR="${PWD}"
cd ../..
## Note: if you don’t have golang in your environment, please install [golang](https://go.dev/doc/install) first. 

# build XQUIC with BoringSSL
# When build XQUIC with boringssl, /usr/local/babassl directory will be searched
# as default. if boringssl is deployed in other directories, SSL_PATH could be 
# used to specify the search path of boringssl
git submodule update --init --recursive
mkdir -p build; cd build
cmake -DGCOV=on -DCMAKE_BUILD_TYPE=Debug -DXQC_ENABLE_TESTING=1 -DXQC_SUPPORT_SENDMMSG_BUILD=1 -DXQC_ENABLE_EVENT_LOG=1 -DXQC_ENABLE_BBR2=1 -DXQC_ENABLE_RENO=1 -DSSL_TYPE=${SSL_TYPE_STR} -DSSL_PATH=${SSL_PATH_STR} ..

# exit if cmake error
if [ $? -ne 0 ]; then
    echo "cmake failed"
    exit 1
fi

make -j

Build with BabaSSL(Tongsuo)

# get XQUIC source code
git clone https://github.com/alibaba/xquic.git
cd xquic

# get and build BabaSSL(Tongsuo)
git clone -b 8.3-stable https://github.com/Tongsuo-Project/Tongsuo.git ./third_party/babassl
cd ./third_party/babassl/
./config --prefix=/usr/local/babassl
make -j
SSL_TYPE_STR="babassl"
SSL_PATH_STR="${PWD}"
cd -

# build XQUIC with BabaSSL
# When build XQUIC with boringssl, /usr/local/babassl directory will be searched
# as default. if boringssl is deployed in other directories, SSL_PATH could be 
# used to specify the search path of boringssl
git submodule update --init --recursive
mkdir -p build; cd build
cmake -DGCOV=on -DCMAKE_BUILD_TYPE=Debug -DXQC_ENABLE_TESTING=1 -DXQC_SUPPORT_SENDMMSG_BUILD=1 -DXQC_ENABLE_EVENT_LOG=1 -DXQC_ENABLE_BBR2=1 -DXQC_ENABLE_RENO=1 -DSSL_TYPE=${SSL_TYPE_STR} -DSSL_PATH=${SSL_PATH_STR} ..

# exit if cmake error
if [ $? -ne 0 ]; then
    echo "cmake failed"
    exit 1
fi

make -j

Run testcases

sh ../scripts/xquic_test.sh

Documentation

For using the API, see the API docs.
For platform support details, see the Platforms docs.
For Chinese Simplified (zh-CN) translation of the IETF QUIC Protocol, see the Translation docs.
For using quic-qlog, see the Features: qlog
For testing the library, see the Testing docs.
For other frequently asked questions, see the FAQs and Trouble Shooting Guide.

Contributing

We would love for you to contribute to XQUIC and help make it even better than it is today! All types of contributions are encouraged and valued. Thanks to all contributors. See our Contributing Guidelines for more information.

If you have any questions, please feel free to open a new Discussion topic in our discussion forums.

License

XQUIC is released under the Apache 2.0 License.

Contact Us

Feel free to contact us in the following ways:

e-mail: [email protected]
Dingtalk group: 34059705
slack channel: #xquic in quicdev group

	/* server ip */
	case 'a':
	printf("option addr :%s\n", optarg);
	snprintf(args->net_cfg.server_addr, sizeof(args->net_cfg.server_addr), optarg);
	break;

	/* server port */
	case 'p':
	printf("option port :%s\n", optarg);
	args->net_cfg.server_port = atoi(optarg);
	break;

	/* create one connection, send multi reqs in multi streams */
	int
	xqc_demo_cli_handle_task(xqc_demo_cli_ctx_t ctx, xqc_demo_cli_task_t task)
	{
	DEBUG;
	/* create socket and connection callback user data */
	xqc_demo_cli_user_conn_t *user_conn = calloc(1, sizeof(xqc_demo_cli_user_conn_t));
	user_conn->ctx = ctx;
	user_conn->task = task;
	// printf(".. user_conn: %p, ctx: %p\n", user_conn, ctx);
	user_conn->fd = xqc_demo_cli_create_socket(user_conn, &ctx->args->net_cfg);
	if (user_conn->fd < 0) {
	printf("xqc_create_socket error\n");
	return -1;
	}

	/* socket event */
	user_conn->ev_socket = event_new(ctx->eb, user_conn->fd, EV_READ \| EV_PERSIST,
	xqc_demo_cli_socket_event_callback, user_conn);
	event_add(user_conn->ev_socket, NULL);

	/* xquic timer */
	user_conn->ev_timeout = event_new(ctx->eb, -1, 0, xqc_demo_cli_idle_callback, user_conn);
	struct timeval tv;
	tv.tv_sec = ctx->args->net_cfg.conn_timeout;
	tv.tv_usec = 0;
	event_add(user_conn->ev_timeout, &tv);

	/* start client */
	xqc_demo_cli_start(user_conn, ctx->args, task->reqs, task->req_cnt);

	task->user_conn = user_conn;
	return 0;
	}

	struct sockaddr addr = (struct sockaddr)&cfg->addr;
	fd = socket(addr->sa_family, SOCK_DGRAM, 0);
	if (fd < 0) {
	printf("create socket failed, errno: %d\n", get_last_sys_errno());
	return -1;
	}

alibaba / xquic Goto Github PK

xquic's Introduction

XQUIC

Introduction

Features

Standardized Features

Not Yet Standardized Features

Library Features

Requirements

QuickStart Guide

Build with BoringSSL

Build with BabaSSL(Tongsuo)

Run testcases

Documentation

Contributing

License

Contact Us

xquic's People

Contributors

Stargazers

Watchers

Forkers

xquic's Issues

Before request a new feature

Describe the feature you'd like supported

Describe alternatives you've considered

Additional context

What happened?

Steps To Reproduce

Relevant log output

What happened?

Steps To Reproduce

Relevant log output

Before request a new feature

Describe the feature you'd like supported

Describe alternatives you've considered

Additional context

What happened?

Steps To Reproduce

Relevant log output

What happened?

Steps To Reproduce

Relevant log output

What happened?

Steps To Reproduce

Relevant log output

What happened?

Steps To Reproduce

Relevant log output

What happened?

Steps To Reproduce

Relevant log output

What happened?

Steps To Reproduce

Relevant log output

Before request a new feature

Describe the feature you'd like supported

Describe alternatives you've considered

Additional context

Before request a new feature

Describe the feature you'd like supported

Describe alternatives you've considered

Additional context

Discussed in #87

What happened?

Steps To Reproduce

Relevant log output

🏕 Alibaba Summer of Code (ASOC) 2022

🎊 What you can get?

🥷🏻 Our Mentor

⏱ Timeline

🚀 Apply Now!

🐚 Contact the Organizer

🏕 阿里巴巴编程之夏 (ASOC) 2022

🎊 参与活动能获得什么？

🥷🏻 活动导师

⏱ 活动里程碑

🚀 立刻申请！

🐚 联系主办方

Before request a new feature