76 lines
2.8 KiB
C++
76 lines
2.8 KiB
C++
// Copyright (c) 2016 Klemens D. Morgenstern
|
|
//
|
|
// 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_POSIX_HPP_
|
|
#define BOOST_PROCESS_POSIX_HPP_
|
|
|
|
#include <boost/process/detail/posix/fd.hpp>
|
|
#include <boost/process/detail/posix/handler.hpp>
|
|
#include <boost/process/detail/posix/use_vfork.hpp>
|
|
#include <boost/process/detail/posix/signal.hpp>
|
|
|
|
|
|
/** \file boost/process/posix.hpp
|
|
*
|
|
* Header which provides the posix extensions.
|
|
\xmlonly
|
|
<programlisting>
|
|
namespace boost {
|
|
namespace process {
|
|
namespace posix {
|
|
<emphasis>unspecified</emphasis> <globalname alt="boost::process::posix::fd">fd</globalname>;
|
|
<emphasis>unspecified</emphasis> <globalname alt="boost::process::posix::sig">sig</globalname>;
|
|
<emphasis>unspecified</emphasis> <globalname alt="boost::process::posix::use_vfork">use_vfork</globalname>;
|
|
}
|
|
}
|
|
}
|
|
</programlisting>
|
|
* \endxmlonly
|
|
* \warning Only available on posix. See the documentation of [fork](http://pubs.opengroup.org/onlinepubs/009695399/functions/fork.html),
|
|
* [execve](http://pubs.opengroup.org/onlinepubs/009695399/functions/execve.html) and
|
|
* [vfork](http://pubs.opengroup.org/onlinepubs/009695399/functions/vfork.html).
|
|
*
|
|
*/
|
|
|
|
namespace boost { namespace process {
|
|
|
|
///Namespace containing the posix exensions.
|
|
namespace posix {
|
|
|
|
/** This property lets you modify file-descriptors other than the standard ones (0,1,2).
|
|
*
|
|
* It provides the functions `bind`, which implements [dup2](http://pubs.opengroup.org/onlinepubs/9699919799/functions/dup.html)
|
|
* and [close](http://pubs.opengroup.org/onlinepubs/9699919799/functions/close.html).
|
|
*
|
|
* Close can also be called with a range of file-descriptors to be closed.
|
|
*
|
|
*/
|
|
constexpr ::boost::process::detail::posix::fd_ fd;
|
|
|
|
/** This property lets you modify the handling of `SIGCHLD` for this call. It will be reset afterwards.
|
|
|
|
It can be set to default, by the expression `sig.dfl()`, set to ignore with `sig.ign()` or
|
|
assigned a custom handler. A custom handler must have the type `sighandler_t`and can be assigned with the following syntax:
|
|
|
|
\code{.cpp}
|
|
sig = handler;
|
|
sig(handler);
|
|
\endcode
|
|
|
|
\warning @ref spawn will automatically use `sig.ign()`, which will override if you pass a custom handler.
|
|
*/
|
|
constexpr ::boost::process::detail::posix::sig_ sig;
|
|
/** This property will replace the usage of [fork](http://pubs.opengroup.org/onlinepubs/9699919799/functions/fork.html) by [vfork](http://pubs.opengroup.org/onlinepubs/009695399/functions/vfork.html).
|
|
\note `vfork` is no longer an official part of the posix standard.
|
|
|
|
*/
|
|
constexpr ::boost::process::detail::posix::use_vfork_ use_vfork;
|
|
|
|
|
|
using ::boost::process::detail::posix::sighandler_t;
|
|
|
|
}}}
|
|
|
|
#endif /* BOOST_PROCESS_POSIX_HPP_ */
|