1UUCICO(8) System Manager's Manual UUCICO(8)
2
6 uucico, uucpd - transfer files queued by uucp or uux
7
9 /usr/sbin/uucico [ -dspooldir ] [ -ggrade ] [ -rrole ] [ -R ] [ -ssys‐
10 tem ] [ -xdebug ] [ -L ] [ -tturnaround ]
11 /usr/libexec/uucpd
13
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 The following options are available.
20 -dspooldir
22 Use spooldir as the spool directory. The default is
23 /usr/spool/uucp.
24 -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 -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 -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 -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 -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 -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 -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 If uucico receives a SIGFPE (see kill(1)), it will toggle the debugging
68 on or off.
69 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 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 0 * * * * /usr/sbin/uucico -r1
82 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 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 nuucp:Password:6:1::/usr/spool/uucppublic:/usr/sbin/uucico
93 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
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 /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 /usr/spool/uucppublic Public access directory
124
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 D. A. Nowitz and M. E. Lesk, A Dial-Up Network of UNIX Systems.
130 D. A. Nowitz, Uucp Implementation Description.
1324.3 Berkeley Distribution October 23, 1996 UUCICO(8)