UUCP(1C) HP-UX 5.0 UUCP(1C) NAME uucp, uulog, uuname - HP-UX system to HP-UX system copy SYNOPSIS uucp [ options ] source-files destination-file uulog [ options ] uuname [ -l ] [ -v ] HP-UX COMPATIBILITY Level: HP-UX/STANDARD Origin: System V DESCRIPTION Uucp. Uucp copies files named by the source-file arguments to the destination-file argument. A file name may be a path name on your machine, or may have the form: system-name!path-name where system-name is taken from a list of system names which uucp knows about. The system-name may also be a list of names such as system-name!system-name!...!system-name!path-name in which case an attempt is made to send the file via the specified route, and only to a destination in PUBDIR (see below). Care should be taken to insure that intermediate nodes in the route are willing to foward information. The shell metacharacters ?, * and [...] appearing in path- name will be expanded on the appropriate system. Path names may be one of: (1) a full path name; (2) a path name preceded by ~user where user is a login name on the specified system and is replaced by that user's login directory; (3) a path name preceded by ~/user where user is a login name on the specified system and is replaced by that user's directory under PUBDIR (see FILES); (4) anything else is prefixed by the current directory. The local and remote system access to the path name is specified in the USERFILE. If the result is an erroneous path name for the remote system the copy will fail. If the destination-file is a directory, the last part of the source-file name is used. The accessibility of the file or path name is specified in USERFILE. Uucp preserves execute permissions across the transmission and gives 0666 read and write permissions (see chmod(2)). The following 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 immediately and use the copy. -mfile Report 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 only be successful if the remote machine allows the uucp command to be executed by /usr/lib/uucp/uuxqt.) -ggrade Request grade as a priority for the work sequencing. Grades are specified in the order A - Z, a - z, with A specifying that the work should be done first, and z specifying that the work should be done last. All other grades specify a sequence somewhere in between. The default is n. -r Queue job but do not start the file transfer process. By default a file transfer process is started each time uucp is evoked. -j Control writing of the uucp job number to standard output (see below). Uucp associates a job number with each request. This job number can be used by uustat to obtain status or terminate the job. The environment variable JOBNO and the -j option are used to control the listing of the uucp job number on standard output. If the environment variable JOBNO is undefined or set to OFF, the job number will not be listed (default). If uucp is then invoked with the -j option, the job number will be listed. If the environment variable JOBNO is set to ON and is exported, a job number will be written to standard output each time uucp is invoked. In this case, the -j option will supress 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 options cause uulog to print logging information: -ssys Print information about work involving system sys. If sys is not specified, then logging information for all systems will be printed. -uuser Print information about work done for the specified user. If user is not specified then logging information for all users will be printed. Uuname. Uuname lists the uucp names of known systems. Duplicate lines are not shown, but blank lines are. The -l option returns the local system name. The -v option will print additional information about each system. A description will be printed for each system that has a line of information in /usr/lib/uucp/ADMIN. The format of ADMIN is: sysname tab description tab. FILES /usr/spool/uucp spool directory /usr/spool/uucppublic public directory for receiving and sending (PUBDIR) /usr/lib/uucp/* other data and program files SEE ALSO mail(1), uux(1C), chmod(2). WARNING 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 path name; 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 path names. As distributed, the remotely accessible files are those whose names begin /usr/spool/uucppublic (equivalent to ~uucp or just ~). Note that, if /etc/passwd contains a blank line, a null user entry, or an entry for ~uucp, then ~ and ~uucp will not expand properly. Because of this, the uuto script will not send files to the proper directory. NOTES In order to send files that begin with a dot (e.g., .profile) the files must by qualified with a dot. For example: .profile, .prof*, .profil? are correct; whereas *prof*, ?profile are incorrect. Uucp will not generate a job number for a strictly local transaction. BUGS All files received by uucp will be owned by uucp. The -m option will only work sending files or receiving a single file. Receiving multiple files specified by special shell characters ? * [...] will not activate the -m option. The -m option will not work if all transactions are local or if uucp is executed remotely via the -e option. The -n option will function only when the source and destination are not on the same machine. Any excess characters are ignored. If uulog is issued with no parameters when a uucp process is writing to a temporary logfile, some log information (that information written after the LOG.* files are unlinked) may be lost. Uucp, when used to copy files locally, will create the new file with mode 644 instead of 666.