manual/GNU_uucp/original/man1/uucp.1

   1 ''' $Id: uucp.1,v 1.11 1995/06/26 21:34:49 ian Rel $
   2 .TH uucp 1 "Taylor UUCP 1.06"
   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 or
  38 .B \--noexpand
  39 option is used); this resulting path will not necessarily exist on a
  40 remote system.  A pathname beginning with a simple ~ starts at the
  41 UUCP public directory; a pathname beginning with ~name starts at the
  42 home directory of the named user.  The ~ is interpreted on the
  43 appropriate system.  Note that some shells will interpret a simple ~
  44 to the local home directory before
  45 .I uucp
  46 sees it; to avoid this the ~ must be quoted.
  47
  48 Shell metacharacters ? * [ ] are interpreted on the appropriate
  49 system, assuming they are quoted to prevent the shell from
  50 interpreting them first.
  51
  52 The copy does not take place immediately, but is queued up for the
  53 .I uucico
  54 (8) daemon; the daemon is started immediately unless the
  55 .B \-r
  56 or
  57 .B \-\-nouucico
  58 switch is given.  In any case, the next time the remote system is called the
  59 file(s) will be copied.
  60 .SH OPTIONS
  61 The following options may be given to
  62 .I uucp.
  63 .TP 5
  64 .B \-c, \-\-nocopy
  65 Do not copy local source files to the spool directory.  If they are
  66 removed before being processed by the
  67 .I uucico
  68 (8) daemon, the copy will fail.  The files must be readable by the
  69 .I uucico
  70 (8) daemon, and by the invoking user.
  71 .TP 5
  72 .B \-C, \-\-copy
  73 Copy local source files to the spool directory.  This is the default.
  74 .TP 5
  75 .B \-d, \-\-directories
  76 Create all necessary directories when doing the copy.  This is the
  77 default.
  78 .TP 5
  79 .B \-f, \-\-nodirectories
  80 If any necessary directories do not exist for the destination path,
  81 abort the copy.
  82 .TP 5
  83 .B \-R, \-\-recursive
  84 If any of the source file names are directories, copy their contents
  85 recursively to the destination (which must itself be a directory).
  86 .TP 5
  87 .B \-g grade, \-\-grade grade
  88 Set the grade of the file transfer command.  Jobs of a higher grade
  89 are executed first.  Grades run 0 ... 9 A ... Z a ... z from high to
  90 low.
  91 .TP 5
  92 .B \-m, \-\-mail
  93 Report completion or failure of the file transfer by
  94 .I mail
  95 (1).
  96 .TP 5
  97 .B \-n user, \-\-notify user
  98 Report completion or failure of the file transfer by
  99 .I mail
 100 (1) to the named
 101 user on the remote system.
 102 .TP 5
 103 .B \-r, \-\-nouucico
 104 Do not start
 105 .I uucico
 106 (8) daemon immediately; merely queue up the file transfer for later
 107 execution.
 108 .TP 5
 109 .B \-j, \-\-jobid
 110 Print jobid on standard output.  The job may be
 111 later cancelled by passing the jobid to the
 112 .B \-k
 113 switch of
 114 .I uustat
 115 (1).
 116 It is possible for some complex operations to produce more than one
 117 jobid, in which case each will be printed on a separate line.  For
 118 example
 119 .br
 120 .in +0.5i
 121 .nf
 122 uucp sys1!~user1/file1 sys2!~user2/file2 ~user3
 123 .fi
 124 .in -0.5i
 125 will generate two separate jobs, one for the system
 126 .I sys1
 127 and one for the system
 128 .I sys2.
 129 .TP 5
 130 .B \-W, \-\-noexpand
 131 Do not prepend remote relative path names with the current directory.
 132 .TP 5
 133 .B \-t, \-\-uuto
 134 This option is used by the
 135 .I uuto
 136 shell script.  It causes
 137 .I uucp
 138 to interpret the final argument as
 139 .I system!user.
 140 The file(s) are sent to
 141 .I ~/receive/USER/LOCAL
 142 on the remote system, where
 143 .I USER
 144 is from the final argument and
 145 .I LOCAL
 146 is the local UUCP
 147 system name.  Also,
 148 .I uucp
 149 will act as though
 150 .I \-\-notify user
 151 were specified.
 152 .TP 5
 153 .B \-x type, \-\-debug type
 154 Turn on particular debugging types.  The following types are
 155 recognized: abnormal, chat, handshake, uucp-proto, proto, port,
 156 config, spooldir, execute, incoming, outgoing.  Only abnormal, config,
 157 spooldir and execute are meaningful for
 158 .I uucp.
 159
 160 Multiple types may be given, separated by commas, and the
 161 .B \-\-debug
 162 option may appear multiple times.  A number may also be given, which
 163 will turn on that many types from the foregoing list; for example,
 164 .B \-\-debug 2
 165 is equivalent to
 166 .B \-\-debug abnormal,chat.
 167 .TP 5
 168 .B \-I file, \-\-config file
 169 Set configuration file to use.  This option may not be available,
 170 depending upon how
 171 .I uucp
 172 was compiled.
 173 .TP 5
 174 .B \-v, \-\-version
 175 Report version information and exit.
 176 .TP 5
 177 .B \-\-help
 178 Print a help message and exit.
 179 .SH FILES
 180 The file names may be changed at compilation time or by the
 181 configuration file, so these are only approximations.
 182
 183 .br
 184 /usr/lib/uucp/config - Configuration file.
 185 .br
 186 /usr/spool/uucp -
 187 UUCP spool directory.
 188 .br
 189 /usr/spool/uucp/Log -
 190 UUCP log file.
 191 .br
 192 /usr/spool/uucppublic -
 193 Default UUCP public directory.
 194 .SH SEE ALSO
 195 mail(1), uux(1), uustat(1), uucico(8)
 196 .SH BUGS
 197 Some of the options are dependent on the capabilities of the
 198 .I uucico
 199 (8) daemon on the remote system.
 200
 201 The
 202 .I \-n
 203 and
 204 .I \-m
 205 switches do not work when transferring a file from one remote system
 206 to another.
 207
 208 File modes are not preserved, except for the execute bit.  The
 209 resulting file is owned by the uucp user.
 210 .SH AUTHOR
 211 Ian Lance Taylor
 212 <ian@airs.com>