Title:			STUBSHACK
Author:			Julian Smith
Version:		1.10
Title From:		Documentation
Author From:		Documentation
Version From:		Documentation
Supplier:		Julian Smith (julians@cogsci.ed.ac.uk)
Date:			12/01/95
Keywords:		Systems software ; Memory management software ; Debuggers
Shareware:		No
Machine:		Archimedes
Operating system:	RISCOS
Memory requirements:	
Peripherals needed:	
Other s/ware needed:	
Directory:		micros/arch/riscos/c080
Date mounted/updated:	16/01/95
File names:		stubshack.arc
Unarchived files:	106
Unarchived size:	203 kbytes
Omissions:		
See also:		

-------------------------------------------------------------------------------

Acquiring the package:

Download the archive file(s) and extract using SparkPlug 2
(see the "tools_help" file in micros/arch/riscos/tools for further info).


Description:

There are two programs in this package: StubsHack and HeapGraph.

StubsHack uses an idea of Martin Ebourne's to enable you very
easily to redirect all calls to the ANSI memory allocation
functions (malloc, realloc, calloc, free) in the Shared C Library
to your own functions.

HeapGraph uses StubsHack to provide a very simple way of making
your program send information on every block of memory allocated /
freed to a file in pipe:$.C_Debug. This is scanned by the included
application !HeapDisp, which displays your program's heap graphically
in real time, and also displays diagnostic text.

The important point is that this happens at *runtime*, so even if you
link your program with a library which was compiled years ago, all
malloc calls within the library will be redirected.