Skip to content

test: add MultiThread relay test mode#363

Open
afrind wants to merge 4 commits into
mainfrom
pr363
Open

test: add MultiThread relay test mode#363
afrind wants to merge 4 commits into
mainfrom
pr363

Conversation

@afrind
Copy link
Copy Markdown
Contributor

@afrind afrind commented Jun 1, 2026

Add RelayMode::MultiThread to the MoQRelayTest parameterized suite so the
relay is exercised across an executor boundary, alongside the existing
SingleThread mode.

Fixture (MoqxRelayTestFixture.h/.cpp, MoqxRelayTestModes.cpp):

  • New RelayMode::MultiThread enum value, instantiated in the AllModes suite.
  • SetUp() starts a ScopedEventBaseThread, wires the relay onto it via
    setRelayExec, and wraps it in PublisherCrossExecFilter /
    SubscriberCrossExecFilter. TearDown() drains pending relay-exec tasks and
    tears down in order to avoid use-after-free on NamespaceTree.
  • TestMoQExecutor::drive() does a loopOnce(), then in MT mode round-trips
    through the relay EVB twice to flush task->relay and relay-created tasks.
  • Add driveIfMultiThread(), make verifyOnRelayExec() hop to the relay EVB,
    and add driveUntil(pred) to advance async cascades deterministically
    instead of using a fixed drive count (capped at one iter in ST mode).

Tests (DataPlane, NGR, Peer, Publish, SubNs, Subscribe):

  • Insert driveIfMultiThread() where work crosses executors.
  • Replace fixed-drive-then-read with driveUntil() plus std::atomic flags.
  • DuplicateSubgroupCancelledWhenNoActiveConsumers splits ST/MT expectations:
    in MT the CrossExecFilter defers the CANCELLED error to the next op, so it
    probes via endOfSubgroup().
  • Add reset() calls to simulate the publisher/QUIC resetting open streams.

Test Plan:


afrind added 4 commits May 31, 2026 23:36
Converts all MoQRelayTest TEST_F cases to TEST_P and instantiates them
under AllModes/MoQRelayTest with named variants (SingleThread, MultiThread).

MoqxTrackFilterTest overrides relayMode() to always return SingleThread
so it stays as TEST_F without GetParam() UB.

MoqxRelayTestModes.cpp is added only to moqx_relay_test (not the shared
fixture library) to avoid a GTest warning in moqx_track_filter_test.
Adds a use_relay_thread boolean config option (default: true) that
controls whether relay state is isolated on a dedicated executor thread.
Disabling it is intended for baseline performance comparison only.

Also removes the hard error that rejected threads > 1, replacing it
with a targeted check: threads > 1 requires use_relay_thread=true.
This unlocks the config validation only — threads > 1 with
use_relay_thread=true will race on shared relay state until the
following commit wires up the dedicated relay executor.
Add RelayMode::MultiThread to the MoQRelayTest parameterized suite so the
relay is exercised across an executor boundary, alongside the existing
SingleThread mode.

Fixture (MoqxRelayTestFixture.h/.cpp, MoqxRelayTestModes.cpp):
- New RelayMode::MultiThread enum value, instantiated in the AllModes suite.
- SetUp() starts a ScopedEventBaseThread, wires the relay onto it via
  setRelayExec, and wraps it in PublisherCrossExecFilter /
  SubscriberCrossExecFilter. TearDown() drains pending relay-exec tasks and
  tears down in order to avoid use-after-free on NamespaceTree.
- TestMoQExecutor::drive() does a loopOnce(), then in MT mode round-trips
  through the relay EVB twice to flush task->relay and relay-created tasks.
- Add driveIfMultiThread(), make verifyOnRelayExec() hop to the relay EVB,
  and add driveUntil(pred) to advance async cascades deterministically
  instead of using a fixed drive count (capped at one iter in ST mode).

Tests (DataPlane, NGR, Peer, Publish, SubNs, Subscribe):
- Insert driveIfMultiThread() where work crosses executors.
- Replace fixed-drive-then-read with driveUntil() plus std::atomic flags.
- DuplicateSubgroupCancelledWhenNoActiveConsumers splits ST/MT expectations:
  in MT the CrossExecFilter defers the CANCELLED error to the next op, so it
  probes via endOfSubgroup().
- Add reset() calls to simulate the publisher/QUIC resetting open streams.

Test Plan:
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant