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. (See z/OS UNIX System Services Planning for more information about using cron to start uucico. 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 information about the permissions file, see 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), where 0 is the highest priority and z 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
and 9 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
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:
- 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