add pathnames.h
[unix-history] / usr / src / libexec / rexecd / rexecd.8
index da82add..f6ca277 100644 (file)
@@ -1,10 +1,21 @@
-.\" Copyright (c) 1983 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1983 The Regents of the University of California.
+.\" All rights reserved.
 .\"
 .\"
-.\"    @(#)rexecd.8    6.1 (Berkeley) %G%
+.\" Redistribution and use in source and binary forms are permitted
+.\" provided that the above copyright notice and this paragraph are
+.\" duplicated in all such forms and that any documentation,
+.\" advertising materials, and other materials related to such
+.\" distribution and use acknowledge that the software was developed
+.\" by the University of California, Berkeley.  The name of the
+.\" University may not be used to endorse or promote products derived
+.\" from this software without specific prior written permission.
+.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+.\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 .\"
 .\"
-.TH REXECD 8C ""
+.\"    @(#)rexecd.8    6.3 (Berkeley) %G%
+.\"
+.TH REXECD 8 ""
 .UC 5
 .SH NAME
 rexecd \- remote execution server
 .UC 5
 .SH NAME
 rexecd \- remote execution server
@@ -13,9 +24,9 @@ rexecd \- remote execution server
 .SH DESCRIPTION
 .I Rexecd
 is the server for the 
 .SH DESCRIPTION
 .I Rexecd
 is the server for the 
-.IR rexec (3X)
+.IR rexec (3)
 routine.  The server provides remote execution facilities
 routine.  The server provides remote execution facilities
-with authentication based on user names and encrypted
+with authentication based on user names and
 passwords.
 .PP
 .I Rexecd
 passwords.
 .PP
 .I Rexecd
@@ -39,7 +50,7 @@ port on the client's machine.
 A null terminated user name of at most 16 characters
 is retrieved on the initial socket.
 .IP 4)
 A null terminated user name of at most 16 characters
 is retrieved on the initial socket.
 .IP 4)
-A null terminated, encrypted, password of at most
+A null terminated, unencrypted password of at most
 16 characters is retrieved on the initial socket.  
 .IP 5)
 A null terminated command to be passed to a
 16 characters is retrieved on the initial socket.  
 .IP 5)
 A null terminated command to be passed to a
@@ -55,18 +66,15 @@ and group protections of the user.
 If any of these steps fail the connection is
 aborted with a diagnostic message returned.
 .IP 7)
 If any of these steps fail the connection is
 aborted with a diagnostic message returned.
 .IP 7)
-A null byte is returned on the connection associated
-with the
-.B stderr 
+A null byte is returned on the initial socket
 and the command line is passed to the normal login
 shell of the user.  The
 shell inherits the network connections established
 by
 .IR rexecd .
 .SH DIAGNOSTICS
 and the command line is passed to the normal login
 shell of the user.  The
 shell inherits the network connections established
 by
 .IR rexecd .
 .SH DIAGNOSTICS
-All diagnostic messages are returned on the connection
-associated with the
-.BR stderr ,
+Except for the last one listed below,
+all diagnostic messages are returned on the initial socket,
 after which any network connections are closed.
 An error is indicated by a leading byte with a value of
 1 (0 is returned in step 7 above upon successful completion
 after which any network connections are closed.
 An error is indicated by a leading byte with a value of
 1 (0 is returned in step 7 above upon successful completion
@@ -106,13 +114,19 @@ A
 .I fork
 by the server failed.
 .PP
 .I fork
 by the server failed.
 .PP
-.B ``/bin/sh: ...''
+.B ``<shellname>: ...''
 .br
 The user's login shell could not be started.
 .br
 The user's login shell could not be started.
+This message is returned
+on the connection associated with the
+.BR stderr ,
+and is not preceded by a flag byte.
+.SH SEE ALSO
+rexec(3)
 .SH BUGS
 Indicating ``Login incorrect'' as opposed to ``Password incorrect''
 is a security breach which allows people to probe a system for users
 with null passwords.
 .PP
 .SH BUGS
 Indicating ``Login incorrect'' as opposed to ``Password incorrect''
 is a security breach which allows people to probe a system for users
 with null passwords.
 .PP
-A facility to allow all data exchanges to be encrypted should be
+A facility to allow all data and password exchanges to be encrypted should be
 present.
 present.