Provided by: uucp_1.07-29_amd64 bug

NAME

       uucico - UUCP file transfer daemon

SYNOPSIS

       uucico [ options ]

DESCRIPTION

       The  uucico daemon processes file transfer requests queued by uucp (1) and uux (1).  It is
       started when uucp or uux is run (unless they  are  given  the  -r  option).   It  is  also
       typically started periodically using entries in the crontab table(s).

       When  invoked  with  -r1, --master, -s, --system, or -S, the daemon will place a call to a
       remote system, running in master mode.  Otherwise the daemon will  start  in  slave  mode,
       accepting  a call from a remote system.  Typically a special login name will be set up for
       UUCP which automatically invokes uucico when a call is made.

       When uucico terminates, it invokes the uuxqt (8) daemon, unless the -q or --nouuxqt option
       is  given;  uuxqt  (8) executes any work orders created by uux (1) on a remote system, and
       any work orders created locally which have received  remote  files  for  which  they  were
       waiting.

       If  a  call  fails,  uucico  will  normally  refuse  to  retry  the  call  until a certain
       (configurable) amount of time has passed.  This may be overridden by the -f,  --force,  or
       -S option.

       The  -l,  --prompt,  -e,  or --loop options may be used to force uucico to produce its own
       prompts of "login: " and "Password:".  When another daemon calls in,  it  will  see  these
       prompts and log in as usual.  The login name and password will normally be checked against
       a separate list kept specially for uucico rather than the /etc/passwd file; it is possible
       on  some  systems to direct uucico to use the /etc/passwd file.  The -l or --prompt option
       will prompt once and then exit; in this mode the UUCP administrator or the  superuser  may
       use  the  -u or --login option to force a login name, in which case uucico will not prompt
       for one.  The -e or --loop option will prompt again after the first session  is  over;  in
       this mode uucico will permanently control a port.

       If uucico receives a SIGQUIT, SIGTERM or SIGPIPE signal, it will cleanly abort any current
       conversation with a remote system and exit.  If it receives a SIGHUP signal it will  abort
       any  current  conversation,  but  will  continue to place calls to (if invoked with -r1 or
       --master) and accept calls from (if invoked with -e  or  --loop)  other  systems.   If  it
       receives  a  SIGINT  signal it will finish the current conversation, but will not place or
       accept any more calls.

OPTIONS

       The following options may be given to uucico.

       -r1, --master
            Start in master mode (call out to a system); implied by -s, --system, or -S.   If  no
            system is specified, call any system for which work is waiting to be done.

       -r0, --slave
            Start in slave mode.  This is the default.

       -s system, --system system
            Call the named system.

       -S system
            Call  the  named system, ignoring any required wait.  This is equivalent to -s system
            -f.

       -f, --force
            Ignore any required wait for any systems to be called.

       -l, --prompt
            Prompt for login name and password using "login:  "  and  "Password:".   This  allows
            uucico  to  be  easily  run  from inetd (8).  The login name and password are checked
            against the UUCP password  file,  which  probably  has  no  connection  to  the  file
            /etc/passwd.   The  --login  option may be used to force a login name, in which cause
            uucico will only prompt for a password.

       -p port, --port port
            Specify a port to call out on or to listen to.

       -e, --loop
            Enter endless loop of login/password prompts and slave mode  daemon  execution.   The
            program will not stop by itself; you must use kill (1) to shut it down.

       -w, --wait
            After  calling  out (to a particular system when -s, --system, or -S is specified, or
            to all systems which have work when just -r1 or  --master  is  specified),  begin  an
            endless loop as with --loop.

       -q, --nouuxqt
            Do not start the uuxqt (8) daemon when finished.

       -c, --quiet
            If no calls are permitted at this time, then don't make the call, but also do not put
            an error message in the log file and do not update the system status (as reported  by
            uustat (1)).  This can be convenient for automated polling scripts, which may want to
            simply attempt to call every system rather than worry about which particular  systems
            may  be called at the moment.  This option also suppresses the log message indicating
            that there is no work to be done.

       -C, --ifwork
            Only call the system named by -s, --system or -S if there is work for that system.

       -D, --nodetach
            Do not detach from the controlling  terminal.   Normally  uucico  detaches  from  the
            terminal  before  each  call  out  to another system and before invoking uuxqt.  This
            option prevents this.

       -u name, --login name
            Set the login name to use instead of that of the invoking user.  This option may only
            be used by the UUCP administrator or the superuser.  If used with --prompt, this will
            cause uucico to prompt only for the password, not the login name.

       -z, --try-next
            If a call fails after the remote system is reached, try  the  next  alternate  rather
            than simply exiting.

       -i type, --stdin type
            Set the type of port to use when using standard input.  The only support port type is
            TLI, and this is  only  available  on  machines  which  support  the  TLI  networking
            interface.  Specifying -iTLI causes uucico to use TLI calls to perform I/O.

       -x type, -X type, --debug type
            Turn  on  particular  debugging types.  The following types are recognized: abnormal,
            chat, handshake,  uucp-proto,  proto,  port,  config,  spooldir,  execute,  incoming,
            outgoing.

            Multiple  types  may be given, separated by commas, and the --debug option may appear
            multiple times.  A number may also be given, which will turn on that many types  from
            the foregoing list; for example, --debug 2 is equivalent to --debug abnormal,chat.

            The  debugging output is sent to the debugging file, which may be printed using uulog
            -D.

       -I file, --config file
            Set configuration file to use.  This option may not be available, depending upon  how
            uucico was compiled.

       -v, --version
            Report version information and exit.

       --help
            Print a help message and exit.

SEE ALSO

       kill(1), uucp(1), uux(1), uustat(1), uuxqt(8)

AUTHOR

       Ian Lance Taylor <ian@airs.com>

                                         Taylor UUCP 1.07                               uucico(8)