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