4.4BSD/usr/share/man/cat8/uucico.0
UUCICO(8) BSD System Manager's Manual UUCICO(8)
NNAAMMEE
uuuucciiccoo, uuuuccppdd - transfer files queued by uucp or uux
SSYYNNOOPPSSIISS
uuuucciiccoo [--LL] [--RR] [--dd_s_p_o_o_l_d_i_r] [--gg_g_r_a_d_e] [--rr_r_o_l_e] [--ss_s_y_s_t_e_m] [--xx_d_e_b_u_g]
[--tt_t_u_r_n_a_r_o_u_n_d]
uuuuccppdd
DDEESSCCRRIIPPTTIIOONN
UUuucciiccoo performs the actual work involved in transferring files between
systems. Uucp(1) and uux(1) merely queue requests for data transfer
which uuuucciiccoo processes.
The following options are available.
--LL Only call ``local'' sites. A site is considered local if the de-
vice-type field in L.sys(5) is one of LOCAL, DIR or TCP.
--RR Reverse roles. When used with the --rr_1 option, this tells the re-
mote system to begin sending its jobs first, instead of waiting
for the local machine to finish.
--dd_s_p_o_o_l_d_i_r
Use _s_p_o_o_l_d_i_r as the spool directory. The default is
_/_v_a_r_/_s_p_o_o_l_/_u_u_c_p_.
--gg_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 uucp(1) or
uux(1).
--rr_r_o_l_e _r_o_l_e is either 1 or 0; it indicates whether uuuucciiccoo is to start up
in master or slave role, respectively. 1 is used when running
uuuucciiccoo by hand or from cron(8). 0 is used when another system
calls the local system. Slave role is the default.
--ss_s_y_s_t_e_m
Call only system _s_y_s_t_e_m. If --ss is not specified, and --rr_1 is spec-
ified, uuuucciiccoo will attempt to call all systems for which there is
work. If --ss is specified, a call will be made even if there is
no work for that system. This is useful for polling.
--tt_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 uuuucciiccoo has been running in
slave role for _t_u_r_n_a_r_o_u_n_d minutes, it will attempt to run in mas-
ter role by negotiating with the remote machine. In earlier ver-
sions of uuuucciiccoo, a transfer of many large files in one direction
would hold up mail going in the other direction. With the
turnaround code working, the message flow will be more bidirec-
tional in the short term. This option only works with newer
uuuucciiccoo's and is ignored by older ones.
--xx_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 verbose. If _r_o_l_e is 1 (master), output is
written to the standard error _s_t_d_e_r_r. If _s_t_d_e_r_r is unavailable,
output is written to _/_v_a_r_/_s_p_o_o_l_/_u_u_c_p_/_A_U_D_I_T_/_s_y_s_t_e_m. When _r_o_l_e is 0
(slave), debugging output is always written to the AUDIT file.
If uuuucciiccoo receives a SIGFPE (see kill(1)), it will toggle the debugging
on or off.
UUuuccppdd is the server for supporting uucp connections over networks. UUuuccppdd
listens for service requests at the port indicated in the ``uucp'' ser-
vice specification; see services(5). The server provides login name and
password authentication before starting up uuuucciiccoo for the rest of the
transaction.
UUuucciiccoo is commonly used either of two ways: as a daemon run periodically
by cron(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
crontab would be:
0 * * * * /usr/lib/uucp/uucico -r1
This will run uuuucciiccoo every hour in master role. For each system that has
transfer requests queued, uuuucciiccoo calls the system, logs in, and executes
the transfers. The file L.sys(5) is consulted for information about how
to log in, while L-devices(5) specifies available lines and modems for
calling.
For remote systems to dial in, an entry in the passwd(5) file must be
created, with a login ``shell'' of uuuucciiccoo. For example:
nuucp:Password:6:1::/var/spool/uucppublic:/usr/lib/uucp/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.
FFIILLEESS
/usr/lib/uucp/ UUCP internal files/utilities
/usr/lib/uucp/L-devices Local device descriptions
/usr/lib/uucp/L-dialcodes Phone numbers and prefixes
/usr/lib/uucp/L.aliases Hostname aliases
/usr/lib/uucp/L.cmds Remote command permissions list
/usr/lib/uucp/L.sys Host connection specifications
/usr/lib/uucp/USERFILE Remote directory tree permissions list
/var/spool/uucp/ Spool directory
/var/spool/uucp/AUDIT/* Debugging audit trails
/var/spool/uucp/C./ Control files directory
/var/spool/uucp/D./ Incoming data file directory
/var/spool/uucp/D.hostname/ Outgoing data file directory
/var/spool/uucp/D.hostnameX/ Outgoing execution file directory
/var/spool/uucp/CORRUPT/ Place for corrupted C. and D. files
/var/spool/uucp/ERRLOG UUCP internal error log
/var/spool/uucp/LOGFILE UUCP system activity log
/var/spool/uucp/LCK/LCK..* Device lock files
/var/spool/uucp/ SYSLOG File transfer statistics log
/var/spool/uucp/STST/* System status files
/var/spool/uucp/TM./ File transfer temp directory
/var/spool/uucp/X./ Incoming execution file directory
/var/spool/uucppublic Public access directory
SSEEEE AALLSSOO
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.
HHIISSTTOORRYY
The uuuucciiccoo command appeared in 4.3BSD.
4.3 Berkeley Distribution June 6, 1993 2