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