home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / uucp / duucp-1.17 / AU-117b4-man.lha / man / UUcico < prev    next >
Encoding:
Text File  |  1994-01-27  |  9.7 KB  |  327 lines
  1. NAME
  2.     UUCICO
  3.  
  4. SYNOPSIS
  5.     UUCICO -A -D[EVICE] device -U[NIT] unit -Getty -w -r1 -xn -Xn -xx -h0
  6.            -o -[s/S]system -e -s -7 -p # -pri -d0 -t<timeout> -T<timeout>
  7.            -packets -nodelay -Q
  8.  
  9. DESCRIPTION
  10.     UUCICO is the basis for UUCP.    It can be run either from by GETTY
  11.     when something logs into the Amiga, it can be run from a CRON, or
  12.     manually to originate connections.
  13.  
  14.     Some options to UUCICO are now outdated and should not be used.
  15.     Specifically, early versions of AmigaUUCP did not have a GETTY, and
  16.     UUCICO dealt with waiting for connections itself.
  17.  
  18.     Either way, the final result is a connection between your machine
  19.     and a remote machine.  UUCICO will retrieve queued work on the remote
  20.     remote machine and send any queued work from your machine. These work
  21.     files are located in UUSpool:.
  22.  
  23.     The term 'work' refers to items queued by other programs, such as
  24.     POSTNEWS and SENDMAIL.    These programs create files in UUSpool: that
  25.     inform UUCICO what to do with them and where to send them. When
  26.     receiving work, UUCICO will write it to UUSpool:, and then run UUXQT.
  27.  
  28.     If the configuration (or environment) variable UseSubDirs is set to
  29.     YES, and the directory named UUSpool:<system> has been created by the
  30.     user, then UUCICO will check for work, and create incoming files, in
  31.     that individual subdirectory for each system.
  32.  
  33.     UUXQT scans received files and determines how to break them up (for
  34.     example, append them to the appropriate mail box or news directory).
  35.     The control files in UUSpool: contain a line indicating the appropriate
  36.     program required to unpack the files.  UUXQT reads this line and runs
  37.     the proper program (RMAIL, RNEWS, etc.).
  38.  
  39.                 LOCKING
  40.  
  41.     UUCICO locks the serial port in the same manner Getty does, by doing the
  42.     equivalent of the UUCP:C/LOCKSERIAL command before opening it.    Thus,
  43.     UUCICO's will never bump into each other on the port.  Any terminal
  44.     program you run should lock the serial port as well.  This is done by
  45.     running the terminal program via UUCP:C/LOCKSERIAL with the appropriate
  46.     arguments.
  47.  
  48.     Refer to the man pages for GETTY and LOCKSERIAL for more information.
  49.  
  50.     Note that recent versions of Terminus and VLT do have direct OwnDevUnit
  51.     support (which is how LOCKSERIAL locks the serial port).
  52.  
  53. GENERAL OPTIONS
  54.  
  55.     (*)'d Options are supplied automatically on Getty Initiated
  56.     connections
  57.  
  58.     -7            Set 7WIRE mode for serial connections
  59.                 (i.e., hardware handshaking).
  60.  
  61.     -A            Attempt to lock device. If it can't be locked,
  62.                 then give up and exit.
  63.  
  64.     -b            Run the BATCHNEWS program before anything else.
  65.  
  66.     -d0            IGNORE DTR switch forces UUCico to use the
  67.                 +++ sequence to disconnect instead of dropping
  68.                 DTR.   This is a workaround for a possible
  69.                 bug in the serial device for those who
  70.                 experience crashes when UUCico tries to
  71.                 disconnect.
  72.  
  73.    (*)    -D <devicename>     Default is serial.device
  74.  
  75.    (*)    -U <unitnumber>     Default is 0
  76.  
  77.     -h0            Ignore Carrier Detect.
  78.  
  79.     -H            Ignore Carrier Detect, and this is a
  80.                 hardwired connect so don't send and
  81.                 dial or connect messages to the remote.
  82.  
  83.     -nodelay        Normally, UUCICO will wait 0.06 seconds after
  84.                 receiving a "no data" indication from the
  85.                 serial port to allow more data time to arrive.
  86.                 This flag prevents UUCICO from waiting, which
  87.                 may be needed with very high-speed interfaces
  88.                 (ISDN, etc.).
  89.  
  90.     -n<size>        Set 'g' and 'G' protocol window size.  If size
  91.                 is not specified, a window size of 1 is forced.
  92.                 The default (-n option not specified) is a
  93.                 window size of 7.
  94.  
  95.                 Sometimes it is necessary to reduce the window
  96.                 size to 3 or 4 when connecting to heavily
  97.                 loaded UNIX systems.
  98.  
  99.     -N<nodename>        An override name to use as NODENAME (ignore
  100.                 what is in UULib:Config).
  101.  
  102.     -p #            So-called "protocol hacks". A bit-field to
  103.                 control special protocol changes. The only
  104.                 one currently implemented is "1". When p1
  105.                 is specified, on incoming connects, an "="
  106.                 is placed in the outgoing SHERE message.
  107.  
  108.     -p <letter>        What protocol to use. Currently, only 'g' and
  109.                 'G' are valid.
  110.  
  111.     -packets        Calculate the most efficient packet size to
  112.                 be used for an outgoing transmission within
  113.                 the current segment size. MANY UNIX SYSTEMS
  114.                 WILL NOT SUPPORT THIS PROPERLY. Taylor UUCP
  115.                 and HDB UUCP seem to. Use with care.
  116.  
  117.     -pri            UUCico ups its priority by 1 during transfer,
  118.                 then downs it by 1 to run uuxqt. (i.e. +1
  119.                 during transer, -1 for uuxqt).
  120.  
  121.     -P<segsize>        Set segment size, in powers of two where a
  122.                 segment size of 2 == 64 bytes.  The maximum
  123.                 segment size is 8 (4096 bytes). The complete
  124.                 table is as follows:
  125.  
  126.                  Segment Size           Bytes
  127.                     2          64
  128.                     3         128
  129.                     4         256
  130.                     5         512
  131.                     6        1024
  132.                     7        2048
  133.                     8        4096
  134.  
  135.                 This option should be used only by EXPERIENCED
  136.                 UUCP users.  Larger is not necessarily better
  137.                 since all packets are fixed length (unless
  138.                 -packets is set).
  139.  
  140.     -Q            When UUXqtInterval is set, and -Q is set, then
  141.                 UUXQT is passed the name of the current host to
  142.                 allow it to unbatch only for that host. Current
  143.                 versions of UUXQT support this. Versions from
  144.                 1.16 and before do not.
  145.  
  146.     -t<timeout>        Set GIO protocol packet timeout before retry.
  147.                 Default is 5.  In many cases this can cause
  148.                 long no-activity delays due to small glitches
  149.                 when, in fact, the receiving host is not loaded
  150.                 down.  Setting the timeout to 1 generally fixes
  151.                 this.
  152.  
  153.     -T<timeout>        Set timeout for send-expect strings, default
  154.                 is 15 seconds.
  155.  
  156.     -Xn            Set log and debug level but do not tell the
  157.                 remote system about it.
  158.  
  159.     -Xx            Set log and debug levels, as well as debug
  160.                 handshake to stdout, but do not tell the
  161.                 remote system about it.
  162.  
  163.     -xn            Set log and debug level for us and for the
  164.                 remote system
  165.  
  166.     -xx            Debug handshake to stdout (but not once connection
  167.                 is established).  Useful for debugging L.Sys
  168.                 send-expect stuff.
  169.  
  170. GETTY INITIATED OPTIONS
  171.  
  172.    (*)    -Getty            Tells UUCICO that it was started from a Getty.
  173.     -g
  174.  
  175. MANUAL POLL OPTIONS
  176.  
  177.     -o            Tells UUCICO to not search for a CONNECT
  178.                 message when carrier is detected (hardwired
  179.                 configuration) and doesn't dial any numbers.
  180.                 (See also H.)
  181.  
  182.     -r1            Call all systems we have pending work for.
  183.                 When not zero, UUCICO starts connection as
  184.                 master. Otherwise, as slave.
  185.  
  186.     -r1 -ssystem        Call this specific system if we have pending
  187.                 work.
  188.  
  189.     -s system        Poll (call-up) the specified system
  190.  
  191.     -S system        Same as -s but ignore time restrictions
  192.  
  193. OBSOLETE OPTIONS    (WAIT MODE OPTIONS)  DO NOT USE IF YOU CAN HELP IT
  194.  
  195.     -e            Tells UUCICO to loop forever waiting for
  196.                 connections.
  197.  
  198.     -B <baudrate>        Ignored.
  199.  
  200.     -w            Tells UUCICO to wait for one or more
  201.                 connections (depending on -e) AFTER having
  202.                 previously polled one or more systems
  203.                 (-r, -s, -S).
  204.  
  205.     <nooptions>        If UUCICO is run without either -Getty,
  206.                 -s, or -r, it will wait for a single
  207.                 connection. This is used for incoming
  208.                 connections.
  209.  
  210. CONFIGURATION OPTIONS
  211.  
  212.     UUCICO understands the following special options, in either
  213.     of UULib:Config, or as environment variables (for 2.0 or
  214.     above):
  215.  
  216.     BATCHNEWS    string
  217.  
  218.         The name of the BATCHNEWS program for the -b switch.
  219.  
  220.     COPYNOTIFY    integer/bitfield
  221.  
  222.         Enable various notifications via mail:
  223.  
  224.         1   - notify of send failure that will not be retried (denied)
  225.         2   - notify of send failures that WILL be retried (protocol
  226.               errors)
  227.         4   - notify of successfull outgoing file copy (UUCP only)
  228.         8   - notify of incoming file (UUCP only)
  229.         16  - notify of incoming failure of anykind
  230.  
  231.         Add together for various options, 31 for all.
  232.  
  233.         Mail is sent to USERNAME entry for incoming files and to
  234.         the originator of outgoing file copies.
  235.  
  236.     CTIMEOUT    integer
  237.  
  238.         How many seconds to wait for the CONNECT message after
  239.         dialing a number
  240.  
  241.     MODEMINIT    string
  242.  
  243.         A string to be sent to the modem immediately before
  244.         dialin a number.
  245.  
  246.     SENDMAIL    string
  247.  
  248.         The name of the mailer program for sending mail (for
  249.         COPYNOTIFY).
  250.  
  251.     USESUBDIRS    yes/no/1/0
  252.  
  253.         Whether subdirectories of UUSpool: should be used for
  254.         sending and receiving work. This is also used by UUX,
  255.         UUCP, and other programs.
  256.  
  257.     UUXQT        string
  258.  
  259.         The name of the UUXQT program for UUXqtInterval.
  260.  
  261.     UUXQTINTERVAL    integer
  262.  
  263.         How many files to receive before starting a UUXQT. If
  264.         zero, UUCICO does not start UUXQT at all (defaults to
  265.         zero).
  266.  
  267.     UUXQTPRIORITY    integer
  268.  
  269.         The priority at which to start UUXQT.
  270.  
  271. TIMELOG FORMAT
  272.  
  273.     UUCICO automatically appends an entry to UUSPOOL:TimeLog in
  274.     the following format:
  275.  
  276.     dd-mmm-yy mm:ss mm:ss in=nnnnn out=nnnnn <system_name>
  277.  
  278.     The date, then two on-line times.  The first is the connect time
  279.     from carrier detect, the second is connect time from send-expect
  280.     success.  Use whichever one is appropriate for bill calculations.
  281.     Following that is the number of data bytes received (total of
  282.     received file sizes) and the number of data bytes sent (total of
  283.     transmitted file sizes).  These numbers do not reflect additional
  284.     overhead used by the G protocol (messages, acks, packet overhead,
  285.     or retries).
  286.  
  287.     UUCICO also automatically appends an entry to UUSPool:XferStat
  288.     in the standard XferStat format for each connect.
  289.  
  290. EXAMPLE
  291.                 -----
  292.  
  293.     ; Place a line similar to this in your startup-sequence!
  294.     ; See GETTY manual
  295.  
  296.     resident uucp:C/Getty
  297.     run <nil: >nil: Getty -A -B19200 -Mm
  298.  
  299.                 -----
  300.  
  301.     ; Manually poll system 'foo'
  302.     UUCICO -sfoo
  303.  
  304.                 -----
  305.  
  306.     ; From DCRON  (DCRON ENTRY)
  307. 40    1    *    *    *    uucp:c/uucico -r1
  308.  
  309.  
  310.  
  311. FILES/REQUIRES
  312.     UUCP:
  313.     UUCP:c/*
  314.     UULib:
  315.     UULib:Config
  316.     UUMail;
  317.     UUSpool:
  318.     UUSpool:LogFile
  319.     UUSpool:XferStat
  320.  
  321. REFERENCES
  322.     UUMan:L.Sys
  323.     UUMan:Getty
  324.     UUMan:DCron
  325.     UUMan:Assigns
  326.     UUMan:Config
  327.