uucp(1C) uucp(1C)NAME uucp - copies files from one system to another system SYNOPSIS uucp [-c] [-C] [-d] [-f] [-ggrade] [-j] [-m] [-nlogin-name] [-r] [-sfile] [-xdebug-level] source-file destination-file ARGUMENTS -c Reads the actual source file, rather than a copy, when the file is transferred. This option is the default. -C Makes a copy of the source file in /usr/spool/uucp/system/grade, where system is the name of the system to which the file is being sent and grade is the priority assigned to the transfer. If you use this option, the copy, rather than the original file, is used to make the transfer. This option is useful if you want to modify the file after submitting your uucp request, but do not want the modified file to be transferred. -d Makes any intermediate directories at the destination. This option is the default. destination-file Specifies the pathname and filename of the copied file on the targeted system. -f Prevents the making of any intermediate directories that may be necessary for the copy to complete successfully. -ggrade Specifies a grade that is used to prioritize file transfers. The value of grade is a string of one or more alphanumeric characters. To see the available priorities, use the uuglist command, which displays a list of priorities or a message that says to use a single letter or number. -j Writes the job identification string on the standard output. The string can be used by uustat to obtain the status or terminate a uucp job and is valid as long as the job remains queued on the local system. -m Sends mail to the requester when the transfer is complete. This option does not work when you are receiving multiple files as the result of one uucp request. The -s option overrides this option. -nlogin-name Sends mail to login-name on the remote system to notify January 1992 1
uucp(1C) uucp(1C)a user that a file has been transferred. -r Queues the job, but does not begin the transfer. -sfile Writes status information about the transfer into file. This option overrides the -m option. source-file Specifies the source and destination of a file that uucp is to copy. Both arguments have this form: [[system!]...]pathname The system portion of the argument must be a system that is known to uucp on your system. You can use the uuname command to learn the names of systems that are known on your system. See uucico(1M) for additional information. See A/UX Network System Administration for details. The pathname portion of source and destination arguments can contain the shell metacharacters ?, *, ~, and [], which are expanded on the appropriate system. In most cases, shell metacharacters must be protected from expansion by the local shell by enclosing the command in double quotation marks ("), or by preceding the metacharacter with a backslash (\). You specify the pathname portion of the source and destination arguments by using one of the following forms: ⊕ An absolute or relative pathname. ⊕ An optional pathname preceded by ~login-name where login-name is a login name on the destination system; the value of ~login-name is expanded to that user's home directory. ⊕ A pathname of ~/file. In this case, uucp forms the pathname by appending ~/file to the string /usr/spool/uucppublic. The file portion of the pathname is treated as a filename if just one file is being transferred by this request. To override the treatment of file as a file, follow it with /. For example, ~/dan/ causes the /usr/spool/uucppublic/dan directory to be made if it does not exist and to be the repository of the transferred file. If the source-file argument expands to multiple files or if file is already a directory, file is treated as a directory. ⊕ The current directory. 2 January 1992
uucp(1C) uucp(1C)If the resulting pathname does not exist on the remote system, the copy operation fails. If destination-file is a directory, the basename of source-file is used to name the transferred file. -xdebug-level Writes debugging information on standard output. The value of debug-level is a number from 0 to 9. Higher numbers produce more detailed debugging information. DESCRIPTION uucp copies files from one system to another system, using both serial and Ethernet connections. The successful completion of a uucp command depends on the correct configuration of uucp files on your system. For detailed information about configuring uucp, see A/UX Network System Administration. EXAMPLES The following command transfers the file myfile, which resides in the current directory, to the home directory of a user called art on a system named hugo: uucp myfile hugo!~art The success of this command depends on your permission to read the file and the permission of uucp on the system named hugo to write the file in the home directory of the user called art. The following command transfers the files that begin with R in the /tmp directory to the /usr/spool/uucppublic directory on a system named sparkie. If there are other files queued for tweetie, these files are sent before files of a lower priority. The command also sends mail to the requester when the transfer to tweetie completes and causes mail to be sent to a user called nancy on sparkie when the files arrive on sparkie. uucp -ghigh -m -nnancy /tmp/R* \ tweetie!junebug!sparkie!~ The success of this command depends on the ability of the systems named tweetie and junebug to forward files. WARNINGS Some versions of uucp cannot forward files. When specifying more than one system name in a source or destination file argument, take care to ensure that intermediate systems along the route are able to forward files. If an intermediate system cannot forward, the file transfer will January 1992 3
uucp(1C) uucp(1C)fail. The A/UX Release 3.0 version of uucp forwards files correctly if the COMMANDS keyword in the Permissions file includes uucp. See A/UX Network System Administration for details. For security reasons, your access to remote files and directories may be severely restricted when you are both sending and receiving files. You can ask a responsible person on the remote system to copy the files to an accessible directory, such as /usr/spool/uucppublic, or send them to you. Regardless of the source file's owner and permission bit settings, when the transfer is complete, the transferred copy of the file is owned by uucp and the file's permission bits are set to 666 (read and write permission for owner, group, and others). LIMITATIONS If you are logged in as root and try to send a file in a directory that is unsearchable by other users or try to send a file that is unreadable by other users, uucp will fail with a can't read error message. FILES /usr/bin/uucp Executable file /usr/lib/uucp/* Directory of uucp commands and configuration files /usr/lib/uucp/uucico Executable file that actually transfers files /usr/spool/uucp Directories containing the queued jobs /usr/spool/uucppublic/* Public directory for receiving and sending files SEE ALSO basename(1), mail(1), uuglist(1C), uusend(1C), uustat(1C), uux(1C) uucico(1M), uuxqt(1M) in A/UX System Administrator's Reference Chapter 8, ``Setting Up the UUCP System,'' in A/UX Network System Administration 4 January 1992