# 2.11BSD#431 - /usr/man/cat8/uucico.0

    UUCICO(8)	    UNIX Programmer's Manual		UUCICO(8)

    NAME
         uucico, uucpd - transfer files queued by uucp or uux

    SYNOPSIS
         /usr/sbin/uucico [ -dspooldir ] [ -ggrade ] [ -rrole ] [ -R
         ] [ -ssystem ] [ -xdebug ] [ -L ] [ -tturnaround ]

         /usr/libexec/uucpd

    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.

         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, respec-
    	     tively. 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 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 ver-
    	     bose.  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.

    Printed 11/26/99	October 23, 1996			1

    UUCICO(8)	    UNIX Programmer's Manual		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.

         -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
    	     uucico's and is ignored by older ones.

         If uucico receives a SIGFPE (see kill(1)), it will toggle
         the debugging on or off.

         Uucpd is the server for supporting uucp connections over
         networks.	Uucpd listens for service requests at the port
         indicated in the ``uucp'' service specification; see ser-
         vices(5).	The server provides login name and password
         authentication before starting up uucico for the rest of the
         transaction.

         Uucico is commonly used either of two ways: as a daemon run
         periodically by cron(8) to call out to remote systems, and
         as a ``shell'' for remote systems who call in.  For calling
         out periodically, a typical line in crontab would be:

    	  0    *    *	 *    *    /usr/sbin/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,
         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/sbin/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.

    Printed 11/26/99	October 23, 1996			2

    UUCICO(8)	    UNIX Programmer's Manual		UUCICO(8)

    FILES
         /etc/uucp/                    UUCP internal files
         /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 ALSO
         uucp(1), uuq(1), uux(1), L-devices(5), L-dialcodes(5),
         L.aliases(5), L.cmds(5), L.sys(5), uuclean(8), uupoll(8),
         uusnap(8), uuxqt(8)

         D. A. Nowitz and M. E. Lesk, A Dial-Up Network of UNIX Sys-
         tems.

         D. A. Nowitz, Uucp Implementation Description.

    Printed 11/26/99	October 23, 1996			3

Generated: 2016-12-26 | Generated by man2html V0.25 page hit count: 661 |