uucico(8) 1.03 uucico(8)
NAME
uucico - UUCP file transfer daemon
SYNOPSIS
uucico [ options ]
DESCRIPTION
The uucico daemon processes file transfer requests queued
by uucp (1) and uux (1). It is started when uucp or uux
is run (unless they are given the -r option). It is also
typically started periodically using entries in the
crontab table(s).
When invoked with the -r1 option or the -s or -S option,
the daemon will place a call to a remote system, running
in master mode. Otherwise the daemon will start in slave
mode, accepting a call from a remote system. Typically a
special login name will be set up for UUCP which automati-
cally invokes uucico when a call is made.
When uucico terminates, it invokes the uuxqt (8) daemon,
unless the -q option is given; uuxqt (8) executes any work
orders created by uux (1) on a remote system, and any work
orders created locally which have received remote files
for which they were waiting.
If a call fails, uucico will normally refuse to retry the
call until a certain (configurable) amount of time has
passed. This may be overriden by the -f or the -S option.
The -l or -e option may be used to force uucico to produce
its own prompts of "login: " and "Password:". When
another daemon calls in, it will see these prompts and log
in as usual; the login name and password will be checked
against a separate list kept specially for uucico rather
than the /etc/passwd file. The -l option will prompt once
and then exit. The -e option will prompt again after the
first session is over; in this mode uucico will perma-
nently control a port.
If uucico receives a SIGQUIT, SIGTERM or SIGPIPE signal,
it will cleanly abort any current conversation with a
remote system and exit. If it receives a SIGHUP signal it
will abort any current conversation, but will continue to
place calls to (if invoked with -r1) and accept calls from
(if invoked with -e) other systems. If it receives a SIG-
INT signal it will finish the current conversation, but
will not place or accept any more calls.
OPTIONS
The following options may be given to uucico.
-r1 Start in master mode (call out to a system); implied
by -s or -S. If no system is specified, call any
UUCP Taylor 1
uucico(8) 1.03 uucico(8)
system for which work is waiting to be done.
-r0 Start in slave mode. This is the default.
-s system
Call the named system.
-S system
Call the named system, ignoring any required wait.
-f Ignore any required wait for any systems to be
called.
-l Prompt for login name and password using "login: "
and "Password:". This allows uucico to be easily run
from inetd (8). The login name and password are
checked against the UUCP password file, which has no
connection to the file /etc/passwd.
-p port
Specify a port to call out on or to listen to. In
slave mode, this implies -e.
-e Enter endless loop of login/password prompts and
slave mode daemon execution. The program will not
stop by itself; you must use kill (1) to shut it
down.
-w After calling out (to a particular system when -s or
-S is specifed, or to all systems which have work
when -r1 is specifed), begin an endless loop as with
-e.
-q Do not start the uuxqt (8) daemon when finished.
-D Do not detach from the controlling terminal. Nor-
mally uucico detaches from the terminal before each
call out to another system and before invoking uuxqt.
This option prevents this.
-x type, -X type
Turn on particular debugging types. The following
types are recognized: abnormal, chat, handshake,
uucp-proto, proto, port, config, spooldir, execute,
incoming, outgoing.
Multiple types may be given, separated by commas, and
the -x option may appear multiple times. A number
may also be given, which will turn on that many types
from the foregoing list; for example, -x 2 is equiva-
lent to -x abnormal,chat.
The debugging output is sent to the debugging file,
usually one of /usr/spool/uucp/Debug,
UUCP Taylor 2
uucico(8) 1.03 uucico(8)
/usr/spool/uucp/DEBUG, or
/usr/spool/uucp/.Admin/audit.local.
-I file
Set configuration file to use. This option may not
be available, depending upon how uucico was compiled.
-u login
This option is ignored. It is only included because
some versions of uucpd invoke uucico with it.
FILES
The file names may be changed at compilation time or by
the configuration file, so these are only approximations.
/usr/lib/uucp/config - Configuration file.
/usr/lib/uucp/passwd - Default UUCP password file.
/usr/spool/uucp - UUCP spool directory.
/usr/spool/uucp/Log - UUCP log file.
/usr/spool/uucppublic - Default UUCP public directory.
/usr/spool/uucp/Debug - Debugging file.
SEE ALSO
kill(1), uucp(1), uux(1), uuxqt(8)
AUTHOR
Ian Lance Taylor (ian@airs.com or uunet!airs!ian)
UUCP Taylor 3