home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga 13 / MA_Cover_13.bin / source / c / stefanb_src / old_projects / umsuucp / docs / uucico116a.doc < prev   
Encoding:
Text File  |  1992-11-01  |  8.6 KB  |  248 lines
  1. -------------- uucico116a.doc ----------------------------------------------
  2.  
  3.           ALPHA VERSION --- USE AT YOUR OWN RISK        uucico116a
  4.         ==========================================
  5.  
  6. * This is uucico116a with some enhancements (known from uucico115c)
  7. * Use this uucico116a only together with getty (V1.16)
  8.  
  9. CHANGES (short version):
  10.  
  11. - 2.0 version string
  12. - security enhancements
  13. - xferstat system
  14. - Protocol Gg detection
  15.  
  16. BUG REPORTS:
  17.  
  18. email:  uucico116a@swb.de
  19.  
  20. -------------- uucico115c.doc ----------------------------------------------
  21.  
  22. This is uucico (DUUCP 1.15) with the following changes:
  23.  
  24. 01-Nov-91 charly        uucico115c
  25.  
  26. files: uucico/sysdep.c          (bug)
  27.  
  28. - Bug in Byte timeout
  29.  
  30.   While inserting the Xferstat counter, i missed two brackets.
  31.   In some situations, the byte timeout failed and could
  32.   result in an hanging uucico - sorry for this bug.
  33.  
  34. - Named Ports for serial & timer IO to unnamed
  35.  
  36.   Because there is no reason - exception debugging - the
  37.   Ports of TimerIO and SerialIO are now unnamed.
  38.   If you need them, toggle the define in sysdep.c !
  39.  
  40. 28-oct-91 charly        uucico115b
  41.  
  42. files: uucico/uucico.c          (changed)
  43.        uucico/sysdep.c          (changed)
  44.        uucico/modem.c           (changed)
  45.        uucico/gio.c             (changed)
  46.        lib/securityuser.c       (new)
  47.  
  48. - Enhanced security support for uucp file transfers
  49.  
  50.   Uucico optionally works with a "UUlib:Security.<hostname>" file.
  51.   You can allow a good friend -OR- the public to access additional
  52.   directories on your machine. The format is the same as the old
  53.   security file. Sorry - we're working on a better security solution.
  54.   This additional security file amends the default "UUlib:Security"
  55.   file, so that if Security allows only read access to a directory
  56.   but Security.foobar allows read & write to it, system foobar is
  57.   able to write to it.
  58.  
  59. - XferStat logfile ( same name - other format ! )
  60.  
  61.   This function logs most of the information you need to calculate
  62.   any statistical information of your links. It counts bytes, files,
  63.   time and direction for any session. You see the used proto, windows
  64.   and packetsize of each link.
  65.   It calculates brutto/netto CPS for the link and percent overhead.
  66.   Those results are written to UUSpool:XferStat.
  67.   The Timelog function is untouched - but a bit redundant now. ;-)
  68.  
  69. - Hangup
  70.  
  71.   In some situations, after gturnoff(), there was a hangup problem.
  72.   This is hopefully FIXED by calling hangup() generally inside the
  73.   top_level() function directly after gturnoff().
  74.   In modem.c you'll see an additional "\r" before the "+++" sequence
  75.   in the reset_modem() function.
  76.  
  77. - Protocol detection 'g' and 'G'
  78.  
  79.   The "used protocol" msg now should response with 'g' or 'G'.
  80.   Uucico offers "Gg" and detects the first in common.
  81.  
  82. - One uucico per device/unit
  83.  
  84.   UUcico locks by a public msgport for device and unit.
  85.  
  86. - version string support for 2.0 version command
  87.  
  88.   Under 2.0 you can use version to find uucico version string.
  89.   Ident is untouched.
  90.  
  91. - MAKEUP: Logfile
  92.  
  93.   For some abort conditions, uucico writes better LOG information.
  94.   This provides a high-level debugging for the possible errors
  95.   between login to turnon() and the failed conditions from the
  96.   top_level() handler.
  97.  
  98.         BAD LOGIN/PASSWORD      .. when the login/password fails
  99.         WRONG MACHINE NAME      .. when getname() fails
  100.         NO COMMON PROTOCOL      .. when getproto() fails
  101.         STARTUP FAILED          .. when turnon() fails
  102.         *** blabla ***          .. when top_level() fails internal.
  103.         CONVERSATION FAILED     .. when top_level() fails internal.
  104.  
  105.   FYI:
  106.  
  107.   We used this kind of uucico for some month now - also we send in
  108.   the sources for this before 1.15 was out in the hope "it's in there".
  109.  
  110.   XFERSTAT Format
  111.   ---------------
  112.   XferStat, by default, writes two lines for each session.
  113.   The format fits on a normal full sized window and is human readable.
  114.  
  115.   The most frequently asked question: What is my CPS rate?
  116.  
  117.   Now some explanation of a log record ( 2 lines )
  118.  
  119. d hostname dd-mm-yy hh:mm:ss > dd-mm-yy hh:mm:ss hh:mm:ss BR_CPS NE_CPS ppp%
  120. | p option bytes_i  bytes_o    fbytes_i fbytes_o fcnt_i fcnt_o
  121.  
  122.   where:
  123.         d  direction of the call
  124.            < outgoing
  125.            > incoming
  126.  
  127.         hostname        who calls/ whom we call
  128.  
  129.         dd-mm-yy        date of start/stop session
  130.         hh:mm:ss        time of start/stop session
  131.                         or total time of sessions
  132.         BR_CPS          brutto cps calculation
  133.         NE_CPS          netto cps calculation
  134.         ppp%            netto/brutto in percent
  135.         bytes_i         total number of bytes (including protocol 
  136.         bytes_o         overhead) in/out
  137.         fbytes_i
  138.         fbytes_o        total number of file bytes in/out
  139.         fcnt_i
  140.         fcnt_o          total number of files in/out
  141.  
  142.         p option        protocol key (mostly g|G)
  143.  
  144.         for g|G option format is n mmmm with
  145.  
  146.                 n ... number of sliding windows
  147.                 m ... number of bytes/packets
  148.  
  149.   A "real world" example:
  150.   -----------------------
  151.   from uuspool:xferstat
  152.              
  153. < horga    23-10-91 07:38:06 > 23-10-91 07:51:04 (00:12:58)  1401   1169  83%
  154. | g 3   64  1000935    89605 #   909846        0 #   26    0
  155.   
  156.    My system called host 'horga' on the 23. October at 7:38am.
  157.    The used protocol was 'g' with 3 windows and 64 byte packets.
  158.    The session terminated at 7:51am (logtime 00:12:58).
  159.    I recieved 1000935 total bytes or 909846 data characters in
  160.    26 files. I did send 89605 total bytes for protocol/ 0 bytes of data.
  161.   
  162.    The calculation returned 1401 bytes/sec OR 1169 bytes/sec
  163.    of usable data. The protocol overhead amounted to 17% of the total
  164.    cps rate.
  165.  
  166.   Both sides here used a TB2500 with PEP and spoofing enabled.
  167.  
  168.   !!! (AREXX) developers !!!
  169.   -----------------------------------
  170.   If you write anything based on xferstat's output,
  171.   NEVER assume a fix number of lines/log !
  172.  
  173.   A log-record allways begins with a direction character and ends
  174.   one byte before the next direction character or EOF.
  175.   Valid direction characters are '<','>' or '=' as the first character
  176.   on a line.
  177.   
  178.   After '<' or '>' the two lines above are the valid scan format.
  179.   The '=' value is reserved.
  180.   
  181.   How to handle other characters in the first column of a line:
  182.  
  183.   - Interpret '|' as a continue line of the current running format.
  184.     For '>' '<' this is the 'p option ... format'
  185.  
  186.   - Interpret '#' followed by a valid isspace() char as a comment line.
  187.  
  188.   - Treat '#anything' as a comment in general until you know what follows.
  189.  
  190.   - For any other leading characters ignore the whole line.
  191.  
  192.   Future Xferstat implementations log much more informations like modem
  193.   extended result codes, packet i/o, retrans i/o and dump internal
  194.   modem statistics (e.x. TBxxxx) on request.
  195.  
  196.  
  197.   -> DONNOT IGNORE THIS NOTE, ELSE YOU NEED MANY UPDATES <-
  198.  
  199.   Real-world
  200.   ----------
  201.   Normally ( g-proto, 7 windows, 64 byte packets ) you'll see a
  202.   protocol overhead of approx. 20%. While using larger packets (the -Pn
  203.   option of uucico) the protocol overhead gets smaller and smaller. If
  204.   you're transfering mostly large files (like news) a V32/V42.bis link
  205.   with 7 windows and 512 byte packets (-P5) can achive as little as 4%
  206.   overhead.
  207.  
  208.   PLEASE NOTE:
  209.   Larger packets are only usable if both sides agree to this and often
  210.   other uucico implementations are broken and will not work correctly if
  211.   asked for a larger packet size. To use larger packets with two AmigaUUCP
  212.   sites, the caller has to supply the -Pn parameter with his uucico command
  213.   line and the receiver needs to have a "uucico -Pn" statement within it's
  214.   UUlib:passwd file, where "n" should be at least as large as what the
  215.   caller might request.
  216.  
  217.   Some results in normal mode:
  218.  
  219.   Modem         Mode             netto cps
  220.  
  221.   V32bis    unknown               ????
  222.   TB2500    PEP && spoofing       1090
  223.   USR DS    V32 V42bis             820
  224.   2400      none MNP               200
  225.  
  226. The executable uucico115c is ready to use, just copy it to UUCP:c/uucico.
  227.  
  228. To recompile you need to modify the original distribution as described
  229. in the .diff files. You need to copy the securityuser.c function to
  230. the lib/ directory and add an entry in the Dmakefile for the new file.
  231. In the uucico Dmakefile you also need to add xferstat.c
  232.  
  233. * WARNING for 1.13 *
  234.  
  235. If you DON'T use 1.15 in general and you just want the enhancements of the
  236. new uucico, make sure you add a UULIB:config line "MUNGECASE N" or to use
  237. the uuxqt from the 1.15 distribution.
  238.  
  239. have fun.
  240.  
  241. charly
  242.  
  243. --
  244.   // <charly> ala Andrew Kopp SMAIL : Zu den Tannen 13,DW5810 Witten,Germany
  245. \X/                           DOMAIN: charly@brewak.swb.de
  246. SWB  -The Software Brewery-   USBANG: {uunet}!cbmvax!cbmger!brewas!charly
  247.  
  248.