UUCICO(8)	    UNIX Programmer's Manual		UUCICO(8)



NAME
     uucico, uucpd - transfer files queued by uucp or uux

SYNOPSIS
     /usr/sbin/uucico [ -d_s_p_o_o_l_d_i_r ] [ -g_g_r_a_d_e ] [ -r_r_o_l_e ] [ -R
     ] [ -s_s_y_s_t_e_m ] [ -x_d_e_b_u_g ] [ -L ] [ -t_t_u_r_n_a_r_o_u_n_d ]

     /usr/libexec/uucpd

DESCRIPTION
     _U_u_c_i_c_o performs the actual work involved in transferring
     files between systems. _U_u_c_p(1) and _u_u_x(1) merely queue
     requests for data transfer which _u_u_c_i_c_o processes.

     The following options are available.

     -d_s_p_o_o_l_d_i_r
	     Use _s_p_o_o_l_d_i_r as the spool directory. The default is
	     /usr/spool/uucp.

     -g_g_r_a_d_e Only send jobs of grade _g_r_a_d_e or higher this
	     transfer.	The grade of a job is specified when the
	     job is queued by _u_u_c_p or _u_u_x.

     -r_r_o_l_e  _r_o_l_e is either 1 or 0; it indicates whether _u_u_c_i_c_o
	     is to start up in master or slave role, respec-
	     tively. 1 is used when running _u_u_c_i_c_o by hand or
	     from _c_r_o_n(8).  0 is used when another system calls
	     the local system.	Slave role is the default.

     -R      Reverse roles.  When used with the -r1 option, this
	     tells the remote system to begin sending its jobs
	     first, instead of waiting for the local machine to
	     finish.

     -s_s_y_s_t_e_m
	     Call only system _s_y_s_t_e_m.  If -s is not specified,
	     and -r1 is specified, _u_u_c_i_c_o will attempt to call
	     all systems for which there is work.  If -s is
	     specified, a call will be made even if there is no
	     work for that system. This is useful for polling.

     -x_d_e_b_u_g Turn on debugging at level _d_e_b_u_g.	Level 5 is a good
	     start when trying to find out why a call failed.
	     Level 9 is very detailed. Level 99 is absurdly ver-
	     bose.  If _r_o_l_e is 1 (master), output is normally
	     written to the standard message output _s_t_d_e_r_r.  If
	     _s_t_d_e_r_r is unavailable, output is written to
	     /usr/spool/uucp/AUDIT/_s_y_s_t_e_m.  When _r_o_l_e is 0
	     (slave), debugging output is always written to the
	     AUDIT file.




Printed 11/26/99	October 23, 1996			1






UUCICO(8)	    UNIX Programmer's Manual		UUCICO(8)



     -L      Only call ``local'' sites. A site is considered
	     local if the device-type field in _L._s_y_s is one of
	     LOCAL, DIR or TCP.

     -t_t_u_r_n_a_r_o_u_n_d
	     Use _t_u_r_n_a_r_o_u_n_d as the line turnaround time (in
	     minutes) instead of the default 30.  If _t_u_r_n_a_r_o_u_n_d
	     is missing or 0, line turnaround will be disabled.
	     After _u_u_c_i_c_o has been running in slave role for _t_u_r_-
	     _n_a_r_o_u_n_d minutes, it will attempt to run in master
	     role by negotiating with the remote machine.  In
	     earlier versions of _u_u_c_i_c_o, a transfer of many large
	     files in one direction would hold up mail going in
	     the other direction.  With the turnaround code work-
	     ing, the message flow will be more bidirectional in
	     the short term.  This option only works with newer
	     _u_u_c_i_c_o's and is ignored by older ones.

     If _u_u_c_i_c_o receives a SIGFPE (see _k_i_l_l(1)), it will toggle
     the debugging on or off.

     _U_u_c_p_d is the server for supporting uucp connections over
     networks.	_U_u_c_p_d listens for service requests at the port
     indicated in the ``uucp'' service specification; see _s_e_r_-
     _v_i_c_e_s(5).	The server provides login name and password
     authentication before starting up _u_u_c_i_c_o for the rest of the
     transaction.

     _U_u_c_i_c_o is commonly used either of two ways: as a daemon run
     periodically by _c_r_o_n(8) to call out to remote systems, and
     as a ``shell'' for remote systems who call in.  For calling
     out periodically, a typical line in _c_r_o_n_t_a_b would be:

	  0    *    *	 *    *    /usr/sbin/uucico -r1

     This will run _u_u_c_i_c_o every hour in master role. For each
     system that has transfer requests queued, _u_u_c_i_c_o calls the
     system, logs in, and executes the transfers. The file
     _L._s_y_s(5) is consulted for information about how to log in,
     while _L-_d_e_v_i_c_e_s(5) specifies available lines and modems for
     calling.

     For remote systems to dial in, an entry in the _p_a_s_s_w_d(5)
     file must be created, with a login ``shell'' of _u_u_c_i_c_o.  For
     example:

	  nuucp:Password:6:1::/usr/spool/uucppublic:/usr/sbin/uucico

     The UID for UUCP remote logins is not critical, so long as
     it differs from the UUCP Administrative login.  The latter
     owns the UUCP files, and assigning this UID to a remote
     login would be an extreme security hazard.



Printed 11/26/99	October 23, 1996			2






UUCICO(8)	    UNIX Programmer's Manual		UUCICO(8)



FILES
     /etc/uucp/                    UUCP internal files
     /etc/uucp/L-devices	   Local device descriptions
     /etc/uucp/L-dialcodes	   Phone numbers and prefixes
     /etc/uucp/L.aliases	   Hostname aliases
     /etc/uucp/L.cmds		   Remote command permissions list
     /etc/uucp/L.sys		   Host connection specifications
     /etc/uucp/USERFILE            Remote directory tree permissions list

     /usr/spool/uucp/		   Spool directory
     /usr/spool/uucp/AUDIT/*	   Debugging audit trails
     /usr/spool/uucp/C./	   Control files directory
     /usr/spool/uucp/D./	   Incoming data file directory
     /usr/spool/uucp/D.hostname/   Outgoing data file directory
     /usr/spool/uucp/D.hostnameX/  Outgoing execution file directory
     /usr/spool/uucp/CORRUPT/	   Place for corrupted C. and D. files
     /usr/spool/uucp/ERRLOG	   UUCP internal error log
     /usr/spool/uucp/LOGFILE	   UUCP system activity log
     /usr/spool/uucp/LCK/LCK..*    Device lock files
     /usr/spool/uucp/SYSLOG	   File transfer statistics log
     /usr/spool/uucp/STST/*	   System status files
     /usr/spool/uucp/TM./	   File transfer temp directory
     /usr/spool/uucp/X./	   Incoming execution file directory

     /usr/spool/uucppublic	   Public access directory

SEE ALSO
     uucp(1), uuq(1), uux(1), L-devices(5), L-dialcodes(5),
     L.aliases(5), L.cmds(5), L.sys(5), uuclean(8), uupoll(8),
     uusnap(8), uuxqt(8)

     D. A. Nowitz and M. E. Lesk, _A _D_i_a_l-_U_p _N_e_t_w_o_r_k _o_f _U_N_I_X _S_y_s_-
     _t_e_m_s.

     D. A. Nowitz, _U_u_c_p _I_m_p_l_e_m_e_n_t_a_t_i_o_n _D_e_s_c_r_i_p_t_i_o_n.




















Printed 11/26/99	October 23, 1996			3