mirror of
https://github.com/matrix-construct/construct
synced 2024-12-30 17:34:04 +01:00
64 lines
2.1 KiB
C++
64 lines
2.1 KiB
C++
// Matrix Construct
|
|
//
|
|
// Copyright (C) Matrix Construct Developers, Authors & Contributors
|
|
// Copyright (C) 2016-2018 Jason Volk <jason@zemos.net>
|
|
//
|
|
// 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 is present in all copies. The
|
|
// full license for this software is available in the LICENSE file.
|
|
|
|
#pragma once
|
|
#define HAVE_IRCD_NET_CLOSE_H
|
|
|
|
namespace ircd::net
|
|
{
|
|
enum class dc;
|
|
struct close_opts extern const close_opts_default;
|
|
using close_callback = std::function<void (std::exception_ptr)>;
|
|
|
|
// Callback-based closer.
|
|
void close(socket &, const close_opts &, close_callback);
|
|
|
|
// Future-based closer.
|
|
ctx::future<void> close(socket &, const close_opts & = close_opts_default);
|
|
|
|
// Fire-and-forget helper callback for close().
|
|
extern const close_callback close_ignore;
|
|
}
|
|
|
|
/// Types of disconnection. SSL_NOTIFY is the recommended type of
|
|
/// disconnection and is usually default. RST is an immediate
|
|
/// alternative which has no asynchronous operations.
|
|
enum class ircd::net::dc
|
|
{
|
|
RST, ///< hardest immediate termination
|
|
FIN, ///< sd graceful shutdown both directions
|
|
FIN_SEND, ///< sd graceful shutdown send side
|
|
FIN_RECV, ///< sd graceful shutdown recv side
|
|
SSL_NOTIFY, ///< SSL close_notify
|
|
};
|
|
|
|
/// Close options structure.
|
|
struct ircd::net::close_opts
|
|
{
|
|
close_opts() = default;
|
|
close_opts(const net::dc &);
|
|
|
|
/// The type of close() to be conducted is specified here.
|
|
net::dc type { dc::SSL_NOTIFY };
|
|
|
|
/// The coarse duration allowed for the close() process.
|
|
milliseconds timeout { 5000ms };
|
|
|
|
/// If specified, these socket options will be applied when conducting
|
|
/// the disconnect (useful for adding an SO_LINGER time etc).
|
|
const sock_opts *sopts { nullptr };
|
|
};
|
|
|
|
/// Allows for implicit construction of close_opts in arguments to close()
|
|
/// without requiring brackets for the close_opts& argument.
|
|
inline
|
|
ircd::net::close_opts::close_opts(const net::dc &type)
|
|
:type{type}
|
|
{}
|