apurify_v1.5

Short:        Enforcer-like tool without MMU. V1.5
Author:       devulder@info.unicaen.fr	(Samuel DEVULDER)
Uploader:     devulder info unicaen fr	(Samuel DEVULDER)
Type:         dev/debug
Architecture: m68k-amigaos

				APurify
				-------

A program that detects illegal memory access of your programs. It needs asm
sourcefile (or reverse-engineering generated sourcefile) and insert code to
check memory access.

It consists  of  a  source  parser  (bin/M?T-APurify),  a  linking  library
(lib/#?APur-#?.#?) and a frontend (bin/APF) to  call  the  parser  and  the
linker automatically.

This archive contains files for APurify v1.5. There are different  versions
of APurify for GCC, PDC, DICE and SAS/C. To install it, you  just  have  to
execute the APurify-Install script. It will install everything for you	and
will even generate a remover script if you want to remove APurify from your
system. If you want to install it by hand, please read the documentation.

For the documentation, consult doc/MIT-APurify.doc for the GCC compiler and
doc/MOT-APurify.doc for other compilers. If you want to use  the  frontend,
read doc/APF.doc. I strongly encourage you to use it. It is simpler to	use
it than making everything by hand.

The source is available from author and is not included in that archive (it
requires around 5.5Mb on my harddisk when compiled :-).

New in this release (see doc/History):

- V1.5:
	+ added some User Interface with the help of some ARexx scripts to
	  interface APurify with GoldEd, Emacs and c:Ed (not very nice the
	  last one, but still better than nothing :)
	+ added installer script.
	+ added code to detect accesses to freed memory.
	+ replace "$%08X" by "0x%08X". Can be modified with ENV:APDOLL.
	+ made the lower bound of the stack block  decrease  automatically.
	  This allow detection of memory accesses below the stack pointer.
	+ added   code	to  handle  $XXXXXXXX(PC)  for  SAS/C  because  the
	  instrumentation of the code modifies the offsets that  are  hard-
	  coded in SAS/C asm file.  (may  be  needed  for  other  compilers
	  too... we'll see).
	+ fixed problem for SAS/C when quotes appear in dc.b '....'.
	+ new test.c. Modified M(I|O)T-Apurify.doc for test.c
	+ made libAPur-gcc.a use dos/System()  instead  of  ixemul/system()
	  so that gcc-compiled programs can use AREXX scripts.
	+ added NOSTRINGMERGE for SAS/C.
	+ added support for ixemul _ctype_ array used in ctype.h: isXXXX().

Happy debugging !

		Sam.

*** Contents ***

LhA Evaluation V1.32 - Copyright (c) 1991,92 Stefan Boberg.
All rights reserved. Not for commercial use.

Listing of archive 'distrib/apurify_v1.5.lha':
Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
     904     349 61.3% 28-Nov-96 23:35:40  APurify.info
   18890    4304 77.2% 28-Nov-96 23:35:34  APurify/APurify-Install
     521     296 43.1% 28-Nov-96 23:35:34  APurify/APurify-Install.info
    8284    2442 70.5% 28-Nov-96 23:35:24  APurify/AREXX/APed.rx
    8023    2485 69.0% 28-Nov-96 23:35:24  APurify/AREXX/APemacs.elx
    5879    2078 64.6% 28-Nov-96 23:35:24  APurify/AREXX/APgolded.ged
     904     348 61.5% 28-Nov-96 23:35:42  APurify/Bin.info
   23752   12323 48.1% 28-Nov-96 23:35:22  APurify/Bin/APF
   25192   13902 44.8% 28-Nov-96 23:35:22  APurify/Bin/MIT-APurify
   31536   17099 45.7% 28-Nov-96 23:35:22  APurify/Bin/MOT-APurify
     904     355 60.7% 28-Nov-96 23:35:42  APurify/Doc.info
    5413    2120 60.8% 28-Nov-96 23:35:30  APurify/Doc/APF.doc
    1011     462 54.3% 28-Nov-96 23:35:28  APurify/Doc/APF.doc.info
    2428    1243 48.8% 28-Nov-96 23:35:30  APurify/Doc/APurify_v1.5.readme
    1011     464 54.1% 28-Nov-96 23:35:28  APurify/Doc/APurify_v1.5.readme.info
    4256    2186 48.6% 28-Nov-96 23:35:28  APurify/Doc/History
    1011     461 54.4% 28-Nov-96 23:35:28  APurify/Doc/History.info
   30506   12295 59.6% 28-Nov-96 23:35:30  APurify/Doc/MIT-APurify.doc
    1011     463 54.2% 28-Nov-96 23:35:28  APurify/Doc/MIT-Apurify.doc.info
   34704   13767 60.3% 28-Nov-96 23:35:30  APurify/Doc/MOT-APurify.doc
    1011     459 54.5% 28-Nov-96 23:35:28  APurify/Doc/MOT-Apurify.doc.info
    5005    2288 54.2% 28-Nov-96 23:35:30  APurify/Doc/Scripts.doc
    1011     462 54.3% 28-Nov-96 23:35:30  APurify/Doc/Scripts.doc.info
     904     352 61.0% 28-Nov-96 23:35:42  APurify/Lib.info
   17944    8631 51.9% 28-Nov-96 23:35:26  APurify/Lib/APur-dcc.lib
     176      97 44.8% 28-Nov-96 23:35:26  APurify/Lib/APur-pdc.dir
   22880    9770 57.2% 28-Nov-96 23:35:26  APurify/Lib/APur-pdc.lib
   56432   27004 52.1% 28-Nov-96 23:35:28  APurify/Lib/APur-sas.lib
   85926   36543 57.4% 28-Nov-96 23:35:26  APurify/Lib/libAPur-gcc.a
    2428    1243 48.8% 28-Nov-96 23:35:32  APurify/README
    1011     462 54.3% 28-Nov-96 23:35:30  APurify/README.info
    4970    1532 69.1% 28-Nov-96 23:35:34  APurify/Test/test.c
   32152   17128 46.7% 28-Nov-96 23:35:36  APurify/Test/test.dcc
  284524  115222 59.5% 28-Nov-96 23:35:38  APurify/Test/test.gcc
   47856   20540 57.0% 28-Nov-96 23:35:36  APurify/Test/test.pdc
   76912   38737 49.6% 28-Nov-96 23:35:40  APurify/Test/test.sas
-------- ------- ----- --------- --------
  847282  369912 56.3% 28-Nov-96 23:36:44   36 files

Operation successful.