uucp(1C) uucp(1C)NAME uucp, uulog, uuname - UNIX(Reg.) system to UNIX system copy SYNOPSIS [-c] [-C] [-d] [-esys] [-f] [-j] [-mfile] [-nuser] [-r] source-files destination-file uulog [-ssys] [-uuser] uuname [-l] [-v] DESCRIPTION uucp uucp copies files named by the source-file arguments to the destination-file argument. A filename may be a pathname on your system, or may have the form system-name!pathname where system-name is taken from a list of system names that uucp knows about. In addition, system-name may be a list of names such as system-name!system-name! . . . !system-name!pathname in which case an attempt is made to send the file via the specified route and only to a destination in the directory PUBDIR (see below). Care should be taken to ensure that in- termediate nodes in the route are willing to forward infor- mation. The shell metacharacters ?, *, and [...] appearing in path- name are expanded on the appropriate system. Pathnames may be any of the following: a full pathname a pathname preceded by ~user where user is a login name on the specified system and is replaced by that user's login directo- ry a pathname preceded by ~/user where user is a login name on the specified system and is replaced by that user's directory under PUBDIR, where PUBDIR is the public directory on the remote system to which all uucp users have access and at which they enter anything else if uucp prefixes it with the current directory April, 1990 1
uucp(1C) uucp(1C)If the result is an erroneous pathname for the remote sys- tem, the copy fails. If the destination-file is a directo- ry, the last part of the source-file name is used. If a simple user destination is inaccessible to uucp, data~is copied to a spool directory, and the user is notified bymail(1). uucp preserves execute permissions across the transmission and gives 0666 read and write permissions. See chmod(2). The following flag options are interpreted by uucp: -d Make all necessary directories for the file copy (default). -f Do not make intermediate directories for the file copy. -c Use the source file when copying out rather than copying the file to the spool directory (default). -C Copy the source file to the spool directory. -mfile Report the status of the transfer in file. If file is omitted, send mail to the requester when the copy is completed. -nuser Notify user on the remote system that a file was sent. -esys Send the uucp command to system sys to be executed there. Note: This will be successful only if the re- mote machine allows uucp to be executed by /usr/lib/uucp/uuxqt. -g Assign a priority, or grade, to the uucp request, so uucico can later process requests of selected grades only. -r Queue the job, but do not start the file-transfer process. By default, a file-transfer process is started each time uucp is evoked. -j Control the writing of the uucp job number to stan- dard output (see below). 2 April, 1990
uucp(1C) uucp(1C)uucp associates a job number with each request. This job number can be used by uustat to obtain the status of the job or terminate the job. The environment variable JOBNO and the -j flag option are used to control the listing of the uucp job number on stan- dard output. If the environment variable JOBNO is undefined or set to OFF, the job number is not listed (default). If uucp is then invoked with the -j flag option, the job number is listed. If the environment variable JOBNO is set to ON and is exported, a job number is written to standard output each time uucp is invoked. In this case, the -j flag option suppresses the output of the job number. uulog uulog queries a summary log of uucp and uux(1C) transactions in the file /usr/spool/uucp/LOGFILE. The following flag options cause uulog to print logging in- formation: -ssys Print information about work involving system sys. If sys is not specified, then logging information for all systems is printed. -uuser Print information about work done for the specified user. If user is not specified, then logging infor- mation for all users is printed. uuname uuname lists the uucp names of known systems. The -l flag option returns the local system name. The -v flag option prints additional information about each system. A descrip- tion is printed for each system that has a line of informa- tion in /usr/lib/uucp/ADMIN. The format of ADMIN is: sysname TAB description TAB EXAMPLES uucp file1 ucbvax! /usr/spool/uucppublic/file2 sends file1 from the local machine via the uucp network to the ucbvax machine, where it is saved as the file /usr/spool/uucppublic/file2. FILES /usr/bin/uucp /usr/bin/uulog /usr/bin/uuname /usr/lib/uudemon.day Performs once per day /usr/lib/uudemon.hour April, 1990 3
uucp(1C) uucp(1C)Performs once per hour /usr/lib/uudemon.week Performs once per week /usr/spool/uucp Spool directory /usr/spool/uucppublic Public directory (PUBDIR) for receiving and sending /usr/lib/uucp/* Other data and program files NOTES To send files that begin with a dot, for example, .profile, the files must be qualified with the dot. For example, .prof*, .profile, .profil? are correct, whereas *prof*, ?profile are incorrect. uucp does not generate a job number for a strictly local transaction. SEE ALSO ftp(1N), mail(1), telnet(1N), tip(1C), uux(1C), chgnod(1M), chmod(2), ``Using UUCP,'' in the A/UX Communications User's Guide. WARNINGS The domain of remotely accessible files may (and for obvious security reasons, usually should) be severely restricted. Very likely, you will not be able to fetch files by path- name, so 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. As dis- tributed, the remotely accessible files are those whose names begin /usr/spool/uucppublic (equivalent to nuucp or~just ).~BUGS All files received by uucp are owned by uucp. The -m flag option only works when sending files or receiv- ing a single file. Receiving multiple files specified by the special shell characters ?, *, and [...] does not ac- tivate the -m flag option. The -m flag option does not work if all transactions are lo- cal or if uucp is executed remotely via the -e flag option. The -n flag option functions only when the source and desti- nation are not on the same system. Only the first six characters of system-name are signifi- cant. Any excess characters are ignored. 4 April, 1990