news

debug source code under unix platform.

Changes for 1.4.8 (8th January, 2002)

  * Added better logging for diagnostic messages.

  * Added much-improved autoconf, automake and libtool support.

  * Added provisional HTML log file support with the HTML option.

  * The library now checks to ensure that there were not any problems writing
    the profiling and tracing output files.

  * Added better Tru64 thread-safe support.

  * Fixed a problem locating symbols for the a.out object file format.

  * Fixed diagnostics for the number of symbols read from Windows DLLs.

  * Fixed a bug which calculated the wrong total size of marked allocations.

  * The mpatrol command now has the --read-env option for using the existing
    contents of the MPATROL_OPTIONS environment variable.

  * The mpsym command now autodetects 64-bit support and now has the --skip
    option.

  * The source code now compiles properly on BSD systems.


Changes for 1.4.7 (5th September, 2001)

  * Fixed the problems building Windows DLLs.

  * Fixed the problems with stack unwinding on Tru64.

  * The mpsym command now works on LynxOS and the mpedit command now works on
    FreeBSD and supports the elvis, pico and nano editors.

  * Added ability to build a Debian package.


Changes for 1.4.6 (28th August, 2001)

  * Added many new arguments that are passed to prologue, epilogue and low
    memory callback functions and updated the tools that already use them.

  * The Windows DLL version of the mpatrol library now correctly exports the
    C++ functions defined within it.

  * Increased the maximum input line length for the mptrace and mleak commands
    due to the excessive length of some C++ identifiers.

  * Improved the UNIX Makefile when building mptrace with GUI support.

  * Added ability to build full documentation from the source code.

  * Added skeleton autoconf, automake and libtool support.


Changes for 1.4.5 (14th June, 2001)

  * Added the CHECKFORK option in order to fix the fork() problem on UNIX
    platforms explicitly.  This had to be added because the fix in the previous
    release did not work for multithreaded programs on Linux.

  * Added the HD_CONTENTS flag to the heapdiff tool.

  * Added the --source option to the mptrace command.


Changes for 1.4.4 (31st May, 2001)

  * Added ability to read, write, compare and remove allocation contents files.

  * Added the __mp_libversion() function to return the library version number.

  * The __mp_* functions can now be called as mpatrol_* functions when the
    mpatrol.h header file is included.

  * Added support for automatic compilation when TARGET=TARGET_ANY and
    ARCH=ARCH_ANY and added information about the platform in the log file.

  * SuSE Linux is now supported.

  * Added ability to trace reallocations.

  * Fixed a problem on UNIX platforms when fork() was called and the child
    process continued to make memory allocations.

  * Fixed a problem on Windows platforms when protecting pages that were
    allocated by different calls to VirtualAlloc().

  * Fixed a bug when using alloca() without full stack support.

  * Added the --hatf-file option to the mptrace command to write out the trace
    file in HATF format.  Also added running statistics to the --verbose
    option.

  * Added the --max-stack option to the mleak command.


Changes for 1.4.3 (22th March, 2001)

  * Added the --call-graph option to the mprof command and fixed a rare bug when
    displaying the leak table and call graph with call sites which have no
    associated symbols.

  * Added the --gui and --verbose options to the mptrace command, which now also
    displays useful statistics.

  * Added chapters on heap corruption, memory leaks and porting to the mpatrol
    manual and moved the Tools and Utilities sections to the top level.


Changes for 1.4.2 (12th March, 2001)

  * Added the LEAKTABLE option which displays a leak table at the end of program
    execution.  Also added functions for users to manipulate the leak table.

  * Added the __mp_iterateall() function to walk the entire heap, including
    free blocks and internal allocations.  The __mp_info() and __mp_printinfo()
    functions now also return information about free blocks.

  * Added functions to print to the log file along with their source position
    and a stack traceback.

  * Added the __mp_errno global variable and a function to obtain the error
    message string corresponding to an error code.

  * Added __mp_init_* and __mp_fini_* initialisation and finalisation function
    support.

  * Finished the support for marked allocations.

  * Tru64 is now supported.

  * The library is now no longer initialised on Linux until the environment
    variables are fully set up.

  * Removed calls to ZeroMemory(), etc. on Windows platforms as they ended up
    calling memset(), etc. thus defeating the whole purpose of the original
    change!

  * Fixed a problem building the shared version of the mpatrol library with some
    versions of GNU C++.

  * Added the --sim-file option to the mptrace command to provide trace-driven
    memory allocation simulation support.

  * Fixed the mpsym command which had problems when GDB displayed lines that
    were too long.  Also now uses progfile.log if mpatrol.log cannot be found.

  * Added Dmalloc-compatible function implementations as an external package.

  * Forgot to build the Dbmalloc module and install its header file in the
    previous release.  Also now read all relevant Dbmalloc environment variables
    on initialisation and mapped all Dbmalloc error codes onto mpatrol errors.
    Fixed the malloc_inuse() function for marked allocations.

  * Added chapters to the mpatrol manual describing the tools supplied and the
    leak table.

  * Added the AUTHORS, CHECKSUMS and THANKS files.


