Content-type: text/html Man page of Bopmtrace

Bopmtrace

Section: User Commands (1)
Updated: User
Index
 

NAME

Bopmtrace - Display Bop memory related informations.  

SYNOPSIS

bopmtrace < input-file

bopmtrace [--help][--version]  

DESCRIPTION

This program is a filter. It reads on standard input the output of bop memory debugging functions. See bop(3) documentation.

Its writes on standard output the result of its analyze of the input. Its functionnalities are somewhat similar to the GNU mtrace1), but it only analyzes the results of bop allocation/unallocation functions wrappers functions.  

OPTIONS

--version
Display Bopmtrace version and exit successfully.
--help
Display Bopmtrace usage and exit successfully.
 

EXIT VALUE

0 ( zero ) unless it crashed or an unrecognized option is entered.  

OUTPUT FORMAT.

Bopmtrace outputs two sets of lines separated by an empty line. lines are sorted in chronological order in a set.
Set 1 :
1 line for each unallocation of non allocated memory.

1 line for each duplicate allocation (Two allocations at the same address without an unallocation of the first allocation).

Set 2 :
1 line for each allocated memory not freed. Note that reallocs are treated as if they were an unallocation followed by an allocation, thus they don't appear as duplicate allocations.
Output line format :
[action number] [diagnostic] [address] [infos]

action number : Chronological order of the operation (allocation or unallocation) in the program.

diagnostic : 'Not allocated' or 'Duplicated' or 'Not freed'.

address : Memory address in hexadecimal.

infos : Memory requested size for allocation actions, name of the program, function and line number from which the action originate

This is a simple output of mtrace :
          3      Not allocated  08049ea0        src/boph.c bophDel 417
        18      Duplicated      08049fd8        12 src/tests/bopleak.c main 64

        16      Not Freed       08049fe8        28 src/boph.c bophPut 234

 

SEE ALSO

bop(3) mtrace(1)  

BUGS

Presume addresses are 32 bits or less.

When there are more than 9,999,999,999 actions, the second set of output lines may not be sorted.  

AUTHOR

Patrick Davalan. http://patrick.davalan.free.fr/

Send bug reports and suggestions at jigmepema<at>wanadoo.fr  

COMMENTS

For prehistorical reasons, this is version 2.0.92 of Bopmtrace, but you should consider it as a test version despite the fact that it probably works fine as well.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXIT VALUE
OUTPUT FORMAT.
SEE ALSO
BUGS
AUTHOR
COMMENTS

This document was created by man2html, using the manual pages.
Time: 00:02:27 GMT, February 28, 2005