usr.bin/rlogin/rlogin.1

   1 .\" Copyright (c) 1983, 1990, 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 .\"     @(#)rlogin.1    8.1 (Berkeley) 6/6/93
  33 .\" $FreeBSD$
  34 .\"
  35 .Dd June 6, 1993
  36 .Dt RLOGIN 1
  37 .Os BSD 4.2
  38 .Sh NAME
  39 .Nm rlogin
  40 .Nd remote login
  41 .Sh SYNOPSIS
  42 .Ar rlogin
  43 .Op Fl 8DEKLdx
  44 .Op Fl e Ar char
  45 .Op Fl i Ar localname
  46 .Op Fl k Ar realm
  47 .Op Fl l Ar username
  48 .Ar host
  49 .Sh DESCRIPTION
  50 .Nm Rlogin
  51 starts a terminal session on a remote host
  52 .Ar host  .
  53 .Pp
  54 .Nm Rlogin
  55 first attempts to use the Kerberos authorization mechanism, described below.
  56 If the remote host does not supporting Kerberos the standard Berkeley
  57 .Pa rhosts
  58 authorization mechanism is used.
  59 The options are as follows:
  60 .Bl -tag -width flag
  61 .It Fl 8
  62 The
  63 .Fl 8
  64 option allows an eight-bit input data path at all times; otherwise
  65 parity bits are stripped except when the remote side's stop and start
  66 characters are other than
  67 ^S/^Q .
  68 .It Fl D
  69 The
  70 .Fl D
  71 option sets the TCP_NODELAY socket option which can improve interactive response
  72 at the expense of increased network load.
  73 .It Fl E
  74 The
  75 .Fl E
  76 option stops any character from being recognized as an escape character.
  77 When used with the
  78 .Fl 8
  79 option, this provides a completely transparent connection.
  80 .It Fl K
  81 The
  82 .Fl K
  83 option turns off all Kerberos authentication.
  84 .It Fl L
  85 The
  86 .Fl L
  87 option allows the rlogin session to be run in
  88 .Dq litout
  89 (see
  90 .Xr tty 4 )
  91 mode.
  92 .It Fl d
  93 The
  94 .Fl d
  95 option turns on socket debugging (see
  96 .Xr setsockopt 2 )
  97 on the TCP sockets used for communication with the remote host.
  98 .It Fl e
  99 The
 100 .Fl e
 101 option allows user specification of the escape character, which is
 102 .Dq ~
 103 by default.
 104 This specification may be as a literal character, or as an octal
 105 value in the form \ennn.
 106 .It Fl i
 107 The
 108 .Fl i
 109 option allows the caller to specify a different local name to be used
 110 for authentication.  This option is restricted to processes with uid 0.
 111 .It Fl k
 112 The
 113 .Fl k
 114 option requests rlogin to obtain tickets for the remote host
 115 in realm
 116 .Ar realm
 117 instead of the remote host's realm as determined by
 118 .Xr krb_realmofhost  3  .
 119 .It Fl l
 120 The
 121 .Fl l
 122 option specifies a different
 123 .Ar username
 124 for the remote login.
 125 If this option is not specified, your local username will be used.
 126 .It Fl x
 127 The
 128 .Fl x
 129 option turns on
 130 .Tn DES
 131 encryption for all data passed via the
 132 rlogin session.
 133 This may impact response time and
 134 .Tn CPU
 135 utilization, but provides
 136 increased security.
 137 .El
 138 .Pp
 139 A line of the form
 140 .Dq Aq escape char .
 141 disconnects from the remote host.
 142 Similarly, the line
 143 .Dq Ao escape char Ac Ns ^Z
 144 will suspend the
 145 .Nm
 146 session, and
 147 .Dq Ao escape char Ac Ao delayed-suspend char Ac
 148 suspends the
 149 send portion of the rlogin, but allows output from the remote system.
 150 By default, the tilde
 151 .Pq Dq ~
 152 character is the escape character, and
 153 normally control-Y
 154 .Pq Dq ^Y
 155 is the delayed-suspend character.
 156 .Pp
 157 All echoing takes place at the remote site, so that (except for delays)
 158 the
 159 .Nm
 160 is transparent.
 161 Flow control via ^S/^Q and flushing of input and output on interrupts
 162 are handled properly.
 163 .Sh KERBEROS AUTHENTICATION
 164 Each user may have a private authorization list in the file
 165 .Pa .klogin
 166 in their home directory.
 167 Each line in this file should contain a Kerberos principal name of the
 168 form
 169 .Ar principal.instance@realm  .
 170 If the originating user is authenticated to one of the principals named
 171 in
 172 .Pa .klogin ,
 173 access is granted to the account.
 174 The principal
 175 .Ar accountname.@localrealm
 176 is granted access if
 177 there is no
 178 .Pa .klogin
 179 file.
 180 Otherwise a login and password will be prompted for on the remote machine
 181 as in
 182 .Xr login  1  .
 183 To avoid certain security problems, the
 184 .Pa .klogin
 185 file must be owned by
 186 the remote user.
 187 .Pp
 188 If Kerberos authentication fails, a warning message is printed and the
 189 standard Berkeley
 190 .Nm
 191 is used instead.
 192 .Sh ENVIRONMENT
 193 The following environment variable is utilized by
 194 .Nm Ns :
 195 .Bl -tag -width TERM
 196 .It Ev TERM
 197 Determines the user's terminal type.
 198 .El
 199 .Sh SEE ALSO
 200 .Xr login 1 ,
 201 .Xr rsh 1 ,
 202 .Xr telnet 1 ,
 203 .Xr setsockopt 2 ,
 204 .Xr kerberos 3 ,
 205 .Xr krb_realmofhost 3 ,
 206 .Xr krb_sendauth 3 ,
 207 .Xr ruserok 3 ,
 208 .Xr tty 4 ,
 209 .Xr auth.conf 5 ,
 210 .Xr hosts.equiv 5 ,
 211 .Xr hosts 5 ,
 212 .Xr rlogind 8 ,
 213 .Xr rshd 8
 214 .Sh FILES
 215 .Bl -tag -width /etc/hosts -compact
 216 .It Pa /etc/hosts
 217 .It Pa /etc/hosts.equiv
 218 .It Pa /etc/auth.conf
 219 .Sm off
 220 .It Pa Ev $HOME /.rhosts
 221 .It Pa Ev $HOME /.klogin
 222 .Sm on
 223 .El
 224 .Sh HISTORY
 225 The
 226 .Nm
 227 command appeared in
 228 .Bx 4.2 .
 229 .Pp
 230 IPv6 support was added by WIDE/KAME project.
 231 .Sh BUGS
 232 .Nm Rlogin
 233 will be replaced by
 234 .Xr telnet  1
 235 in the near future.
 236 .Pp
 237 More of the environment should be propagated.