Annotation of researchv10no/cmd/uucp/man/uucp.1c, revision 1.1.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.