RLOGIN(1)           RISC/os Reference Manual            RLOGIN(1)



NAME
     rlogin - remote login

SYNOPSIS
     rlogin rhost [ -ec ] [ -8 ] [ -L ] [ -l username ]
     rhost [ -ec ] [ -8 ] [ -L ] [ -l username ]

DESCRIPTION
     rlogin connects your terminal on the current local host sys-
     tem lhost to the remote host system rhost.

     If /usr/hosts is included in your PATH, you may use the
     second form of the synopsis.  /usr/hosts is a directory of
     links to rlogin, each being the name of a host from
     /etc/hosts.

     Each host has a file /etc/hosts.equiv which contains a list
     of rhosts with which it shares account names.  (The host
     names must be the standard names as described in rsh(1C).)
     When you rlogin as the same user on an equivalent host, you
     don't need to give a password.  Each user may also have a
     private equivalence list in a file .rhosts in his login
     directory.  Each line in this file should contain an rhost
     and a username separated by a space, giving additional cases
     where logins without passwords are to be permitted.  If the
     originating user is not equivalent to the remote user, then
     a login and password will be prompted for on the remote
     machine as in login(1).  To avoid some security problems,
     the .rhosts file must be owned by either the remote user or
     root.

     The remote terminal type is the same as your local terminal
     type (as given in your environment TERM variable).  The ter-
     minal or window size is also copied to the remote system if
     the server supports the option, and changes in size are
     reflected as well.  All echoing takes place at the remote
     site, so that (except for delays) the rlogin is transparent.
     Flow control via ^S and ^Q and flushing of input and output
     on interrupts are handled properly.  The default argument -8
     allows an eight-bit input data path when ISTRIP and PARENB
     are not set when rlogin is invoked, and also disables ^S/^Q
     flow control (see termio(7)) at all times.  (Otherwise,
     ^S/^Q flow control is enabled or disabled according to the
     desires of the remote application.)  The argument -L allows
     the rlogin session to be run in litout mode.  A line of the
     form ``~.'' disconnects from the remote host, where ``~'' is
     the escape character.  Similarly, the line ``~^Z'' (where
     ^Z, control-Z, is the suspend character) will suspend the
     rlogin session.  Substitution of the delayed-suspend charac-
     ter (normally ^Y) for the suspend character suspends the
     send portion of the rlogin, but allows output from the
     remote system.  A different escape character may be



                        Printed 11/19/92                   Page 1

RLOGIN(1)           RISC/os Reference Manual            RLOGIN(1)



     specified by the -e option.  There is no space separating
     this option flag and the argument character.

     rlogind(1M) supports an optional facility to simulate the
     ISTRIP, PARENB, and PARODD termio(7) options, if set, to
     compensate for deficiencies in rlogin client applications on
     other operating systems.  Many such client programs disable
     parity generation on output, and fail to discard parity bits
     on input, whenever IXON is turned off by rlogind. This means
     that terminals which expect parity on data they send sud-
     denly fail to receive it, and further that applications
     receiving data from such terminals see characters with the
     parity bit set.  Thus only terminals which do not generate
     parity, and which ignore parity on received characters,
     function correctly with all applications.

     If the file /etc/rlogind.simulation.ok exists, rlogind will
     simulate ISTRIP, PARENB, and PARODD (if they are set), when-
     ever IXON is turned off.  All users must then be careful to
     make the appropriate stty(1) settings when logging in via
     rlogin, such that the settings on their local virtual termi-
     nals match those expected by their respective real termi-
     nals.  For example, if the real terminal expects and gen-
     erates even parity, the initialization

          stty istrip parenb -parodd

     would be appropriate.  If the real terminal neither expects
     nor generates parity, and rlogin is invoked with the -8
     option, the initialization

          stty -istrip -parenb

     would be appropriate.  Users may test for the existence of
     the file /etc/rlogind.simulation.ok to determine whether
     such settings on are needed.  Note that this feature is not
     needed with the RISC/os rlogin client, as it always gen-
     erates and strips parity as directed by the user.

SEE ALSO
     rsh(1C)
     rlogind(1M) in the System Administrator's Reference Manual.

FILES
     /usr/hosts/*        for rhost version of the command

ERRORS
     More of the environment should be propagated.

     If IXON is turned off by the application on the remote sys-
     tem, the rlogin client is directed to do so via an out-of-
     band message, so that considerable output, which may have



 Page 2                 Printed 11/19/92

RLOGIN(1)           RISC/os Reference Manual            RLOGIN(1)



     required flow control, may still be pending when flow con-
     trol is disabled.  As a consequence, some of the data may be
     lost due to overruns.  (This is a fundamental deficiency of
     the rlogin protocol, not an implementation error.)



















































                        Printed 11/19/92                   Page 3