uucico(1M) uucico(1M)NAME uucico, uushell - transfer files queued by uucp or uux SYNOPSIS /usr/lib/uucp/uucico [-dspooldir] [-ggrade] [-rrole] [-R] [-ssystem] [-xdebug] [-L] [-tturnaround] /usr/lib/uucp/uushell DESCRIPTION uucico performs the actual work involved in transferring files between systems. uucp(1C) and uux(1C) merely queue requests for data transfer which uucico processes. uushell serves as the login shell for the user uucp. uu- shell sets the environment variable TZ and calls uucico. The following options are available to uucico. -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, respective- ly. 1 is used when running uucico by hand or from cron(1M). 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 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 speci- fied, 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 ver- bose. If role is 1 (master), output is normally written to the standard error output. If the stan- dard error output is unavailable, output is written to /usr/spool/uucp/AUDIT/system. When role is 0 April, 1990 1
uucico(1M) uucico(1M)(slave), debugging output is always written to the AUDIT file. -L Only call ``local'' sites. A site is considered lo- cal if the device-type field in L.sys is one of LO- CAL, 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 tur- naround 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 work- ing, the message flow will be more bidirectional in the short term. This option only works with newer versions of uucico and is ignored by older ones. If uucico receives a SIGFPE (see kill(1)), it will toggle the debugging on or off. uucico is commonly used either of two ways: as a daemon run periodically by cron(1M) to call out to remote systems, and as a ``shell'' for remote systems who call in. For calling out periodically, a typical line in a crontab file would be: 0 * * * * /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 is consulted for information about how to log in, while L- devices specifies available lines and modems for calling. For remote systems to dial in, an entry in the passwd(4) file must be created, with a login shell of uushell. For example: nuucp:password:5:5::/usr/spool/uucppublic:/usr/lib/uucp/uushell 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 lo- gin would be an extreme security hazard. FILES /usr/spool/uucp/D.hostnameX/ /usr/lib/uucp/ UUCP internal files/utilities 2 April, 1990
uucico(1M) uucico(1M)/usr/lib/uucp/L-devices Local device descriptions /usr/lib/uucp/L-dialcodes Phone numbers and prefixes /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 /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 April, 1990 3
uucico(1M) uucico(1M)SEE ALSO uucp(1C), uuq(1C), uux(1C), uuclean(1M), uuxqt(1M). 4 April, 1990