xenial (1) uucp.1.gz

Provided by: uucp_1.07-23_amd64 bug

NAME

       uucp - Unix to Unix copy

SYNOPSIS

       uucp [ options ] source-file destination-file

       uucp [ options ] source-file... destination-directory

DESCRIPTION

       The  uucp  command  copies  files  between systems.  Each file argument is either a pathname on the local
       machine or is of the form

              system!path

       which is interpreted as being on a remote system.  In the first form, the contents of the first file  are
       copied to the second.  In the second form, each source file is copied into the destination directory.

       A file be transferred to or from system2 via system1 by using

              system1!system2!path.

       Any  pathname that does not begin with / or ~ will be appended to the current directory (unless the -W or
       --noexpand option is used); this resulting path will  not  necessarily  exist  on  a  remote  system.   A
       pathname  beginning  with a simple ~ starts at the UUCP public directory; a pathname beginning with ~name
       starts at the home directory of the named user.  The ~ is interpreted on the  appropriate  system.   Note
       that some shells will interpret a simple ~ to the local home directory before uucp sees it; to avoid this
       the ~ must be quoted.

       Shell metacharacters ? * [ ] are interpreted on the appropriate  system,  assuming  they  are  quoted  to
       prevent the shell from interpreting them first.

       The  copy  does  not  take  place  immediately, but is queued up for the uucico (8) daemon; the daemon is
       started immediately unless the -r or --nouucico switch is given.  In any case, the next time  the  remote
       system is called the file(s) will be copied.

OPTIONS

       The following options may be given to uucp.

       -c, --nocopy
            Do  not  copy local source files to the spool directory.  If they are removed before being processed
            by the uucico (8) daemon, the copy will fail.  The files must be readable by the uucico (8)  daemon,
            and by the invoking user.

       -C, --copy
            Copy local source files to the spool directory.  This is the default.

       -d, --directories
            Create all necessary directories when doing the copy.  This is the default.

       -f, --nodirectories
            If any necessary directories do not exist for the destination path, abort the copy.

       -R, --recursive
            If  any of the source file names are directories, copy their contents recursively to the destination
            (which must itself be a directory).

       -g grade, --grade grade
            Set the grade of the file transfer command.  Jobs of a higher grade are executed first.  Grades  run
            0 ... 9 A ... Z a ... z from high to low.

       -m, --mail
            Report completion or failure of the file transfer by mail (1).

       -n user, --notify user
            Report  completion  or  failure  of  the  file  transfer by mail (1) to the named user on the remote
            system.

       -r, --nouucico
            Do not start uucico (8) daemon immediately; merely queue up the file transfer for later execution.

       -j, --jobid
            Print jobid on standard output.  The job may be later cancelled by  passing  the  jobid  to  the  -k
            switch of uustat (1).  It is possible for some complex operations to produce more than one jobid, in
            which case each will be printed on a separate line.  For example
                 uucp sys1!~user1/file1 sys2!~user2/file2 ~user3
            will generate two separate jobs, one for the system sys1 and one for the system sys2.

       -W, --noexpand
            Do not prepend remote relative path names with the current directory.

       -t, --uuto
            This option is used by the uuto shell script.  It causes uucp to interpret  the  final  argument  as
            system!user.   The file(s) are sent to ~/receive/USER/LOCAL on the remote system, where USER is from
            the final argument and LOCAL is the local UUCP system name.  Also, uucp will act as though  --notify
            user were specified.

       -x type, --debug type
            Turn  on particular debugging types.  The following types are recognized: abnormal, chat, handshake,
            uucp-proto, proto, port, config, spooldir, execute,  incoming,  outgoing.   Only  abnormal,  config,
            spooldir and execute are meaningful for uucp.

            Multiple  types may be given, separated by commas, and the --debug option may appear multiple times.
            A number may also be given, which will turn on that many types from the foregoing list; for example,
            --debug 2 is equivalent to --debug abnormal,chat.

       -I file, --config file
            Set  configuration  file  to  use.   This  option  may not be available, depending upon how uucp was
            compiled.

       -v, --version
            Report version information and exit.

       --help
            Print a help message and exit.

SEE ALSO

       mail(1), uux(1), uustat(1), uucico(8)

BUGS

       Some of the options are dependent on the capabilities of the uucico (8) daemon on the remote system.

       The -n and -m switches do not work when transferring a file from one remote system to another.

       File modes are not preserved, except for the execute bit.  The resulting file is owned by the uucp user.

AUTHOR

       Ian Lance Taylor <ian@airs.com>

                                                Taylor UUCP 1.07                                         uucp(1)