Annotation of coherent/g/usr/lib/uucp/tay104/uucp.1, revision 1.1.1.1

1.1       root        1: ''' $Id: uucp.1,v 1.1 93/07/30 07:58:23 bin Exp Locker: bin $
                      2: .TH uucp 1 "Taylor UUCP 1.04"
                      3: .SH NAME
                      4: uucp \- Unix to Unix copy
                      5: .SH SYNOPSIS
                      6: .B uucp
                      7: [ options ] source-file destination-file
                      8: .PP
                      9: .B uucp
                     10: [ options ] source-file... destination-directory
                     11: .SH DESCRIPTION
                     12: The
                     13: .I uucp
                     14: command copies files between systems.  Each
                     15: .I file
                     16: argument is either a pathname on the local machine or is of the form
                     17: .IP
                     18: system!path
                     19: .LP
                     20: which is interpreted as being on a remote system.
                     21: In the first form, the contents of the first file are copied to the
                     22: second.  In the second form, each source file is copied into the
                     23: destination directory.
                     24: 
                     25: A file be transferred to or from
                     26: .I system2
                     27: via
                     28: .I system1
                     29: by using
                     30: .IP
                     31: system1!system2!path.
                     32: .LP
                     33: 
                     34: Any pathname that does not begin with / or ~ will be appended to the
                     35: current directory (unless the
                     36: .B \-W
                     37: option is used); this resulting path will not necessarily exist on a
                     38: remote system.  A pathname beginning with a simple ~ starts at the
                     39: UUCP public directory; a pathname beginning with ~name starts at the
                     40: home directory of the named user.  The ~ is interpreted on the
                     41: appropriate system.  Note that some shells will interpret a simple ~
                     42: to the local home directory before
                     43: .I uucp
                     44: sees it; to avoid this the ~ must be quoted.
                     45: 
                     46: Shell metacharacters ? * [ ] are interpreted on the appropriate
                     47: system, assuming they are quoted to prevent the shell from
                     48: interpreting them first.
                     49: 
                     50: The copy does not take place immediately, but is queued up for the
                     51: .I uucico
                     52: (8) daemon; the daemon is started immediately unless the 
                     53: .B \-r
                     54: switch is given.  In any case, the next time the remote system is called the
                     55: file(s) will be copied.
                     56: .SH OPTIONS
                     57: The following options may be given to
                     58: .I uucp.
                     59: .TP 5
                     60: .B \-c
                     61: Do not copy local source files to the spool directory.  If they are
                     62: removed before being processed by the
                     63: .I uucico
                     64: (8) daemon, the copy will fail.  The files must be readable by the
                     65: .I uucico
                     66: (8) daemon, and by the invoking user.
                     67: .TP 5
                     68: .B \-C
                     69: Copy local source files to the spool directory.  This is the default.
                     70: .TP 5
                     71: .B \-d
                     72: Create all necessary directories when doing the copy.  This is the
                     73: default.
                     74: .TP 5
                     75: .B \-f
                     76: If any necessary directories do not exist for the destination path,
                     77: abort the copy.
                     78: .TP 5
                     79: .B \-g grade
                     80: Set the grade of the file transfer command.  Jobs of a higher grade
                     81: are executed first.  Grades run 0 ... 9 A ... Z a ... z from high to
                     82: low.
                     83: .TP 5
                     84: .B \-m
                     85: Report completion or failure of the file transfer by
                     86: .I mail
                     87: (1).
                     88: .TP 5
                     89: .B \-n user
                     90: Report completion or failure of the file transfer by
                     91: .I mail
                     92: (1) to the named
                     93: user on the remote system.
                     94: .TP 5
                     95: .B \-r
                     96: Do not start
                     97: .I uucico
                     98: (8) daemon immediately; merely queue up the file transfer for later
                     99: execution.
                    100: .TP 5
                    101: .B \-j
                    102: Print jobid on standard output.  The job may be
                    103: later cancelled by passing the jobid to the
                    104: .B \-k
                    105: switch of
                    106: .I uustat
                    107: (1).
                    108: It is possible for some complex operations to produce more than one
                    109: jobid, in which case each will be printed on a separate line.  For
                    110: example
                    111: .EX
                    112: uucp sys1!~user1/file1 sys2!~user2/file2 /usr/spool/uucppublic
                    113: .EE
                    114: will generate two separate jobs, one for the system
                    115: .I sys1
                    116: and one for the system
                    117: .I sys2.
                    118: .TP 5
                    119: .B \-W
                    120: Do not prepend remote relative path names with the current directory.
                    121: .TP 5
                    122: .B \-x type
                    123: Turn on particular debugging types.  The following types are
                    124: recognized: abnormal, chat, handshake, uucp-proto, proto, port,
                    125: config, spooldir, execute, incoming, outgoing.  Only abnormal, config,
                    126: spooldir and execute are meaningful for
                    127: .I uucp.
                    128: 
                    129: Multiple types may be given, separated by commas, and the
                    130: .B \-x
                    131: option may appear multiple times.  A number may also be given, which
                    132: will turn on that many types from the foregoing list; for example,
                    133: .B \-x 2
                    134: is equivalent to
                    135: .B \-x abnormal,chat.
                    136: .TP 5
                    137: .B \-I file
                    138: Set configuration file to use.  This option may not be available,
                    139: depending upon how
                    140: .I uucp
                    141: was compiled.
                    142: .SH FILES
                    143: The file names may be changed at compilation time or by the
                    144: configuration file, so these are only approximations.
                    145: 
                    146: .br
                    147: /usr/lib/uucp/config - Configuration file.
                    148: .br
                    149: /usr/spool/uucp -
                    150: UUCP spool directory.
                    151: .br
                    152: /usr/spool/uucp/Log -
                    153: UUCP log file.
                    154: .br
                    155: /usr/spool/uucppublic -
                    156: Default UUCP public directory.
                    157: .SH SEE ALSO
                    158: mail(1), uux(1), uustat(1), uucico(8)
                    159: .SH BUGS
                    160: Some of the options are dependent on the capabilities of the
                    161: .I uucico
                    162: (8) daemon on the remote system.
                    163: 
                    164: The 
                    165: .I \-n
                    166: and
                    167: .I \-m
                    168: switches do not work when transferring a file from one remote system
                    169: to another.
                    170: 
                    171: File modes are not preserved, except for the execute bit.  The
                    172: resulting file is owned by the uucp user.
                    173: .SH AUTHOR
                    174: Ian Lance Taylor
                    175: ([email protected] or uunet!airs!ian)

unix.superglobalmegacorp.com

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