Annotation of researchv10no/cmd/uucp/man/uucp.1c, revision 1.1

1.1     ! root        1: .\"@(#)uucp.1c 5.2
        !             2: .TH UUCP 1C
        !             3: .SH NAME
        !             4: uucp, uulog, uuname \- unix to unix copy
        !             5: .SH SYNOPSIS
        !             6: .B uucp
        !             7: [ options ]
        !             8: source-files destination-file
        !             9: .PP
        !            10: .B uulog
        !            11: [ options ]
        !            12: .RB  \-s \^system
        !            13: .PP
        !            14: or
        !            15: .PP
        !            16: .B uulog
        !            17: [ options ]
        !            18: .RB  \-f \^system
        !            19: .PP
        !            20: .B uuname
        !            21: [
        !            22: .B \-l
        !            23: ]
        !            24: .SH DESCRIPTION
        !            25: .SS Uucp.
        !            26: .I Uucp\^
        !            27: copies files named by the
        !            28: .I source-file\^
        !            29: arguments to the
        !            30: .I destination-file\^
        !            31: argument.
        !            32: A file name may be a path name on your machine, or may
        !            33: have the form:
        !            34: .PP
        !            35: .RS .5i
        !            36: system-name!path-name
        !            37: .RE
        !            38: .PP
        !            39: where
        !            40: .I system-name\^
        !            41: is taken from a list of system names that
        !            42: .I uucp\^
        !            43: knows about.
        !            44: The
        !            45: .I system-name\^
        !            46: may also be a list of names such as
        !            47: .PP
        !            48: .RS .5i
        !            49: system-name!system-name!...!system-name!path-name
        !            50: .RE
        !            51: .PP
        !            52: in which case an attempt is made to send the file via the specified route,
        !            53: to the destination.
        !            54: (see BUGS below for restrictions)
        !            55: Care should be taken to ensure that intermediate nodes in the
        !            56: route are willing to foward information.
        !            57: .PP
        !            58: The shell metacharacters
        !            59: .BR ? ,
        !            60: .B \(**
        !            61: and
        !            62: .B [\|.\|.\|.\|]
        !            63: appearing in
        !            64: .I path-name\^
        !            65: will be expanded on the appropriate system.
        !            66: .PP
        !            67: Path names may be one of:
        !            68: .PP
        !            69: .RS
        !            70: .TP
        !            71: (1)
        !            72: a full path name;
        !            73: .TP
        !            74: (2)
        !            75: a path name preceded by
        !            76: .BI ~ user\^
        !            77: where
        !            78: .I user\^
        !            79: is a login name on the specified system
        !            80: and is replaced by that user's login directory;
        !            81: .TP
        !            82: (3)
        !            83: a path name preceded by
        !            84: .BI ~/ destination\^
        !            85: where
        !            86: .I destination\^
        !            87: is appended to \s-1/usr/spool/uucppublic\s+1;
        !            88: (\fBNOTE:\fR  This destination will be treated as a file name unless
        !            89: more than one file is being transfered by this request or
        !            90: the destination is already a directory.
        !            91: To \fBensure\fR that it is a directory, follow the destination with a '/'.
        !            92: For example  ~/dan/ as the destination will make the directory
        !            93: /usr/spool/uucppublic/dan if it does not exist and put the requested file(s)
        !            94: in that directory).
        !            95: .TP
        !            96: (4)
        !            97: anything else is prefixed by the current directory.
        !            98: .RE
        !            99: .PP
        !           100: If the result is an erroneous path name for the remote system
        !           101: the copy will fail.
        !           102: If the
        !           103: .I destination-file\^
        !           104: is a directory, the last part of the
        !           105: .I source-file\^
        !           106: name is used.
        !           107: .ig
        !           108: If a simple
        !           109: .I ~user\^
        !           110: destination is inaccessible to 
        !           111: .IR uucp ,
        !           112: data is copied to a spool directory and the user
        !           113: is notified by
        !           114: .IR mail (1).
        !           115: ..
        !           116: .PP
        !           117: .I Uucp\^
        !           118: preserves execute permissions across the transmission
        !           119: and gives 0666 read and write permissions (see
        !           120: .IR chmod (2)).
        !           121: .PP
        !           122: The following options are interpreted by
        !           123: .IR uucp :
        !           124: .TP .5i
        !           125: .B \-c
        !           126: Don't copy local file to the spool directory for transfer to the remote
        !           127: machine (default).
        !           128: .TP .5i
        !           129: .B \-C
        !           130: Force the copy of local files to the spool directory for transfer.
        !           131: .TP .5i
        !           132: .B \-d
        !           133: Make all necessary directories for the file copy (default).
        !           134: .TP .5i
        !           135: .B \-f
        !           136: Do not make intermediate directories for the file copy.
        !           137: .TP .5i
        !           138: .BI \-g grade\^
        !           139: Grade is a single letter/number;
        !           140: lower ASCII sequence characters will cause the job to be transmitted
        !           141: earlier during a particular conversation.
        !           142: .TP .5i
        !           143: .B \-j
        !           144: Output the job identification
        !           145: \s-1ASCII\s+1 string on the standard output.
        !           146: This job identification can be used by
        !           147: .I uustat\^
        !           148: to obtain the status 
        !           149: or terminate a job.
        !           150: .TP .5i
        !           151: .B \-m
        !           152: Send mail to the requester when the copy is
        !           153: completed.
        !           154: .TP .5i
        !           155: .BI \-s file\^
        !           156: Report status of the transfer to
        !           157: .I file.\^
        !           158: .TP .5i
        !           159: .BI \-n user\^
        !           160: Notify
        !           161: .I user\^
        !           162: on the remote system that a file was sent.
        !           163: .TP .5i
        !           164: .B \-r
        !           165: Don't start the file transfer, just queue the job.
        !           166: .TP .5i
        !           167: .BI \-x debug-level\^
        !           168: Produce debugging output on stdout.
        !           169: The debug_level is a number between 0 and 9;
        !           170: higher numbers give more detailed information.
        !           171: .SS Uulog.
        !           172: .PP
        !           173: .I Uulog\^
        !           174: queries a log file
        !           175: of 
        !           176: .I uucp\^
        !           177: or
        !           178: .I uuxqt
        !           179: transactions in a file
        !           180: .BI /usr/spool/uucp/.Log/uucico/ system.
        !           181: or
        !           182: .BI /usr/spool/uucp/.Log/uuxqt/ system.
        !           183: .ne 3
        !           184: .PP
        !           185: The options cause 
        !           186: .I uulog
        !           187: to print logging information:
        !           188: .TP .5i
        !           189: .BI \-s sys\^
        !           190: Print information about file transfer work involving system
        !           191: .IR sys .
        !           192: .TP .5i
        !           193: .BI \-f sys\^
        !           194: Does a ``tail -f'' of the file transfer log for system
        !           195: .IR sys .
        !           196: Other options used in conjunction with the above:
        !           197: .TP .5i
        !           198: .B \-x
        !           199: Look in the uuxqt log file for the given system.
        !           200: .TP .5i
        !           201: .BI \- number\^
        !           202: Indicates that a ``tail'' command of
        !           203: .I number
        !           204: lines should be done.
        !           205: .SS Uuname.
        !           206: .PP
        !           207: .I Uuname\^
        !           208: lists the uucp names of known systems.
        !           209: The
        !           210: .B \-l
        !           211: option returns the local system name.
        !           212: .SH FILES
        !           213: .PD 0
        !           214: .TP \w'/usr/spool/uucppublic/*\ \ 'u
        !           215: /usr/spool/uucp
        !           216: spool directories
        !           217: .TP
        !           218: /usr/spool/uucppublic/\(**
        !           219: public directory for receiving and sending (\s-1/usr/spool/uucppublic\s0)
        !           220: .TP
        !           221: /usr/lib/uucp/\(**
        !           222: other data and program files
        !           223: .PD
        !           224: .SH SEE ALSO
        !           225: mail(1), uux(1C).
        !           226: .SH WARNING
        !           227: The domain of remotely accessible files can
        !           228: (and for obvious security reasons, usually should)
        !           229: be severely restricted.
        !           230: You will very likely not be able to fetch files
        !           231: by path name;
        !           232: ask a responsible person on the remote system to
        !           233: send them to you.
        !           234: For the same reasons you will probably not be able
        !           235: to send files to arbitrary path names.
        !           236: As distributed, the remotely accessible files are
        !           237: those whose names begin
        !           238: .B /usr/spool/uucppublic
        !           239: (equivalent to
        !           240: .BR ~/ ).
        !           241: .PP
        !           242: All files received by
        !           243: .I uucp\^
        !           244: will be owned by
        !           245: .IR uucp .
        !           246: .br
        !           247: The \fB\-m\fP option will only work sending files or receiving
        !           248: a single file.
        !           249: Receiving multiple files specified by special shell
        !           250: characters \fB? \(** \|[\|.\|.\|.\|]\fP will not activate
        !           251: the \fB\-m\fP option.
        !           252: .P
        !           253: The forwarding of files through other systems is NOT compataible
        !           254: with the previous version of uucp.  If forwarding is used, all
        !           255: systems in the route must have the same version of uucp.
        !           256: .SH BUGS
        !           257: Protected files and files that are in protected directories
        !           258: that are owned by the requestor can be sent by
        !           259: .IR uucp .
        !           260: However, if the requestor is root, and the directory is not searchable
        !           261: by "other" or the file is not readable by "other",
        !           262: the request will fail due to a bug in setuid().
        !           263: .\"    @(#)

unix.superglobalmegacorp.com

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