MLEAK(1) mpatrol library MLEAK(1) NAME mleak - locates memory leaks in an mpatrol log file SYNOPSIS mleak [options] [file] DESCRIPTION The mleak command is used to display all unfreed memory allocations from a log file produced by the mpatrol library. This should be used if the mpa- trol library could not finish writing the log file due to abnormal program termination (which would prevent the SHOWUNFREED option from working), but note that some of the unfreed allocations might have been freed if the pro- gram had terminated successfully. The mleak command scans through an mpatrol log file looking for lines be- ginning with ALLOC: and FREE: but ignores lines beginning with REALLOC:, so only the LOGALLOCS and LOGFREES options are necessary when running a pro- gram linked with the mpatrol library. Note that as a result of this, no attempt is made to account for resizing of memory allocations and so the total amount of memory used by the resulting unfreed allocations may not be entirely accurate. This command will also read the unfreed allocations table produced by the SHOWUNFREED option in the log file if one is present. The entries in the table will be compared with the currently allocated entries and will be added if not already present. The file argument must be a valid mpatrol log filename but if file is omit- ted then mleak will use mpatrol.log as the name of the log file to use. The mleak command makes two passes over the log file so the file must be randomly-accessable. If file is given as - then the standard input file stream will be used as the log file. OPTIONS --help [-h] Displays a quick-reference option summary. --ignore [-i] Specifies that the list of unfreed allocations in the log file should be ignored. --max-stack depth [-n] Specifies the maximum stack depth to display for each unfreed memory allocation. If depth is 0 then the call stack depth will be unlim- ited in size. The default call stack depth is 0. --version [-V] Displays the version number of the mleak command. SEE ALSO mpatrol(1), mprof(1), mptrace(1), mpsym(1), mpedit(1), hexwords(1), libmpa- trol(3), libmpalloc(3). The mpatrol manual and reference card. http://www.cbmamiga.demon.co.uk/mpatrol/ AUTHOR Graeme S. Roy <graeme.roy@analog.com> COPYRIGHT Copyright (C) 1997-2002 Graeme S. Roy <graeme.roy@analog.com> This library is free software; you can redistribute it and/or modify it un- der the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your op- tion) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FIT- NESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details. You should have received a copy of the GNU Library General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA. Release 1.4 8 January 2002 MLEAK(1)
Want to link to this manual page? Use this URL:
<https://man.FreeBSD.org/cgi/man.cgi?query=mleak&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>