home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / packhack.zip / PACKHACK.TXT < prev   
Text File  |  1994-08-23  |  5KB  |  147 lines
  1.  
  2. PACKHACK.TXT   Doc file for PACKHACK Version 6c  August '94
  3.  
  4. PACKHACK  is a program used to analyze packet radio activity
  5. taking place on a specific radio channel.  It identifies and
  6. counts packets from each station, and categorizes the packets
  7. into frame types.  Generally, only "I" frames contain user
  8. information.  The "RR" frames are Acks, the "UA" frames are
  9. Acks for disconnect requests, the "D" frames are disconnect
  10. requests, and the REJ frames are Reject, send again requests.
  11. See a TNC-II manual for a complete discussion on frame types.
  12.  
  13. With PACKHACK you can see a list of stations on the air, and
  14. the number and type of each packet sent by each station.
  15. You can see which node is most active and if most of it's
  16. activity is retries or real information.  It is interesting
  17. to compare the ratio of I to RR frames for different stations,
  18. and hopefully it will be useful too.
  19.  
  20. How to use PackHack:
  21.  
  22. To use PACKHACK, you first need a text file that contains
  23. the monitored packets of the radio channel to be analyzed.
  24.  
  25. This program was developed for TNC-II Clones (specifically
  26. the MFJ-1270/B TNC).  Set the TNC commands as follows:
  27.  
  28.    MON ON    MCOM ON    MCON ON     MALL ON    MRPT ON
  29.  
  30. It is important that the "<RR R R5>" or "<I C S7 R2>" data
  31. be seen in each packet.  Also if MSTAMP is set ON,the date
  32. and time of the first buffer file packet will be shown in
  33. the PackHack report.
  34.  
  35. Set the TNC as above, open a capture buffer, and monitor
  36. packets for some period of time (10 minutes? 3 hours?).
  37. Then save the buffer to disk.
  38.  
  39. After saving the buffer to file, you are ready to run PACKHACK.
  40.  
  41. Enter  PACKHACK  [filename]  where filename is the name of the
  42. file saved from capture buffer.  If the specified file can
  43. not be found, and error message is displayed, and the program
  44. exits.
  45.  
  46. After finding the capture buffer file, PACKHACK will say:
  47.  
  48.  
  49.   Analyzing file: [filename]    Length: [size]  Bytes
  50.  
  51.   working, please wait.....
  52.  
  53.    (on a 386DX, a 100k file will take about seven seconds to
  54.     run.  On a slow floppy drive it may take a minute or so.
  55.     Please be patient.)
  56.  
  57.  
  58. Next a screen appears that gives a choice of where to send the
  59. report.
  60.  
  61.  
  62.   PackHack Chronicle for  [filename]
  63.  
  64.   Send report to...
  65.  
  66.         1  Screen
  67.  
  68.         2  Printer
  69.  
  70.         3  File named [filename].rpt
  71.  
  72.  
  73. If you are running PackHack for the first time, enter  '1', send
  74. report to screen.
  75.  
  76. Display after entering '1':
  77.  
  78.  
  79.   The PACKHACK Chronicle for file: [filename]   [size] bytes
  80.  
  81.   First Time/Date stamp:           [time and date stamp, 1st packet]
  82.  
  83.      Originating
  84.          Station    Total   Packet Frame type:
  85.        Call Sign  Packets   I       RR      UA      D     REJ
  86.  
  87.             etc.     etc.   etc.    etc.    etc.   etc.   etc.
  88.  
  89.     (you get a list of call signs, and the total number of frame types
  90.      from each call sign.)
  91.  
  92.  
  93. Choice  '2' sends the report to printer.  If there is a printer error,
  94. PackHack prompts user to try again or exit.
  95.  
  96. Choice  '3' sends the report to a file in the current directory.  The
  97. report file has the same name as the original capture buffer file,
  98. but with the extension  '.RPT' added.  For example, if the capture
  99. buffer file used with PackHack is named 'APR29145' then the report
  100. file will be named 'APR29145.RPT'.
  101.  
  102. The PackHack Chronicle report format is the same for reports sent to
  103. the screen, printer, or file.
  104.  
  105.  
  106. Things that PackHack does to your computer:
  107.  
  108. PackHack makes one or two new files in the current directory.
  109. The file named BUFFER is made every time PackHack is run, and
  110. is used as a buffer for data crunching.  BUFFER is overwritten
  111. every time PackHack runs, so it's OK to just pretend it doesn't
  112. exist, or you can delete it to save disk space.
  113.  
  114. The other file named [filename].RPT is created when choice '3'
  115. is made, 'Send report to file'.  This file only appears when
  116. choice '3' is made.
  117.  
  118. PackHack runs best (fastest) on a fixed drive.
  119.  
  120.  
  121. Special Request:
  122.  
  123. PackHack was written for use with TNC-II clones, specifically the
  124. MFJ-1270B.  Other TNC types present the frame data in different
  125. ways.  To make PackHack work with other types of TNC's, I need
  126. capture buffer files from AEA, Kantronics, and other  TNC's.  I
  127. solicit your files.  If you can supply me with capture buffer
  128. files using Any TNC, I would happily pay the postage and disk
  129. cost.  Please advise me via Compuserve, the packet network, or
  130. mail, your TNC type and what files you have available.  I will
  131. then send a disk, and stamped mailer, and make sure that you
  132. receive the new PackHack versions.
  133.  
  134. This program was written in Borland Pascal.  If you would like
  135. the source code, or a version that runs in protected mode, contact
  136. me.  I hope that you find it useful.  Feedback please.
  137.  
  138. Distribution of this program is encouraged.
  139.  
  140. Bill Bradford   K7EA
  141. c/o  Bradford
  142. P.O. Box 701188
  143. Salt Lake City, UT 84170-1188
  144.  
  145. Compuserve 73007,1523   Packet K7EA@WB7ULH.#SLC.USA.NOAM
  146.       or   wbradford@delphi.com
  147.