initial checkin of GNO-formatted man page

usr.bin/rlogin/Makefile

@@ -1,11 +1,12 @@
 #	@(#)Makefile	8.1 (Berkeley) 7/19/93
-#	$Id: Makefile,v 1.2 1998/03/11 03:08:15 gdr-ftp Exp $
+#	$Id: Makefile,v 1.3 1998/04/17 01:02:22 gdr-ftp Exp $
 
 PROG=	rlogin
 SRCS=	rlogin.c
 LDADD=	-lnetdb
 OPTIMIZE=79
 BINDIR	= /usr/bin
+HAS_BSD_MANPAGE	= true
 
 #.if exists(${DESTDIR}/usr/lib/libkrb.a) && (defined(MAKE_KERBEROS) \
 #	|| defined(MAKE_EBONES))

usr.bin/rlogin/rlogin.1G

@@ -0,0 +1,174 @@
+.\" Copyright (c) 1983, 1990, 1993
+.\"	The Regents of the University of California.  All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"	This product includes software developed by the University of
+.\"	California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"	@(#)rlogin.1	8.1 (Berkeley) 6/6/93
+.\"
+.TH RLOGIN 1 "16 April 1998" GNO "Commands and Applications"
+.SH NAME
+.BR rlogin
+\- remote login
+.SH SYNOPSIS
+.BR rlogin
+.RB [ -8DEKLdx ]
+.RB [ -e
+.IR char ]
+.RB [ -k
+.IR realm ]
+.RB [ -l 
+.IR username ]
+.I host
+.SH DESCRIPTION
+.BR Rlogin
+starts a terminal session on a remote host
+.BR host  .
+.LP
+.BR Rlogin
+first attempts to use the Kerberos authorization mechanism, described below.
+If the remote host does not supporting Kerberos the standard Berkeley
+.Pa rhosts
+authorization mechanism is used.
+The options are as follows:
+.IP \fB-8\fR
+The
+.B -8
+option allows an eight-bit input data path at all times; otherwise
+parity bits are stripped except when the remote side's stop and start
+characters are other than ^S/^Q.
+.IP \fB-D\fR
+The
+.B -D
+option sets the TCP_NODELAY socket option which can improve interactive
+response at the expense of increased network load.
+.IP \fB-E\fR
+The
+.B -E
+option stops any character from being recognized as an escape character.
+When used with the
+.B -8
+option, this provides a completely transparent connection.
+.IP \fB-K\fR
+The
+.B -K
+option turns off all Kerberos authentication.
+.IP \fB-L\fR
+The
+.B -L
+option allows the rlogin session to be run in ``litout'' (see
+.BR tty (4))
+mode.
+.IP \fB-d\fR
+The
+.B -d
+option turns on socket debugging (see
+.BR setsockopt (2))
+on the TCP sockets used for communication with the remote host.
+.IP \fB-e\fR
+The
+.B -e
+option allows user specification of the escape character, which is
+``~'' by default.
+This specification may be as a literal character, or as an octal
+value in the form \ennn.
+.IP \fB-k\fR
+The
+.B -k
+option requests rlogin to obtain tickets for the remote host
+in realm
+.IR realm
+instead of the remote host's realm as determined by
+.BR krb_realmofhost (3).
+.IP \fB-x\fR
+The
+.B -x
+option turns on DES
+encryption for all data passed via the
+rlogin session.
+This may impact response time and CPU
+utilization, but provides
+increased security.
+.LP
+A line of the form ``<escape char>.'' disconnects from the remote host.
+Similarly, the line ``<escape char>^Z'' will suspend the
+.BR rlogin
+session, and ``<escape char><delayed-suspend char>'' suspends the
+send portion of the rlogin, but allows output from the remote system.
+By default, the tilde (``~'') character is the escape character, and
+normally control-Y (``^Y'') is the delayed-suspend character.
+.LP
+All echoing takes place at the remote site, so that (except for delays)
+the
+.BR rlogin
+is transparent.
+Flow control via ^S/^Q and flushing of input and output on interrupts
+are handled properly.
+.SH KERBEROS AUTHENTICATION
+Each user may have a private authorization list in the file \&.klogin
+in their home directory.
+Each line in this file should contain a Kerberos principal name of the
+form
+.BR principal.instance@realm  .
+If the originating user is authenticated to one of the principals named
+in \&.klogin, 
+access is granted to the account.
+The principal
+.BR accountname.@localrealm
+is granted access if there is no \&.klogin file.
+Otherwise a login and password will be prompted for on the remote machine
+as in
+.BR login (1).
+To avoid certain security problems, the \&.klogin file must be owned by
+the remote user.
+.LP
+If Kerberos authentication fails, a warning message is printed and the
+standard Berkeley
+.BR rlogin
+is used instead.
+.SH ENVIRONMENT
+The following environment variable is utilized by
+.BR rlogin :
+.IP TERM
+Determines the user's terminal type.
+.SH SEE ALSO
+.BR rsh (1),
+.BR kerberos (3),
+.BR krb_sendauth (3),
+.BR krb_realmofhost (3)
+.SH HISTORY
+The
+.BR rlogin
+command appeared in 4.2BSD.
+.SH BUGS
+.BR Rlogin
+will be replaced by
+.BR telnet (1)
+in the near future.
+.LP
+More of the environment should be propagated.

usr.bin/rsh/Makefile

@@ -1,5 +1,5 @@
 #	@(#)Makefile	8.1 (Berkeley) 7/19/93
-#	$Id: Makefile,v 1.3 1998/03/11 03:08:10 gdr-ftp Exp $
+#	$Id: Makefile,v 1.4 1998/04/17 01:01:16 gdr-ftp Exp $
 
 PROG=	rsh
 SRCS=	rsh.c
@@ -22,5 +22,6 @@ INSTALLFLAGS=-fschg
 LDADD=  -lnetdb
 OPTIMIZE=79
 DEBUG=	25
+HAS_BSD_MANPAGE	= true
 
 .INCLUDE: /src/gno/prog.mk

usr.bin/rsh/rsh.1G

@@ -0,0 +1,171 @@
+.\" Copyright (c) 1983, 1990, 1993
+.\"	The Regents of the University of California.  All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"	This product includes software developed by the University of
+.\"	California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"	@(#)rsh.1	8.1 (Berkeley) 6/6/93
+.\"
+.TH RSH 1 "16 April 1998" GNO "Commands and Applications"
+.SH NAME
+.BR rsh
+\- remote shell
+.SH SYNOPSIS
+.BR rsh
+.RB [ -Kdnx ]
+.RB [ -k
+.IR realm ]
+.RB [ -l
+.IR username ]
+.I host
+.RI [ command ]
+.SH DESCRIPTION
+.BR Rsh
+executes
+.BR command
+on
+.BR host  .
+.LP
+.BR Rsh
+copies its standard input to the remote command, the standard
+output of the remote command to its standard output, and the
+standard error of the remote command to its standard error.
+Interrupt, quit and terminate signals are propagated to the remote
+command;
+.BR rsh
+normally terminates when the remote command does.
+The options are as follows:
+.IP \fB-K\fR
+The
+.B -K
+option turns off all Kerberos authentication.
+.IP \fB-d\fR
+The
+.B -d
+option turns on socket debugging (using
+.BR setsockopt (2))
+on the TCP sockets used for communication with the remote host.
+.IP \fB-k\fR
+The
+.B -k
+option causes
+.BR rsh
+to obtain tickets for the remote host in
+.IR realm
+instead of the remote host's realm as determined by
+.BR krb_realmofhost (3).
+.IP \fB-l\fR
+By default, the remote username is the same as the local username.  The
+.B -l
+option allows the remote name to be specified.
+Kerberos authentication is used, and authorization is determined as in
+.BR rlogin (1).
+.IP \fB-n\fR
+The
+.B -n
+option redirects input from the special device /dev/null (see the
+.B BUGS
+section of this manual page).
+.IP \fB-x\fR
+The
+.B -x
+option turns on DES
+encryption for all data exchange.
+This may introduce a significant delay in response time.
+.LP
+If no
+.BR command
+is specified, you will be logged in on the remote host using
+.BR rlogin (1).
+.LP
+Shell metacharacters which are not quoted are interpreted on local machine,
+while quoted metacharacters are interpreted on the remote machine.
+For example, the command
+.LP
+.nf
+	rsh otherhost cat remotefile >> localfile
+.fi
+.LP
+appends the remote file
+.IR remotefile
+to the local file
+.IR localfile ,
+while
+.LP
+.nf
+	rsh otherhost cat remotefile \&">>\&" other_remotefile
+.fi
+.LP
+appends
+.IR remotefile
+to
+.IR other_remotefile .
+.\" .LP
+.\" Many sites specify a large number of host names as commands in the
+.\" directory /usr/hosts.
+.\" If this directory is included in your search path, you can use the
+.\" shorthand ``host command'' for the longer form ``rsh host command''.
+.SH FILES
+/etc/hosts
+.SH SEE ALSO
+.BR rlogin (1),
+.BR kerberos (3),
+.BR krb_sendauth (3),
+.BR krb_realmofhost (3)
+.SH HISTORY
+The
+.BR rsh
+command appeared in 4.2BSD.
+.SH BUGS
+If you are using
+.BR csh (1)
+and put a
+.BR rsh
+in the background without redirecting its input away from the terminal,
+it will block even if no reads are posted by the remote command.
+If no input is desired you should redirect the input of
+.BR rsh
+to /dev/null using the
+.B -n
+option.
+.LP
+You cannot run an interactive command
+(like
+.BR rogue (6)
+or
+.BR vi (1))
+using
+.BR rsh  ;
+use
+.BR rlogin (1)
+instead.
+.LP
+Stop signals stop the local
+.BR rsh
+process only; this is arguably wrong, but currently hard to fix for reasons
+too complicated to explain here.