1uucico(8) System Manager's Manual uucico(8)
2
6 uucico - UUCP file transfer daemon
7
9 uucico [ options ]
10
12 The uucico daemon processes file transfer requests queued by uucp (1)
13 and uux (1). It is started when uucp or uux is run (unless they are
14 given the -r option). It is also typically started periodically using
15 entries in the crontab table(s).
16 When invoked with -r1, --master, -s, --system, or -S, the daemon will
18 place a call to a remote system, running in master mode. Otherwise the
19 daemon will start in slave mode, accepting a call from a remote system.
20 Typically a special login name will be set up for UUCP which automati‐
21 cally invokes uucico when a call is made.
22 When uucico terminates, it invokes the uuxqt (8) daemon, unless the -q
24 or --nouuxqt option is given; uuxqt (8) executes any work orders cre‐
25 ated by uux (1) on a remote system, and any work orders created locally
26 which have received remote files for which they were waiting.
27 If a call fails, uucico will normally refuse to retry the call until a
29 certain (configurable) amount of time has passed. This may be overri‐
30 den by the -f, --force, or -S option.
31 The -l, --prompt, -e, or --loop options may be used to force uucico to
33 produce its own prompts of "login: " and "Password:". When another
34 daemon calls in, it will see these prompts and log in as usual. The
35 login name and password will normally be checked against a separate
36 list kept specially for uucico rather than the /etc/passwd file; it is
37 possible on some systems to direct uucico to use the /etc/passwd file.
38 The -l or --prompt option will prompt once and then exit; in this mode
39 the UUCP administrator or the superuser may use the -u or --login
40 option to force a login name, in which case uucico will not prompt for
41 one. The -e or --loop option will prompt again after the first session
42 is over; in this mode uucico will permanently control a port.
43 If uucico receives a SIGQUIT, SIGTERM or SIGPIPE signal, it will
45 cleanly abort any current conversation with a remote system and exit.
46 If it receives a SIGHUP signal it will abort any current conversation,
47 but will continue to place calls to (if invoked with -r1 or --master)
48 and accept calls from (if invoked with -e or --loop) other systems. If
49 it receives a SIGINT signal it will finish the current conversation,
50 but will not place or accept any more calls.
51
53 The following options may be given to uucico.
54 -r1, --master
56 Start in master mode (call out to a system); implied by -s, --sys‐
57 tem, or -S. If no system is specified, call any system for which
58 work is waiting to be done.
59 -r0, --slave
61 Start in slave mode. This is the default.
62 -s system, --system system
64 Call the named system.
65 -S system
67 Call the named system, ignoring any required wait. This is equiv‐
68 alent to -s system -f.
69 -f, --force
71 Ignore any required wait for any systems to be called.
72 -l, --prompt
74 Prompt for login name and password using "login: " and "Pass‐
75 word:". This allows uucico to be easily run from inetd (8). The
76 login name and password are checked against the UUCP password
77 file, which probably has no connection to the file /etc/passwd.
78 The --login option may be used to force a login name, in which
79 cause uucico will only prompt for a password.
80 -p port, --port port
82 Specify a port to call out on or to listen to.
83 -e, --loop
85 Enter endless loop of login/password prompts and slave mode daemon
86 execution. The program will not stop by itself; you must use kill
87 (1) to shut it down.
88 -w, --wait
90 After calling out (to a particular system when -s, --system, or -S
91 is specifed, or to all systems which have work when just -r1 or
92 --master is specifed), begin an endless loop as with --loop.
93 -q, --nouuxqt
95 Do not start the uuxqt (8) daemon when finished.
96 -c, --quiet
98 If no calls are permitted at this time, then don't make the call,
99 but also do not put an error message in the log file and do not
100 update the system status (as reported by uustat (1)). This can be
101 convenient for automated polling scripts, which may want to simply
102 attempt to call every system rather than worry about which partic‐
103 ular systems may be called at the moment. This option also sup‐
104 presses the log message indicating that there is no work to be
105 done.
106 -C, --ifwork
108 Only call the system named by -s, --system or -S if there is work
109 for that system.
110 -D, --nodetach
112 Do not detach from the controlling terminal. Normally uucico
113 detaches from the terminal before each call out to another system
114 and before invoking uuxqt. This option prevents this.
115 -u name, --login name
117 Set the login name to use instead of that of the invoking user.
118 This option may only be used by the UUCP administrator or the
119 superuser. If used with --prompt, this will cause uucico to
120 prompt only for the password, not the login name.
121 -z, --try-next
123 If a call fails after the remote system is reached, try the next
124 alternate rather than simply exiting.
125 -i type, --stdin type
127 Set the type of port to use when using standard input. The only
128 support port type is TLI, and this is only available on machines
129 which support the TLI networking interface. Specifying -iTLI
130 causes uucico to use TLI calls to perform I/O.
131 -x type, -X type, --debug type
133 Turn on particular debugging types. The following types are rec‐
134 ognized: abnormal, chat, handshake, uucp-proto, proto, port, con‐
135 fig, spooldir, execute, incoming, outgoing.
136 Multiple types may be given, separated by commas, and the --debug
138 option may appear multiple times. A number may also be given,
139 which will turn on that many types from the foregoing list; for
140 example, --debug 2 is equivalent to --debug abnormal,chat.
141 The debugging output is sent to the debugging file, which may be
143 printed using uulog -D.
144 -I file, --config file
146 Set configuration file to use. This option may not be available,
147 depending upon how uucico was compiled.
148 -v, --version
150 Report version information and exit.
151 --help
153 Print a help message and exit.
154
156 kill(1), uucp(1), uux(1), uustat(1), uuxqt(8)
157
159 Ian Lance Taylor <ian@airs.com>
160 Taylor UUCP 1.07 uucico(8)