uucico man page on 4.4BSD

Man page or keyword search:  
man Server   1065 pages
apropos Keyword Search (all sections)
Output format
4.4BSD logo
[printable version]

UUCICO(8)		  BSD System Manager's Manual		     UUCICO(8)

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

SYNOPSIS
     uucico [-L] [-R] [-dspooldir] [-ggrade] [-rrole] [-ssystem] [-xdebug]
	    [-tturnaround]
     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.

     -L	     Only call ``local'' sites. A site is considered local if the de-
	     vice-type field in L.sys(5) is one of LOCAL, DIR or TCP.

     -R	     Reverse roles.  When used with the -r1 option, this tells the re-
	     mote system to begin sending its jobs first, instead of waiting
	     for the local machine to finish.

     -dspooldir
	     Use spooldir as the spool directory. The default is
	     /var/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(1) or
	     uux(1).

     -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.

     -ssystem
	     Call only system system. If -s is not specified, and -r1 is spec-
	     ified, 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.

     -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 turnaround minutes, it will attempt to run in mas-
	     ter role by negotiating with the remote machine.  In earlier ver-
	     sions 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 bidirec-
	     tional in the short term.	This option only works with newer
	     uucico's and is ignored by older ones.

     -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
	     written to the standard error stderr. If stderr is unavailable,
	     output is written to /var/spool/uucp/AUDIT/system. When role is 0
	     (slave), debugging output is always written to the AUDIT file.

     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'' ser-
     vice specification; see services(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/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(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::/var/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.

FILES
     /usr/lib/uucp/		   UUCP internal files/utilities
     /usr/lib/uucp/L-devices	   Local device descriptions
     /usr/lib/uucp/L-dialcodes	   Phone numbers and prefixes
     /usr/lib/uucp/L.aliases	   Hostname aliases
     /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
     /var/spool/uucp/		   Spool directory
     /var/spool/uucp/AUDIT/*	   Debugging audit trails
     /var/spool/uucp/C./	   Control files directory
     /var/spool/uucp/D./	   Incoming data file directory
     /var/spool/uucp/D.hostname/   Outgoing data file directory
     /var/spool/uucp/D.hostnameX/  Outgoing execution file directory
     /var/spool/uucp/CORRUPT/	   Place for corrupted C. and D. files
     /var/spool/uucp/ERRLOG	   UUCP internal error log
     /var/spool/uucp/LOGFILE	   UUCP system activity log
     /var/spool/uucp/LCK/LCK..*	   Device lock files
     /var/spool/uucp/		   SYSLOG File transfer statistics log
     /var/spool/uucp/STST/*	   System status files
     /var/spool/uucp/TM./	   File transfer temp directory
     /var/spool/uucp/X./	   Incoming execution file directory
     /var/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 Systems.

     D. A. Nowitz, Uucp Implementation Description.

HISTORY
     The uucico command appeared in 4.3BSD.

4.3 Berkeley Distribution	 June 6, 1993				     2
[top]

List of man pages available for 4.4BSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net