uucp(1)								       uucp(1)

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

SYNOPSIS
       [options] source_files destination_file

       number]

       system]...  number]

       debug_level]

DESCRIPTION
       copies  files  named  by	 the  source_files argument to the destination
       identified by the destination_file argument.  When copying files to  or
       from  a	remote system, source_files and destination_file can be a path
       name on the local system, or have the form:

       where system_name is the name of a remote system in a  list  of	system
       names  known  to	 When copying files to (but not from) a remote system,
       system_name can also be a chained list of remote system names such as:

       in which case an attempt is made to send the file,  via	the  specified
       route,  to the destination.  Care should be taken to ensure that inter‐
       mediate nodes in the route are configured to forward  information  (see
       for restrictions).

       The shell metacharacters and appearing in path_name are expanded on the
       appropriate system.

       path_name can be one of:

	 ·  A full path name.

	 ·  A path name preceded by where user is a login name on  the	speci‐
	    fied  system  and is replaced by that user's login directory.  (If
	    an invalid login is specified, the	default	 public	 directory  is
	    used instead.

	 ·  A path name preceded by where destination is appended to

	    This  destination  is  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 destination is a directory,
	    append a to the destination argument.  For example, as the	desti‐
	    nation  argument  causes  directory	 to  be created if it does not
	    already exist, and places the requested  file  or  files  in  that
	    directory.

	 ·  Anything else is prefixed by the current directory.

       If  an erroneous path name is specified for the remote system, the copy
       fails.  If destination_file is a directory, the file name part  of  the
       source_file argument is used.

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

   Options
       recognizes the following options:

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

	      Force the copy of local files to the spool directory for	trans‐
	      fer.

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

	      Do not make intermediate directories for the file copy.

	      grade	     is	 a  single  letter  or	number.	 A lower ASCII
			     sequence value for grade causes  the  job	to  be
			     transmitted   earlier  in	a  given  conversation
			     between systems.

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

	      Send mail to the requester when the copy is completed.

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

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

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

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

   uulog
       queries a log file of transactions in a file system.

       The following options cause to print logging information:

	      Print information about work involving
			     system.

	      Do a	     (see tail(1)) of the file transfer log  for  sys‐
			     tem.

       Other options used in conjunction with the and options above are:

	      Search for the given system in the
			     file instead of in the log file.

	      Do a	     tail(1) command of number lines.

   uuname
       lists  the  names of known systems.  returns the local system's default
       name.

   uutry
       tests for the successful login to the remote system.  This is  executed
       for checking communication channel.

	      Starts	     in the MASTER mode.  The default is SLAVE mode.

	      Do work only for the system specified by
			     system.   If  there  is no work for system on the
			     local spool directory, initiate a	connection  to
			     system  to	 determine  if system has work for the
			     local system.  This option must  be  used	if  is
			     specified.

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

       When started by a local program, is considered the MASTER and  attempts
       a  connection to a remote system.  If is started by a remote system, it
       is considered to be in SLAVE mode.

   Access Control Lists (ACLs)
       A file's optional ACL entries are not  preserved	 across	 transmission.
       Instead,	 new  files have a summary of the access modes (as returned in
       by see stat(2)).

EXTERNAL INFLUENCES
   Environment Variables
       determines the format and contents of date and time  strings  displayed
       by and commands.

       determines  the	language  in  which messages are displayed by and com‐
       mands.

       If is not specified in the environment or is set to the	empty  string,
       the  value  of is used as a default for each unspecified or empty vari‐
       able.  If is not specified or is set to the empty string, a default  of
       "C"  (see lang(5)) is used instead of If any internationalization vari‐
       able contains an invalid setting, and behave as if  all	international‐
       ization variables are set to "C".  See environ(5).

   International Code Set Support
       Single- and multibyte character code sets are supported with the excep‐
       tion that multibyte-character file names are not supported.

WARNINGS
       The domain of remotely accessible files can (and for  obvious  security
       reasons,	 usually  should)  be severely restricted.  In most cases, you
       cannot fetch files by path name from a remote system.  Ask a  responsi‐
       ble person on the remote system to send them to you.  For the same rea‐
       sons, you probably cannot send files to arbitrary path names.  As  dis‐
       tributed, remotely accessible files are those whose names begin (equiv‐
       alent to

       All files received by are owned by

       The option only works when sending files or  when  receiving  a	single
       file.   Receiving  multiple files specified by special shell characters
       and does not activate the option.

       Protected files	and  files  in	protected  directories	owned  by  the
       requester  can  be  sent	 by  However, if the requester is root and the
       directory is not searchable by or the  file  is	not  readable  by  the
       request fails.

       should  be  executed only with a request file that exists in the direc‐
       tory

FILES
       Configuration files

       Log and error files

       Spool directories

       Lock files

       Public directory for receiving and sending

SEE ALSO
       mail(1), uux(1), uucico(1M), chmod(2), stat(2), acl(5).

       O'Reilly & Associates, Inc. USA.

       O'Reilly & Associates, Inc. USA.

STANDARDS CONFORMANCE
								       uucp(1)

Vote for polarhome