|
bool | init () |
| Initializes the handle.
|
void | spawn (const char *file, char **args, char **env=nullptr) |
| spawn Starts the process.
|
void | kill (int signum) |
| Sends the specified signal to the internal process handle.
|
int | pid () noexcept |
| Gets the PID of the spawned process.
|
ProcessHandle & | cwd (const std::string &path) noexcept |
| Sets the current working directory for the subprocess.
|
ProcessHandle & | flags (Flags< Process > flags) noexcept |
| Sets flags that control how spawn() behaves.
|
template<typename T, typename U> |
ProcessHandle & | stdio (StreamHandle< T, U > &stream, Flags< StdIO > flags) |
| Makes a stdio handle available to the child process.
|
ProcessHandle & | stdio (FileHandle fd, Flags< StdIO > flags) |
| Makes a file descriptor available to the child process.
|
ProcessHandle & | uid (Uid id) |
| Sets the child process' user id.
|
ProcessHandle & | gid (Gid id) |
| Sets the child process' group id.
|
Public Member Functions inherited from uvw::Handle< ProcessHandle, uv_process_t > |
HandleCategory | category () const noexcept |
| Gets the category of the handle.
|
HandleType | type () const noexcept |
| Gets the type of the handle.
|
bool | active () const noexcept |
| Checks if the handle is active.
|
bool | closing () const noexcept |
| Checks if a handle is closing or closed.
|
void | close () noexcept |
| Request handle to be closed.
|
void | reference () noexcept |
| Reference the given handle.
|
void | unreference () noexcept |
| Unreference the given handle.
|
bool | referenced () const noexcept |
| Checks if the given handle referenced.
|
std::size_t | size () const noexcept |
| Returns the size of the underlying handle type.
|
int | sendBufferSize () |
| Gets the size of the send buffer used for the socket.
|
int | recvBufferSize () |
| Gets the size of the receive buffer used for the socket.
|
OSFileDescriptor | fd () const |
| Gets the platform dependent file descriptor equivalent.
|
std::shared_ptr< R > | data () const |
| Gets user-defined data. uvw won't use this field in any case.
|
Loop & | loop () const noexcept |
| Gets the loop from which the resource was originated.
|
const uv_process_t * | raw () const noexcept |
| Gets the underlying raw data structure.
|
Connection< E > | on (Listener< E > f) |
| Registers a long-lived listener with the event emitter.
|
Connection< E > | once (Listener< E > f) |
| Registers a short-lived listener with the event emitter.
|
void | erase (Connection< E > conn) noexcept |
| Disconnects a listener from the event emitter.
|
void | clear () noexcept |
| Disconnects all the listeners for the given event type.
|
bool | empty () const noexcept |
| Checks if there are listeners registered for the specific event.
|
The ProcessHandle handle.
Process handles will spawn a new process and allow the user to control it and establish communication channels with it using streams.
Definition at line 58 of file process.h.
void uvw::ProcessHandle::disableStdIOInheritance |
( |
| ) |
|
|
staticnoexcept |
Disables inheritance for file descriptors/handles.
Disables inheritance for file descriptors/handles that this process inherited from its parent. The effect is that child processes spawned by this process don’t accidentally inherit these handles.
It is recommended to call this function as early in your program as possible, before the inherited file descriptors can be closed or duplicated.
See the official documentation for further details.