public class RLoginClient extends RCommandClient
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
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 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
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
getInputStream()
Unlike RExecClient and RCommandClient, it is not possible to tell the rlogind daemon to return the standard error stream over a separate connection.
getErrorStream()
will always return null. The standard input of the remote process can be
written to through the output stream returned by getOutputSream()
SocketClient
,
RExecClient
,
RCommandClient
Modifier and Type | Field and Description |
---|---|
static int |
DEFAULT_PORT
The default rlogin port.
|
MAX_CLIENT_PORT, MIN_CLIENT_PORT
_errorStream_, NULL_CHAR
_defaultPort_, _hostname_, _input_, _output_, _serverSocketFactory_, _socket_, _socketFactory_, _timeout_, connectTimeout, NETASCII_EOL
Constructor and Description |
---|
RLoginClient()
The default RLoginClient constructor.
|
Modifier and Type | Method and Description |
---|---|
void |
rlogin(String localUsername,
String remoteUsername,
String terminalType)
Same as the other rlogin method, but no terminal speed is defined.
|
void |
rlogin(String localUsername,
String remoteUsername,
String terminalType,
int terminalSpeed)
Logins into a remote machine through the rlogind daemon on the server to which the RLoginClient is connected.
|
connect, connect, connect, connect, connect, connect, rcommand, rcommand
disconnect, getErrorStream, getInputStream, getOutputStream, isRemoteVerificationEnabled, rexec, rexec, setRemoteVerificationEnabled
_connectAction_, addProtocolCommandListener, applySocketAttributes, connect, connect, createCommandSupport, fireCommandSent, fireReplyReceived, getCharset, getCharsetName, getCommandSupport, getConnectTimeout, getDefaultPort, getDefaultTimeout, getKeepAlive, getLocalAddress, getLocalPort, getProxy, getReceiveBufferSize, getRemoteAddress, getRemotePort, getSendBufferSize, getServerSocketFactory, getSoLinger, getSoTimeout, getTcpNoDelay, isAvailable, isConnected, removeProtocolCommandListener, setCharset, setConnectTimeout, setDefaultPort, setDefaultTimeout, setKeepAlive, setProxy, setReceiveBufferSize, setSendBufferSize, setServerSocketFactory, setSocketFactory, setSoLinger, setSoTimeout, setTcpNoDelay, verifyRemote
public static final int DEFAULT_PORT
public RLoginClient()
DEFAULT_PORT
.public void rlogin(String localUsername, String remoteUsername, String terminalType) throws IOException
localUsername
- the local userremoteUsername
- the remote userterminalType
- the terminal typeIOException
- on errorpublic void rlogin(String localUsername, String remoteUsername, String terminalType, int terminalSpeed) throws IOException
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.
localUsername
- The user account on the local machine that is trying to login to the remote host.remoteUsername
- The account name on the server that is being logged in to.terminalType
- The name of the user's terminal (e.g., "vt100", "network", etc.)terminalSpeed
- The speed of the user's terminal, expressed as a baud rate or bps (e.g., 9600 or 38400)IOException
- If the rlogin() attempt fails. The exception will contain a message indicating the nature of the failure.Copyright © 2001–2022 The Apache Software Foundation. All rights reserved.