UUCICO(8C)UUCICO(8C)NAME
uucico, uucpd - transfer files queued by uucp or uux
SYNOPSIS
/usr/lib/uucp/uucico [ -dspooldir ] [ -ggrade ] [ -rrole ] [ -R ] [
-ssystem ] [ -xdebug ] [ -L ] [ -tturnaround ]
/usr/etc/uucpd
DESCRIPTION
The uucico utility performs the actual work in transferring files
between systems. The uucp(1C) and uux(1C) commands merely queue
requests for data transfer which uucico processes.
The following options are available.
-dspooldir
Use spooldir as the spool directory. The default is
/usr/spool/uucp.
-ggrade Only send jobs of grade grade or higher this transfer. The
grade of a job is specified when the job is queued by uucp or
uux.
-rrole role is either 1 or 0; it indicates whether uucico is to start
up in master or slave role, respectively. 1 is used when
running uucico by hand or from cron(8). 0 is used when another
system calls the local system. Slave role (0) 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.
-ssystem
Call only system system. If -s is not specified, and -r1 is
specified, uucico 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.
-xdebug Turn on debugging at level debug. 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 role is 1
(master), output is normally written to the standard message
output, stderr. If stderr is unavailable, output is written to
/usr/spool/uucp/AUDIT/system. When role is 0 (slave),
debugging output is always written to the AUDIT file.
-L Only call ``local'' sites. A site is considered local if the
device-type field in L.sys is one of LOCAL, DIR or TCP.
-tturnaround
Use turnaround as the line turnaround time (in minutes) instead
of the default 30. If turnaround is missing or 0, line
turnaround will be disabled. After uucico has been running in
slave role for turnaround minutes, it will attempt to run in
master role by negotiating with the remote machine. In earlier
versions of uucico, 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
bidirectional in the short term. This option only works with
newer uucicos, and is ignored by older ones.
If uucico receives a SIGFPE (see kill(1)), it will toggle the debugging
on or off.
The uucpd server supports uucp connections over networks. The uucpd
daemon listens for service requests at the port indicated in the
``uucp'' service specification; see services(5). The server provides
login name and password authentication before starting up uucico for
the rest of the transaction.
The uucico daemon is commonly used either of two ways: either run
periodically by cron(8) to call out to remote systems, or as a
``shell'' for remote systems who call in. For calling out
periodically, a typical line in crontab might be:
0 * * * * uucp /usr/lib/uucp/uucico -r1
This will run uucico every hour in master role. For each system that
has transfer requests queued, uucico calls the system, logs in, and
executes the transfers. The file L.sys(5) is consulted for information
about how to log in, and 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 uucico. For example:
uucp:*:4:4::/usr/spool/uucppublic:/usr/lib/uucp/uucico
The UID for UUCP remote logins is not critical, but it should differ
from the UUCP Administrative login. The latter owns the UUCP files,
and assigning this UID to a remote login might, were uucico NOT used as
the login ``shell,'' pose a security hazard.
FILES
/etc/uucp/ UUCP internal files/utilities
/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 ALSOuucp(1C), uuq(1C), uux(1C), L-devices(5), L-dialcodes(5), L.aliases(5),
L.cmds(5), L.sys(5), uuclean(8C), uupoll(8C), uusnap(8C), uuxqt(8C)
D. A. Nowitz and M. E. Lesk, A Dial-Up Network of UNIX Systems.
D. A. Nowitz, Uucp Implementation Description.
4.3 Berkeley Distribution May 15, 1986 UUCICO(8C)