Changes for 1.4.1 (27th February, 2001)

  * Added the __mp_atexit() and __mp_setmark() functions.  Also added more
    fields to the information returned by __mp_info() and better source-level
    information when __mp_check() is called.

  * Added the FREMRK error for when an attempt is made to free a marked memory
    allocation.

  * Fixed a problem which prevented the const keyword being used when compiling
    with a C++ compiler.

  * Fixed a problem when profiling memory reallocations.

  * Fixed a typing error which would prevent compilation on Windows platforms.
    Also fixed std namespace problems for set_new_handler() on Windows
    platforms.

  * Changed HEAPDIFFSTART() and HEAPDIFFEND() to their lowercase equivalents and
    added support in the heapdiff tool for marked memory allocations.

  * Added Dbmalloc-compatible function implementations as an external package.

  * The trace file in the mtrace tool is now automatically closed at exit.


Changes for 1.4.0 (21st February, 2001)

  * Added release versions of all of the mpatrol library functions that can be
    used to quickly remove all mpatrol features by linking with libmpalloc.
    Changed the arguments to the MP_MALLOC() family of functions so that the
    pointer being manipulated is always the first argument.

  * The log file now displays a summary of all of the symbols loaded from the
    main executable file and any shared libraries.

  * The C++ operators are now ANSI standard conforming, with new versions that
    throw the std::bad_alloc exception when no more memory is available.  The
    mpatrol library is now built with a C++ compiler by default on some
    platforms.

  * The alloca() family of functions now abort instead of returning NULL when
    there is no more memory available.  Also added the BSD reallocf() function.

  * Added a function to read the value of any mpatrol option at runtime.  Also
    added a function that can set most mpatrol options at any point in a
    program's execution.  In addition, a function has been added to obtain
    symbolic information about a code address from the mpatrol symbol manager
    and another function added to associate user-specific data with a particular
    memory allocation.

  * Added functions to snapshot the heap and iterate across all memory
    allocations in the heap.  Also added functions to write strings, hex dumps,
    memory allocations and current call stacks to the mpatrol log file, as well
    as the ability to edit or view specific source files from within a program
    when it is running.  A function is also now available to obtain various
    statistics about the current state of the heap.

  * The CHECK option is now zero by default, which means that the library does
    not perform as much checking by default as it did before.  Also added a
    frequency argument to the CHECK option so that checking can be performed
    every nth time across a given range.

  * Changed the behaviour of the NOFREE option so that NOFREE=0 really does mean
    that all memory allocations will be freed immediately.  A large finite
    number must given to the NOFREE option in order to mimic the old behaviour
    of the NOFREE=0 option.

  * The mpatrol library now calls FillMemory(), etc. on Windows platforms in
    order to perform memory operations faster than would normally be done with
    __mp_memset(), etc.

  * Fixed a bug in the strdup() and realloc() families of functions that would
    be triggered if they ran out of memory.

  * Fixed a bug in memalign() which meant that if the alignment was specified as
    zero then the system page size would be used instead of the default system
    alignment.

  * GNU C++ destructor symbols are now recognised and preserved when reading
    the symbol tables from object files.  Previously this meant that memory
    allocations from such destructors were recorded as having occurred in the
    wrong place.

  * Added the return address as an additional argument to the prologue and
    epilogue handlers.

  * The hexwords command now searches for a dictionary in several other
    locations if the default dictionary is not found.

  * Added an Automake macro for use when incorporating mpatrol into a new or
    existing project.  Also added a new header file which can be used to
    include mpatrol.h, mpalloc.h or neither depending on whether the mpatrol
    or mpalloc libraries are available.

  * Added the allocstop, reallocstop and freestop commands to the .gdbinit
    configuration file so that it is possible to stop at specific allocations,
    reallocations and deallocations when debugging a program.

  * Added new tests demonstrating the MP_MALLOC() family of functions and the
    __mp_snapshot() and __mp_iterate() functions.  Also improved some of the
    existing tests to make use of the new functions.

  * Added a tools directory containing additional source code for the mpatrol
    library.  Currently contains packages for determining the difference in the
    heap between two points in a program's execution, a GNU-compatible mtrace()
    function and a memory allocation gauge.  A new library is also available
    which contains these packages.

  * The mpatrol distribution now contains the mpatrol documentation and manual
    page archives which are no longer available separately.


