Classes
interface	ProcessTerminator

class	StreamToStringRedirect

class	StreamToWriterRedirect

class	TimedProcessTerminator

Public Member Functions
synchronized String	execute (final String aCommand, final String...params) throws IOException, InterruptedException

synchronized void	execute (final Writer stdoutWriter, final String aCommand, final String...params) throws IOException, InterruptedException

synchronized int	getExitValue ()

synchronized void	stop ()

Static Public Member Functions
static int	execute (ProcessBuilder processBuilder) throws SecurityException, IOException

static int	execute (ProcessBuilder processBuilder, ProcessTerminator terminator) throws SecurityException, IOException

static int	execute (ProcessBuilder processBuilder, long timeOut, TimeUnit units, ProcessTerminator terminator) throws SecurityException, IOException

static void	killProcess (Process process)

Private Attributes
ExecUtil.StreamToStringRedirect	errorStringRedirect = null

int	exitValue = -100

ExecUtil.StreamToStringRedirect	outputStringRedirect = null

ExecUtil.StreamToWriterRedirect	outputWriterRedirect = null

Process	proc = null

Static Private Attributes
static final long	DEFAULT_TIMEOUT = 5

static final TimeUnit	DEFAULT_TIMEOUT_UNITS = TimeUnit.SECONDS

static final Logger	logger = Logger.getLogger(ExecUtil.class.getName())

Detailed Description

Executes a command line using an operating system process with a configurable timeout and pluggable logic to kill or continue the process on timeout.

Definition at line 37 of file ExecUtil.java.

Member Function Documentation

static int org.sleuthkit.autopsy.coreutils.ExecUtil.execute ( ProcessBuilder processBuilder ) throws SecurityException, IOException

static

Runs a process without a timeout and terminator.

Parameters

processBuilder A process builder used to configure and construct the process to be run.

Returns: the exit value of the process

Exceptions

SecurityException	if a security manager exists and vetoes any aspect of running the process.
IOException	if an I/O error occurs.

Definition at line 118 of file ExecUtil.java.

References org.sleuthkit.autopsy.coreutils.ExecUtil.execute().

Referenced by org.sleuthkit.autopsy.coreutils.ExecUtil.execute(), and org.sleuthkit.autopsy.casemodule.LocalFilesDSProcessor.extractLogicalEvidenceFileContents().

static int org.sleuthkit.autopsy.coreutils.ExecUtil.execute	(	ProcessBuilder	processBuilder,
		ProcessTerminator	terminator
	)		throws SecurityException, IOException

static

Runs a process using the default timeout and a custom terminator.

Parameters

processBuilder	A process builder used to configure and construct the process to be run.
terminator	The terminator.

Returns: the exit value of the process

Exceptions

SecurityException	if a security manager exists and vetoes any aspect of running the process.
IOException	if an I/O error occurs.

Definition at line 140 of file ExecUtil.java.

References org.sleuthkit.autopsy.coreutils.ExecUtil.DEFAULT_TIMEOUT, org.sleuthkit.autopsy.coreutils.ExecUtil.DEFAULT_TIMEOUT_UNITS, and org.sleuthkit.autopsy.coreutils.ExecUtil.execute().

static int org.sleuthkit.autopsy.coreutils.ExecUtil.execute	(	ProcessBuilder	processBuilder,
		long	timeOut,
		TimeUnit	units,
		ProcessTerminator	terminator
	)		throws SecurityException, IOException

static

Runs a process using a custom terminator.

Parameters

processBuilder	A process builder used to configure and construct the process to be run.
timeOut	The duration of the timeout.
units	The units for the timeout.
terminator	The terminator.

Returns: the exit value of the process

Exceptions

SecurityException	if a security manager exists and vetoes any aspect of running the process.
IOException	if an I/o error occurs.

Definition at line 159 of file ExecUtil.java.

References org.sleuthkit.autopsy.coreutils.Logger.getLogger(), and org.sleuthkit.autopsy.coreutils.ExecUtil.killProcess().

synchronized String org.sleuthkit.autopsy.coreutils.ExecUtil.execute	(	final String	aCommand,
		final String...	params
	)		throws IOException, InterruptedException

Execute a process. Redirect asynchronously stdout to a string and stderr to nowhere. Use only for small outputs, otherwise use the execute() variant with Writer.

Parameters

aCommand	command to be executed
params	parameters of the command

Returns: string buffer with captured stdout

Definition at line 236 of file ExecUtil.java.

References org.sleuthkit.autopsy.coreutils.ExecUtil.errorStringRedirect, and org.sleuthkit.autopsy.coreutils.ExecUtil.outputStringRedirect.

synchronized void org.sleuthkit.autopsy.coreutils.ExecUtil.execute	(	final Writer	stdoutWriter,
		final String	aCommand,
		final String...	params
	)		throws IOException, InterruptedException