Seastar
High performance C++ framework for concurrent servers
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Modules Pages
closeable_test.cc
/*
* This file is open source software, licensed to you under the terms
* of the Apache License, Version 2.0 (the "License"). See the NOTICE file
* distributed with this work for additional information regarding copyright
* ownership. You may not use this file except in compliance with the License.
*
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
/*
* Copyright 2021 ScyllaDB
*/
#include <exception>
#include <ranges>
#include <seastar/testing/test_case.hh>
#include <seastar/testing/thread_test_case.hh>
#include <seastar/core/gate.hh>
#include <seastar/core/loop.hh>
using namespace seastar;
class expected_exception : public std::runtime_error {
public:
expected_exception() : runtime_error("expected") {}
};
SEASTAR_TEST_CASE(deferred_close_test) {
return do_with(gate(), 0, 42, [] (gate& g, int& count, int& expected) {
return async([&] {
auto close_gate = deferred_close(g);
for (auto i = 0; i < expected; i++) {
(void)with_gate(g, [&count] {
++count;
});
}
}).then([&] {
// destroying close_gate should invoke g.close()
// and wait for all background continuations to complete
BOOST_REQUIRE(g.is_closed());
BOOST_REQUIRE_EQUAL(count, expected);
});
});
}
SEASTAR_TEST_CASE(move_deferred_close_test) {
return do_with(gate(), [] (gate& g) {
return async([&] {
auto close_gate = make_shared(deferred_close(g));
// g.close() should not be called when deferred_close is moved away
BOOST_REQUIRE(!g.is_closed());
}).then([&] {
// Before this test is exercised, gate::close() would run into a
// assert failure when leaving previous continuation, if gate::close()
// is called twice, so this test only verifies the behavior with the
// release build.
BOOST_REQUIRE(g.is_closed());
});
});
}
SEASTAR_TEST_CASE(close_now_test) {
return do_with(gate(), 0, 42, [] (gate& g, int& count, int& expected) {
return async([&] {
auto close_gate = deferred_close(g);
for (auto i = 0; i < expected; i++) {
(void)with_gate(g, [&count] {
++count;
});
}
close_gate.close_now();
BOOST_REQUIRE(g.is_closed());
BOOST_REQUIRE_EQUAL(count, expected);
// gate must not be double-closed.
});
});
}
SEASTAR_TEST_CASE(cancel_deferred_close_test) {
gate g;
{
auto close_gate = deferred_close(g);
close_gate.cancel();
}
g.check(); // should not throw
return make_ready_future<>();
}
SEASTAR_TEST_CASE(with_closeable_test) {
return do_with(0, 42, [] (int& count, int& expected) {
return with_closeable(gate(), [&] (gate& g) {
for (auto i = 0; i < expected; i++) {
(void)with_gate(g, [&count] {
++count;
});
}
return 17;
}).then([&] (int res) {
// res should be returned by the function called
// by with_closeable.
BOOST_REQUIRE_EQUAL(res, 17);
// closing the gate should wait for
// all background continuations to complete
BOOST_REQUIRE_EQUAL(count, expected);
});
});
}
SEASTAR_TEST_CASE(with_closeable_exception_test) {
return do_with(0, 42, [] (int& count, int& expected) {
return with_closeable(gate(), [&] (gate& g) {
for (auto i = 0; i < expected; i++) {
(void)with_gate(g, [&count] {
++count;
});
}
throw expected_exception();
}).handle_exception_type([&] (const expected_exception&) {
// closing the gate should also happen when func throws,
// waiting for all background continuations to complete
BOOST_REQUIRE_EQUAL(count, expected);
});
});
}
namespace {
class count_stops {
int _count = -1;
int* _ptr = nullptr;
public:
count_stops(int* ptr = nullptr) noexcept
: _ptr(ptr ? ptr : &_count)
{
*_ptr = 0;
}
count_stops(count_stops&& o) noexcept {
std::exchange(_count, o._count);
if (o._ptr == &o._count) {
_ptr = &_count;
} else {
std::exchange(_ptr, o._ptr);
}
}
future<> stop() noexcept {
++*_ptr;
return make_ready_future<>();
}
int stopped() const noexcept {
return *_ptr;
}
};
} // anonymous namespace
SEASTAR_TEST_CASE(cancel_deferred_stop_test) {
count_stops cs;
{
auto stop = deferred_stop(cs);
stop.cancel();
}
BOOST_REQUIRE_EQUAL(cs.stopped(), 0);
return make_ready_future<>();
}
SEASTAR_TEST_CASE(deferred_stop_test) {
return do_with(count_stops(), [] (count_stops& cs) {
return async([&] {
auto stop_counting = deferred_stop(cs);
}).then([&] {
// cs.stop() should be called when stop_counting is destroyed
BOOST_REQUIRE_EQUAL(cs.stopped(), 1);
});
});
}
SEASTAR_TEST_CASE(move_deferred_stop_test) {
return do_with(count_stops(), [] (count_stops& cs) {
return async([&] {
auto stop = make_shared(deferred_stop(cs));
}).then([&] {
// cs.stop() should be called once and only once
// when stop is destroyed
BOOST_REQUIRE_EQUAL(cs.stopped(), 1);
});
});
}
SEASTAR_TEST_CASE(stop_now_test) {
return do_with(count_stops(), [] (count_stops& cs) {
return async([&] {
auto stop_counting = deferred_stop(cs);
stop_counting.stop_now();
// cs.stop() should not be called again
// when stop_counting is destroyed
BOOST_REQUIRE_EQUAL(cs.stopped(), 1);
}).then([&] {
// cs.stop() should be called exactly once
BOOST_REQUIRE_EQUAL(cs.stopped(), 1);
});
});
}
SEASTAR_TEST_CASE(with_stoppable_test) {
return do_with(0, [] (int& stopped) {
return with_stoppable(count_stops(&stopped), [] (count_stops& cs) {
return 17;
}).then([&] (int res) {
// res should be returned by the function called
// by with_closeable.
BOOST_REQUIRE_EQUAL(res, 17);
// cs.stop() should be called before count_stops is destroyed
BOOST_REQUIRE_EQUAL(stopped, 1);
});
});
}
SEASTAR_TEST_CASE(with_stoppable_exception_test) {
return do_with(0, [] (int& stopped) {
return with_stoppable(count_stops(&stopped), [] (count_stops& cs) {
throw expected_exception();
}).handle_exception_type([&] (const expected_exception&) {
// cs.stop() should be called before count_stops is destroyed
// also when func throws
BOOST_REQUIRE_EQUAL(stopped, 1);
});
});
}
SEASTAR_THREAD_TEST_CASE(move_open_gate_test) {
gate g1;
g1.enter();
// move an open gate
gate g2 = std::move(g1);
// the state in g1 should be moved into g2
BOOST_CHECK_EQUAL(g1.get_count(), 0);
BOOST_REQUIRE_EQUAL(g2.get_count(), 1);
g2.leave();
g2.close().get();
BOOST_CHECK(!g1.is_closed());
BOOST_CHECK(g2.is_closed());
}
SEASTAR_THREAD_TEST_CASE(move_closing_gate_test) {
gate g1;
g1.enter();
auto fut = g1.close();
// move a closing gate
gate g2 = std::move(g1);
BOOST_CHECK_EQUAL(g1.get_count(), 0);
BOOST_REQUIRE_EQUAL(g2.get_count(), 1);
g2.leave();
fut.get();
BOOST_CHECK(!g1.is_closed());
BOOST_CHECK(g2.is_closed());
}
SEASTAR_THREAD_TEST_CASE(move_closed_gate_test) {
gate g1;
g1.close().get();
// move a closed gate
gate g2 = std::move(g1);
BOOST_CHECK_EQUAL(g1.get_count(), 0);
BOOST_CHECK_EQUAL(g2.get_count(), 0);
BOOST_CHECK(!g1.is_closed());
BOOST_CHECK(g2.is_closed());
}
SEASTAR_THREAD_TEST_CASE(gate_holder_basic_test) {
gate g;
auto gh = g.hold();
auto fut = g.close();
BOOST_CHECK(!fut.available());
gh.release();
fut.get();
}
SEASTAR_THREAD_TEST_CASE(gate_holder_closed_test) {
gate g;
g.close().get();
BOOST_REQUIRE_THROW(g.hold(), gate_closed_exception);
}
SEASTAR_THREAD_TEST_CASE(gate_holder_move_test) {
gate g;
auto gh0 = g.hold();
auto fut = g.close();
BOOST_CHECK(!fut.available());
auto gh1 = std::move(gh0);
BOOST_CHECK(!fut.available());
gh1.release();
fut.get();
}
SEASTAR_THREAD_TEST_CASE(gate_holder_copy_test) {
gate g;
auto gh0 = g.hold();
auto gh1 = gh0;
auto fut = g.close();
BOOST_CHECK(!fut.available());
gh0.release();
BOOST_CHECK(!fut.available());
gh1.release();
fut.get();
}
SEASTAR_THREAD_TEST_CASE(gate_holder_copy_and_move_test) {
gate g0;
auto gh00 = g0.hold();
auto gh01 = gh00;
auto fut0 = g0.close();
BOOST_CHECK(!fut0.available());
gate g1;
auto gh1 = g1.hold();
auto fut1 = g1.close();
BOOST_CHECK(!fut1.available());
gh01.release();
BOOST_CHECK(!fut0.available());
BOOST_CHECK(!fut1.available());
gh00 = std::move(gh1);
fut0.get();
BOOST_CHECK(!fut1.available());
gh00.release();
fut1.get();
}
SEASTAR_THREAD_TEST_CASE(gate_holder_copy_after_close_test) {
gate g;
auto gh0 = g.hold();
auto fut = g.close();
BOOST_CHECK(g.is_closed());
gate::holder gh1 = gh0;
BOOST_CHECK(!fut.available());
gh0.release();
BOOST_CHECK(!fut.available());
gh1.release();
fut.get();
}
SEASTAR_TEST_CASE(gate_holder_parallel_copy_test) {
constexpr int expected = 42;
return do_with(0, [expected] (int& count) {
return with_closeable(gate(), [&] (gate& g) {
auto gh = g.hold();
// Copying the gate::holder in the lambda below should keep it open
// until all instances complete
(void)parallel_for_each(std::views::iota(0, expected), [&count, gh = gh] (int) {
count++;
return make_ready_future<>();
});
return 17;
}).then([&, expected] (int res) {
// res should be returned by the function called
// by with_closeable.
BOOST_REQUIRE_EQUAL(res, 17);
// closing the gate should wait for
// all background continuations to complete
BOOST_REQUIRE_EQUAL(count, expected);
});
});
}
SEASTAR_THREAD_TEST_CASE(gate_holder_try_close_test) {
gate g;
auto gh0 = g.try_hold();
BOOST_CHECK(gh0.has_value());
auto fut = g.close();
BOOST_CHECK(g.is_closed());
auto failed_gh = g.try_hold();
BOOST_CHECK(!failed_gh.has_value());
auto gh1 = std::move(gh0);
BOOST_CHECK(!fut.available());
gh0.reset();
BOOST_CHECK(!fut.available());
gh1.reset();
fut.get();
}
Definition: closeable.hh:49
Definition: closeable.hh:118
A representation of a possibly not-yet-computed value.
Definition: future.hh:1240
value_type && get()
gets the value returned by the computation
Definition: future.hh:1342
Definition: gate.hh:171
void release() noexcept
Leave the held gate.
Definition: gate.hh:270
Definition: gate.hh:48
Definition: gate.hh:61
bool is_closed() const noexcept
Returns whether the gate is closed.
Definition: gate.hh:158
future close() noexcept
Definition: gate.hh:143
size_t get_count() const noexcept
Returns a current number of registered in-progress requests.
Definition: gate.hh:153
void check() const
Definition: gate.hh:133
std::optional< holder > try_hold() noexcept
Definition: gate.hh:286
holder hold()
Definition: gate.hh:279
void enter()
Definition: gate.hh:109
void leave() noexcept
Definition: gate.hh:118
auto with_gate(gate &g, Func &&func)
Definition: gate.hh:333
auto do_with(T1 &&rv1, T2 &&rv2, More &&... more) noexcept
Definition: do_with.hh:135
future parallel_for_each(Iterator begin, Sentinel end, Func &&func) noexcept
Run tasks in parallel (iterator version).
Definition: loop.hh:568
futurize_t< std::invoke_result_t< Func, Args... > > async(thread_attributes attr, Func &&func, Args &&... args) noexcept
Definition: thread.hh:245
Seastar API namespace.
Definition: abort_on_ebadf.hh:26