COHERENT manpages

This page displays the COHERENT manpage for uucico [Communicate with a remote site].

List of available manpages
Index

uucico -- Command

Communicate with a remote site
/usr/lib/uucp/uucico [-D] [-csite] [-Ifile] [-pport] [-r0] [-r1] [-ssite] [-Ssite] [-xlevel]

The UUCP daemon uucico is the program that communicates with a remote site.
It either contacts another site and issues commands for execution by
another uucico process on that remote system (master mode); or it receives
a call from a remote system and executes the commands that that system
issues (slave mode).

The commands uucp and uux invoke uucico automatically, usually in master
mode. uucico can also be invoked directly from the shell, from within a
script, or from with a cron file.

You can also name uucico in file /etc/passwd as the default process to run
for a given login identifier. A system that logs in under that login ID
(presumably, a version of uucico on a remote system) will interact with
your system's uucico, instead of a shell. When invoked in this manner,
uucico runs in slave mode by default.

After uucico has finished communicating with the remote system, it invokes
the daemon uuxqt to execute the commands issued by the remote system. For
information on uuxqt, see its Lexicon entry.

uucico recognizes the following command-line options:

-csite ``Cron'' mode: If a call is not permitted to site at the present
time, then do not make the call; but also, do not log an error
message or update the system status. Use this option if you wish
to invoke uucico regularly through cron, and do not want to be
bombarded with error messages should the entry in cron conflict
with the legal calling times set in sys.

-D Do not detach from the device until the contact with the remote
system concludes.

-e Force uucico to produce its own login: and Password: prompts.
uucico checks the password it receives against its own, private
list, rather than against the password kept in file /etc/passwd.
This should be used with the options -l and -p. When used with this
option, uucico does not terminate, but continues to issue prompts
until you kill it explicitly. This option permits you to use
uucico as a server on a network.

-fsite Force option: call site immediately, regardless of whether the
site's description in sys indicates that this is a legal time to
call.

-I file
Read configuration information from file, instead of from the
default file /usr/lib/uucp/sys.

-l Force uucico to produce its own login: prompt. uucico checks the
login it receives against its own, private list, rather than
against the normal system password files. This should be used with
the option -e.

-q Quiet: do not invoke daemon uuxqt on the remote system.

-pport Use port. When used with the options -s or -S, dial out on port;
this overrides the default port used with the system being
contacted. When uucico is in slave mode, this implies the option -
e.

-r0 Act as slave in polling process; that is, carry out the orders of
another uucico that has dialed into your system. This is the
default.

-r1 Act as master in polling process; that is, dial out to another
system and give it orders. This option is implied by options -s or
-S. If the uucico command line does not name a site to call, this
option tells uucico to call any system for which work is waiting to
be performed.

-ssite Call site. This must name one of the entries in /usr/lib/uucp/sys.

-Ssite Call site immediately, if the present time lies within the legal
time set for site, as described in file /usr/lib/uucp/sys.

-w After contacting a system with the options -r1, -s, -S, begin an
endless loop of login prompts, as with the option -e. In effect,
UUCP calls a remote site; but instead of logging into that site, it
lets that site log into it.

-xactivity[,activity,...,activity^]
-Xactivity[,activity,...,activity]
Log a given activity. These logs can help you debug problems with
UUCP. uucico recognizes the following activities:

abnormal chat config
execute handshake incoming
outgoing port proto
spooldir uucp-proto

One -x option can name multiple activities, separated by commas. A
uucico command line can contain more than -x option. uucico writes
its logging information into file
/usr/spool/uucp/.Admin/audit.local.

Example

To poll the site mwcbbs (the Mark Williams bulletin board) five minutes
after each hour, put the following entry into a cron file:

05 * * * * /usr/lib/uucp/uucico -smwcbbs -r1

Files

/usr/lib/uucp/sys -- List of reachable systems
/usr/spool/uucp/.Log/uucico/sitename -- uucico activities log file for
sitename
/usr/spool/uucp/.Log/uucico/UUCICO -- uucico debug log
/usr/spool/uucp/sitename -- Spool directory for work