org.eclipse.rse.services.shells
Interface IShellService

All Superinterfaces:

IService

public interface IShellService
extends IService

IShellService is an abstraction for running shells and shell commands

Method Summary

String[]	getHostEnvironment() Return an array of environment variables that describe the environment on the host.
IHostShell	launchShell(String initialWorkingDirectory, String[] environment, IProgressMonitor monitor) Launch a new shell in the specified directory
IHostShell	launchShell(String initialWorkingDirectory, String encoding, String[] environment, IProgressMonitor monitor) Launch a new shell in the specified directory
IHostShell	runCommand(String initialWorkingDirectory, String command, String[] environment, IProgressMonitor monitor) Run a command in it's own shell
IHostShell	runCommand(String initialWorkingDirectory, String command, String encoding, String[] environment, IProgressMonitor monitor) Run a command in it's own shell

Methods inherited from interface org.eclipse.rse.services.IService

getDescription, getMessage, getName, initService, uninitService

Method Detail

launchShell

IHostShell launchShell(String initialWorkingDirectory,
                       String[] environment,
                       IProgressMonitor monitor)

Launch a new shell in the specified directory

Parameters:

initialWorkingDirectory -

environment - Array of environment variable Strings of the form "var=text"

monitor -

Returns:

the shell object

launchShell

IHostShell launchShell(String initialWorkingDirectory,
                       String encoding,
                       String[] environment,
                       IProgressMonitor monitor)

Launch a new shell in the specified directory

Parameters:

initialWorkingDirectory -

encoding -

environment - Array of environment variable Strings of the form "var=text"

monitor -

Returns:

the shell object

runCommand

IHostShell runCommand(String initialWorkingDirectory,
                      String command,
                      String[] environment,
                      IProgressMonitor monitor)

Run a command in it's own shell

Parameters:

initialWorkingDirectory -

command -

environment - Array of environment variable Strings of the form "var=text"

monitor -

Returns:

the shell object for getting output and error streams

runCommand

IHostShell runCommand(String initialWorkingDirectory,
                      String command,
                      String encoding,
                      String[] environment,
                      IProgressMonitor monitor)

Run a command in it's own shell

Parameters:

initialWorkingDirectory -

command -

encoding -

environment - Array of environment variable Strings of the form "var=text"

monitor -

Returns:

the shell object for getting output and error streams

getHostEnvironment

String[] getHostEnvironment()

Return an array of environment variables that describe the environment on the host. Each String returned is of the format "var=text": Everything up to the first equals sign is the name of the given environment variable, everything after the equals sign is its contents.

Returns:

Array of environment variable Strings of the form "var=text"