rexec man page on BSDOS

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDOS logo
[printable version]

REXEC(3)		    BSD Programmer's Manual		      REXEC(3)

NAME
     rexec - return stream to a remote command

SYNOPSIS
     int
     rexec(ahost, int inport, char *user, char *passwd, char *cmd, int *fd2p);

DESCRIPTION
     The rexec() function presents a significant security problem in that it
     sends plaintext passwords over the network.  It is not included in the
     system libraries because it is only rarely used and no new program should
     use it.  If you are porting a program that uses rexec() you should almost
     certainly use rcmd(3) or krcmd(3) instead.

     If you have no other choice, the source for rexec() is included in the
     source distribution, as /usr/src/lib/libcompat/4.3/rexec.c. You will need
     to compile and load /usr/src/lib/libcompat/4.3/ruserpass.c with your pro-
     gram as well.  Note, the latter is an incomplete implementation of the
     historic ruserpass() functionality, in that it does not support specify-
     ing logins and passwords in the process environment.

     The rexecd(8) daemon is supported and existing programs will continue to
     work.

     The rexec() function looks up the host *ahost using gethostbyname(3),
     returning -1 if the host does not exist.  Otherwise *ahost is set to the
     standard name of the host.	 If a username and password are both speci-
     fied, then these are used to authenticate to the foreign host; otherwise
     the environment and then the user's .netrc file in his home directory are
     searched for appropriate information.  If all this fails, the user is
     prompted for the information.

     The port inport specifies which well-known DARPA Internet port to use for
     the connection; the call `getservbyname("exec", "tcp")' (see
     getservent(3))  will return a pointer to a structure, which contains the
     necessary port.  The protocol for connection is described in detail in
     rexecd(8).

     If the connection succeeds, a socket in the Internet domain of type
     SOCK_STREAM is returned to the caller, and given to the remote command as
     stdin and stdout. If fd2p is non-zero, then an auxiliary channel to a
     control process will be setup, and a descriptor for it will be placed in
     *fd2p. The control process will return diagnostic output from the command
     (unit 2) on this channel, and will also accept bytes on this channel as
     being UNIX signal numbers, to be forwarded to the process group of the
     command.  The diagnostic information returned does not include remote au-
     thorization failure, as the secondary connection is set up after autho-
     rization has been verified.  If fd2p is 0, then the stderr (unit 2 of the
     remote command) will be made the same as the stdout and no provision is
     made for sending arbitrary signals to the remote process, although you
     may be able to get its attention by using out-of-band data.

SEE ALSO
     rcmd(3),  rexecd(8)

HISTORY
     The rexec() function appeared in 4.2BSD.

4.2 Berkeley Distribution	 June 4, 1993				     1
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server BSDOS

List of man pages available for BSDOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net