include/boost/corosio/native/detail/reactor/reactor_op_complete.hpp

92.4% Lines (122/132) 100.0% List of functions (40/40)

[ ] prev/next file n p prev/next uncovered line

reactor_op_complete.hpp

f(x) Functions (40)

Function Calls Lines Blocks

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_NATIVE_DETAIL_REACTOR_REACTOR_OP_COMPLETE_HPP
11		#define BOOST_COROSIO_NATIVE_DETAIL_REACTOR_REACTOR_OP_COMPLETE_HPP
12
13		#include <boost/corosio/detail/dispatch_coro.hpp>
14		#include <boost/corosio/native/detail/endpoint_convert.hpp>
15		#include <boost/corosio/native/detail/make_err.hpp>
16		#include <boost/corosio/io/io_object.hpp>
17
18		#include <coroutine>
19		#include <mutex>
20		#include <utility>
21
22		#include <netinet/in.h>
23		#include <sys/socket.h>
24		#include <unistd.h>
25
26		namespace boost::corosio::detail {
27
28		/** Complete a base read/write operation.
29
30		Translates the recorded errno and cancellation state into
31		an error_code, stores the byte count, then resumes the
32		caller via symmetric transfer.
33
34		@tparam Op The concrete operation type.
35		@param op The operation to complete.
36		*/
37		template<typename Op>
38		void
39	87869x	complete_io_op(Op& op)
40		{
41	87869x	op.stop_cb.reset();
42	87869x	op.socket_impl_->desc_state_.scheduler_->reset_inline_budget();
43
44	87869x	if (op.cancelled.load(std::memory_order_acquire))
45	306x	*op.ec_out = capy::error::canceled;
46	87563x	else if (op.errn != 0)
47	✗	*op.ec_out = make_err(op.errn);
48	87563x	else if (op.is_read_operation() && op.bytes_transferred == 0)
49	3x	*op.ec_out = capy::error::eof;
50		else
51	87560x	*op.ec_out = {};
52
53	87869x	*op.bytes_out = op.bytes_transferred;
54
55	87869x	op.cont_op.cont.h = op.h;
56	87869x	capy::executor_ref saved_ex(op.ex);
57	87869x	auto prevent = std::move(op.impl_ptr);
58	87869x	dispatch_coro(saved_ex, op.cont_op.cont).resume();
59	87869x	}
60
61		/** Complete a datagram recv operation (connected mode).
62
63		Like complete_io_op but does not translate zero bytes into
64		EOF. Zero-length datagrams are valid and should be reported
65		as success with 0 bytes transferred.
66
67		@param op The operation to complete.
68		*/
69		template<typename Op>
70		void
71		complete_dgram_recv_op(Op& op)
72		{
73		op.stop_cb.reset();
74		op.socket_impl_->desc_state_.scheduler_->reset_inline_budget();
75
76		if (op.cancelled.load(std::memory_order_acquire))
77		*op.ec_out = capy::error::canceled;
78		else if (op.errn != 0)
79		*op.ec_out = make_err(op.errn);
80		else
81		*op.ec_out = {};
82
83		*op.bytes_out = op.bytes_transferred;
84
85		op.cont_op.cont.h = op.h;
86		capy::executor_ref saved_ex(op.ex);
87		auto prevent = std::move(op.impl_ptr);
88		dispatch_coro(saved_ex, op.cont_op.cont).resume();
89		}
90
91		/** Complete a wait operation.
92
93		Wait operations report only an error_code — no bytes_transferred,
94		no EOF translation. Used for socket and acceptor wait() awaitables;
95		picks the impl pointer set by start() to reach the scheduler.
96
97		@tparam Op The concrete wait operation type.
98		@param op The operation to complete.
99		*/
100		template<typename Op>
101		void
102	56x	complete_wait_op(Op& op)
103		{
104	56x	op.stop_cb.reset();
105	56x	if (op.socket_impl_)
106	44x	op.socket_impl_->desc_state_.scheduler_->reset_inline_budget();
107		else
108	12x	op.acceptor_impl_->desc_state_.scheduler_->reset_inline_budget();
109
110	56x	if (op.cancelled.load(std::memory_order_acquire))
111	26x	*op.ec_out = capy::error::canceled;
112	30x	else if (op.errn != 0)
113	✗	*op.ec_out = make_err(op.errn);
114		else
115	30x	*op.ec_out = {};
116
117	56x	op.cont_op.cont.h = op.h;
118	56x	capy::executor_ref saved_ex(op.ex);
119	56x	auto prevent = std::move(op.impl_ptr);
120	56x	dispatch_coro(saved_ex, op.cont_op.cont).resume();
121	56x	}
122
123		/** Complete a connect operation with endpoint caching.
124
125		On success, queries the local endpoint via getsockname and
126		caches both endpoints in the socket impl. Then resumes the
127		caller via symmetric transfer.
128
129		@tparam Op The concrete connect operation type.
130		@param op The operation to complete.
131		*/
132		template<typename Op>
133		void
134	8347x	complete_connect_op(Op& op)
135		{
136	8347x	op.stop_cb.reset();
137	8347x	op.socket_impl_->desc_state_.scheduler_->reset_inline_budget();
138
139	8347x	bool success =
140	8347x	(op.errn == 0 && !op.cancelled.load(std::memory_order_acquire));
141
142	8347x	if (success && op.socket_impl_)
143		{
144		using ep_type = decltype(op.target_endpoint);
145	8321x	ep_type local_ep;
146	8321x	sockaddr_storage local_storage{};
147	8321x	socklen_t local_len = sizeof(local_storage);
148	8321x	if (::getsockname(
149		op.fd, reinterpret_cast<sockaddr*>(&local_storage),
150	8321x	&local_len) == 0)
151	8301x	local_ep =
152	8321x	from_sockaddr_as(local_storage, local_len, ep_type{});
153	8321x	op.socket_impl_->set_endpoints(local_ep, op.target_endpoint);
154		}
155
156	8347x	if (op.cancelled.load(std::memory_order_acquire))
157	2x	*op.ec_out = capy::error::canceled;
158	8345x	else if (op.errn != 0)
159	24x	*op.ec_out = make_err(op.errn);
160		else
161	8321x	*op.ec_out = {};
162
163	8347x	op.cont_op.cont.h = op.h;
164	8347x	capy::executor_ref saved_ex(op.ex);
165	8347x	auto prevent = std::move(op.impl_ptr);
166	8347x	dispatch_coro(saved_ex, op.cont_op.cont).resume();
167	8347x	}
168
169		/** Construct and register a peer socket from an accepted fd.
170
171		Creates a new socket impl via the acceptor's associated
172		socket service, registers it with the scheduler, and caches
173		the local and remote endpoints.
174
175		@tparam SocketImpl The concrete socket implementation type.
176		@tparam AcceptorImpl The concrete acceptor implementation type.
177		@param acceptor_impl The acceptor that accepted the connection.
178		@param accepted_fd The accepted file descriptor (set to -1 on success).
179		@param peer_storage The peer address from accept().
180		@param impl_out Output pointer for the new socket impl.
181		@param ec_out Output pointer for any error.
182		@return True on success, false on failure.
183		*/
184		template<typename SocketImpl, typename AcceptorImpl>
185		bool
186	8291x	setup_accepted_socket(
187		AcceptorImpl* acceptor_impl,
188		int& accepted_fd,
189		sockaddr_storage const& peer_storage,
190		socklen_t peer_addrlen,
191		io_object::implementation** impl_out,
192		std::error_code* ec_out)
193		{
194	8291x	auto* socket_svc = acceptor_impl->service().stream_service();
195	8291x	if (!socket_svc)
196		{
197	✗	*ec_out = make_err(ENOENT);
198	✗	return false;
199		}
200
201	8291x	auto& impl = static_cast<SocketImpl&>(*socket_svc->construct());
202	8291x	impl.set_socket(accepted_fd);
203
204	8291x	impl.desc_state_.fd = accepted_fd;
205		{
206	8291x	std::lock_guard lock(impl.desc_state_.mutex);
207	8291x	impl.desc_state_.read_op = nullptr;
208	8291x	impl.desc_state_.write_op = nullptr;
209	8291x	impl.desc_state_.connect_op = nullptr;
210	8291x	}
211	8291x	socket_svc->scheduler().register_descriptor(accepted_fd, &impl.desc_state_);
212
213		using ep_type = decltype(acceptor_impl->local_endpoint());
214	8291x	impl.set_endpoints(
215		acceptor_impl->local_endpoint(),
216	8291x	from_sockaddr_as(
217		peer_storage,
218		peer_addrlen,
219		ep_type{}));
220
221	8291x	if (impl_out)
222	8291x	*impl_out = &impl;
223	8291x	accepted_fd = -1;
224	8291x	return true;
225		}
226
227		/** Complete an accept operation.
228
229		Sets up the peer socket on success, or closes the accepted
230		fd on failure. Then resumes the caller via symmetric transfer.
231
232		@tparam SocketImpl The concrete socket implementation type.
233		@tparam Op The concrete accept operation type.
234		@param op The operation to complete.
235		*/
236		template<typename SocketImpl, typename Op>
237		void
238	8311x	complete_accept_op(Op& op)
239		{
240	8311x	op.stop_cb.reset();
241	8311x	op.acceptor_impl_->desc_state_.scheduler_->reset_inline_budget();
242
243	8311x	bool success =
244	8311x	(op.errn == 0 && !op.cancelled.load(std::memory_order_acquire));
245
246	8311x	if (op.cancelled.load(std::memory_order_acquire))
247	20x	*op.ec_out = capy::error::canceled;
248	8291x	else if (op.errn != 0)
249	✗	*op.ec_out = make_err(op.errn);
250		else
251	8291x	*op.ec_out = {};
252
253	8311x	if (success && op.accepted_fd >= 0 && op.acceptor_impl_)
254		{
255	8291x	if (!setup_accepted_socket<SocketImpl>(
256	8291x	op.acceptor_impl_, op.accepted_fd, op.peer_storage,
257		op.peer_addrlen, op.impl_out, op.ec_out))
258	✗	success = false;
259		}
260
261	8311x	if (!success \|\| !op.acceptor_impl_)
262		{
263	20x	if (op.accepted_fd >= 0)
264		{
265	✗	::close(op.accepted_fd);
266	✗	op.accepted_fd = -1;
267		}
268	20x	if (op.impl_out)
269	20x	*op.impl_out = nullptr;
270		}
271
272	8311x	op.cont_op.cont.h = op.h;
273	8311x	capy::executor_ref saved_ex(op.ex);
274	8311x	auto prevent = std::move(op.impl_ptr);
275	8311x	dispatch_coro(saved_ex, op.cont_op.cont).resume();
276	8311x	}
277
278		/** Complete a datagram operation (send_to or recv_from).
279
280		For recv_from operations, writes the source endpoint from the
281		recorded sockaddr_storage into the caller's endpoint pointer.
282		Then resumes the caller via symmetric transfer.
283
284		@tparam Op The concrete datagram operation type.
285		@param op The operation to complete.
286		*/
287		template<typename Op>
288		void
289	18x	complete_datagram_op(Op& op)
290		{
291	18x	op.stop_cb.reset();
292	18x	op.socket_impl_->desc_state_.scheduler_->reset_inline_budget();
293
294	18x	if (op.cancelled.load(std::memory_order_acquire))
295	6x	*op.ec_out = capy::error::canceled;
296	12x	else if (op.errn != 0)
297	✗	*op.ec_out = make_err(op.errn);
298		else
299	12x	*op.ec_out = {};
300
301	18x	*op.bytes_out = op.bytes_transferred;
302
303	18x	op.cont_op.cont.h = op.h;
304	18x	capy::executor_ref saved_ex(op.ex);
305	18x	auto prevent = std::move(op.impl_ptr);
306	18x	dispatch_coro(saved_ex, op.cont_op.cont).resume();
307	18x	}
308
309		/** Complete a datagram operation with source endpoint capture.
310
311		For recv_from operations, writes the source endpoint from the
312		recorded sockaddr_storage into the caller's endpoint pointer.
313		Then resumes the caller via symmetric transfer.
314
315		@tparam Op The concrete datagram operation type.
316		@param op The operation to complete.
317		@param source_out Optional pointer to store source endpoint
318		(non-null for recv_from, null for send_to).
319		*/
320		template<typename Op, typename Endpoint>
321		void
322	26x	complete_datagram_op(Op& op, Endpoint* source_out)
323		{
324	26x	op.stop_cb.reset();
325	26x	op.socket_impl_->desc_state_.scheduler_->reset_inline_budget();
326
327	26x	if (op.cancelled.load(std::memory_order_acquire))
328	12x	*op.ec_out = capy::error::canceled;
329	14x	else if (op.errn != 0)
330	✗	*op.ec_out = make_err(op.errn);
331		else
332	14x	*op.ec_out = {};
333
334	26x	*op.bytes_out = op.bytes_transferred;
335
336	36x	if (source_out && !op.cancelled.load(std::memory_order_acquire) &&
337	10x	op.errn == 0)
338	20x	*source_out = from_sockaddr_as(
339	10x	op.source_storage,
340		op.source_addrlen,
341		Endpoint{});
342
343	26x	op.cont_op.cont.h = op.h;
344	26x	capy::executor_ref saved_ex(op.ex);
345	26x	auto prevent = std::move(op.impl_ptr);
346	26x	dispatch_coro(saved_ex, op.cont_op.cont).resume();
347	26x	}
348
349		} // namespace boost::corosio::detail
350
351		#endif // BOOST_COROSIO_NATIVE_DETAIL_REACTOR_REACTOR_OP_COMPLETE_HPP
352