RLOGIN(1) — Series 300 and 800 Only

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, then the originating user is prompted for the password of the remote account. If this fails, then a login and password are prompted for, as in login(1).

Your terminal type (as specified by your TERM environment variable), is propagated across the network and is 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). Additionally, on systems with job control (currently only implemented on the Series 800, for users running csh), a line beginning with the escape sequence “~^Z” or “~^Y” will suspend the rlogin session and return the user to the shell which invoked rlogin; the job may then be resumed with the “fg” command; see csh(1). The “^Z” and “^Y” characters are the users susp and dsusp tty characters; see stty(1).

Your system administrator may arrange for more convenient access to a remote host rhost by linking remsh(1) 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, then 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 “Connection closed.” is printed on stderr and rlogin exits.

Options

Rlogin supports the following options:

−ec Sets the escape character to c. There is no space separating this option flag 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 will interpret 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.

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

< system call >: ...
An error occurred when rlogin attempted the indicated system call. See the appropriate manual page for a description of the error.

EXAMPLES

To login as the same user on the remote host “remote”, use:

rlogin remote

To set the escape character to a !, use a seven-bit data connection, and attempt a login as user “guest” on host “rhost”, use:

rlogin rhost -e! -7 -l guest

Assuming that your system administator has set up the links in /usr/hosts, then 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).

On Series 300 computers, HP-UX does not support job control, so the escape sequences “~^Y” and “~^Z” do not work.

DEPENDENCIES

Implemented on the Series 300 and 800 only.

AUTHOR

UCB (University of California at 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