1UUCICO(8)                   System Manager's Manual                  UUCICO(8)
2
3
4

NAME

6       uucico, uucpd - transfer files queued by uucp or uux
7

SYNOPSIS

9       /usr/sbin/uucico  [ -dspooldir ] [ -ggrade ] [ -rrole ] [ -R ] [ -ssys‐
10       tem ] [ -xdebug ] [ -L ] [ -tturnaround ]
11
12       /usr/libexec/uucpd
13

DESCRIPTION

15       Uucico performs the actual work involved in transferring files  between
16       systems.   Uucp(1)  and  uux(1) merely queue requests for data transfer
17       which uucico processes.
18
19       The following options are available.
20
21       -dspooldir
22               Use  spooldir  as  the  spool   directory.   The   default   is
23               /usr/spool/uucp.
24
25       -ggrade Only  send  jobs  of  grade grade or higher this transfer.  The
26               grade of a job is specified when the job is queued by  uucp  or
27               uux.
28
29       -rrole  role  is either 1 or 0; it indicates whether uucico is to start
30               up in master or slave role, respectively. 1 is used  when  run‐
31               ning  uucico  by  hand or from cron(8).  0 is used when another
32               system calls the local system.  Slave role is the default.
33
34       -R      Reverse roles.  When used with the -r1 option, this  tells  the
35               remote system to begin sending its jobs first, instead of wait‐
36               ing for the local machine to finish.
37
38       -ssystem
39               Call only system system.  If -s is not specified,  and  -r1  is
40               specified,  uucico  will  attempt to call all systems for which
41               there is work.  If -s is specified, a call will be made even if
42               there is no work for that system. This is useful for polling.
43
44       -xdebug Turn on debugging at level debug.  Level 5 is a good start when
45               trying to find out why a call failed. Level 9 is very detailed.
46               Level 99 is absurdly verbose.  If role is 1 (master), output is
47               normally written to the standard  message  output  stderr.   If
48               stderr     is     unavailable,    output    is    written    to
49               /usr/spool/uucp/AUDIT/system.  When role is 0  (slave),  debug‐
50               ging output is always written to the AUDIT file.
51
52       -L      Only  call  ``local''  sites. A site is considered local if the
53               device-type field in L.sys is one of LOCAL, DIR or TCP.
54
55       -tturnaround
56               Use turnaround as the line turnaround time (in minutes) instead
57               of  the  default 30.  If turnaround is missing or 0, line turn‐
58               around will be disabled.  After  uucico  has  been  running  in
59               slave  role  for  turnaround minutes, it will attempt to run in
60               master role by negotiating with the remote machine.  In earlier
61               versions  of  uucico,  a  transfer  of  many large files in one
62               direction would hold up mail  going  in  the  other  direction.
63               With the turnaround code working, the message flow will be more
64               bidirectional in the short term.  This option only  works  with
65               newer uucico's and is ignored by older ones.
66
67       If uucico receives a SIGFPE (see kill(1)), it will toggle the debugging
68       on or off.
69
70       Uucpd is the server for  supporting  uucp  connections  over  networks.
71       Uucpd  listens  for  service  requests  at  the  port  indicated in the
72       ``uucp'' service specification; see services(5).  The  server  provides
73       login  name  and  password authentication before starting up uucico for
74       the rest of the transaction.
75
76       Uucico is commonly used either of two ways: as a  daemon  run  periodi‐
77       cally  by cron(8) to call out to remote systems, and as a ``shell'' for
78       remote systems who call in.  For calling out  periodically,  a  typical
79       line in crontab would be:
80
81            0    *    *    *    *    /usr/sbin/uucico -r1
82
83       This  will  run uucico every hour in master role.  For each system that
84       has transfer requests queued, uucico calls the  system,  logs  in,  and
85       executes  the transfers. The file L.sys(5) is consulted for information
86       about how to log in, while L-devices(5) specifies available  lines  and
87       modems for calling.
88
89       For  remote  systems to dial in, an entry in the passwd(5) file must be
90       created, with a login ``shell'' of uucico.  For example:
91
92            nuucp:Password:6:1::/usr/spool/uucppublic:/usr/sbin/uucico
93
94       The UID for UUCP remote logins is not critical, so long as  it  differs
95       from  the  UUCP  Administrative login.  The latter owns the UUCP files,
96       and assigning this UID to a remote login would be an  extreme  security
97       hazard.
98

FILES

100       /etc/uucp/                    UUCP internal files
101       /etc/uucp/L-devices           Local device descriptions
102       /etc/uucp/L-dialcodes         Phone numbers and prefixes
103       /etc/uucp/L.aliases           Hostname aliases
104       /etc/uucp/L.cmds              Remote command permissions list
105       /etc/uucp/L.sys               Host connection specifications
106       /etc/uucp/USERFILE            Remote directory tree permissions list
107
108       /usr/spool/uucp/              Spool directory
109       /usr/spool/uucp/AUDIT/*       Debugging audit trails
110       /usr/spool/uucp/C./           Control files directory
111       /usr/spool/uucp/D./           Incoming data file directory
112       /usr/spool/uucp/D.hostname/   Outgoing data file directory
113       /usr/spool/uucp/D.hostnameX/  Outgoing execution file directory
114       /usr/spool/uucp/CORRUPT/      Place for corrupted C. and D. files
115       /usr/spool/uucp/ERRLOG        UUCP internal error log
116       /usr/spool/uucp/LOGFILE       UUCP system activity log
117       /usr/spool/uucp/LCK/LCK..*    Device lock files
118       /usr/spool/uucp/SYSLOG        File transfer statistics log
119       /usr/spool/uucp/STST/*        System status files
120       /usr/spool/uucp/TM./          File transfer temp directory
121       /usr/spool/uucp/X./           Incoming execution file directory
122
123       /usr/spool/uucppublic         Public access directory
124

SEE ALSO

126       uucp(1),  uuq(1),  uux(1),  L-devices(5), L-dialcodes(5), L.aliases(5),
127       L.cmds(5), L.sys(5), uuclean(8), uupoll(8), uusnap(8), uuxqt(8)
128
129       D. A. Nowitz and M. E. Lesk, A Dial-Up Network of UNIX Systems.
130
131       D. A. Nowitz, Uucp Implementation Description.
132
133
134
1354.3 Berkeley Distribution      October 23, 1996                      UUCICO(8)
Impressum