home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 570.lha / CFX_v2.3b / CFX.DOC.pp / CFX.DOC
Encoding:
Text File  |  1991-11-07  |  9.0 KB  |  273 lines
  1.  
  2.  
  3.     THIS PROGRAM WILL ONLY RUN WITH THE ARP LIBRARY V33+ IN YOUR LIBS:
  4.     DIRECTORY.
  5.  
  6.  
  7.     *****************************************************************
  8.     *                                *
  9.     *        CFX 2.0h - Crunched file examiner        *
  10.     *                                *
  11.     *        by BOB RYE and MARCUS MROCZKOWSKI        *
  12.     *                                *
  13.     *        Official Release: Tuesday/10/1990        *
  14.     *                                *
  15.     *****************************************************************
  16.  
  17.  
  18.     THIS PROGRAM IS PUBLIC DOMAIN AND MAY BE FREELY REDISTRIBUTED SO
  19.     LONG AS THIS DOCUMENT ACCOMPANIES THE EXECUTABLE/BINARY
  20.     FILE 'CFX' (ALONG WITH THE UPDATE.DOC AND CFX.INFO FILES),
  21.     AND THAT NO PROFIT IS MADE IN THE PROCESS. PEOPLE COPYING THE
  22.     PROGRAM MAY CHARGE A REASONABLE FEE SO AS TO COVER COSTS OF THE
  23.     COPYING AND/OR COSTS OF FREIGHT AND/OR MEDIA.
  24.  
  25.  
  26. DISCLAIMER.
  27. -----------
  28.     THIS PROGRAM HAS BEEN TESTED OVER A PERIOD OF 2 YEARS
  29.     (FROM BETA VERSION TO THIS VERSION) AND I HAVE FOUND IT, AS USED IN
  30.     ITS PROPER CAPACITY, TO BE BUGLESS. THIS IS NOT TO SAY THAT THE
  31.     PROGRAM DOESN'T HAVE BUGS, ITS JUST THAT WE HAVEN'T FOUND THEM AS
  32.     YET. IF, HOWEVER, BUGS ARE FOUND TO CAUSE A MENTAL AND/OR PHYSICAL
  33.     STOPPAGE TO YOUR COMPUTING, THEN THAT IS AS THEY SAY IN THE
  34.     CLASSICS, BAD LUCK! WE ACCEPT NO BLAME IN ANY LOSS OR INCONVENIENCE
  35.     FOUND TO ARISE FROM THE USAGE OF THIS PROGRAM.
  36.  
  37.     Filesizes after decompression:
  38.                     CFX     = 5856 bytes.
  39.                     CFX.doc = 9238 bytes.
  40.  
  41.     PLEASE REFER TO UPDATE.DOC FOR NEW FEATURES.
  42. _____________________________________________________________________________
  43.  
  44.                    ENJOY!
  45.  
  46.                             CFX 2.0h    Page I
  47.  
  48.  
  49.  
  50.  
  51.  
  52. Table of contents:
  53. ------------------
  54.  
  55.  
  56.             II .... Overview
  57.  
  58.             III ... Usage
  59.  
  60.             IV .... Cans and Can'ts (Wills and Won'ts)
  61.  
  62.             V ..... Technical Information
  63.  
  64.             VI .... Bug Report Form
  65.  
  66.             VII ... Ideas Report Form
  67.  
  68.                             CFX 2.0h    Page II
  69.  
  70.  
  71.  
  72. Overview:
  73. ---------
  74.     CFX was written to enable the Amiga user to identify certain
  75. characteristics of a given Amiga file. The file, let's call it 'TEST', is
  76. a file that you received from a BBS, but there were no accompanying docs
  77. with it. The file is executable, but you have a feeling that it was
  78. crunched. PowerPacker doesn't know this file's 'crunch' type, so you can't
  79. easily identify the filetype. You could use a debugger/monitor to find what
  80. the filetype is, but the most you'll get out of that is to ascertain that
  81. the file REALLY IS crunched. Well, from my experiences on the Aus. Amiga
  82. Fido Echo, I know that there are a lot of you who don't like receiving
  83. crunched files. This program attempts to let you know if it is crunched,
  84. and most possibly, what it is crunched with. You can then decide what to do
  85. with the mysterious file 'TEST'. Keep it or trash it????
  86.     Unlike many other so-called 'File examiners' on the Amiga PD, CFX
  87. has a very large brainfile from which it can decipher LOTS of the current
  88. Amiga filetypes. It will then report to you what type of cruncher was used
  89. to cruncher the file, or, if it isn't crunched, what type of file 'TEST'
  90. really is. The information that CFX gives is pretty much self-explanatory,
  91. although will describe what the display means.
  92.     When run, CFX will place a simple instruction line on the current
  93. CLI title-bar, and if no filename is passed to CFX, it will pull up the ARP
  94. file-requester. You can then click on the desired filename or change
  95. directories as per ARP file-requester standards. Upon clicking on a
  96. filename, CFX will write to the current CLI these things:
  97.  
  98. FILENAME (max. of 28 chars.)
  99. Whether the file is executable or not.
  100. How many hunks the file contains (if executable.)
  101. The filetype: ie. Imploder Normal or TetraPack etc.....
  102.  
  103.                             CFX 2.0h    Page III
  104.  
  105.  
  106.  
  107. Usage:
  108. ------
  109.     CFX is only executable from the CLI (you can try it at workbench,
  110. but it's not going to work very well!!)
  111.  
  112.     The syntax for running CFX is:
  113.  
  114. 1.....................................CFX [path:]filename {return}
  115.  
  116. 2.....................................CFX {return}
  117.  
  118. 3.....................................CFX @ {return}
  119.  
  120.  
  121. 1/    CFX will then attempt to locate the desired file, following
  122. standard path convetions, and then output information based on that file.
  123. CFX will then quit.
  124.  
  125. 2/    CFX will pull up the ARP file-requester allowing you to make
  126. sequentially multiple choices from the current directory, or via the
  127. right-mouse-button, from any directory you like. 'CANCEL' quits CFX.
  128.     
  129. 3/    CFX will display the contents of its current release brainfile and
  130. then quit.
  131.  
  132.                             CFX 2.0h    Page IV
  133.  
  134.  
  135.  
  136.  
  137.  
  138. Cans and Can'ts (Wills and Won'ts)
  139. ----------------------------------
  140.     CFX CAN NOT and WILL NOT modify any given file in any way. That is
  141. not the desired effect. If public outcry is great enough, I'll think about
  142. writing a decrunching & rebuilding version, but at the moment, CFX just
  143. examines. CFX can detect whether or not the examined file contains one of
  144. the two link-viri that I have stumbled across, and only if they have
  145. attached themselves AFTER the file was crunched. CFX will not attempt to
  146. remove the offending parasite from the file in question. It is up to you to
  147. run a reputable virus/link-virus checker/remover over the infected file.
  148.  
  149.     If CFX defines waht the fieltype is of a certain file, then there
  150. is a better than good chance that it has elicited the correct filetype from
  151. the file. In earlier versions (1.0 -> 1.3) CFX would sometimes get confused
  152. if a particular filetype 'looked' like another filetype. The chance of this
  153. happening has now been GREATLY reduced, almost to the point of not
  154. occurring any more. I know that this will not be the case in the future, as
  155. more people will use CFX, and probably find crunchers or filetypes that it
  156. doesn't know. If anyone has written a cruncher or knows of an alien
  157. cruncher, or an alien filetype, then please get back to me, either through
  158. the Ideas Report Form, Bur Report Form, or on any FIDONET echo board. I
  159. will then attempt to add the alien filetype to CFX's brainfile.
  160.     FOR THE LATEST ON CFX UPDATES, PLEASE REFER TO 'BUGFIX.DOC'.
  161.  
  162.  
  163.                             CFX 2.0h    Page V
  164.  
  165.  
  166.  
  167.  
  168.  
  169. Technical Information.
  170. ----------------------
  171.  
  172.     CFX2.0h requires the ARP library V33+ in your LIBS: directory.
  173.     CFX requires that your current CLI is in 80 column mode.
  174.  
  175.     CFX 2.0h was written in 68000 assembly code, using DEVPAC 2.14.
  176.     The source code was edited with the brilliant TxEd Plus editor.
  177.     It was debugged with METASCOPE and occasionally the excellent
  178.     RESOURCE 4.0.
  179.  
  180.     The source code for CFX is 2200 lines long, and CFX contains approx.
  181.     500 global labels, 200 local labels, and 2 code sections.
  182.  
  183.     CFX has been under development for approx. 2 years, and started
  184.     only as a private program (ie: only for Marcus and myself to use.)
  185.     However, now that people are going cruncher-mad (no DAC, not you!)
  186.     I have decided to release this program as it really examines the
  187.     files you feed to it, unlike the previous poor attempts that people
  188.     are releasing at the moment.
  189.  
  190.     One idea for later inclusion (I hope!) is a recursive full directory
  191.     checker, which will eliminate the need for the multiple clicking in
  192.     the ARP file-requester. It is up to you users if you want updates
  193.     or not.....
  194.  
  195.     Call me on FidoNet, on the Aussie Amiga Echo.
  196. HRFN,
  197.     BOB RYE, 16/10/90
  198.  
  199.  
  200.                             CFX 2.0h    Page VI
  201.  
  202.  
  203.             Mail To:
  204.                 BOB RYE
  205.                 4 COULTER ST., WENDOUREE
  206.                 VICTORIA, AUSTRALIA, 3355
  207.                 or contact me on FidoNet Aus. Amiga echo.
  208.  
  209.  
  210.             BUG REPORT FORM.  CFX 2.0h
  211.  
  212.  
  213. UserName__________________________________________________________________
  214.  
  215. Address___________________________________________________________________
  216.  
  217. __________________________________________________________________________
  218.  
  219. Phone (_______)_______________________________
  220.  
  221. Amiga Model (500, 1000, 2000)___________________
  222.  
  223. Hardware (please specify)_________________________________________________
  224.  
  225. __________________________________________________________________________
  226.  
  227. Bug_______________________________________________________________________
  228.  
  229. __________________________________________________________________________
  230.  
  231. __________________________________________________________________________
  232.  
  233. __________________________________________________________________________
  234.  
  235. __________________________________________________________________________
  236.  
  237.                             CFX 2.0h    Page VII
  238.  
  239.  
  240.             Mail To:
  241.                 BOB RYE
  242.                 4 COULTER ST., WENDOUREE
  243.                 VICTORIA, AUSTRALIA, 3355
  244.                 or contact me on FidoNet Aus. Amiga echo.
  245.  
  246.  
  247.             IDEAS REPORT FORM.  CFX 2.0h
  248.  
  249.  
  250. UserName__________________________________________________________________
  251.  
  252. Address___________________________________________________________________
  253.  
  254. __________________________________________________________________________
  255.  
  256. Phone (_______)_________________________________
  257.  
  258. Amiga Model (500, 1000, 2000)___________________
  259.  
  260. Hardware (please specify)_________________________________________________
  261.  
  262. __________________________________________________________________________
  263.  
  264. Ideas_____________________________________________________________________
  265.  
  266. __________________________________________________________________________
  267.  
  268. __________________________________________________________________________
  269.  
  270. __________________________________________________________________________
  271.  
  272. __________________________________________________________________________
  273.