| 1 |
------------------------------------------------------------------------------- |
| 2 |
|
| 3 |
Debug Malloc Library |
| 4 |
******************** |
| 5 |
|
| 6 |
Version 5.5.2 - May 2007 |
| 7 |
|
| 8 |
The debug memory allocation or "dmalloc" library has been designed as a |
| 9 |
drop in replacement for the system's `malloc', `realloc', `calloc', |
| 10 |
`free' and other memory management routines while providing powerful |
| 11 |
debugging facilities configurable at runtime. These facilities include |
| 12 |
such things as memory-leak tracking, fence-post write detection, |
| 13 |
file/line number reporting, and general logging of statistics. |
| 14 |
|
| 15 |
The library is reasonably portable having been run successfully on at |
| 16 |
least the following operating systems: AIX, DGUX, Free/Net/OpenBSD, |
| 17 |
GNU/Hurd, HPUX, Irix, Linux, Mac OSX, NeXT, OSF/DUX, SCO, Solaris, |
| 18 |
Ultrix, Unixware, MS Windows, and Unicos on a Cray T3E. It also |
| 19 |
provides support for the debugging of threaded programs. *Note Using |
| 20 |
With Threads::. |
| 21 |
|
| 22 |
The package includes the library, configuration scripts, debug |
| 23 |
utility application, test program, and documentation. Online |
| 24 |
documentation as well as the full source is available at URL |
| 25 |
`http://dmalloc.com/'. Details on the library's mailing list are |
| 26 |
available there as well. |
| 27 |
|
| 28 |
Please use the forums at URL `http://dmalloc.com/' to discuss any |
| 29 |
problems or to request features. If you are still having problems, the |
| 30 |
author can be reached via his home page at URL `http://256.com/gray/' |
| 31 |
with questions or feedback. Please include the version number of the |
| 32 |
library that you are using, your machine and operating system types, |
| 33 |
and the value of the DMALLOC_OPTIONS environment variable. |
| 34 |
|
| 35 |
Gray Watson. |
| 36 |
|
| 37 |
------------------------------------------------------------------------------- |
| 38 |
|
| 39 |
See the INSTALL file for building, installation, and quick-start notes. |
| 40 |
|
| 41 |
------------------------------------------------------------------------------- |
| 42 |
|
| 43 |
DOCUMENTATION: |
| 44 |
|
| 45 |
Examine the dmalloc.html file which contains the user-documentation |
| 46 |
for the dmalloc subsystem. There also is an dmalloc.info file which |
| 47 |
can be installed in the emacs info directory and read with emacs/info |
| 48 |
or the info program available from the texinfo package at GNU archive |
| 49 |
sites. It is also suitable for reading as text. The source of all |
| 50 |
documation is the dmalloc.texi texinfo file which also can generate |
| 51 |
postscript or TeX hardcopy output with the help of the texinfo.tex |
| 52 |
file. You can download the full documentation package or read it |
| 53 |
online from the repository. |
| 54 |
|
| 55 |
http://dmalloc.com/ |
| 56 |
|
| 57 |
------------------------------------------------------------------------------- |
| 58 |
|
| 59 |
ARGV LIBRARY: |
| 60 |
|
| 61 |
My argv library should have been included with this package |
| 62 |
(argv.[ch], argv_loc.h). I use it with all my binaries. It functions |
| 63 |
similar to the getopt routines in that it provides a standardized way |
| 64 |
of processing arguments. However, that is where the similarity ends. |
| 65 |
You have to write no C code to do the actual processing, it handles |
| 66 |
short -l and long --logfile style options, gives standard short and |
| 67 |
long usage messages, and many other features while trying to comply |
| 68 |
with POSIX specs. |
| 69 |
|
| 70 |
The newest versions of the argv library are available on the web: |
| 71 |
|
| 72 |
http://256.com/sources/argv/ |
| 73 |
|
| 74 |
------------------------------------------------------------------------------- |
| 75 |
|
| 76 |
THANKS: |
| 77 |
|
| 78 |
Many net folk contributed to the design, development, and overall |
| 79 |
library and my thanks goes out to them all. |
| 80 |
|
| 81 |
------------------------------------------------------------------------------- |
| 82 |
|
| 83 |
AUTHOR: |
| 84 |
|
| 85 |
If you have any questions, comments, or problems feel free to send me |
| 86 |
mail. |
| 87 |
|
| 88 |
Gray Watson |
| 89 |
http://256.com/gray/ |
| 90 |
|
| 91 |
------------------------------------------------------------------------------- |
| 92 |
$Id: README.1,v 1.58 2000/03/30 19:31:56 gray Exp $ |
| 93 |
------------------------------------------------------------------------------- |