UUCICO(8) UUCICO(8)
NAME
uucico - transfer files queued by uucp or uux
SYNOPSIS
uucico [-flags]
DESCRIPTION
Uucico performs the actual work involved in transferring
files between systems. uucp(1) and uux(1) merely queue
requests for data transfer which uucico processes.
If uucico receives a SIGFPE (see kill(1)), it will toggle
the debugging on or off.
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, 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 uucico.
For example:
nuucp:<password>:6:1::/usr/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.
Uucico changes its name to give details of its state. The
state shows the remote nodename, the current role
(MST/SLV), the direction of transfer (SND/RCV), the number
of messages transferred, and the overall throughput in
bytes/second.
OPTIONS
-c Check for messages to be sent: if none don't call.
-dspooldir
Use spooldir as the spool directory. The default is
`/usr/spool/uucp'. This should be either SPOOLDIR, or
one of the directories named in SPOOLALTDIRS (see
uuparams(5)).
-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.
-k Arrange to keep any debugging output in a time-stamped
audit file in LOGDIR/audit/site.yymmddhhss
UUCP 1
UUCICO(8) UUCICO(8)
-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.
-mmynode
Change the name of the local host to mynode. This is
better done system-wide via the NODENAME parameter
(see uuparams(5)).
-pgrade
(Same as -g.)
-Pparams
Alters the pathname for the UUCP parameters file
[default: `/usr/lib/uucp/CONFIG'].
-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 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 system. If -s is specified, a call will be made
even if there is no work for that system (but see -c
above). This is useful for polling. One of either -s
or -S (below) must be specified.
-Ssystem
Same as -s, but any time-to-call restrictions are
ignored when uucico is in master role. NB: if system
starts with a `/', then it is assumed to be a spool
directory pathname, and is interpreted as for -d
above.
-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, and the directory exists, output is
written to LOGDIR/audit/system. When role is 0
(slave), debugging output is always written to the
audit file.
-T[level]
Turns on routine tracing at level [default: 1]. If
UUCP 2
UUCICO(8) UUCICO(8)
tracing is not compiled in, this flag will have no
effect.
-t[turnaround]
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. When
running in master mode with more than one SPOOLDIR,
uucico will return to the first directory at least
every turnaround minutes. 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 uucico's and
is ignored by older ones.
FILES
All these file names are configurable in the file
`/usr/lib/uucp/CONFIG'. See uuparams(5) for details.
/usr/lib/uucp/CONFIG
Current parameters for all UUCP programs.
PARAMSDIR/
UUCP internal files [/usr/lib/uucp].
PARAMSDIR/L-devices
Local device descriptions.
PARAMSDIR/L-dialcodes
Phone numbers and prefixes.
PARAMSDIR/L.aliases
Hostname aliases.
PARAMSDIR/L.cmds
Remote command permissions list.
PARAMSDIR/L.sys
Host connection specifications.
PARAMSDIR/USERFILE
Remote directory tree permissions list.
PROGDIR/
UUCP internal utilities [/usr/lib/uucp].
SPOOLALTDIRS
Alternate spool directories for obtaining messages to
UUCP 3
UUCICO(8) UUCICO(8)
transmit [/usr/spool/nuucp].
SPOOLDIR
Spool directory [/usr/spool/uucp].
SPOOLDIR/.Corrupt/
Place for corrupted `C.' and `D.' files.
SPOOLDIR/system
Directories for each system containing message data
and control files.
SPOOLDIR/system/.active
File created while uucico is active in this directory,
containing CPU name and process ID in ASCII.
SPOOLDIR/system/TTimeUsecPidN
Master mode receive message temporary file.
SPOOLDIR/system/tTimeUsecPidN
Slave mode receive message temporary file.
PUBDIR
Public access directory [/usr/spool/uucppublic].
LOGDIR
Directory for uucp-related log files [/var/log/uucp].
LOGDIR/audit/system
Debugging audit trails.
LOGDIR/errors
UUCP internal error log.
LOGDIR/uucico/system
Uucico system activity log per site.
LOGDIR/xferstats/system
File transfer statistics log per site.
LOGDIR/status/system
System status files.
LOCKDIR
Directory for lock files [/var/run].
LOCKDIR/LCK..*
Device lock files.
SEE ALSO
uucp(1), uuq(1), uux(1), L-devices(5), L-dialcodes(5),
L.aliases(5), L.cmds(5), L.sys(5), uuparams(5),
uuclean(8), uupoll(8), uusched(8), uusnap(8), uuxqt(8).
UUCP 4
UUCICO(8) UUCICO(8)
D. A. Nowitz and M. E. Lesk, A Dial-Up Network of UNIX
Systems
D. A. Nowitz, Installation and Operation of UUCP
UUCP 5