Annotation of 43BSDTahoe/man/man1/uucp.1, revision 1.1.1.1

1.1       root        1: .\"    @(#)uucp.1c     6.3 (Berkeley) 4/24/86
                      2: .\"
                      3: .TH UUCP 1C "April 24, 1986"
                      4: .AT 3
                      5: .SH NAME
                      6: uucp \- unix to unix copy
                      7: .SH SYNOPSIS
                      8: .B uucp
                      9: [
                     10: .B \-acCdfmr
                     11: ] [
                     12: .BI \-n user
                     13: ] [
                     14: .BI \-g grade
                     15: ] [
                     16: .BI \-s spool
                     17: ] [
                     18: .BI \-x debug
                     19: ] source-file....  destination-file
                     20: .SH DESCRIPTION
                     21: .I Uucp
                     22: copies files named by the source-file arguments
                     23: to the destination-file argument.
                     24: A file name may be a pathname on your machine, or may 
                     25: have the form
                     26: .IP
                     27: system-name!pathname
                     28: .LP
                     29: where `system-name' is taken from a list of system names
                     30: that
                     31: .I uucp
                     32: knows about.
                     33: Shell metacharacters ?*[] appearing in the pathname part
                     34: will be expanded on the appropriate system.
                     35: .PP
                     36: Pathnames may be one of:
                     37: .IP (1)
                     38: a full pathname;
                     39: .IP (2)
                     40: a pathname preceded by
                     41: .BI ~ user;
                     42: where
                     43: .I user
                     44: is a userid on the specified system
                     45: and is replaced by that user's login directory;
                     46: .IP (3)
                     47: a pathname prefixed by
                     48: .BR ~ ,
                     49: where
                     50: .B ~
                     51: is expanded into the system's public directory (usually /usr/spool/uucppublic);
                     52: .IP (4)
                     53: a partial pathname, which is prefixed by the current directory.
                     54: .PP
                     55: If the result is an erroneous pathname for the remote system,
                     56: the copy will fail.
                     57: If the destination-file is a directory, the last part of the
                     58: source-file name is used.
                     59: .ig
                     60: If a simple
                     61: .I ~user
                     62: destination is inaccessible to 
                     63: .IR uucp ,
                     64: data is copied to a spool directory and the user
                     65: is notified by
                     66: .IR mail (1).
                     67: ..
                     68: .PP
                     69: .I Uucp
                     70: preserves execute permissions across the transmission
                     71: and gives 0666 read and write permissions (see
                     72: .IR chmod (2)).
                     73: .PP
                     74: The following options are interpreted by
                     75: .IR uucp .
                     76: .TP
                     77: .B \-a
                     78: Avoid doing a
                     79: .I getwd
                     80: to find the current directory.
                     81: (This is sometimes used for efficiency.)
                     82: .TP 
                     83: .B \-c
                     84: Use the source file when copying out rather than
                     85: copying the file to the spool directory.
                     86: (This is the default.)
                     87: .TP
                     88: .B \-C
                     89: Copy the source file to the spool directory and transmit
                     90: the copy.
                     91: .TP 
                     92: .B \-d
                     93: Make all necessary directories for the file copy.
                     94: (This is the default.)
                     95: .TP
                     96: .B \-f
                     97: Do not make intermediate directories for the file copy.
                     98: .TP
                     99: .BI \-g grade
                    100: .I Grade
                    101: is a single letter/number; lower ASCII sequence characters
                    102: will cause a job to be transmitted earlier during a particular conversation.
                    103: Default is `n'. By way of comparison,
                    104: .IR uux (1C)
                    105: defaults to `A'; mail is usually sent at `C'.
                    106: .TP 
                    107: .B \-m
                    108: Send mail to the requester when the copy is complete.
                    109: .TP
                    110: .BI \-n user
                    111: Notify
                    112: .I user
                    113: on remote system (i.e., send
                    114: .I user
                    115: mail) that a file was sent.
                    116: .TP
                    117: .B \-r
                    118: Do not start the transfer, just queue the job.
                    119: .TP
                    120: .BI \-s spool
                    121: Use
                    122: .I spool
                    123: as the spool directory instead of the default.
                    124: .TP
                    125: .BI \-x debug
                    126: Turn on the debugging at level
                    127: .I debug.
                    128: .SH FILES
                    129: /usr/spool/uucp - spool directory
                    130: .br
                    131: /usr/lib/uucp/* - other data and program files
                    132: .SH SEE ALSO
                    133: uux(1C), mail(1)
                    134: .PP
                    135: D. A. Nowitz and M. E. Lesk,
                    136: .IR "A Dial-Up Network of UNIX Systems" .
                    137: .PP
                    138: D. A. Nowitz,
                    139: .IR "Uucp Implementation Description" .
                    140: .SH WARNING
                    141: The domain of remotely accessible files can
                    142: (and for obvious security reasons, usually should)
                    143: be severely restricted.
                    144: You will very likely not be able to fetch files
                    145: by pathname;
                    146: ask a responsible person on the remote system to
                    147: send them to you.
                    148: For the same reasons you will probably not be able
                    149: to send files to arbitrary pathnames.
                    150: .SH BUGS
                    151: .br
                    152: All files received by
                    153: .I uucp
                    154: will be owned by the uucp administrator (usually UID 5).
                    155: .PP
                    156: The 
                    157: .B \-m
                    158: option will only work sending files or receiving
                    159: a single file.
                    160: (Receiving multiple files specified by special shell
                    161: characters ?*[] will not activate
                    162: the
                    163: .B \-m
                    164: option.)
                    165: .PP
                    166: At present
                    167: .I uucp
                    168: cannot copy to a system several "hops" away, that is, a command of
                    169: the form
                    170: .PP
                    171: .nf
                    172:        uucp myfile system1!system2!system3!yourfile
                    173: .fi
                    174: .PP
                    175: is not permitted. Use
                    176: .IR uusend (1C)
                    177: instead.
                    178: .PP
                    179: When invoking
                    180: .I uucp
                    181: from
                    182: .IR csh (1),
                    183: the `!' character must be prefixed by the `\e' escape to inhibit
                    184: .IR csh 's
                    185: history mechanism. (Quotes are not sufficient.)
                    186: .PP
                    187: .I Uucp
                    188: refuses to copy a file that does not give read access to ``other'';
                    189: that is, the file must have at least 0444 modes.

unix.superglobalmegacorp.com

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