RLoginClientpublic class RLoginClient extends RCommandClient | RLoginClient is very similar to
{@link org.apache.commons.net.bsd.RCommandClient},
from which it is derived, and uses the rcmd() facility implemented
in RCommandClient to implement the functionality of the rlogin command that
first appeared in 4.2BSD Unix. rlogin is a command used to login to
a remote machine from a trusted host, sometimes without issuing a
password. The trust relationship is the same as described in
the documentation for
{@link org.apache.commons.net.bsd.RCommandClient}.
As with virtually all of the client classes in org.apache.commons.net, this
class derives from SocketClient. But it relies on the connection
methods defined in RcommandClient which ensure that the local Socket
will originate from an acceptable rshell port. The way to use
RLoginClient is to first connect
to the server, call the {@link #rlogin rlogin() } method,
and then
fetch the connection's input and output streams.
Interaction with the remote command is controlled entirely through the
I/O streams. Once you have finished processing the streams, you should
invoke {@link org.apache.commons.net.bsd.RExecClient#disconnect disconnect() }
to clean up properly.
The standard output and standard error streams of the
remote process are transmitted over the same connection, readable
from the input stream returned by
{@link org.apache.commons.net.bsd.RExecClient#getInputStream getInputStream() }
. Unlike RExecClient and RCommandClient, it is
not possible to tell the rlogind daemon to return the standard error
stream over a separate connection.
{@link org.apache.commons.net.bsd.RExecClient#getErrorStream getErrorStream() }
will always return null.
The standard input of the remote process can be written to through
the output stream returned by
{@link org.apache.commons.net.bsd.RExecClient#getOutputStream getOutputSream() }
.
|
| Fields Summary |
|---|
| public static final int | DEFAULT_PORTThe default rlogin port. Set to 513 in BSD Unix and according
to RFC 1282. |
| Constructors Summary |
|---|
public RLoginClient()The default RLoginClient constructor. Initializes the
default port to DEFAULT_PORT .
setDefaultPort(DEFAULT_PORT);
|
| Methods Summary |
|---|
| public void | rlogin(java.lang.String localUsername, java.lang.String remoteUsername, java.lang.String terminalType, int terminalSpeed)Logins into a remote machine through the rlogind daemon on the server
to which the RLoginClient is connected. After calling this method,
you may interact with the remote login shell through its standard input
and output streams. Standard error is sent over the same stream as
standard output. You will typically be able to detect
the termination of the remote login shell after reaching end of file
on its standard output (accessible through
{@link #getInputStream getInputStream() }. Disconnecting
from the server or closing the process streams before reaching
end of file will terminate the remote login shell in most cases.
If user authentication fails, the rlogind daemon will request that
a password be entered interactively. You will be able to read the
prompt from the output stream of the RLoginClient and write the
password to the input stream of the RLoginClient.
rexec(localUsername, remoteUsername, terminalType + "/" + terminalSpeed,
false);
| | public void | rlogin(java.lang.String localUsername, java.lang.String remoteUsername, java.lang.String terminalType)Same as the other rlogin method, but no terminal speed is defined.
rexec(localUsername, remoteUsername, terminalType, false);
|
|
