BSD 4_3_Tahoe development

[unix-history] / usr / man / cat1 / uucp.0

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



N\bNA\bAM\bME\bE
     uucp - unix to unix copy

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
     u\buu\buc\bcp\bp [ -\b-a\bac\bcC\bCd\bdf\bfm\bmr\br ] [ -\b-n\bn_\bu_\bs_\be_\br ] [ -\b-g\bg_\bg_\br_\ba_\bd_\be ] [ -\b-s\bs_\bs_\bp_\bo_\bo_\bl ] [ -\b-x\bx_\bd_\be_\b-
     _\bb_\bu_\bg ] source-file....  destination-file

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
     _\bU_\bu_\bc_\bp 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 _\bu_\bu_\bc_\bp 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 ~\b~_\bu_\bs_\be_\br; where _\bu_\bs_\be_\br is a userid on
	  the specified system and is replaced by that user's
	  login directory;

     (3)  a pathname prefixed by ~\b~, where ~\b~ 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.

     _\bU_\bu_\bc_\bp preserves execute permissions across the transmission
     and gives 0666 read and write permissions (see _\bc_\bh_\bm_\bo_\bd(2)).

     The following options are interpreted by _\bu_\bu_\bc_\bp.

     -\b-a\ba   Avoid doing a _\bg_\be_\bt_\bw_\bd to find the current directory.
	  (This is sometimes used for efficiency.)

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

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



Printed 7/9/88		 April 24, 1986                         1






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



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

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

     -\b-g\bg_\bg_\br_\ba_\bd_\be
	  _\bG_\br_\ba_\bd_\be 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, _\bu_\bu_\bx(1C) defaults to `A'; mail is
	  usually sent at `C'.

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

     -\b-n\bn_\bu_\bs_\be_\br
	  Notify _\bu_\bs_\be_\br on remote system (i.e., send _\bu_\bs_\be_\br mail)
	  that a file was sent.

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

     -\b-s\bs_\bs_\bp_\bo_\bo_\bl
	  Use _\bs_\bp_\bo_\bo_\bl as the spool directory instead of the
	  default.

     -\b-x\bx_\bd_\be_\bb_\bu_\bg
	  Turn on the debugging at level _\bd_\be_\bb_\bu_\bg.

F\bFI\bIL\bLE\bES\bS
     /usr/spool/uucp - spool directory
     /usr/lib/uucp/* - other data and program files

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
     uux(1C), mail(1)

     D. A. Nowitz and M. E. Lesk, _\bA _\bD_\bi_\ba_\bl-_\bU_\bp _\bN_\be_\bt_\bw_\bo_\br_\bk _\bo_\bf _\bU_\bN_\bI_\bX _\bS_\by_\bs_\b-
     _\bt_\be_\bm_\bs.

     D. A. Nowitz, _\bU_\bu_\bc_\bp _\bI_\bm_\bp_\bl_\be_\bm_\be_\bn_\bt_\ba_\bt_\bi_\bo_\bn _\bD_\be_\bs_\bc_\br_\bi_\bp_\bt_\bi_\bo_\bn.

W\bWA\bAR\bRN\bNI\bIN\bNG\bG
     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.

B\bBU\bUG\bGS\bS
     All files received by _\bu_\bu_\bc_\bp will be owned by the uucp
     administrator (usually UID 5).





Printed 7/9/88		 April 24, 1986                         2






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



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

     At present _\bu_\bu_\bc_\bp 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 _\bu_\bu_\bs_\be_\bn_\bd(1C) instead.

     When invoking _\bu_\bu_\bc_\bp from _\bc_\bs_\bh(1), the `!' character must be
     prefixed by the `\' escape to inhibit _\bc_\bs_\bh's history mechan-
     ism. (Quotes are not sufficient.)

     _\bU_\bu_\bc_\bp refuses to copy a file that does not give read access
     to ``other''; that is, the file must have at least 0444
     modes.





































Printed 7/9/88		 April 24, 1986                         3