home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 2 / crawlyvol2.bin / apps / bbs / smp_awk / readme < prev   
Text File  |  1995-01-01  |  3KB  |  89 lines
  1.    Semper log statistics using an awk
  2.    ==================================
  3.    1995 - Borek Lupomesky
  4.  
  5.  
  6.  
  7.    This archive contains a set of awk scripts for processing logfiles
  8. produced by Semper FidoNet mailer by Jan Kriesten. Awk is a Unix utility
  9. that can perform arbitrary pattern matching and replacing on a stream of
  10. data. It is especially suited for creating log reports. After seeing few log
  11. reporters (and writing two of them ;-) I decided to do it in the most
  12. obvious and convenient way: using awk. So here it is.
  13.  
  14.  
  15.  
  16.    Usage
  17.    -----
  18.    To use awk you need some good command line shell. GNU bash is a good
  19. choice, but there are many others. Here is general usage of the awk utility:
  20.  
  21.    awk -f {program.awk} {input_file} >{output_file}
  22.  
  23.    It is possible to pass arguments to an awk program:
  24.  
  25.    awk -v {VARIABLE}={value} -f {program.awk} {input_file} >{output_file}
  26.  
  27.    If it's not clear, don't worry, there are examples of usage below.
  28.  
  29.  
  30.  
  31.    logstat.awk
  32.    -----------
  33.    This is most elaborate script of the three. It creates report from Semper's
  34. log. This log consists from three parts. The first one contains listing of all
  35. calls, both incoming and outgoing along with their date/time, connection
  36. speed, FTN address, number of sent/received files, amount of sent/received
  37. data, duration of a connection and a cost.
  38.    The second part is lists basically the same things, but on a per address
  39. basis. All values are sum for given node/point address.
  40.    The third part is a brief summary. It sums number of calls, files etc.
  41.    Normally, this script will process all calls from all nodes. But there's
  42. an useful option for restricting it only to addresses from single domain.
  43. This is done by passing variable DOMAIN with domain name in it.
  44.    Be careful when using this log on non-EMSI sessions - I didn't test it,
  45. so I can't say if it will work. Also note, that you need Semper that writes
  46. consistent 'Rcvd' and 'Sent' lines in log (versions 0.74 and higher do).
  47. Loglevels '*' and '/' have to be enabled!
  48.  
  49.    Example of usage (suppose logfile 'system.log' and output file
  50. 'stats.txt'):
  51.  
  52.    awk -f logstat.awk system.log >stats.txt
  53.    awk -v DOMAIN=nest.ftn -f logstat.awk system.log >stats.txt
  54.  
  55.  
  56.  
  57.    nicelog.awk
  58.    -----------
  59.    This script 'nicens' logfile little bit. It removes uneccessary empty
  60. lines and adds newlines between blocks of entries of different programs.
  61.  
  62.  
  63.  
  64.    cutlog.awk
  65.    ----------
  66.    This script cuts down a logfile a little bit. It does two things: Removes
  67. 'EMSI extra field' entries (frequent with D'Bridge and T-Mail mailers) and
  68. removes extra 'Ringing' messages and replaces them with 'Ringing (Nx)',
  69. where N is number of subsequent rings. If your boss is often not answering
  70. phone (like mine), this can make quite some difference. (On my December '94
  71. log it made about 200KB!)
  72.  
  73.  
  74.  
  75.    Awk utility
  76.    -----------
  77.    There's good port of GNU awk for Atari ST available. It can be found on
  78. many good Atari BBS's (to mention few: Eregion MailStorage, Dao Lin H'ay,
  79. Traveller Box) and most ftp sites with Atari software.
  80.  
  81.  
  82.  
  83.    Author
  84.    ------
  85.    Borek Lupomesky 
  86.    FidoNet: 2:423/71
  87.    NeST:    90:1200/1
  88.    I~net:   borek@leo1.zlin.vutbr.cz
  89.