home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga 13 / MA_Cover_13.bin / source / c / stefanb_src / old_projects / umsuucp / docs / uucico < prev    next >
Encoding:
Text File  |  1991-07-12  |  5.8 KB  |  202 lines
  1.  
  2.  
  3. NAME
  4.     UUCico
  5.  
  6. SYNOPSIS
  7.     UUCico -D[EVICE] device -U[NIT] unit -Getty -w -r1 -xn -Xn -xx -h0
  8.            -o -[s/S]system -e -s -7 -p # -pri -d0 -t<timeout> -T<timeout>
  9.  
  10. DESCRIPTION
  11.     UUCico is the basis for UUCP.    It can be run either from a
  12.     GETTY when somebody logs into the Amiga, or it can be run
  13.     from DCRON or manually to originate connections.
  14.  
  15.     Some options to UUCico are now outdated and should not be
  16.     used.  Specifically, earlier distributions did not have a
  17.     GETTY and UUCICO had to deal with waiting for connections
  18.     itself.
  19.  
  20.     Either way, the final result is a connection between your
  21.     machine and some remote machine.  UUCICO will retrieve any
  22.     queued work on the remote machine and send any queued work on
  23.     your machine.  These work files are located in UUCP:SPOOL.
  24.  
  25.     The term 'work' refers to items queued by other programs,
  26.     such as PNEWS and MAIL.  These programs create files in
  27.     UUCP:SPOOL that inform UUCICO what to do with them and where
  28.     to send them to.  On the flip side, when UUCICO receives a
  29.     work file it will write it to UUCP:SPOOL then run UUXQT.
  30.  
  31.     UUXQT scans received files and determines how to break them
  32.     up (for example, append them to the appropriate mail box or
  33.     news directory).  The control files in UUCP:SPOOL contain a
  34.     line indicating the appropriate program required to unpack
  35.     the files.  UUXQT reads this line and runs the proper
  36.     unpacker (RMAIL, RNEWS, or CUNBATCH).
  37.  
  38.                     LOCKING
  39.  
  40.     UUCico locks the serial port in the same manner Getty does, but
  41.     doing the equivalent of the UUCP:C/LOCKSERIAL command before
  42.     openning it.  Thus, uucico's will never bump into each other
  43.     on the port.  Any terminal program you run should lock the
  44.     serial port as well.  This is done by running the terminal
  45.     program via UUCP:C/LOCKSERIAL with the appropriate arguments,
  46.     see the manual pages for GETTY and LOCKSERIAL for more information
  47.  
  48.  
  49. GENERAL OPTIONS
  50.  
  51.     (*)'d Options are supplied automatically on Getty Initiated
  52.     connections
  53.  
  54.    (*)  -D devicename       Default is serial.device (space is required)
  55.    (*)  -U unitnumber       Default is 0 (space is optional)
  56.     -xn            Set log level for us and for remote system
  57.     -Xn            Set log level but do not tell remote system
  58.                 about it.
  59.  
  60.     -xx            Debug handshake to stdout (but not once connection
  61.                 is established).  Useful for debugging L.Sys
  62.                 send-expect stuff.
  63.  
  64.     -h0            Ignore Carrier Detect.
  65.  
  66.     -b            BATCH news before anything else
  67.  
  68.     -7            Set 7WIRE mode for serial connections
  69.                 (i.e. hardware handshaking)
  70.  
  71.     -p #
  72.  
  73.     -pri            UUCico ups its priority by 1 during transfer,
  74.                 then downs it by 1 to run uuxqt. (i.e. +1
  75.                 during transer, -1 for uuxqt)
  76.  
  77.     -d0            IGNORE DTR switch forces UUCico to use the
  78.                 +++ sequence to disconnect instead of dropping
  79.                 DTR.   This is a workaround for a possible
  80.                 bug in the serial device for those who
  81.                 experience crashes when UUCico tries to
  82.                 disconnect.
  83.  
  84.     -n[size]        Set protocol window size.  If size is not
  85.                 specified, a window size of 1 is forced.  The
  86.                 default (-n option not specified) it a
  87.                 window size of 7.
  88.  
  89.                 Sometimes it is necessary to reduce the window
  90.                 size to 3 or 4 when connecting to heavily
  91.                 loaded UNIX systems.
  92.  
  93.     -t<timeout>        Set GIO protocol timeout before packet retry.
  94.                 Default is 5.  In many cases this can cause
  95.                 long no-activity delays due to small glitches
  96.                 when, in fact, the receiving host is not loaded
  97.                 down.  Setting the timeout to 1 generally fixes
  98.                 this.
  99.  
  100.     -T<timeout>        Set timeout for send-expect strings, default
  101.                 is 15 seconds.
  102.  
  103.     -P<segsize>        Set segment size, in powers of two where a
  104.                 segment size of 2 == 64 bytes.  The maximum
  105.                 segment size is 9 (2048 bytes??).
  106.  
  107.                 This option should be used only by EXPERIENCED
  108.                 UUCP users.  Larger is not necessarily better
  109.                 since all packets are fixed length.
  110.  
  111. GETTY INITIATED OPTIONS
  112.  
  113.    (*)  -Getty              Tells UUCICO that it was started from a Getty.
  114.  
  115. MANUAL POLL OPTIONS
  116.  
  117.     -ssystem        Poll (call-up) the specified system
  118.  
  119.     -Ssystem        Same as -s but ignore time restrictions
  120.                 (note, currently time restrictions are
  121.                  ignored anyway)
  122.  
  123.     -r1            Call all systems we have pending work for
  124.  
  125.     -r1 -ssystem        Call this specific system if we have pending
  126.                 work.
  127.  
  128.     -o            Tells UUCICO to not search for a CONNECT
  129.                 message when carrier is detected (hardwired
  130.                 configuration)
  131.  
  132. OBSOLETE OPTIONS    (WAIT MODE OPTIONS)  DO NOT USE IF YOU CAN HELP IT
  133.  
  134.     -w            Tells UUCICO to wait for one or more
  135.                 connections (depending on -e) AFTER having
  136.                 previously polled one or more systems
  137.                 (-r, -s, -S).
  138.  
  139.  
  140.     -e            Tells UUCICO to loop forever waiting for
  141.                 connections.
  142.  
  143.     <nooptions>        If UUCICO is run without either -Getty,
  144.                 -s, or -r, it will wait for a single
  145.                 connection.
  146.  
  147. TIMELOG FORMAT
  148.     UUcico automatically appends an entry to UUSPOOL:TimeLog in
  149.     the following format:
  150.  
  151.     dd-mmm-yy mm:ss mm:ss in=nnnnn out=nnnnn <system_name>
  152.  
  153.     The date, then two on-line times.  The first is the connect time
  154.     from carrier detect, the second is connect time from send-expect
  155.     success.  Use whichever one is appropriate for bill calculations.
  156.     Following that is the number of data bytes received (total of
  157.     received file sizes) and the number of data bytes sent (total of
  158.     transmitted file sizes).  These numbers do not reflect additional
  159.     overhead used by the G protocol (messages, acks, packet overhead,
  160.     or retries).
  161.  
  162.  
  163.  
  164. EXAMPLE
  165.                 -----
  166.  
  167.     ; Place a line similar to this in your startup-sequence!
  168.     ; See GETTY manual
  169.  
  170.     resident uucp:C/Getty
  171.     run <nil: >nil: Getty -A -B19200 -Mm
  172.  
  173.                 -----
  174.  
  175.     ; Manually poll system 'foo'
  176.     UUCico -sfoo
  177.  
  178.                 -----
  179.  
  180.     ; From DCRON  (DCRON ENTRY)
  181. 40    1    *    *    *    uucp:c/uucico -r1
  182.  
  183.  
  184.  
  185. FILES/REQUIRES
  186.     UUCP:
  187.     UUCP:c/*
  188.     UUCP:lib/*
  189.     UUCP:mail/
  190.     UUCP:spool/
  191.     UUCP:spool/LOGFILE
  192.  
  193. REFERENCES
  194.     man/L.Sys
  195.     man/Getty
  196.     man/DCron
  197.     man/Assigns
  198.  
  199.  
  200.  
  201.  
  202.