Return to uux.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / uucp

Annotation of 43BSDReno/usr.bin/uucp/uux.1, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1988, 1990 Regents of the University of California.
        !             2: .\" All rights reserved.  The Berkeley software License Agreement
        !             3: .\" specifies the terms and conditions for redistribution.
        !             4: .\"
        !             5: .\"            @(#)uux.1       6.5 (Berkeley) 6/24/90
        !             6: .\"
        !             7: .TH UUX 1 "October 24, 1988"
        !             8: .AT 3
        !             9: .SH NAME
        !            10: uux \- unix to unix command execution
        !            11: .SH SYNOPSIS
        !            12: .B uux
        !            13: [
        !            14: .B -
        !            15: ] [
        !            16: .B -cClLnprz
        !            17: ] [
        !            18: .BI -a name
        !            19: ] [
        !            20: .BI -g grade
        !            21: ] [
        !            22: .BI -x debug
        !            23: ]
        !            24: command-string
        !            25: .SH DESCRIPTION
        !            26: .I Uux\^
        !            27: will gather zero or more files from various systems,
        !            28: execute a command on a specified system
        !            29: and then send standard output to a file on a specified
        !            30: system.
        !            31: .PP
        !            32: The
        !            33: .I command-string
        !            34: is made up of one or more arguments that look
        !            35: like a Shell command line,
        !            36: except that the command and file names
        !            37: may be prefixed by
        !            38: .IB system-name !\fR.\fP
        !            39: A null \fIsystem-name\fP is interpreted as the local system.
        !            40: .PP
        !            41: File names may be one of
        !            42: .IP
        !            43: (1) a full path name;
        !            44: .IP
        !            45: (2) a path name preceded by
        !            46: .BI ~ user
        !            47: where
        !            48: .I user
        !            49: is a login name on the specified system
        !            50: and is replaced by that user's login directory;
        !            51: .IP
        !            52: (3) a path name prefixed by
        !            53: .BR ~;
        !            54: where
        !            55: .B ~
        !            56: is expanded to the system's public directory (usually /var/spool/uucppublic);
        !            57: .IP
        !            58: (4) a partial pathname, which is prefixed by the current directory.
        !            59: .PP
        !            60: As an example, the command
        !            61: .IP
        !            62: uux "\^!diff usg!/usr/dan/file1 pwba!/a4/dan/file2 > !~/dan/file.diff\^"
        !            63: .PP
        !            64: will get the \fBfile1\fP and \fBfile2\fP files
        !            65: from the ``usg'' and ``pwba'' machines,
        !            66: execute a
        !            67: .IR diff (1)
        !            68: command
        !            69: and put the results in \fBfile.diff\fP in the 
        !            70: local /var/spool/uucppublic/dan/ directory.
        !            71: .PP
        !            72: Any special shell characters, such as \fB<>;|\fP, should be quoted either
        !            73: by quoting the entire \fIcommand-string\fP, or quoting the special
        !            74: characters as individual arguments.
        !            75: .PP
        !            76: .I Uux
        !            77: will attempt to get all files to the execution system.
        !            78: For files that are output files, the file name must be escaped using
        !            79: parentheses.
        !            80: For example, the command
        !            81: .IP
        !            82: uux a!wc b!/usr/file1 \\(c!/usr/file2 \\)
        !            83: .PP
        !            84: get \fB/usr/file1\fP from system ``b'' and send it to system ``a'',
        !            85: perform a \fIwc\fP command on that file
        !            86: and send the result of the 
        !            87: .I wc
        !            88: command to system ``c''.
        !            89: .PP
        !            90: .I Uux\^
        !            91: will notify you by mail if the requested command on the remote
        !            92: system was disallowed.
        !            93: This notification can be turned off by the \fB\-n\fP option.
        !            94: .PP
        !            95: The following \fIoptions\fP are interpreted by
        !            96: .IR uux :
        !            97: .TP .5i
        !            98: .B \-
        !            99: The standard input to
        !           100: .I uux
        !           101: is made the standard input to the
        !           102: .IR command-string .
        !           103: .TP .5i
        !           104: .BI \-a name
        !           105: Use
        !           106: .I name
        !           107: as the user identification replacing the initiator user-id.
        !           108: .TP .5i
        !           109: .B \-c
        !           110: Do not copy local file to the spool directory for transfer to the remote
        !           111: machine (this is the default).
        !           112: .TP .5i
        !           113: .B \-C
        !           114: Force the copy of local files to the spool directory for transfer.
        !           115: .TP .5i
        !           116: .BI \-g grade
        !           117: .I Grade
        !           118: is a single letter/number, from
        !           119: .B 0
        !           120: to
        !           121: .BR 9 ,
        !           122: .B A
        !           123: to
        !           124: .BR Z ,
        !           125: or
        !           126: .B a
        !           127: to
        !           128: .BR z ;
        !           129: .B 0
        !           130: is the highest, and
        !           131: .B z
        !           132: is the lowest grade.
        !           133: The default is 
        !           134: .BR A ;
        !           135: by comparison
        !           136: .IR uucp (1)
        !           137: defaults to
        !           138: .B n
        !           139: and mail is usually sent at grade
        !           140: .BR C .
        !           141: Lower grades should be specified for high-volume jobs, such as news.
        !           142: .TP .5i
        !           143: .B \-l
        !           144: Try and make a link from the original file to the spool directory.
        !           145: If the link cannot be made, copy the file.
        !           146: .TP .5i
        !           147: .B \-n
        !           148: Do not notify the user when the command completes.
        !           149: .TP .5i
        !           150: .B \-p
        !           151: Same as \-:
        !           152: The standard input to
        !           153: .I uux
        !           154: is made the standard input to the
        !           155: .IR command-string .
        !           156: .TP .5i
        !           157: .B \-r
        !           158: Do not start the file transfer, just queue the job.
        !           159: .TP .5i
        !           160: .BI \-x debug
        !           161: Produce debugging output on stdout.
        !           162: The debug is a number between 0 and 9;
        !           163: higher numbers give more detailed information. Debugging is permitted
        !           164: only for privileged users (specifically, those with read access to
        !           165: .IR L.sys (5) .
        !           166: .TP .5i
        !           167: .B \-z
        !           168: Notify the user only if the command fails.
        !           169: .TP .5i
        !           170: .B \-L
        !           171: Start up
        !           172: .I uucico
        !           173: with the \fB-L\fP flag. This will force
        !           174: calls to be made to local sites only (see
        !           175: .IR uucico (8)).
        !           176: .SH FILES
        !           177: .PD 0
        !           178: .TP 22
        !           179: /var/spool/uucp
        !           180: spool directories
        !           181: .TP
        !           182: /usr/lib/uucp/\(**
        !           183: UUCP configuration data and daemons
        !           184: .PD
        !           185: .SH SEE ALSO
        !           186: uucp(1), uucico(8), uuxqt(8).
        !           187: .SH WARNING
        !           188: For security reasons, many installations will
        !           189: limit the list of
        !           190: commands executable on behalf of an incoming request from
        !           191: .IR uux .
        !           192: Many sites will permit little more than
        !           193: the receipt of mail (see
        !           194: .IR mail (1))
        !           195: via 
        !           196: .IR uux .
        !           197: .SH BUGS
        !           198: Only the first command of a shell pipeline may
        !           199: have a
        !           200: .IB system-name !\fR.
        !           201: All other commands are executed on the system of the first
        !           202: command.
        !           203: .PP
        !           204: The use of the shell metacharacter
        !           205: .B \(**
        !           206: will probably not do what you want it to do.
        !           207: .PP
        !           208: The shell tokens
        !           209: .B <<
        !           210: and
        !           211: .B >>
        !           212: are not implemented.
        !           213: .PP
        !           214: When invoking
        !           215: .I uux
        !           216: from
        !           217: .IR csh (1),
        !           218: the `!' character must be prefixed by the `\\' escape to inhibit
        !           219: .IR csh 's
        !           220: history mechanism. (Quotes are not sufficient.)

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