org.apache.sshd.server.shell

Class ProcessShell

java.lang.Object

org.apache.sshd.common.util.logging.AbstractLoggingBean

org.apache.sshd.server.shell.ProcessShell

All Implemented Interfaces:

SessionContextHolder, SessionHolder<ServerSession>, CommandLifecycle, ServerSessionHolder, SessionAware, InvertedShell

public class ProcessShell
extends AbstractLoggingBean
implements InvertedShell

Bridges the I/O streams between the SSH command and the process that executes it

Author:

Apache MINA SSHD Project

Field Summary

Fields inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

log

Constructor Summary

Constructors

Constructor and Description
ProcessShell(Collection<String> command)
ProcessShell(String... command)

Method Summary

Modifier and Type	Method and Description
void	destroy(ChannelSession channel) This method is called by the SSH server to destroy the command because the client has disconnected somehow.
int	exitValue() Retrieve the exit value of the shell.
ChannelSession	getChannelSession()
InputStream	getErrorStream()
OutputStream	getInputStream() Returns the output stream used to feed the shell.
InputStream	getOutputStream()
ServerSession	getServerSession()
boolean	isAlive() Check if the underlying shell is still alive
protected Map<String,String>	resolveShellEnvironment(Map<String,String> env)
protected Map<PtyMode,Integer>	resolveShellTtyOptions(Map<PtyMode,Integer> modes)
void	setSession(ServerSession session)
void	start(ChannelSession channel, Environment env) Starts the command execution.
String	toString()

Methods inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

getSimplifiedLogger

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.sshd.server.shell.InvertedShell

getSession

Methods inherited from interface org.apache.sshd.common.session.SessionHolder

getSessionContext

Constructor Detail

ProcessShell

public ProcessShell(String... command)

Parameters:

command - The command components which when joined (with space separator) create the full command to be executed by the shell

ProcessShell

public ProcessShell(Collection<String> command)

Method Detail

getServerSession

public ServerSession getServerSession()

Specified by:

getServerSession in interface ServerSessionHolder

Returns:

The underlying ServerSession used

setSession

public void setSession(ServerSession session)

Specified by:

setSession in interface SessionAware

Parameters:

session - The ServerSession in which this shell will be executed.

getChannelSession

public ChannelSession getChannelSession()

Specified by:

getChannelSession in interface InvertedShell

Returns:

The ChannelSession instance through which the shell was created - may be null if shell not started yet

start

public void start(ChannelSession channel,
                  Environment env)
           throws IOException

Description copied from interface: CommandLifecycle

Starts the command execution. All streams must have been set before calling this method. The command should implement Runnable, and this method should spawn a new thread like:

  Thread(this).start(); 
 

Specified by:

start in interface CommandLifecycle

Parameters:

channel - The ChannelSession through which the command has been received

env - The Environment

Throws:

IOException - If failed to start

resolveShellEnvironment

protected Map<String,String> resolveShellEnvironment(Map<String,String> env)

resolveShellTtyOptions

protected Map<PtyMode,Integer> resolveShellTtyOptions(Map<PtyMode,Integer> modes)

getInputStream

public OutputStream getInputStream()

Description copied from interface: InvertedShell

Returns the output stream used to feed the shell. This method is called after the shell has been started.

Specified by:

getInputStream in interface InvertedShell

Returns:

The OutputStream used to feed the shell

getOutputStream

public InputStream getOutputStream()

Specified by:

getOutputStream in interface InvertedShell

Returns:

The InputStream representing the output stream of the shell

getErrorStream

public InputStream getErrorStream()

Specified by:

getErrorStream in interface InvertedShell

Returns:

The InputStream representing the error stream of the shell

isAlive

public boolean isAlive()

Description copied from interface: InvertedShell

Check if the underlying shell is still alive

Specified by:

isAlive in interface InvertedShell

Returns:

true if alive

exitValue

public int exitValue()

Description copied from interface: InvertedShell

Retrieve the exit value of the shell. This method must only be called when the shell is not alive anymore.

Specified by:

exitValue in interface InvertedShell

Returns:

the exit value of the shell

destroy

public void destroy(ChannelSession channel)

Description copied from interface: CommandLifecycle

This method is called by the SSH server to destroy the command because the client has disconnected somehow.

Specified by:

destroy in interface CommandLifecycle

Parameters:

channel - The ChannelSession through which the command has been received

toString

public String toString()

Overrides:

toString in class Object