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.

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 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.

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

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.

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

Museum

Related Articles