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

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