xref: /386bsd/usr/share/man/cat8/uucico.0 (revision a2142627)
1
2
3
4uucico(8)                      1.03                     uucico(8)
5
6
7NNAAMMEE
8       uucico - UUCP file transfer daemon
9
10SSYYNNOOPPSSIISS
11       uuuucciiccoo [ options ]
12
13DDEESSCCRRIIPPTTIIOONN
14       The  _u_u_c_i_c_o daemon processes file transfer requests queued
15       by _u_u_c_p (1) and _u_u_x (1).  It is started when _u_u_c_p  or  _u_u_x
16       is  run (unless they are given the --rr option).  It is also
17       typically  started  periodically  using  entries  in   the
18       _c_r_o_n_t_a_b table(s).
19
20       When  invoked  with the --rr11 option or the --ss or --SS option,
21       the daemon will place a call to a remote  system,  running
22       in  master mode.  Otherwise the daemon will start in slave
23       mode, accepting a call from a remote system.  Typically  a
24       special login name will be set up for UUCP which automati-
25       cally invokes _u_u_c_i_c_o when a call is made.
26
27       When _u_u_c_i_c_o terminates, it invokes the _u_u_x_q_t  (8)  daemon,
28       unless the --qq option is given; _u_u_x_q_t (8) executes any work
29       orders created by _u_u_x (1) on a remote system, and any work
30       orders  created  locally  which have received remote files
31       for which they were waiting.
32
33       If a call fails, _u_u_c_i_c_o will normally refuse to retry  the
34       call  until  a  certain  (configurable) amount of time has
35       passed.  This may be overriden by the --ff or the --SS option.
36
37       The --ll or --ee option may be used to force _u_u_c_i_c_o to produce
38       its own  prompts  of  "login:  "  and  "Password:".   When
39       another daemon calls in, it will see these prompts and log
40       in as usual; the login name and password will  be  checked
41       against  a  separate list kept specially for _u_u_c_i_c_o rather
42       than the /_e_t_c/_p_a_s_s_w_d file.  The --ll option will prompt once
43       and  then exit.  The --ee option will prompt again after the
44       first session is over; in this  mode  _u_u_c_i_c_o  will  perma-
45       nently control a port.
46
47       If  _u_u_c_i_c_o  receives a SIGQUIT, SIGTERM or SIGPIPE signal,
48       it will cleanly abort  any  current  conversation  with  a
49       remote system and exit.  If it receives a SIGHUP signal it
50       will abort any current conversation, but will continue  to
51       place calls to (if invoked with --rr11)) and accept calls from
52       (if invoked with --ee)) other systems.  If it receives a SIG-
53       INT  signal  it  will finish the current conversation, but
54       will not place or accept any more calls.
55
56OOPPTTIIOONNSS
57       The following options may be given to _u_u_c_i_c_o.
58
59       --rr11  Start in master mode (call out to a system);  implied
60            by  --ss  or  --SS..  IIff  nnoo ssyysstteemm iiss ssppeecciiffiieedd,, call any
61
62
63
64UUCP                          Taylor                            1
65
66
67
68
69
70uucico(8)                      1.03                     uucico(8)
71
72
73            system for which work is waiting to be done.
74
75       --rr00  Start in slave mode.  This is the default.
76
77       --ss ssyysstteemm
78            Call the named system.
79
80       --SS ssyysstteemm
81            Call the named system, ignoring any required wait.
82
83       --ff   Ignore any  required  wait  for  any  systems  to  be
84            called.
85
86       --ll   Prompt  for  login  name and password using "login: "
87            and "Password:".  This allows _u_u_c_i_c_o to be easily run
88            from  _i_n_e_t_d  (8).   The  login  name and password are
89            checked against the UUCP password file, which has  no
90            connection to the file /_e_t_c/_p_a_s_s_w_d.
91
92       --pp ppoorrtt
93            Specify  a  port  to call out on or to listen to.  In
94            slave mode, this implies --ee..
95
96       --ee   Enter endless  loop  of  login/password  prompts  and
97            slave  mode  daemon  execution.  The program will not
98            stop by itself; you must use  _k_i_l_l  (1)  to  shut  it
99            down.
100
101       --ww   After  calling out (to a particular system when --ss or
102            --SS is specifed, or to all  systems  which  have  work
103            when  --rr11 is specifed), begin an endless loop as with
104            --ee..
105
106       --qq   Do not start the _u_u_x_q_t (8) daemon when finished.
107
108       --DD   Do not detach from the  controlling  terminal.   Nor-
109            mally  _u_u_c_i_c_o  detaches from the terminal before each
110            call out to another system and before invoking _u_u_x_q_t.
111            This option prevents this.
112
113       --xx ttyyppee,, --XX ttyyppee
114            Turn  on  particular  debugging types.  The following
115            types  are  recognized:  abnormal,  chat,  handshake,
116            uucp-proto,  proto,  port, config, spooldir, execute,
117            incoming, outgoing.
118
119            Multiple types may be given, separated by commas, and
120            the  --xx  option  may appear multiple times.  A number
121            may also be given, which will turn on that many types
122            from the foregoing list; for example, --xx 22 is equiva-
123            lent to --xx aabbnnoorrmmaall,,cchhaatt..
124
125            The debugging output is sent to the  debugging  file,
126            usually       one      of      /usr/spool/uucp/Debug,
127
128
129
130UUCP                          Taylor                            2
131
132
133
134
135
136uucico(8)                      1.03                     uucico(8)
137
138
139            /usr/spool/uucp/DEBUG,                             or
140            /usr/spool/uucp/.Admin/audit.local.
141
142       --II ffiillee
143            Set  configuration  file to use.  This option may not
144            be available, depending upon how _u_u_c_i_c_o was compiled.
145
146       --uu llooggiinn
147            This  option is ignored.  It is only included because
148            some versions of uucpd invoke _u_u_c_i_c_o with it.
149
150FFIILLEESS
151       The file names may be changed at compilation  time  or  by
152       the  configuration file, so these are only approximations.
153
154       /usr/lib/uucp/config - Configuration file.
155       /usr/lib/uucp/passwd - Default UUCP password file.
156       /usr/spool/uucp - UUCP spool directory.
157       /usr/spool/uucp/Log - UUCP log file.
158       /usr/spool/uucppublic - Default UUCP public directory.
159       /usr/spool/uucp/Debug - Debugging file.
160
161SSEEEE AALLSSOO
162       kill(1), uucp(1), uux(1), uuxqt(8)
163
164AAUUTTHHOORR
165       Ian Lance Taylor (ian@airs.com or uunet!airs!ian)
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196UUCP                          Taylor                            3
197
198
199