com.oracle.libuv

Class ProcessHandle

java.lang.Object

com.oracle.libuv.Handle

com.oracle.libuv.ProcessHandle

All Implemented Interfaces:

Closeable, AutoCloseable

public class ProcessHandle
extends Handle

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ProcessHandle.ProcessFlags

Field Summary

Fields inherited from class com.oracle.libuv.Handle

loop, pointer

Method Summary

Modifier and Type	Method and Description
void	close()
int	kill(int signal) Sends the specified signal to the given process handle.
void	setCloseCallback(ProcessCloseCallback callback)
void	setExitCallback(ProcessExitCallback callback)
int	spawn(String program, String[] args, String[] env, String dir, EnumSet<ProcessHandle.ProcessFlags> flags, StdioOptions[] stdio, int uid, int gid) Initializes the process handle and starts the process.

Methods inherited from class com.oracle.libuv.Handle

equals, hashCode, isClosing, ref, toString, unref

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

setCloseCallback

public void setCloseCallback(ProcessCloseCallback callback)

setExitCallback

public void setExitCallback(ProcessExitCallback callback)

spawn

public int spawn(String program,
                 String[] args,
                 String[] env,
                 String dir,
                 EnumSet<ProcessHandle.ProcessFlags> flags,
                 StdioOptions[] stdio,
                 int uid,
                 int gid)

Initializes the process handle and starts the process.

If the process is successfully spawned, this function will return 0. Otherwise, the negative error code corresponding to the reason it couldn't spawn is returned.

Possible reasons for failing to spawn would include (but not be limited to) the file to execute not existing, not having permissions to use the setuid or setgid specified, or not having enough memory to allocate for the new process.

close

public void close()

kill

public int kill(int signal)

Sends the specified signal to the given process handle.