NAME

uucp, uulog, uuname − UNIX system to UNIX system copy

SYNOPSIS

uucp [ options ] source-files destination-file

uulog −f system [ −x ] [ −number ]

uulog [ −s system ] ... [ −x ] [ −number ]

uuname [ −l ]

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, to the destination.  Care should be taken to insure that intermediate nodes in the route are willing to forward information (see WARNINGS below for restrictions). 

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; Note that if an invalid login is specified, the default will be to the public directory (/usr/spool/uucppublic);

(3) a path name preceded by ~/destination, where destination is appended to /usr/spool/uucppublic.

NOTE:  This destination will be treated as a file name unless more than one file is being transferred by this request or the destination is already a directory.  To ensure that it is a directory, follow the destination with a ‘/’.  For example, ~/dan/ as the destination will make the directory /usr/spool/uucppublic/dan if it does not exist and put the requested file(s) in that directory. 

(4) anything else is prefixed by the current directory. 

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. 

Uucp preserves execute permissions across the transmission and gives 0666 read and write permissions (see chmod(2) and Access Control Lists below).

Options

The following options are interpreted by uucp:

−c Do not copy local file to the spool directory for transfer to the remote machine (default). 

−C Force the copy of local files to the spool directory for transfer. 

−d Make all necessary directories for the file copy (default). 

−f Do not make intermediate directories for the file copy. 

−ggrade Grade is a single letter or number.  Lower ASCII sequence characters cause the job to be transmitted earlier during a particular conversation. 

−j Output the job identification ASCII string on standard output.  This job identification can be used by uustat(1) to obtain the status or terminate a job.

−mfile Send mail to the requester when the copy is completed. 

−nuser Notify user on the remote system that a file was sent. 

−r Do not start the file transfer; just queue the job. 

−sfile Report status of the transfer to file. Note that the file must be a full path name. 

−xdebug_level Produce debugging on standard output. The debug_level is a number between 0 and 9; higher numbers give more information. 

Uulog

Uulog queries a log file of uucp transactions in a file /usr/spool/uucp/.Log/uucico/ system.

The options cause uulog to print logging information:

−s system Print information about work involving system. 

−f system Do a tail -f (see tail(1)) of the file transfer log for system.

Other options used in conjunction with the above:

−x Search in the /usr/spool/uucp/.Log/uuxqt/system file for the given system, instead of the uucico log file. 

−number Do a tail(1) command of number lines. 

Uuname

Uuname lists the uucp names of known systems.  The −l option returns the local system name. 

In the HP Clustered environment, all UUCP activity is handled through device files residing on the cluster server as if the cluster were a single system. 

Access Control Lists (ACLs)

A file’s optional ACL entries are not preserved across uucp transmission.  Instead, new files have a summary of the access modes (as returned in st_mode by stat(2)).

WARNINGS

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 ~/). 

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. 

Protected files and files that are in protected directories that are owned by the requester can be sent by uucp.  However, if the requester is root and the directory is not searchable by "other" or the file is not readable by "other," the request will fail. 

DEPENDENCIES

Series 300
The following options to uucp are not currently supported: −s, −x. 

The following options to uulog are not currently supported: −f system, −x, −number. 

FILES

/usr/lib/uucp/∗ other data and program files

/usr/spool/uucp spool directories

/usr/spool/uucppublic public directory for receiving and sending

SEE ALSO

mail(1), uux(1), chmod(2), stat(2), acl(5). 

UUCP tutorial in HP-UX Concepts and Tutorials. 

EXTERNAL INFLUENCES

Environment Variables

LC_TIME determines the format and contents of date and time strings displayed by the uucp and uulog commands. 

LANG determines the language in which messages are displayed by the uucp and uuname commands. 

If LC_TIME is not specified in the environment or is set to the empty string, the value of LANG is used as a default for each unspecified or empty variable.  If LANG is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of LANG.  If any internationalization variable contains an invalid setting,

International Code Set Support

Single- and multi-byte character code sets are supported with the exception that multi-byte-character file names are not supported.  uucp, uulog, and uuname behave as if all internationalization variables are set to "C". 
 See environ(5).

STANDARDS CONFORMANCE

uucp: SVID2, XPG2, XPG3

uulog: SVID2, XPG2, XPG3

uuname: SVID2, XPG2, XPG3

Hewlett-Packard Company  —  HP-UX Release 7.0: Sept 1989