HPUX rlogin[1]
rlogin(1) rlogin(1)
NAME
rlogin - remote login
SYNOPSIS
rlogin rhost [-e c] [-7] [-8] [-l username]
rhost [-e c] [-7] [-8] [-l username]
DESCRIPTION
rlogin connects your terminal on the local host to the remote host,
rhost; rlogin acts as a virtual terminal to the remote system. The
hostname rhost can be either the official name or an alias as listed
in /etc/hosts; see hosts(4).
In a manner similar to remsh(1), rlogin allows a user to log in on an
equivalent remote host, rhost, bypassing the normal login/password
sequence. For more information about equivalent hosts and how to
specify them in the files /etc/hosts.equiv and .rhosts, see
hosts.equiv(4). Note that the searching of the files /etc/hosts.equiv
and .rhosts occurs on the remote host, and that the .rhosts file must
be owned by the remote user account or by the super-user.
If the originating user account is not equivalent to the remote user
account, the originating user is prompted for the password of the
remote account. If this fails, a login and password are prompted for,
as when login is used (see login(1)).
The terminal type specified by the current TERM environment variable
is propagated across the network and used to set the initial value of
your TERM environment variable on the remote host. Your terminal baud
rate is also propagated to the remote host, and is required by some
systems to set up the pseudo-terminal used by rlogind.
All echoing takes place at the remote site, so that (except for
delays) the remote login is transparent. A line beginning with ~.
disconnects from the remote host. A line beginning with ~! causes a
shell escape on the local host, where ~ is the escape character (see
the -e option below).
If rlogin is run from a shell that supports job control, see (csh(1),
ksh(1)), and sh-posix(1)), escape sequences can be used to suspend
rlogin. The following assumes that ^Z and ^Y are the user's susp and
dsusp characters, respectively (see stty(1) and termio(7)). A line
beginning with the escape sequence ~^Z or ~^Y suspends the rlogin
session and returns the user to the shell that invoked rlogin. The
rlogin job can be resumed with the fg command (see csh(1), ksh(1), and
sh-posix(1). ~^Z suspends both rlogin processes: the one transmitting
user input to the remote login, and the one displaying output from the
remote login. ~^Y suspends only the input process; output from the
remote login continues to be displayed.
Hewlett-Packard Company - 1 - HP-UX Release 9.0: August 1992
rlogin(1) rlogin(1)
The system administrator can arrange for more convenient access to a
remote host rhost by linking remsh to /usr/hosts/rhost, allowing use
of the remote host name (rhost) as a command; see remsh(1). For
example, if remotehost is the name of a remote host and
/usr/hosts/remotehost is linked to remsh, and if /usr/hosts is in your
search path, the command
remotehost
is equivalent to
rlogin remotehost
If at any time rlogin is unable to read from or write to the socket
connection to the remote host, the message Connectionclosed. is
printed on stderr and rlogin exits.
Options
rlogin recognizes the following options:
-ec Sets the escape character to c. There is no space
separating this option and the argument character.
To start a line with the escape character, two of
the escape characters must be entered. The
default escape character is ~. Some characters
may conflict with your terminal configuration,
such as ^S, ^Q, or backspace. Using one of these
as the escape character may not be possible or may
cause problems communicating with the remote host
(see stty(1) and tty(7)).
-l username Sets the user login name on the remote host to
username. The default name is the current account
name of the user invoking rlogin.
-7 Causes rlogin to set the character size to seven
bits. The eighth bit of each byte sent is set to
zero.
-8 Causes rlogin to use an eight-bit data path. This
is the default HP-UX behavior. To use eight-bit
characters, the terminal must be configured to
generate either eight-bit characters with no
parity, or seven bit characters with null parity.
The HP-UX implementation of rlogind interprets
seven bit characters with even, odd, or mark
parity as eight-bit non-USASCII characters. You
may also need to reconfigure the remote host
appropriately (see stty(1) and tty(7)). Some
remote hosts may not provide the necessary support
for eight-bit characters. In this case, or if it
Hewlett-Packard Company - 2 - HP-UX Release 9.0: August 1992
rlogin(1) rlogin(1)
is not possible to disable parity generation by
the local terminal, use the -7 option.
RETURN VALUES
rlogin sends an error message to stderr and returns a non-zero value
if an error occurs before the connection to the remote host is
completed; otherwise it returns a zero.
DIAGNOSTICS
Diagnostics can occur from both the local and remote hosts. Those
that occur on the local host before the connection is completely
established are written to stderr. Once the connection is
established, any error messages from the remote host are written on
stdout like any other data.
login/tcp: Unknown service
rlogin was unable to find the login service listed in the
/etc/services database file.
There is no entry for you (user ID <uid>) in /etc/passwd
rlogin was unable to find your user ID in the password file.
Next Step: Contact your system administrator.
< system call >: ...
An error occurred when rlogin attempted the indicated system
call. See the appropriate manual entry for a description of
the error.
EXAMPLES
Login as the same user on the remote host remote:
rlogin remote
Set the escape character to a !, use a seven-bit data connection, and
attempt a login as user guest on host rhost:
rlogin rhost -e! -7 -l guest
Assuming that your system administrator has set up the links in
/usr/hosts, the following is equivalent to the previous command:
rhost -e! -7 -l guest
WARNINGS
For security purposes, the /etc/hosts.equiv and .rhosts files should
exist, even if they are empty, and should be readable and writable
only by the owner. Note also that all information, including any
passwords asked for, is passed unencrypted between the two hosts.
Hewlett-Packard Company - 3 - HP-UX Release 9.0: August 1992
rlogin(1) rlogin(1)
rlogin is unable to transmit the Break key as an interrupt signal to
the remote system, regardless of whether the user has done stty brkint
on the local system. The key assigned to SIGINT with stty intr c
should be used instead (see stty (1)).
AUTHOR
rlogin was developed by the University of California, Berkeley.
FILES
/etc/hosts.equiv list of equivalent hosts
$HOME/.rhosts user's private equivalence list
/usr/hosts/* for rhost version of the command
SEE ALSO
csh(1), ksh(1), remsh(1), stty(1), telnet(1), rlogind(1M), hosts(4),
hosts.equiv(4), services(4), termio(7).
Hewlett-Packard Company - 4 - HP-UX Release 9.0: August 1992