Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add support for both Qtip and UDP traffic for Server Listeners. #4803

Open
wants to merge 104 commits into
base: main
Choose a base branch
from

Conversation

ProjectsByJackHe
Copy link
Contributor

@ProjectsByJackHe ProjectsByJackHe commented Feb 7, 2025

Description

Currently, we have an execution parameter (QUIC_EXECUTION_CONFIG_FLAG_QTIP) that you set to either process packets via QTIP or normal QUIC/UDP traffic.

For a server listener, that means you can only talk to clients with the same execution profile as you; you either deal over QTIP or QUIC/UDP.

This is inconvenient and sometimes a blocker when you want your listener to accept from clients with varying execution parameters (QTIP through the Azure load balancer, normal QUIC/UDP for on-prem clients)

Changes
The main behavior change is that now all Server listeners created will accept both QTIP and QUIC+udp traffic by default when XDP is configured and running correctly.

To support this new design and make testing a bit easier, we also add a knob at the connection layer to control whether a connection created is going to send QUIC+udp/QTIP.

This pull-request also updates the behavior of QUIC_EXECUTION_CONFIG_FLAG_QTIP: If you set this flag, all client connections created will default to using QTIP unless otherwise specified. Note that the QUIC_EXECUTION_CONFIG_FLAG_QTIP does not impact server Listeners as they will always accept both QUIC/QTIP traffic assuming XDP is configured and running correctly.

This PR adds an API (connection Get/Set parameter) for client connections to specify whether the connection sends normal QUIC and/or TCP traffic.

Closes: #3516

Testing

Modified a datatest to alternate between creating normal QUIC connections and QTIP connections, where they all ping the same listener. The expectation is all the tests pass.

Documentation

QUIC_EXECUTION_CONFIG_FLAG_QTIP and QUIC_PARAM_CONN_QTIP will be documented in a follow up PR.

@ProjectsByJackHe ProjectsByJackHe requested a review from a team as a code owner February 7, 2025 20:49
@ProjectsByJackHe ProjectsByJackHe marked this pull request as draft February 7, 2025 20:49
Copy link

codecov bot commented Feb 7, 2025

Codecov Report

Attention: Patch coverage is 93.54839% with 4 lines in your changes missing coverage. Please review.

Project coverage is 83.95%. Comparing base (9073911) to head (6b4394a).
Report is 17 commits behind head on main.

Files with missing lines Patch % Lines
src/core/settings.c 82.35% 3 Missing ⚠️
src/core/connection.c 95.83% 1 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##             main    #4803      +/-   ##
==========================================
- Coverage   86.20%   83.95%   -2.26%     
==========================================
  Files          56       56              
  Lines       17726    17769      +43     
==========================================
- Hits        15281    14918     -363     
- Misses       2445     2851     +406     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@ProjectsByJackHe ProjectsByJackHe added Partner: SQL By or For the SQL team Area: Lola Related to low latency work Area: API labels Feb 13, 2025
@@ -6641,6 +6657,25 @@ QuicConnParamSet(
break;
}

case QUIC_PARAM_CONN_QTIP: {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of making a param for this, I think it'd be better to indicate the UseQTIP state in the QUIC_NEW_CONNECTION_INFO struct that's indicated in the NEW_CONNECTION event to listeners.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am removing this in the next few iterations. We are fully migrating off of params to settings. I wanted to get the settings stuff working before deleting code.

Comment on lines +1853 to +1857
QuicTraceLogConnInfo(
IndicateQTIPSettingsBubbledDown,
Connection,
"Bubbling down UseQTIP setting: %hhu",
UdpConfig.UseQTIP);
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This log should be unnecessary, IMO, because QuicConnApplyNewSettings would log the value of every settings.

@@ -1770,6 +1770,11 @@ QuicConnStart(

CXPLAT_TEL_ASSERT(Path->Binding == NULL);

QuicConnApplyNewSettings(
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We want to make sure we don't also call this in QuicConnSetConfiguration for the client path now (but you do for server).

@@ -578,6 +577,8 @@ typedef struct CXPLAT_UDP_CONFIG {
uint8_t CibirIdOffsetSrc; // CIBIR ID offset in source CID
uint8_t CibirIdOffsetDst; // CIBIR ID offset in destination CID
uint8_t CibirId[6]; // CIBIR ID data

uint8_t UseQTIP;
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Make this a CXPLAT_SOCKET_FLAG

Comment on lines 187 to 191
if (IoMode && IsValue(IoMode, "qtip")) {
Config->Flags |= QUIC_EXECUTION_CONFIG_FLAG_QTIP;
SetConfig = true;
MsQuicSettings Settings;
Settings.SetQtipEnabled(TRUE);
Settings.SetGlobal();
}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Now that this doesn't have to be global, let's move this logic to PerfClient.cpp, and set the Configurations settings.

@@ -113,7 +113,9 @@ class QuicTestEnvironment : public ::testing::Environment {
#if defined(QUIC_API_ENABLE_PREVIEW_FEATURES)
if (UseQTIP) {
Config.PollingIdleTimeoutUs = 10000;
Config.Flags |= QUIC_EXECUTION_CONFIG_FLAG_QTIP;
MsQuicSettings Settings;
Settings.SetQtipEnabled(TRUE);
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Settings.SetQtipEnabled(TRUE);
Settings.SetQtipEnabled(true);

C++ code uses true instead of TRUE.

@@ -578,6 +577,9 @@ typedef struct CXPLAT_UDP_CONFIG {
uint8_t CibirIdOffsetSrc; // CIBIR ID offset in source CID
uint8_t CibirIdOffsetDst; // CIBIR ID offset in destination CID
uint8_t CibirId[6]; // CIBIR ID data

uint8_t UseQTIP;
uint8_t IgnoreRawSocketFailure;
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please use socket flags instead

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Area: API Area: Lola Related to low latency work Partner: SQL By or For the SQL team
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Support for QTIP and UDP on QUIC
4 participants