Return to uucp.1 CVS log

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

Annotation of 43BSDReno/usr.bin/uucp/uucp.1, revision 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.

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