uucp(1)                                                   uucp(1)

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  begin-
       ning  with a simple ~ starts at the UUCP public directory;
       a pathname beginning with ~name starts at the home  direc-
       tory  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 appro-
       priate  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 immedi-
       ately 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  direc-
            tory.   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  opera-
            tions  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  sys-
            tem!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 num-
            ber  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.

FILES
       The file names may be changed at compilation  time  or  by
       the  configuration file, so these are only approximations.

       /etc/uucp/config - Configuration file.
       /etc/uucp/oldconfig/ - Alternative configuration  (HDB  or
       V2 format)
       /var/spool/uucp - UUCP spool directory.
       /var/log/uucp/Log - UUCP log file.
       /var/spool/uucppublic - Default UUCP public directory.

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.06                       1