Files
rippled/src/test/overlay/short_read_test.cpp
Scott Schurr 0839a202c9 Reduce console noise coming from unit tests:
A few unit tests have historically generated a lot of noise
to the console from log writes.  This noise was not useful
and made it harder to locate actual test failures.

By changing the log level of these tests from
- severities::kError to
- severities::kDisabled
it was possible to remove that noise coming from the logs.
2022-07-17 22:17:24 -07:00

659 lines
20 KiB
C++

//------------------------------------------------------------------------------
/*
This file is part of rippled: https://github.com/ripple/rippled
Copyright 2014 Ripple Labs Inc.
Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/
//==============================================================================
#include <ripple/basics/make_SSLContext.h>
#include <ripple/beast/core/CurrentThreadName.h>
#include <ripple/beast/unit_test.h>
#include <test/jtx/envconfig.h>
#include <boost/asio.hpp>
#include <boost/asio/ssl.hpp>
#include <boost/utility/in_place_factory.hpp>
#include <cassert>
#include <condition_variable>
#include <functional>
#include <memory>
#include <optional>
#include <thread>
#include <utility>
namespace ripple {
/*
Findings from the test:
If the remote host calls async_shutdown then the local host's
async_read will complete with eof.
If both hosts call async_shutdown then the calls to async_shutdown
will complete with eof.
*/
class short_read_test : public beast::unit_test::suite
{
private:
using io_context_type = boost::asio::io_context;
using strand_type = boost::asio::io_context::strand;
using timer_type =
boost::asio::basic_waitable_timer<std::chrono::steady_clock>;
using acceptor_type = boost::asio::ip::tcp::acceptor;
using socket_type = boost::asio::ip::tcp::socket;
using stream_type = boost::asio::ssl::stream<socket_type&>;
using error_code = boost::system::error_code;
using endpoint_type = boost::asio::ip::tcp::endpoint;
using address_type = boost::asio::ip::address;
io_context_type io_context_;
std::optional<boost::asio::executor_work_guard<boost::asio::executor>>
work_;
std::thread thread_;
std::shared_ptr<boost::asio::ssl::context> context_;
template <class Streambuf>
static void
write(Streambuf& sb, std::string const& s)
{
using boost::asio::buffer;
using boost::asio::buffer_copy;
using boost::asio::buffer_size;
boost::asio::const_buffers_1 buf(s.data(), s.size());
sb.commit(buffer_copy(sb.prepare(buffer_size(buf)), buf));
}
//--------------------------------------------------------------------------
class Base
{
protected:
class Child
{
private:
Base& base_;
public:
explicit Child(Base& base) : base_(base)
{
}
virtual ~Child()
{
base_.remove(this);
}
virtual void
close() = 0;
};
private:
std::mutex mutex_;
std::condition_variable cond_;
std::map<Child*, std::weak_ptr<Child>> list_;
bool closed_ = false;
public:
~Base()
{
// Derived class must call wait() in the destructor
assert(list_.empty());
}
void
add(std::shared_ptr<Child> const& child)
{
std::lock_guard lock(mutex_);
list_.emplace(child.get(), child);
}
void
remove(Child* child)
{
std::lock_guard lock(mutex_);
list_.erase(child);
if (list_.empty())
cond_.notify_one();
}
void
close()
{
std::vector<std::shared_ptr<Child>> v;
{
std::lock_guard lock(mutex_);
v.reserve(list_.size());
if (closed_)
return;
closed_ = true;
for (auto const& c : list_)
{
if (auto p = c.second.lock())
{
p->close();
// Must destroy shared_ptr outside the
// lock otherwise deadlock from the
// managed object's destructor.
v.emplace_back(std::move(p));
}
}
}
}
void
wait()
{
std::unique_lock<std::mutex> lock(mutex_);
while (!list_.empty())
cond_.wait(lock);
}
};
//--------------------------------------------------------------------------
class Server : public Base
{
private:
short_read_test& test_;
endpoint_type endpoint_;
struct Acceptor : Child, std::enable_shared_from_this<Acceptor>
{
Server& server_;
short_read_test& test_;
acceptor_type acceptor_;
socket_type socket_;
strand_type strand_;
explicit Acceptor(Server& server)
: Child(server)
, server_(server)
, test_(server_.test_)
, acceptor_(
test_.io_context_,
endpoint_type(
beast::IP::Address::from_string(
test::getEnvLocalhostAddr()),
0))
, socket_(test_.io_context_)
, strand_(test_.io_context_)
{
acceptor_.listen();
server_.endpoint_ = acceptor_.local_endpoint();
}
void
close() override
{
if (!strand_.running_in_this_thread())
return post(
strand_,
std::bind(&Acceptor::close, shared_from_this()));
acceptor_.close();
}
void
run()
{
acceptor_.async_accept(
socket_,
bind_executor(
strand_,
std::bind(
&Acceptor::on_accept,
shared_from_this(),
std::placeholders::_1)));
}
void
fail(std::string const& what, error_code ec)
{
if (acceptor_.is_open())
{
if (ec != boost::asio::error::operation_aborted)
test_.log << what << ": " << ec.message() << std::endl;
acceptor_.close();
}
}
void
on_accept(error_code ec)
{
if (ec)
return fail("accept", ec);
auto const p =
std::make_shared<Connection>(server_, std::move(socket_));
server_.add(p);
p->run();
acceptor_.async_accept(
socket_,
bind_executor(
strand_,
std::bind(
&Acceptor::on_accept,
shared_from_this(),
std::placeholders::_1)));
}
};
struct Connection : Child, std::enable_shared_from_this<Connection>
{
Server& server_;
short_read_test& test_;
socket_type socket_;
stream_type stream_;
strand_type strand_;
timer_type timer_;
boost::asio::streambuf buf_;
Connection(Server& server, socket_type&& socket)
: Child(server)
, server_(server)
, test_(server_.test_)
, socket_(std::move(socket))
, stream_(socket_, *test_.context_)
, strand_(test_.io_context_)
, timer_(test_.io_context_)
{
}
void
close() override
{
if (!strand_.running_in_this_thread())
return post(
strand_,
std::bind(&Connection::close, shared_from_this()));
if (socket_.is_open())
{
socket_.close();
timer_.cancel();
}
}
void
run()
{
timer_.expires_from_now(std::chrono::seconds(3));
timer_.async_wait(bind_executor(
strand_,
std::bind(
&Connection::on_timer,
shared_from_this(),
std::placeholders::_1)));
stream_.async_handshake(
stream_type::server,
bind_executor(
strand_,
std::bind(
&Connection::on_handshake,
shared_from_this(),
std::placeholders::_1)));
}
void
fail(std::string const& what, error_code ec)
{
if (socket_.is_open())
{
if (ec != boost::asio::error::operation_aborted)
test_.log << "[server] " << what << ": " << ec.message()
<< std::endl;
socket_.close();
timer_.cancel();
}
}
void
on_timer(error_code ec)
{
if (ec == boost::asio::error::operation_aborted)
return;
if (ec)
return fail("timer", ec);
test_.log << "[server] timeout" << std::endl;
socket_.close();
}
void
on_handshake(error_code ec)
{
if (ec)
return fail("handshake", ec);
#if 1
boost::asio::async_read_until(
stream_,
buf_,
"\n",
bind_executor(
strand_,
std::bind(
&Connection::on_read,
shared_from_this(),
std::placeholders::_1,
std::placeholders::_2)));
#else
close();
#endif
}
void
on_read(error_code ec, std::size_t bytes_transferred)
{
if (ec == boost::asio::error::eof)
{
server_.test_.log << "[server] read: EOF" << std::endl;
return stream_.async_shutdown(bind_executor(
strand_,
std::bind(
&Connection::on_shutdown,
shared_from_this(),
std::placeholders::_1)));
}
if (ec)
return fail("read", ec);
buf_.commit(bytes_transferred);
buf_.consume(bytes_transferred);
write(buf_, "BYE\n");
boost::asio::async_write(
stream_,
buf_.data(),
bind_executor(
strand_,
std::bind(
&Connection::on_write,
shared_from_this(),
std::placeholders::_1,
std::placeholders::_2)));
}
void
on_write(error_code ec, std::size_t bytes_transferred)
{
buf_.consume(bytes_transferred);
if (ec)
return fail("write", ec);
stream_.async_shutdown(bind_executor(
strand_,
std::bind(
&Connection::on_shutdown,
shared_from_this(),
std::placeholders::_1)));
}
void
on_shutdown(error_code ec)
{
if (ec)
return fail("shutdown", ec);
socket_.close();
timer_.cancel();
}
};
public:
explicit Server(short_read_test& test) : test_(test)
{
auto const p = std::make_shared<Acceptor>(*this);
add(p);
p->run();
}
~Server()
{
close();
wait();
}
endpoint_type const&
endpoint() const
{
return endpoint_;
}
};
//--------------------------------------------------------------------------
class Client : public Base
{
private:
short_read_test& test_;
struct Connection : Child, std::enable_shared_from_this<Connection>
{
Client& client_;
short_read_test& test_;
socket_type socket_;
stream_type stream_;
strand_type strand_;
timer_type timer_;
boost::asio::streambuf buf_;
endpoint_type const& ep_;
Connection(Client& client, endpoint_type const& ep)
: Child(client)
, client_(client)
, test_(client_.test_)
, socket_(test_.io_context_)
, stream_(socket_, *test_.context_)
, strand_(test_.io_context_)
, timer_(test_.io_context_)
, ep_(ep)
{
}
void
close() override
{
if (!strand_.running_in_this_thread())
return post(
strand_,
std::bind(&Connection::close, shared_from_this()));
if (socket_.is_open())
{
socket_.close();
timer_.cancel();
}
}
void
run(endpoint_type const& ep)
{
timer_.expires_from_now(std::chrono::seconds(3));
timer_.async_wait(bind_executor(
strand_,
std::bind(
&Connection::on_timer,
shared_from_this(),
std::placeholders::_1)));
socket_.async_connect(
ep,
bind_executor(
strand_,
std::bind(
&Connection::on_connect,
shared_from_this(),
std::placeholders::_1)));
}
void
fail(std::string const& what, error_code ec)
{
if (socket_.is_open())
{
if (ec != boost::asio::error::operation_aborted)
test_.log << "[client] " << what << ": " << ec.message()
<< std::endl;
socket_.close();
timer_.cancel();
}
}
void
on_timer(error_code ec)
{
if (ec == boost::asio::error::operation_aborted)
return;
if (ec)
return fail("timer", ec);
test_.log << "[client] timeout";
socket_.close();
}
void
on_connect(error_code ec)
{
if (ec)
return fail("connect", ec);
stream_.async_handshake(
stream_type::client,
bind_executor(
strand_,
std::bind(
&Connection::on_handshake,
shared_from_this(),
std::placeholders::_1)));
}
void
on_handshake(error_code ec)
{
if (ec)
return fail("handshake", ec);
write(buf_, "HELLO\n");
#if 1
boost::asio::async_write(
stream_,
buf_.data(),
bind_executor(
strand_,
std::bind(
&Connection::on_write,
shared_from_this(),
std::placeholders::_1,
std::placeholders::_2)));
#else
stream_.async_shutdown(bind_executor(
strand_,
std::bind(
&Connection::on_shutdown,
shared_from_this(),
std::placeholders::_1)));
#endif
}
void
on_write(error_code ec, std::size_t bytes_transferred)
{
buf_.consume(bytes_transferred);
if (ec)
return fail("write", ec);
#if 1
boost::asio::async_read_until(
stream_,
buf_,
"\n",
bind_executor(
strand_,
std::bind(
&Connection::on_read,
shared_from_this(),
std::placeholders::_1,
std::placeholders::_2)));
#else
stream_.async_shutdown(bind_executor(
strand_,
std::bind(
&Connection::on_shutdown,
shared_from_this(),
std::placeholders::_1)));
#endif
}
void
on_read(error_code ec, std::size_t bytes_transferred)
{
if (ec)
return fail("read", ec);
buf_.commit(bytes_transferred);
stream_.async_shutdown(bind_executor(
strand_,
std::bind(
&Connection::on_shutdown,
shared_from_this(),
std::placeholders::_1)));
}
void
on_shutdown(error_code ec)
{
if (ec)
return fail("shutdown", ec);
socket_.close();
timer_.cancel();
}
};
public:
Client(short_read_test& test, endpoint_type const& ep) : test_(test)
{
auto const p = std::make_shared<Connection>(*this, ep);
add(p);
p->run(ep);
}
~Client()
{
close();
wait();
}
};
public:
short_read_test()
: work_(io_context_.get_executor())
, thread_(std::thread([this]() {
beast::setCurrentThreadName("io_context");
this->io_context_.run();
}))
, context_(make_SSLContext(""))
{
}
~short_read_test()
{
work_.reset();
thread_.join();
}
void
run() override
{
Server s(*this);
Client c(*this, s.endpoint());
c.wait();
pass();
}
};
BEAST_DEFINE_TESTSUITE(short_read, overlay, ripple);
} // namespace ripple