manual/GNU_uucp/original/man8/uucico.8

   1 ''' $Id: uucico.8,v 1.18 1995/06/26 22:36:09 ian Rel $
   2 .TH uucico 8 "Taylor UUCP 1.06"
   3 .SH NAME
   4 uucico \- UUCP file transfer daemon
   5 .SH SYNOPSIS
   6 .B uucico
   7 [ options ]
   8 .SH DESCRIPTION
   9 The
  10 .I uucico
  11 daemon processes file transfer requests queued by
  12 .I uucp
  13 (1) and
  14 .I uux
  15 (1).  It is started when
  16 .I uucp
  17 or
  18 .I uux
  19 is run (unless they are given the
  20 .B \-r
  21 option).  It is also typically started periodically using
  22 entries in the
  23 .I crontab
  24 table(s).
  25
  26 When invoked with
  27 .B \-r1,
  28 .B \-\-master,
  29 .B \-s,
  30 .B \-\-system,
  31 or
  32 .B \-S,
  33 the daemon will place a call to a remote system, running in master
  34 mode.  Otherwise the daemon will start in slave mode, accepting a call
  35 from a remote system.  Typically a special login name will be set up
  36 for UUCP which automatically invokes
  37 .I uucico
  38 when a call is made.
  39
  40 When
  41 .I uucico
  42 terminates, it invokes the
  43 .I uuxqt
  44 (8) daemon, unless the
  45 .B \-q
  46 or
  47 .B \-\-nouuxqt
  48 option is given;
  49 .I uuxqt
  50 (8) executes any work orders created by
  51 .I uux
  52 (1) on a remote system, and any work orders created locally which have
  53 received remote files for which they were waiting.
  54
  55 If a call fails,
  56 .I uucico
  57 will normally refuse to retry the
  58 call until a certain (configurable) amount of time
  59 has passed.  This may be overriden by the
  60 .B -f,
  61 .B --force,
  62 or
  63 .B -S
  64 option.
  65
  66 The
  67 .B \-l,
  68 .B \-\-prompt,
  69 .B \-e,
  70 or
  71 .B \-\-loop
  72 options may be used to force
  73 .I uucico
  74 to produce its own prompts of "login: " and "Password:".  When another
  75 daemon calls in, it will see these prompts and log in as usual.  The
  76 login name and password will normally be checked against a separate
  77 list kept specially for
  78 .I uucico
  79 rather than the
  80 .I /etc/passwd
  81 file; it is possible on some systems to direct
  82 .I uucico
  83 to use the
  84 .I /etc/passwd
  85 file.  The
  86 .B \-l
  87 or
  88 .B \--prompt
  89 option will prompt once and then exit; in this mode the UUCP
  90 administrator or the superuser may use the
  91 .B \-u
  92 or
  93 .B \--login
  94 option to force a login name, in which case
  95 .I uucico
  96 will not prompt for one.
  97 The
  98 .B \-e
  99 or
 100 .B \--loop
 101 option will prompt again after the first session is over; in this mode
 102 .I uucico
 103 will permanently control a port.
 104
 105 If
 106 .I uucico
 107 receives a SIGQUIT, SIGTERM or SIGPIPE signal, it will cleanly abort
 108 any current conversation with a remote system and exit.  If it
 109 receives a SIGHUP signal it will abort any current conversation, but
 110 will continue to place calls to (if invoked with
 111 .B \-r1
 112 or
 113 .B \-\-master)
 114 and accept calls from (if invoked with
 115 .B \-e
 116 or
 117 .B \-\-loop)
 118 other systems.  If it receives a
 119 SIGINT signal it will finish the current conversation, but will not
 120 place or accept any more calls.
 121 .SH OPTIONS
 122 The following options may be given to
 123 .I uucico.
 124 .TP 5
 125 .B \-r1, \-\-master
 126 Start in master mode (call out to a system); implied by
 127 .B \-s,
 128 .B \-\-system,
 129 or
 130 .B \-S.
 131 If no system is specified, call any system for which work is waiting
 132 to be done.
 133 .TP 5
 134 .B \-r0, \-\-slave
 135 Start in slave mode.  This is the default.
 136 .TP 5
 137 .B \-s system, \-\-system system
 138 Call the named system.
 139 .TP 5
 140 .B \-S system
 141 Call the named system, ignoring any required wait.  This is equivalent
 142 to
 143 .B \-s system \-f.
 144 .TP 5
 145 .B \-f, \-\-force
 146 Ignore any required wait for any systems to be called.
 147 .TP 5
 148 .B \-l, \-\-prompt
 149 Prompt for login name and password using "login: " and "Password:".
 150 This allows
 151 .I uucico
 152 to be easily run from
 153 .I inetd
 154 (8).  The login name and password are checked against the UUCP
 155 password file, which probably has no connection to the file
 156 .I /etc/passwd.
 157 The
 158 .B \-\-login
 159 option may be used to force a login name, in which cause
 160 .I uucico
 161 will only prompt for a password.
 162 .TP 5
 163 .B \-p port, \-\-port port
 164 Specify a port to call out on or to listen to.
 165 .TP 5
 166 .B \-e, \-\-loop
 167 Enter endless loop of login/password prompts and slave mode daemon
 168 execution.  The program will not stop by itself; you must use
 169 .I kill
 170 (1) to shut it down.
 171 .TP 5
 172 .B \-w, \-\-wait
 173 After calling out (to a particular system when
 174 .B \-s,
 175 .B \-\-system,
 176 or
 177 .B \-S
 178 is specifed, or to all systems which have work when just
 179 .B \-r1
 180 or
 181 .B \-\-master
 182 is specifed), begin an endless loop as with
 183 .B \-\-loop.
 184 .TP 5
 185 .B \-q, \-\-nouuxqt
 186 Do not start the
 187 .I uuxqt
 188 (8) daemon when finished.
 189 .TP 5
 190 .B \-c, \-\-quiet
 191 If no calls are permitted at this time, then don't make the call, but
 192 also do not put an error message in the log file and do not update the
 193 system status (as reported by
 194 .I uustat
 195 (1)).  This can be convenient for automated polling scripts, which may
 196 want to simply attempt to call every system rather than worry about
 197 which particular systems may be called at the moment.  This option
 198 also suppresses the log message indicating that there is no work to be
 199 done.
 200 .TP 5
 201 .B \-C, \-\-ifwork
 202 Only call the system named by
 203 .B \-s,
 204 .B \-\-system
 205 or
 206 .B \-S
 207 if there is work for that system.
 208 .TP 5
 209 .B \-D, \-\-nodetach
 210 Do not detach from the controlling terminal.  Normally
 211 .I uucico
 212 detaches from the terminal before each call out to another system and
 213 before invoking
 214 .I uuxqt.
 215 This option prevents this.
 216 .TP 5
 217 .B \-u name, \-\-login name
 218 Set the login name to use instead of that of the invoking user.  This
 219 option may only be used by the UUCP administrator or the superuser.
 220 If used with
 221 .B \-\-prompt,
 222 this will cause
 223 .I uucico
 224 to prompt only for the password, not the login name.
 225 .TP 5
 226 .B \-z, \-\-try-next
 227 If a call fails after the remote system is reached, try the next
 228 alternate rather than simply exiting.
 229 .TP 5
 230 .B \-i type, \-\-stdin type
 231 Set the type of port to use when using standard input.  The only
 232 support port type is TLI, and this is only available on machines which
 233 support the TLI networking interface.  Specifying
 234 .B \-iTLI
 235 causes
 236 .I uucico
 237 to use TLI calls to perform I/O.
 238 .TP 5
 239 .B \-x type, \-X type, \-\-debug type
 240 Turn on particular debugging types.  The following types are
 241 recognized: abnormal, chat, handshake, uucp-proto, proto, port,
 242 config, spooldir, execute, incoming, outgoing.
 243
 244 Multiple types may be given, separated by commas, and the
 245 .B \-\-debug
 246 option may appear multiple times.  A number may also be given, which
 247 will turn on that many types from the foregoing list; for example,
 248 .B \-\-debug 2
 249 is equivalent to
 250 .B \-\-debug abnormal,chat.
 251
 252 The debugging output is sent to the debugging file, usually one of
 253 /usr/spool/uucp/Debug, /usr/spool/uucp/DEBUG, or
 254 /usr/spool/uucp/.Admin/audit.local.
 255 .TP 5
 256 .B \-I file, \-\-config file
 257 Set configuration file to use.  This option may not be available,
 258 depending upon how
 259 .I uucico
 260 was compiled.
 261 .TP 5
 262 .B \-v, \-\-version
 263 Report version information and exit.
 264 .TP 5
 265 .B \-\-help
 266 Print a help message and exit.
 267 .SH FILES
 268 The file names may be changed at compilation time or by the
 269 configuration file, so these are only approximations.
 270
 271 .br
 272 /usr/lib/uucp/config - Configuration file.
 273 .br
 274 /usr/lib/uucp/passwd - Default UUCP password file.
 275 .br
 276 /usr/spool/uucp -
 277 UUCP spool directory.
 278 .br
 279 /usr/spool/uucp/Log -
 280 UUCP log file.
 281 .br
 282 /usr/spool/uucppublic -
 283 Default UUCP public directory.
 284 .br
 285 /usr/spool/uucp/Debug -
 286 Debugging file.
 287 .SH SEE ALSO
 288 kill(1), uucp(1), uux(1), uustat(1), uuxqt(8)
 289 .SH AUTHOR
 290 Ian Lance Taylor
 291 <ian@airs.com>