uucico(ADM)                     19 June 1992                     uucico(ADM)


 Name

    uucico - file transport program for the UUCP system

 Syntax

    /usr/lib/uucp/uucico [ -r rolenumber ] [ -x debuglevel ]
    [ -i interface ] [ -d spooldirectory ] [ -s ] [ -S ] systemname

 Description

    uucico is the file transport program for UUCP work file transfers.  Role
    numbers for the -r are the digit 1 for master mode or 0 for slave mode
    (default).  The -r option should be specified as the digit 1 for master
    mode when uucico is started by a program or cron.  uux and uucp both
    queue jobs that will be transferred by uucico. It is normally started by
    the scheduler, uusched, but can be started manually; this is done for
    debugging.  For example, the shell uutry starts uucico with debugging
    turned on.  A single digit must be used for the -x option with higher
    numbers for more debugging.

    The -i option defines the interface used with uucico.  This interface
    only affects slave mode.  Known interfaces are UNIX (default), TLI (basic
    Transport Layer Interface), and TLIS (Transport Layer Interface with
    Streams modules, read/write).

    The -d option can be used to specify the spool directory:  the default is
    /usr/spool/uucp.

    If -s is specified, a call to the specified site is made even if there is
    no work for site sitename in the spool directory, but call only when
    times in the Systems file permit it.  This is useful for polling sites
    that do not have the hardware to initiate a connection.

    The -S option can be used to specify the system name, overriding the call
    schedule given in the Systems file. For example, -S can be used to call a
    system which is said to be ``Never'' called in the Systems file.

 Changing packet parameters

    An additional feature is the ability to change two specialized parameters
    contained in the uucico program without having to recompile the source.
    (The uucico binary is provided unstripped so that patches can be applied
    using the /etc/fst tool.)  The first is a parameter called windows,
    which specifies the size of window that the sliding-window protocol
    should use (how many packets it can send before getting any ack/nack's
    from the remote site).  windows can be changed using a variation of the
    following patch, which set the value of windows to 7:

       /etc/fst -w uucico << FSTEOF
       $d
       windows/w 7
       $q
       FSTEOF

    In addition, the parameter pktime can be altered.  This is the number of
    seconds uucico should wait before giving up and re-transmitting the
    packet being sent sent.  This interval can be as long as 35 seconds,
    which can be costly with overseas phone connections.  pktime can be
    changed using a variation of the following patch.  In this example,
    pktime is set to 5:

       /etc/fst -w uucico << FSTEOF
       $d
       pktime/w 5
       $q
       FSTEOF

 Files

    /usr/lib/uucp/Systems
    /usr/lib/uucp/Permissions
    /usr/lib/uucp/Devices
    /usr/lib/uucp/Maxuuxqts
    /usr/lib/uucp/Maxuuscheds
    /usr/spool/uucp/*
    /usr/spool/uucppublic/*

 See also

    cron(C), uucp(C), uusched(ADM), uustat(C), uutry(ADM), uux(C)