irix - uucp (1)




NAME
     uucp, uulog, uuname - UNIX-to-UNIX	system copy


SYNOPSIS
     uucp [ options ] source-files destination-file
     uulog [ options ] -ssystem
     uulog [ options ] system
     uulog [ options ] -fsystem
     uuname [ -l ] [ -c	]


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 that 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.	 See WARNINGS and BUGS below for restrictions.
     Care should be taken to ensure 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;

	  (3)  a path name preceded by ~/destination where destination is
	       appended	to /var/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 /var/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)).

     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/number;	lower ascii sequence
	       characters will cause the job to	be transmitted earlier during
	       a particular conversation.

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

     -m	       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 output	on standard output.  The debug_level
	       is a number between 0 and 9; higher numbers give	more detailed
	       information.  (Debugging	will not be available if uucp was
	       compiles	with -DSMALL.)

   uulog
     uulog queries a log file of uucp or uuxqt transactions in a file
     /var/spool/uucp/.Log/uucico/system, or /var/spool/uucp/.Log/uuxqt/system.

     The options cause uulog to	print logging information:

     -ssys     Print information about file transfer work involving system
	       sys.


     -fsystem  Does a ``tail -f'' of the file transfer log for system.	(You
	       must hit	BREAK to exit this function.)  Other options used in
	       conjunction with	the above:

     -x	       Look in the uuxqt log file for the given	system.

     -number   Indicates that a	``tail'' command of number lines should	be
	       executed.

   uuname
     uuname lists the names of systems known to	uucp.  The -c option returns
     the names of systems known	to cu.	(The two lists are the same, unless
     your machine is using different Systems files for cu and uucp.  See the
     Sysfiles file.)  The -l option returns the	local system name.


FILES
     /var/spool/uucp	      spool directories
     /var/spool/uucppublic/*public
			      directory	for receiving and sending
			      (/var/spool/uucppublic)
     /etc/uucp/*	      uucp system data files
     /usr/lib/uucp/*	      uucp administrative programs


SEE ALSO
     mail(1), uustat(1C), uucico(1M), uux(1C), uuxqt(1M), chmod(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
     /var/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.

     The forwarding of files through other systems may not be compatible with
     the previous version of uucp.  If forwarding is used, all systems in the
     route must	have the same version of uucp.


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