org.eclipse.cdt.utils.spawner

Class Spawner

java.lang.Object

java.lang.Process

org.eclipse.cdt.utils.spawner.Spawner

public class Spawner
extends Process

Field Summary

Fields

Modifier and Type	Field and Description
int	CTRLC A fabricated signal number for use on Windows only.
int	HUP
int	INT On Windows, what this does is far from easy to explain.
int	KILL
int	NOOP
int	TERM

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Spawner(String command)
protected	Spawner(String[] command)
protected	Spawner(String[] command, String[] environment)
protected	Spawner(String[] command, String[] environment, File workingDirectory)
protected	Spawner(String[] cmdarray, String[] envp, File dir, PTY pty)
	Spawner(String command, boolean bNoRedirect)
protected	Spawner(String command, String[] environment)
protected	Spawner(String command, String[] environment, File workingDirectory)

Method Summary

Modifier and Type	Method and Description
void	destroy() See java.lang.Process#destroy (); Clients are responsible for explicitly closing any streams that they have requested through getErrorStream(), getInputStream() or getOutputStream()
void	exec_detached(String[] cmdarray, String[] envp, String dirpath)
int	exitValue() See java.lang.Process#exitValue ();
protected void	finalize()
InputStream	getErrorStream() See java.lang.Process#getErrorStream (); The client is responsible for closing the stream explicitly.
InputStream	getInputStream() See java.lang.Process#getInputStream (); The client is responsible for closing the stream explicitly.
OutputStream	getOutputStream() See java.lang.Process#getOutputStream (); The client is responsible for closing the stream explicitly.
int	hangup()
int	interrupt()
int	interruptCTRLC()
boolean	isRunning()
int	kill()
int	raise(int processID, int sig)
int	terminate()
int	waitFor() See java.lang.Process#waitFor ();

Methods inherited from class java.lang.Process

destroyForcibly, isAlive, waitFor

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NOOP

public int NOOP

HUP

public int HUP

KILL

public int KILL

TERM

public int TERM

INT

public int INT

On Windows, what this does is far from easy to explain. Some of the logic is in the JNI code, some in the spawner.exe code.

• If the process this is being raised against was launched by us (the Spawner)
  • If the process is a cygwin program (has the cygwin1.dll loaded), then issue a 'kill -SIGINT'. If the 'kill' utility isn't available, send the process a CTRL-C
  • If the process is not a cygwin program, send the process a CTRL-C
• If the process this is being raised against was not launched by us, use DebugBreakProcess to interrupt it (sending a CTRL-C is easy only if we share a console with the target process)

On non-Windows, raising this just raises a POSIX SIGINT

CTRLC

public int CTRLC

A fabricated signal number for use on Windows only. Tells the starter program to send a CTRL-C regardless of whether the process is a Cygwin one or not.

Since:

5.2

Constructor Detail

Spawner

public Spawner(String command,
               boolean bNoRedirect)
        throws IOException

Throws:

IOException

Spawner

protected Spawner(String[] command,
                  String[] environment,
                  File workingDirectory)
           throws IOException

Throws:

IOException

Spawner

protected Spawner(String[] cmdarray,
                  String[] envp,
                  File dir,
                  PTY pty)
           throws IOException

Throws:

IOException

Spawner

protected Spawner(String command)
           throws IOException

Throws:

IOException

Spawner

protected Spawner(String[] command)
           throws IOException

Throws:

IOException

Spawner

protected Spawner(String[] command,
                  String[] environment)
           throws IOException

Throws:

IOException

Spawner

protected Spawner(String command,
                  String[] environment)
           throws IOException

Throws:

IOException

Spawner

protected Spawner(String command,
                  String[] environment,
                  File workingDirectory)
           throws IOException

Throws:

IOException

Method Detail

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable

getInputStream

public InputStream getInputStream()

See java.lang.Process#getInputStream (); The client is responsible for closing the stream explicitly.

Specified by:

getInputStream in class Process

getOutputStream

public OutputStream getOutputStream()

See java.lang.Process#getOutputStream (); The client is responsible for closing the stream explicitly.

Specified by:

getOutputStream in class Process

getErrorStream

public InputStream getErrorStream()

See java.lang.Process#getErrorStream (); The client is responsible for closing the stream explicitly.

Specified by:

getErrorStream in class Process

waitFor

public int waitFor()
            throws InterruptedException

See java.lang.Process#waitFor ();

Specified by:

waitFor in class Process

Throws:

InterruptedException

exitValue

public int exitValue()

See java.lang.Process#exitValue ();

Specified by:

exitValue in class Process

destroy

public void destroy()

See java.lang.Process#destroy (); Clients are responsible for explicitly closing any streams that they have requested through getErrorStream(), getInputStream() or getOutputStream()

Specified by:

destroy in class Process

interrupt

public int interrupt()

interruptCTRLC

public int interruptCTRLC()

hangup

public int hangup()

kill

public int kill()

terminate

public int terminate()

isRunning

public boolean isRunning()

exec_detached

public void exec_detached(String[] cmdarray,
                          String[] envp,
                          String dirpath)
                   throws IOException

Throws:

IOException

raise

public int raise(int processID,
                 int sig)