diff options
Diffstat (limited to 'upstream/archlinux/man1/uucp.1')
-rw-r--r-- | upstream/archlinux/man1/uucp.1 | 197 |
1 files changed, 197 insertions, 0 deletions
diff --git a/upstream/archlinux/man1/uucp.1 b/upstream/archlinux/man1/uucp.1 new file mode 100644 index 00000000..be6ce8b3 --- /dev/null +++ b/upstream/archlinux/man1/uucp.1 @@ -0,0 +1,197 @@ +''' $Id: uucp.1,v 1.12 2002/03/05 22:13:33 ian Rel $ +.TH uucp 1 "Taylor UUCP 1.07" +.SH NAME +uucp \- Unix to Unix copy +.SH SYNOPSIS +.B uucp +[ options ] source-file destination-file +.PP +.B uucp +[ options ] source-file... destination-directory +.SH DESCRIPTION +The +.I uucp +command copies files between systems. Each +.I file +argument is either a pathname on the local machine or is of the form +.IP +system!path +.LP +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 +.I system2 +via +.I system1 +by using +.IP +system1!system2!path. +.LP + +Any pathname that does not begin with / or ~ will be appended to the +current directory (unless the +.B \-W +or +.B \--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 +.I 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 +.I uucico +(8) daemon; the daemon is started immediately unless the +.B \-r +or +.B \-\-nouucico +switch is given. In any case, the next time the remote system is called the +file(s) will be copied. +.SH OPTIONS +The following options may be given to +.I uucp. +.TP 5 +.B \-c, \-\-nocopy +Do not copy local source files to the spool directory. If they are +removed before being processed by the +.I uucico +(8) daemon, the copy will fail. The files must be readable by the +.I uucico +(8) daemon, and by the invoking user. +.TP 5 +.B \-C, \-\-copy +Copy local source files to the spool directory. This is the default. +.TP 5 +.B \-d, \-\-directories +Create all necessary directories when doing the copy. This is the +default. +.TP 5 +.B \-f, \-\-nodirectories +If any necessary directories do not exist for the destination path, +abort the copy. +.TP 5 +.B \-R, \-\-recursive +If any of the source file names are directories, copy their contents +recursively to the destination (which must itself be a directory). +.TP 5 +.B \-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. +.TP 5 +.B \-m, \-\-mail +Report completion or failure of the file transfer by +.I mail +(1). +.TP 5 +.B \-n user, \-\-notify user +Report completion or failure of the file transfer by +.I mail +(1) to the named +user on the remote system. +.TP 5 +.B \-r, \-\-nouucico +Do not start +.I uucico +(8) daemon immediately; merely queue up the file transfer for later +execution. +.TP 5 +.B \-j, \-\-jobid +Print jobid on standard output. The job may be +later cancelled by passing the jobid to the +.B \-k +switch of +.I 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 +.br +.in +0.5i +.nf +uucp sys1!~user1/file1 sys2!~user2/file2 ~user3 +.fi +.in -0.5i +will generate two separate jobs, one for the system +.I sys1 +and one for the system +.I sys2. +.TP 5 +.B \-W, \-\-noexpand +Do not prepend remote relative path names with the current directory. +.TP 5 +.B \-t, \-\-uuto +This option is used by the +.I uuto +shell script. It causes +.I uucp +to interpret the final argument as +.I system!user. +The file(s) are sent to +.I ~/receive/USER/LOCAL +on the remote system, where +.I USER +is from the final argument and +.I LOCAL +is the local UUCP +system name. Also, +.I uucp +will act as though +.I \-\-notify user +were specified. +.TP 5 +.B \-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 +.I uucp. + +Multiple types may be given, separated by commas, and the +.B \-\-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, +.B \-\-debug 2 +is equivalent to +.B \-\-debug abnormal,chat. +.TP 5 +.B \-I file, \-\-config file +Set configuration file to use. This option may not be available, +depending upon how +.I uucp +was compiled. +.TP 5 +.B \-v, \-\-version +Report version information and exit. +.TP 5 +.B \-\-help +Print a help message and exit. +.SH SEE ALSO +mail(1), uux(1), uustat(1), uucico(8) +.SH BUGS +Some of the options are dependent on the capabilities of the +.I uucico +(8) daemon on the remote system. + +The +.I \-n +and +.I \-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. +.SH AUTHOR +Ian Lance Taylor +<ian@airs.com> |