Changes for 1.3.4 (25th January, 2001)

  * Added the MP_MALLOC() family of functions for recording the type name and
    type size of a memory allocation.  Also added the xmalloc() family of
    functions which never return NULL.

  * Added a new header file and library for use when mpatrol is not being used.

  * Added FreeBSD, NetBSD, OpenBSD and SunOS support.

  * Added the ability to read symbols from a.out files.  Also added the ability
    to build mpatrol as a shared library on AIX, as well as being able to read
    symbols from shared libraries on AIX.  The COFF and XCOFF symbol readers now
    require the use of the libld object file access library.

  * Changed the behaviour of the low memory handler to automatically retry the
    memory allocation once the handler has been called.

  * Now store information about the point of last reallocation rather than the
    point of original allocation.

  * The manual pages are now also supplied in HTML format.


Changes for 1.3.3 (6th January, 2001)

  * Added support for the -fcheck-memory-usage option of the GNU compiler.

  * Added the hexwords command to extract any words from a dictionary file that
    can be written as hexadecimal numbers.

  * The mpsym command can now make use of perl if it is installed rather than
    using the slower method of calling awk and sed.

  * The library now allocates internal memory with mmap() by default, and with
    sbrk() when the USEMMAP option is used, but only if the mmap() system call
    is supported.

  * The MP_USE_ATEXIT feature macro has been added to force the mpatrol library
    to be registered with atexit() instead of using alternative methods to
    automatically terminate the library, if they exist.

  * Added two new tests demonstrating the support for -fcheck-memory-usage.


Changes for 1.3.2 (18th December, 2000)

  * Added the TRACE and TRACEFILE options to handle memory allocation tracing.

  * Added the SHOWFREE option to display information about free memory blocks.

  * Added the mptrace command to decode a tracing output file into tabular, and
    possibly graphical, form.

  * Added the %d, %t and %f filename characters to be replaced with the current
    date, current time and full path of the executable.

  * Added information about the peak number of memory allocations to the log
    file summary.

  * Improved the handling of internal blocks used by the mpatrol library to be
    more efficient.

  * Added a chapter on tracing to the mpatrol manual.

  * Added new DVI, postscript and PDF formats for the UNIX manual pages and
    added the mpatrol_man.tar.gz archive.  Also changed the mpatrol.3 manual
    page to libmpatrol.3.


Changes for 1.3.1 (22nd November, 2000)

  * The initialisation and termination of the mpatrol library has been improved
    when compiling on ELF, GNU or C++ systems.  All memory deallocations
    resulting from C++ file-scope destructors will now be recorded as a result.

  * The thread-safe shared library version of mpatrol was not being built
    correctly with the GNU linker.  This has now been fixed, with the result
    that the library is properly initialised.

  * Improved the RPM package specification file to keep in line with the Red Hat
    PowerTools release.

  * Added the ability to build an SD/UX package for use on HP/UX.

  * Documented how to create shared libraries from archive libraries when using
    the GNU linker.


Changes for 1.3.0 (19th November, 2000)

  * Added the CHECKMEMORY option for displaying an error for each zero-size
    memory operation on a NULL pointer.

  * Added the EDIT and LIST options for editing and listing source lines that
    cause warnings or error messages.  Also added the mpedit command which is
    used by these options.

  * Changed the format of stack traces in the mpatrol log file so that symbol
    names also contain a byte offset from the beginning of the symbol.

  * Warnings and errors are now reported with error abbreviation codes.

  * Added the alloca(), strdupa(), strndupa() and dealloca() functions for
    tracing and debugging temporary stack-based memory allocations.

  * Improved the error-checking of the strdup() family of functions and also
    fixed a bug in strndup() and strnsave() where the string was not being
    terminated correctly.

  * Added support for the LOGDIR and PROFDIR environment variables.

  * ICL DRS/NX is now supported.

  * The OFLOWWATCH option is now supported on IRIX.

  * Finally fixed the determination of the address of an illegal memory access
    on IRIX platforms and added support for the SGI N32 object file format.

  * MP_FUNCNAME is now supported for C9X compilers.  Also added MP_NONEWDELETE,
    MP_NEW and MP_DELETE to prevent problems with the macro replacement of the
    C++ operators.

  * Added long options to the external commands and added --help.  The short
    options have now been heavily revised so beware!

  * Added the --show-env option to the mpatrol command and removed the implicit
    LOGALL that was always being added to MPATROL_OPTIONS.  Also added the
    --threads option to link at run-time with thread-safe libraries.

  * Fixed a problem with the mpatrol command on UNIX platforms when the command