4.3BSD-UWisc/man/cat1/uucp.1c




UUCP(1C)            UNIX Programmer's Manual             UUCP(1C)



NAME
     uucp - unix to unix copy

SYNOPSIS
     uucp [ -acCdfmr ] [ -n_u_s_e_r ] [ -g_g_r_a_d_e ] [ -s_s_p_o_o_l ] [ -x_d_e_-
     _b_u_g ] source-file....  destination-file

DESCRIPTION
     _U_u_c_p copies files named by the source-file arguments to the
     destination-file argument.  A file name may be a pathname on
     your machine, or may have the form

          system-name!pathname

     where `system-name' is taken from a list of system names
     that _u_u_c_p knows about.  Shell metacharacters ?*[] appearing
     in the pathname part will be expanded on the appropriate
     system.

     Pathnames may be one of:

     (1)  a full pathname;

     (2)  a pathname preceded by ~_u_s_e_r; where _u_s_e_r is a userid on
          the specified system and is replaced by that user's
          login directory;

     (3)  a pathname prefixed by ~, where ~ is expanded into the
          system's public directory (usually
          /usr/spool/uucppublic);

     (4)  a partial pathname, which is prefixed by the current
          directory.

     If the result is an erroneous pathname for the remote sys-
     tem, the copy will fail.  If the destination-file is a
     directory, the last part of the source-file name is used.

     _U_u_c_p preserves execute permissions across the transmission
     and gives 0666 read and write permissions (see _c_h_m_o_d(2)).

     The following options are interpreted by _u_u_c_p.

     -a   Avoid doing a _g_e_t_w_d to find the current directory.
          (This is sometimes used for efficiency.)

     -c   Use the source file when copying out rather than copy-
          ing the file to the spool directory.  (This is the
          default.)

     -C   Copy the source file to the spool directory and
          transmit the copy.



Printed 12/27/86         April 24, 1986                         1






UUCP(1C)            UNIX Programmer's Manual             UUCP(1C)



     -d   Make all necessary directories for the file copy.
          (This is the default.)

     -f   Do not make intermediate directories for the file copy.

     -g_g_r_a_d_e
          _G_r_a_d_e is a single letter/number; lower ASCII sequence
          characters will cause a job to be transmitted earlier
          during a particular conversation.  Default is `n'. By
          way of comparison, _u_u_x(1C) defaults to `A'; mail is
          usually sent at `C'.

     -m   Send mail to the requester when the copy is complete.

     -n_u_s_e_r
          Notify _u_s_e_r on remote system (i.e., send _u_s_e_r mail)
          that a file was sent.

     -r   Do not start the transfer, just queue the job.

     -s_s_p_o_o_l
          Use _s_p_o_o_l as the spool directory instead of the
          default.

     -x_d_e_b_u_g
          Turn on the debugging at level _d_e_b_u_g.

FILES
     /usr/spool/uucp - spool directory
     /usr/lib/uucp/* - other data and program files

SEE ALSO
     uux(1C), mail(1)

     D. A. Nowitz and M. E. Lesk, _A _D_i_a_l-_U_p _N_e_t_w_o_r_k _o_f _U_N_I_X _S_y_s_-
     _t_e_m_s.

     D. A. Nowitz, _U_u_c_p _I_m_p_l_e_m_e_n_t_a_t_i_o_n _D_e_s_c_r_i_p_t_i_o_n.

WARNING
     The domain of remotely accessible files can (and for obvious
     security reasons, usually should) be severely restricted.
     You will very likely not be able to fetch files by pathname;
     ask a responsible person on the remote system to send them
     to you.  For the same reasons you will probably not be able
     to send files to arbitrary pathnames.

BUGS
     All files received by _u_u_c_p will be owned by the uucp
     administrator (usually UID 5).





Printed 12/27/86         April 24, 1986                         2






UUCP(1C)            UNIX Programmer's Manual             UUCP(1C)



     The -m option will only work sending files or receiving a
     single file.  (Receiving multiple files specified by special
     shell characters ?*[] will not activate the -m option.)

     At present _u_u_c_p cannot copy to a system several "hops" away,
     that is, a command of the form

          uucp myfile system1!system2!system3!yourfile

     is not permitted. Use _u_u_s_e_n_d(1C) instead.

     When invoking _u_u_c_p from _c_s_h(1), the `!' character must be
     prefixed by the `\' escape to inhibit _c_s_h's history mechan-
     ism. (Quotes are not sufficient.)

     _U_u_c_p refuses to copy a file that does not give read access
     to ``other''; that is, the file must have at least 0444
     modes.





































Printed 12/27/86         April 24, 1986                         3