uucico daemon - Process UUCP file transfer requests
Format
uucico [-f] [-g grade] [-r0|-r1] [-s system] [-x type]
Description
The uucico daemon processes file transfer requests that were queued by uucp and uux. It establishes the connection with remote sites and manages the transfer of data between the local and remote sites as specified by the queued uucp or uux job.
uucico is automatically invoked after the uucp or uux command completes (unless the -r option was specified on the uucp or uux command). To process requests that cannot be successfully completed at the time the uucp or uux command was executed and to initiate transfers from remote sites, the traditional approach is to use cron to start uucico at regular intervals. (For more information, see Schedule periodic UUCP transfers with cron in z/OS UNIX System Services Planning. It contains information about creating crontab entries.)
- In slave mode, uucico receives requests from the remote site. The -r0 option (the default option) starts uucico in slave mode. uucico is typically started in slave mode by either the uucpd daemon (for remote connections via TCP/IP) or as the login shell for special UUCP user IDs that can be logged onto via serial connections. See uucpd and uucp for more information.
- In master mode, uucico processes requests from the local site; the -r1 and -s options start uucico in master mode. uucico is typically started in master mode via cron. uucp and uux also invoke uucico in master mode by default.
If uucico cannot contact a remote system, it does not allow itself to run again until a specified amount of time has passed. You can specify how long the daemon should wait before trying to call each system again by setting a parameter in the Permissions file. For more information about permissions, seeThe Permissions file in z/OS UNIX System Services Planning.
If uucico receives a SIGQUIT, SIGTERM or SIGPIPE signal, it ends any current conversation with a remote site and exits.
Options
- -f
- Ignores the required wait period for all remote systems and makes calls as requested.
- -g grade
- Processes outgoing work only if it is designated priority grade or
better. grade is a number (
0-9
) or letter (A-Z
,a-z
), where0
is the highest priority andz
is the lowest. - -r0 | -r1
- Specifies the mode for uucico to use. -r0 (the default) specifies slave mode; -r1 specifies master mode. If you want uucico to call a remote system (master mode), specify -r1.
- -s system
- Calls the remote system. By default, uucico calls all defined systems.
- -x type
- Turns on debugging. type is a number indicating the level of detail.
0
is the least detail and9
is the most detail. The debugging output is written to stderr if uucico is run in the foreground, or to /usr/spool/uucp/LOGFILE if uucico is run in the background by uucpd or by a remote uucico logging into a UUCP user ID.The LOGFILE must be monitored so that it does not fill up your file system.
Examples
west
, with debugging output sent to stdout:
uucico -r1 -x 9 -s west
Files
- /usr/lib/uucp/config
- UUCP configuration file. See uucc.
- /usr/spool/uucp/LOGFILE
- UUCP debug file.
- /usr/spool/locks
- The directory containing the lock files created by uucico.
- /usr/spool/uucp/.Status
- UUCP status file.
Exit values
0
- Successful completion.
1
- Failure due to any of the following reasons:
- Unknown command-line option.
- Not running setuid uucp.
- Argument list too long.
- Unable to open log file.
- CTRL-C interrupt.
Portability
X/Open Portability Guide.
Related information
uucc, uucp, uulog, uux, uuxqt