libexec/rlogind/rlogind.8

   1 .\" Copyright (c) 1983, 1989, 1991, 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. All advertising materials mentioning features or use of this software
  13 .\"    must display the following acknowledgement:
  14 .\"     This product includes software developed by the University of
  15 .\"     California, Berkeley and its contributors.
  16 .\" 4. Neither the name of the University nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\"     @(#)rlogind.8   8.1 (Berkeley) 6/4/93
  33 .\" $FreeBSD: src/libexec/rlogind/rlogind.8,v 1.13.2.4 2001/08/16 10:44:17 ru Exp $
  34 .\" $DragonFly: src/libexec/rlogind/rlogind.8,v 1.4 2006/02/17 19:33:31 swildner Exp $
  35 .\"
  36 .Dd June 4, 1993
  37 .Dt RLOGIND 8
  38 .Os
  39 .Sh NAME
  40 .Nm rlogind
  41 .Nd remote login server
  42 .Sh SYNOPSIS
  43 .Nm
  44 .Op Fl Daln
  45 .Sh DESCRIPTION
  46 .Nm Rlogind
  47 is the server for the
  48 .Xr rlogin 1
  49 program.  The server provides a remote login facility
  50 with authentication based on privileged port numbers from trusted hosts.
  51 .Pp
  52 Options supported by
  53 .Nm :
  54 .Bl -tag -width indent
  55 .It Fl D
  56 Set TCP_NODELAY socket option. This improves responsiveness at the expense of
  57 some additional network traffic.
  58 .It Fl a
  59 Ask hostname for verification.
  60 .It Fl l
  61 Prevent any authentication based on the user's
  62 .Dq Pa .rhosts
  63 file, unless the user is logging in as the superuser.
  64 .It Fl n
  65 Disable keep-alive messages.
  66 .El
  67 .Pp
  68 The following options are valid only if Kerberos is in use:
  69 .Bl -tag -width indent
  70 .It Fl k
  71 Enable Kerberos authentication.
  72 .It Fl v
  73 Enable vacuous mode.
  74 .It Fl x
  75 Enable
  76 .Tn DES
  77 encryption for all data passed via the rlogin
  78 session.  This may impact response time
  79 and
  80 .Tn CPU
  81 utilization, but provides increased security.
  82 .El
  83 .Pp
  84 .Nm Rlogind
  85 listens for service requests at the port indicated in
  86 the
  87 .Dq login
  88 service specification; see
  89 .Xr services 5 .
  90 When a service request is received the following protocol
  91 is initiated:
  92 .Bl -enum
  93 .It
  94 The server checks the client's source port.
  95 If the port is not in the range 512-1023, the server
  96 aborts the connection.
  97 .It
  98 The server checks the client's source address
  99 and requests the corresponding host name (see
 100 .Xr gethostbyaddr 3 ,
 101 .Xr hosts 5
 102 and
 103 .Xr named 8 ) .
 104 If the hostname cannot be determined,
 105 the dot-notation representation of the host address is used.
 106 If the hostname is in the same domain as the server (according to
 107 the last two components of the domain name),
 108 or if the
 109 .Fl a
 110 option is given,
 111 the addresses for the hostname are requested,
 112 verifying that the name and address correspond.
 113 Normal authentication is bypassed if the address verification fails.
 114 .El
 115 .Pp
 116 Once the source port and address have been checked,
 117 .Nm
 118 proceeds with the authentication process described in
 119 .Xr rshd 8 .
 120 It then allocates a pseudo terminal (see
 121 .Xr pty 4 ) ,
 122 and manipulates file descriptors so that the slave
 123 half of the pseudo terminal becomes the
 124 .Em stdin ,
 125 .Em stdout ,
 126 and
 127 .Em stderr
 128 for a login process.
 129 The login process is an instance of the
 130 .Xr login 1
 131 program, invoked with the
 132 .Fl f
 133 option if authentication has succeeded.
 134 If automatic authentication fails, the user is
 135 prompted to log in as if on a standard terminal line.
 136 .Pp
 137 The parent of the login process manipulates the master side of
 138 the pseudo terminal, operating as an intermediary
 139 between the login process and the client instance of the
 140 .Xr rlogin 1
 141 program.  In normal operation, the packet protocol described
 142 in
 143 .Xr pty 4
 144 is invoked to provide
 145 .Ql ^S/^Q
 146 type facilities and propagate
 147 interrupt signals to the remote programs.  The login process
 148 propagates the client terminal's baud rate and terminal type,
 149 as found in the environment variable,
 150 .Ev TERM ;
 151 see
 152 .Xr environ 7 .
 153 The screen or window size of the terminal is requested from the client,
 154 and window size changes from the client are propagated to the pseudo terminal.
 155 .Pp
 156 Transport-level keepalive messages are enabled unless the
 157 .Fl n
 158 option is present.
 159 The use of keepalive messages allows sessions to be timed out
 160 if the client crashes or becomes unreachable.
 161 .Sh FILES
 162 .Bl -tag -width /etc/hostsxxxxxxxx -compact
 163 .It Pa /etc/hosts
 164 .It Pa /etc/hosts.equiv
 165 .It Ev $HOME Ns Pa /.rhosts
 166 .It Pa /var/run/nologin
 167 .El
 168 .Sh DIAGNOSTICS
 169 All initial diagnostic messages are indicated
 170 by a leading byte with a value of 1,
 171 after which any network connections are closed.
 172 If there are no errors before
 173 .Xr login 1
 174 is invoked, a null byte is returned as in indication of success.
 175 .Bl -tag -width Ds
 176 .It Sy Try again.
 177 A
 178 .Xr fork 2
 179 by the server failed.
 180 .El
 181 .Sh SEE ALSO
 182 .Xr login 1 ,
 183 .Xr ruserok 3 ,
 184 .Xr hosts 5 ,
 185 .Xr hosts.equiv 5 ,
 186 .Xr login.conf 5 ,
 187 .Xr nologin 5 ,
 188 .Xr services 5 ,
 189 .Xr rshd 8
 190 .Sh HISTORY
 191 The
 192 .Nm
 193 command appeared in
 194 .Bx 4.2 .
 195 .Pp
 196 IPv6 support was added by WIDE/KAME project.
 197 .Sh BUGS
 198 The authentication procedure used here assumes the integrity
 199 of each client machine and the connecting medium.  This is
 200 insecure, but is useful in an
 201 .Dq open
 202 environment.
 203 .Pp
 204 A facility to allow all data exchanges to be encrypted should be
 205 present.
 206 .Pp
 207 A more extensible protocol should be used.