Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
uucp(1C)		    Communication Commands		      uucp(1C)

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

       uucp  [-c  |  -C]  [-d |	-f]  [-ggrade] [-jmr] [-nuser] [-sfile]	[-xde-
       bug_level] source-file destination-file

       uulog [-ssys] [-fsystem]	[-x] [-number] system

       uuname [-c | -l]

       uucp copies files named by the source-file arguments  to	 the  destina-
       tion-file argument.

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

       uuname lists the	names of systems known to uucp.

       The following options are supported 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	trans-

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

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

	     grade can be either a single letter, number, or a string  of  al-
	     phanumeric	 characters defining a service grade. The uuglist com-
	     mand can determine	whether	it is appropriate to  use  the	single
	     letter,  number, or a string of alphanumeric characters as	a ser-
	     vice grade. The output from the uuglist command will be a list of
	     service  grades that are available, or a message that says	to use
	     a single letter or	number as a grade of service.

       -j    Print the uucp job	identification string on standard output. This
	     job  identification can be	used by	uustat to obtain the status of
	     a uucp job	or to terminate	a uucp job.  The uucp job is valid  as
	     long as the job remains queued on the local system.

       -m    Send mail to the requester	when the copy is complete.

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

       -r    Do	not start the file transfer, just queue	the job.

	     Report  status  of	 the transfer to file. This option is accepted
	     for compatibility,	but it is ignored because it is	insecure.

	     Produce debugging output on standard  output.  debug_level	 is  a
	     number  between  0	and 9; as it increases to 9, more detailed de-
	     bugging information is given. This	option may not be available on
	     all systems.

       The following options cause uulog to print logging information:

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

	     Do	 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	options	are:

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

	     Execute a tail command of number lines.

       The following options are supported by  uuname:

       -c    Display 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.

       -l    Display the local system name.

       The source file name may	be a path name on your machine,	 or  may  have
       the form:


       where  system-name is taken from	a list of system names that uucp knows
       about. source_file is restricted	to no more than	one  system-name.  The
       destination system-name may also	include	a list of system names such as


       In  this	case, an attempt is made to send the file, using the specified
       route, to the destination. Care should be taken to ensure that interme-
       diate  nodes in the route are willing to	forward	information (see NOTES
       below for restrictions).

       For C-Shell users, the ``!'' character must  be	surrounded  by	single
       quotes ('), or preceded by a backslash (\).

       The  shell  metacharacters ?, * and [...] appearing in pathname will be
       expanded	on the appropriate system.

       Pathnames may be	one of the following:

       (1)   An	absolute pathname.

       (2)   A pathname	preceded by ~user where	user is	a login	 name  on  the
	     specified system and is replaced by that user's login directory.

       (3)   A	pathname  preceded  by	~/destination where destination	is ap-
	     pended to /var/spool/uucppublic. (Note:  This destination will be
	     treated  as  a filename unless more than one file is being	trans-
	     ferred by this request or the destination is already a directory.
	     To	 ensure	 that the destination is a directory, follow it	with a
	     '/'. For example ~/dan/ as	the destination	will make  the	direc-
	     tory  /var/spool/uucppublic/dan  if it does not exist and put the
	     requested file(s) in that directory).

       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.

       Invoking	uucp with shell	wildcard characters as the remote  source-file
       invokes	the  uux(1C) command to	execute	the uucp command on the	remote
       machine.	The remote uucp	command	spools the files  on  the  remote  ma-
	After  the  first session terminates, if the remote machine is config-
       ured to transfer	the spooled files to the local machine,	the remote ma-
       chine will initiate a call and send the files; otherwise, the user must
       "call" the remote machine to transfer the files from the	 spool	direc-
       tory  to	 the  local  machine.  This  call  can	be done	manually using
       Uutry(1M), or as	a side effect of another uux(1C) or uucp call.

       Note that the local machine must	have permission	to  execute  the  uucp
       command	on  the	remote machine in order	for the	remote machine to send
       the spooled files.

       uucp removes execute permissions	across the transmission	and gives 0666
       read and	write permissions (see chmod(2)).

       See  environ(5) for descriptions	of the following environment variables
       that affect the execution of uucp: LC_COLLATE,  LC_CTYPE,  LC_MESSAGES,
       LC_TIME,	TZ, and	NLSPATH.

       The following exit values are returned:

       0     Successful	completion.

       >0    An	error occurred.

	     other data	files

	     spool directories

	     other program files

	     public directory for receiving and	sending

       See attributes(5) for descriptions of the following attributes:

       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       |Availability		     |SUNWbnuu			   |

       mail(1),	  uuglist(1C),	 uustat(1C),  uux(1C),	Uutry(1M),  uuxqt(1M),
       chmod(2), attributes(5)

       For security reasons, the domain	of remotely accessible	files  may  be
       severely	 restricted.  You will probably	not be able to access 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 when sending files or receiving  a	single
       file. Receiving multiple	files specified	by special shell characters ?,
       &, and [...] 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 compatible versions of uucp.

       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.

       Strings	that  are passed to remote systems may not be evaluated	in the
       same locale as the one in use by	the process that invoked uucp on   the
       local system.

       Configuration files must	be treated as C	(or POSIX) locale text files.

SunOS 5.9			  28 Mar 1995			      uucp(1C)


Want to link to this manual page? Use this URL:

home | help