Return to rexec.3 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / lib / libcompat / 4.3

Annotation of 43BSDReno/lib/libcompat/4.3/rexec.3, revision 1.1

1.1     ! root        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 provided
        !             5: .\" that: (1) source distributions retain this entire copyright notice and
        !             6: .\" comment, and (2) distributions including binaries display the following
        !             7: .\" acknowledgement:  ``This product includes software developed by the
        !             8: .\" University of California, Berkeley and its contributors'' in the
        !             9: .\" documentation or other materials provided with the distribution and in
        !            10: .\" all advertising materials mentioning features or use of this software.
        !            11: .\" Neither the name of the University nor the names of its contributors may
        !            12: .\" be used to endorse or promote products derived from this software without
        !            13: .\" specific prior written permission.
        !            14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
        !            15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
        !            16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
        !            17: .\"
        !            18: .\"    @(#)rexec.3     6.8 (Berkeley) 6/23/90
        !            19: .\"
        !            20: .TH REXEC 3 "June 23, 1990"
        !            21: .UC 5
        !            22: .SH NAME
        !            23: rexec \- return stream to a remote command
        !            24: .SH SYNOPSIS
        !            25: .nf
        !            26: .PP
        !            27: .B "rem = rexec(ahost, inport, user, passwd, cmd, fd2p);"
        !            28: .B char **ahost;
        !            29: .B int inport;
        !            30: .B "char *user, *passwd, *cmd;"
        !            31: .B int *fd2p;
        !            32: .fi
        !            33: .SH DESCRIPTION
        !            34: .ft B
        !            35: This interface is obsoleted by krcmd(3).
        !            36: .br
        !            37: It is available from the compatibility library, libcompat.
        !            38: .ft R
        !            39: .PP
        !            40: .I Rexec
        !            41: looks up the host
        !            42: .I *ahost
        !            43: using
        !            44: .IR gethostbyname (3),
        !            45: returning \-1 if the host does not exist.
        !            46: Otherwise
        !            47: .I *ahost
        !            48: is set to the standard name of the host.
        !            49: If a username and password are both specified, then these
        !            50: are used to authenticate to the foreign host; otherwise
        !            51: the environment and then the user's
        !            52: .I .netrc
        !            53: file in his
        !            54: home directory are searched for appropriate information.
        !            55: If all this fails, the user is prompted for the information.
        !            56: .PP
        !            57: The port
        !            58: .I inport
        !            59: specifies which well-known DARPA Internet port to use for
        !            60: the connection; the call ``getservbyname("exec", "tcp")'' (see 
        !            61: .IR getservent (3))
        !            62: will return a pointer to a structure, which contains the
        !            63: necessary port.
        !            64: The protocol for connection is described in detail in
        !            65: .IR rexecd (8).
        !            66: .PP
        !            67: If the connection succeeds,
        !            68: a socket in the Internet domain of type SOCK_STREAM is returned to
        !            69: the caller, and given to the remote command as
        !            70: .B stdin
        !            71: and
        !            72: .BR stdout .
        !            73: If
        !            74: .I fd2p
        !            75: is non-zero, then an auxiliary channel to a control
        !            76: process will be setup, and a descriptor for it will be placed
        !            77: in
        !            78: .IR *fd2p .
        !            79: The control process will return diagnostic
        !            80: output from the command (unit 2) on this channel, and will also
        !            81: accept bytes on this channel as being UNIX signal numbers, to be
        !            82: forwarded to the process group of the command.  The diagnostic
        !            83: information returned does not include remote authorization failure,
        !            84: as the secondary connection is set up after authorization has been
        !            85: verified.
        !            86: If
        !            87: .I fd2p
        !            88: is 0, then the 
        !            89: .B stderr
        !            90: (unit 2 of the remote
        !            91: command) will be made the same as the 
        !            92: .B stdout
        !            93: and no
        !            94: provision is made for sending arbitrary signals to the remote process,
        !            95: although you may be able to get its attention by using out-of-band data.
        !            96: .SH SEE ALSO
        !            97: rcmd(3), rexecd(8)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.