Annotation of coherent/g/usr/lib/uucp/tay104/uucp.1, revision 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.