// // process/exit_code.hpp // ~~~~~~~~~~~~~~ // // Copyright (c) 2022 Klemens D. Morgenstern (klemens dot morgenstern at gmx dot net) // // Distributed under the Boost Software License, Version 1.0. (See accompanying // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) // #ifndef BOOST_PROCESS_V2_EXIT_CODE_HPP #define BOOST_PROCESS_V2_EXIT_CODE_HPP #include #include #if defined(BOOST_PROCESS_V2_STANDALONE) #include #include #else #include #include #endif #if defined(BOOST_PROCESS_V2_POSIX) #include #endif BOOST_PROCESS_V2_BEGIN_NAMESPACE #if defined(GENERATING_DOCUMENTATION) /// The native exit-code type, usually an integral value /** The OS may have a value different from `int` to represent * the exit codes of subprocesses. It might also * contain additional information. */ typedef implementation_defined native_exit_code_type; /// Check if the native exit code indicates the process is still running bool process_is_running(native_exit_code_type code); /// Obtain the portable part of the exit code, i.e. what the subprocess has returned from main. int evaluate_exit_code(native_exit_code_type code); #else #if defined(BOOST_PROCESS_V2_WINDOWS) typedef unsigned long native_exit_code_type; namespace detail { constexpr native_exit_code_type still_active = 259u; } inline bool process_is_running(native_exit_code_type code) { return code == detail::still_active; } inline int evaluate_exit_code(native_exit_code_type code) { return static_cast(code); } #else typedef int native_exit_code_type; namespace detail { constexpr native_exit_code_type still_active = 0x7f; } inline bool process_is_running(int code) { return !WIFEXITED(code) && !WIFSIGNALED(code); } inline int evaluate_exit_code(int code) { if (WIFEXITED(code)) return WEXITSTATUS(code); else if (WIFSIGNALED(code)) return WTERMSIG(code); else return code; } #endif #endif /** Convert the exit-code in a completion into an error if the actual error isn't set. * @code {.cpp} * process proc{ctx, "exit", {"1"}}; * * proc.async_wait(code_as_error( * [](error_code ec) * { * assert(ec.value() == 10); * assert(ec.category() == error::get_exit_code_category()); * })); * * @endcode */ template struct code_as_error_t { CompletionToken token_; const error_category & category; template code_as_error_t(Token_ && token, const error_category & category) : token_(std::forward(token)), category(category) { } }; /// Deduction function for code_as_error_t. template code_as_error_t code_as_error( CompletionToken && token, const error_category & category = error::get_exit_code_category()) { return code_as_error_t::type>( std::forward(token), category); }; namespace detail { template struct code_as_error_handler { typedef void result_type; template code_as_error_handler(H && h, const error_category & category) : handler_(std::forward(h)), category(category) { } void operator()(error_code ec, native_exit_code_type code) { if (!ec) ec.assign(code, category); std::move(handler_)(ec); } Handler handler_; const error_category & category; }; } BOOST_PROCESS_V2_END_NAMESPACE #if !defined(BOOST_PROCESS_V2_STANDALONE) namespace boost { #endif namespace asio { template struct async_result< BOOST_PROCESS_V2_NAMESPACE::code_as_error_t, void(BOOST_PROCESS_V2_NAMESPACE::error_code, BOOST_PROCESS_V2_NAMESPACE::native_exit_code_type)> { using signature = void(BOOST_PROCESS_V2_NAMESPACE::error_code); using return_type = typename async_result::return_type; template struct init_wrapper { init_wrapper(Initiation init) : initiation_(std::move(init)) { } template void operator()( Handler && handler, const BOOST_PROCESS_V2_NAMESPACE::error_category & cat, Args && ... args) { std::move(initiation_)( BOOST_PROCESS_V2_NAMESPACE::detail::code_as_error_handler::type>( std::forward(handler), cat), std::forward(args)...); } Initiation initiation_; }; template static BOOST_PROCESS_V2_INITFN_DEDUCED_RESULT_TYPE(CompletionToken, signature, (async_initiate( declval::type> >(), declval(), declval()...))) initiate( Initiation && initiation, RawCompletionToken && token, Args &&... args) { return async_initiate( init_wrapper::type>( std::forward(initiation)), token.token_, token.category, std::forward(args)...); } }; template