com.qualcomm.robotcore.util

Class RunShellCommand

java.lang.Object

com.qualcomm.robotcore.util.RunShellCommand

public class RunShellCommand
extends java.lang.Object

Run shell commands

Light weight utility class for running shell commands.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RunShellCommand.ProcessResult The text output and return code of a completed process

Constructor Summary

Constructors

Constructor and Description
RunShellCommand() Constructor

Method Summary

Modifier and Type	Method and Description
void	commitSeppuku()
void	enableLogging(boolean enable) If logging is enabled, all command will be logged
static int	getSpawnedProcessPid(java.lang.String processName, java.lang.String packageName) return the PID of a given process name started a given package name
static void	killSpawnedProcess(java.lang.String processName, java.lang.String packageName) Kill any spawn processes matching a given process name
RunShellCommand.ProcessResult	run(java.lang.String cmd) Run the given command
RunShellCommand.ProcessResult	runAsRoot(java.lang.String cmd) Run the given command, as root

Methods inherited from class java.lang.Object

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

Constructor Detail

RunShellCommand

public RunShellCommand()

Constructor

Method Detail

enableLogging

public void enableLogging(boolean enable)

If logging is enabled, all command will be logged

Parameters:

enable - true to enable

run

public RunShellCommand.ProcessResult run(java.lang.String cmd)

Run the given command

Parameters:

cmd - command to run

Returns:

the commands output

runAsRoot

public RunShellCommand.ProcessResult runAsRoot(java.lang.String cmd)

Run the given command, as root

Parameters:

cmd - command to run

Returns:

the commands output

commitSeppuku

public void commitSeppuku()

killSpawnedProcess

public static void killSpawnedProcess(java.lang.String processName,
                                      java.lang.String packageName)
                               throws RobotCoreException

Kill any spawn processes matching a given process name

Parameters:

processName - name of process to kill

packageName - name of this package

Throws:

RobotCoreException - if unable to kill process

getSpawnedProcessPid

public static int getSpawnedProcessPid(java.lang.String processName,
                                       java.lang.String packageName)

return the PID of a given process name started a given package name

Parameters:

processName - name of process to search for

packageName - name of this package

Returns:

PID, or -1 if none found