include/boost/corosio/detail/acceptor_service.hpp

100.0% Lines (2/2) 100.0% Functions (2/2)

Line	Hits	Source Code
1		//
2		// Copyright (c) 2026 Steve Gerbino
3		//
4		// Distributed under the Boost Software License, Version 1.0. (See accompanying
5		// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
6		//
7		// Official repository: https://github.com/cppalliance/corosio
8		//
9
10		#ifndef BOOST_COROSIO_DETAIL_ACCEPTOR_SERVICE_HPP
11		#define BOOST_COROSIO_DETAIL_ACCEPTOR_SERVICE_HPP
12
13		#include <boost/corosio/detail/config.hpp>
14		#include <boost/corosio/tcp_acceptor.hpp>
15		#include <boost/corosio/endpoint.hpp>
16		#include <boost/capy/ex/execution_context.hpp>
17		#include <system_error>
18
19		namespace boost::corosio::detail {
20
21		/** Abstract acceptor service base class.
22
23		Concrete implementations ( epoll_acceptors, select_acceptors, etc. )
24		inherit from this class and provide platform-specific acceptor
25		operations. The context constructor installs whichever backend
26		via `make_service`, and `tcp_acceptor.cpp` retrieves it via
27		`use_service<acceptor_service>()`.
28		*/
29		class BOOST_COROSIO_DECL acceptor_service
30		: public capy::execution_context::service
31		, public io_object::io_service
32		{
33		public:
34		/// Identifies this service for `execution_context` lookup.
35		using key_type = acceptor_service;
36
37		/** Open an acceptor.
38
39		Creates an IPv4 TCP socket, binds it to the specified endpoint,
40		and begins listening for incoming connections.
41
42		@param impl The acceptor implementation to open.
43		@param ep The local endpoint to bind to.
44		@param backlog The maximum length of the queue of pending connections.
45		@return Error code on failure, empty on success.
46		*/
47		virtual std::error_code open_acceptor(
48		tcp_acceptor::implementation& impl, endpoint ep, int backlog) = 0;
49
50		protected:
51		/// Construct the acceptor service.
52	340	acceptor_service() = default;
53
54		/// Destroy the acceptor service.
55	340	~acceptor_service() override = default;
56		};
57
58		} // namespace boost::corosio::detail
59
60		#endif // BOOST_COROSIO_DETAIL_ACCEPTOR_SERVICE_HPP
61