src/rlogind/rlogind.8

   1 .\" Copyright (c) 1983 The Regents of the University of California.
   2 .\" All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms are permitted
   5 .\" provided that the above copyright notice and this paragraph are
   6 .\" duplicated in all such forms and that any documentation,
   7 .\" advertising materials, and other materials related to such
   8 .\" distribution and use acknowledge that the software was developed
   9 .\" by the University of California, Berkeley.  The name of the
  10 .\" University may not be used to endorse or promote products derived
  11 .\" from this software without specific prior written permission.
  12 .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
  13 .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
  14 .\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  15 .\"
  16 .\"     @(#)rlogind.8   6.8 (Berkeley) 1/6/89
  17 .\"
  18 .TH RLOGIND 8 "January 6, 1989"
  19 .UC 5
  20 .SH NAME
  21 rlogind \- remote login server
  22 .SH SYNOPSIS
  23 .B /etc/rlogind
  24 [
  25 .B \-ln
  26 ]
  27 .SH DESCRIPTION
  28 .I Rlogind
  29 is the server for the
  30 .IR rlogin (1)
  31 program.  The server provides a remote login facility
  32 with authentication based on privileged port numbers from trusted hosts.
  33 .PP
  34 .I Rlogind
  35 listens for service requests at the port indicated in
  36 the ``login'' service specification; see
  37 .IR services (5).
  38 When a service request is received the following protocol
  39 is initiated:
  40 .IP 1)
  41 The server checks the client's source port.
  42 If the port is not in the range 512-1023, the server
  43 aborts the connection.
  44 .IP 2)
  45 The server checks the client's source address
  46 and requests the corresponding host name (see
  47 .IR gethostbyaddr (3),
  48 .IR hosts (5)
  49 and
  50 .IR named (8)).
  51 If the hostname cannot be determined,
  52 the dot-notation representation of the host address is used.
  53 .PP
  54 Once the source port and address have been checked,
  55 .I rlogind
  56 proceeds with the authentication process described in
  57 .IR rshd (8C).
  58 It then allocates a pseudo terminal (see
  59 .IR pty (4)),
  60 and manipulates file descriptors so that the slave
  61 half of the pseudo terminal becomes the
  62 .B stdin ,
  63 .B stdout ,
  64 and
  65 .B stderr
  66 for a login process.
  67 The login process is an instance of the
  68 .IR login (1)
  69 program, invoked with the
  70 .B \-f
  71 option if authentication has succeeded.
  72 If automatic authentication fails, the user is
  73 prompted to log in as if on a standard terminal line.  The
  74 .I -l
  75 option prevents any authentication based on the user's
  76 ``.rhosts'' file, unless the user is logging in as the superuser.
  77 .PP
  78 The parent of the login process manipulates the master side of
  79 the pseudo terminal, operating as an intermediary
  80 between the login process and the client instance of the
  81 .I rlogin
  82 program.  In normal operation, the packet protocol described
  83 in
  84 .IR pty (4)
  85 is invoked to provide ^S/^Q type facilities and propagate
  86 interrupt signals to the remote programs.  The login process
  87 propagates the client terminal's baud rate and terminal type,
  88 as found in the environment variable, ``TERM''; see
  89 .IR environ (7).
  90 The screen or window size of the terminal is requested from the client,
  91 and window size changes from the client are propagated to the pseudo terminal.
  92 .PP
  93 Transport-level keepalive messages are enabled unless the
  94 .B \-n
  95 option is present.
  96 The use of keepalive messages allows sessions to be timed out
  97 if the client crashes or becomes unreachable.
  98 .SH DIAGNOSTICS
  99 All diagnostic messages are returned on the connection
 100 associated with the
 101 .BR stderr ,
 102 after which any network connections are closed.
 103 An error is indicated by a leading byte with a value of 1.
 104 .PP
 105 .B ``Try again.''
 106 .br
 107 A
 108 .I fork
 109 by the server failed.
 110 .PP
 111 .B ``/bin/sh: ...''
 112 .br
 113 The user's login shell could not be started.
 114 .SH "SEE ALSO"
 115 ruserok(3), rshd(8)
 116 .SH BUGS
 117 The authentication procedure used here assumes the integrity
 118 of each client machine and the connecting medium.  This is
 119 insecure, but is useful in an ``open'' environment.
 120 .PP
 121 A facility to allow all data exchanges to be encrypted should be
 122 present.
 123 .PP
 124 A more extensible protocol should be used.