man1/mtrace.1

   1 .\" Copyright (c) 2013, Peter Schiffer (pschiffe@redhat.com)
   2 .\"
   3 .\" %%%LICENSE_START(GPLv2+_DOC_FULL)
   4 .\" This is free documentation; you can redistribute it and/or
   5 .\" modify it under the terms of the GNU General Public License as
   6 .\" published by the Free Software Foundation; either version 2 of
   7 .\" the License, or (at your option) any later version.
   8 .\"
   9 .\" The GNU General Public License's references to "object code"
  10 .\" and "executables" are to be interpreted as the output of any
  11 .\" document formatting or typesetting system, including
  12 .\" intermediate and printed output.
  13 .\"
  14 .\" This manual is distributed in the hope that it will be useful,
  15 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  16 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17 .\" GNU General Public License for more details.
  18 .\"
  19 .\" You should have received a copy of the GNU General Public
  20 .\" License along with this manual; if not, see
  21 .\" <http://www.gnu.org/licenses/>.
  22 .\" %%%LICENSE_END
  23 .TH MTRACE 1 2021-03-22 "GNU" "Linux user manual"
  24 .SH NAME
  25 mtrace \- interpret the malloc trace log
  26 .SH SYNOPSIS
  27 .nf
  28 .BR mtrace " [\fIoption\fR]... [\fIbinary\fR] \fImtracedata\fR"
  29 .fi
  30 .SH DESCRIPTION
  31 .B mtrace
  32 is a Perl script used to interpret and provide human readable output
  33 of the trace log contained in the file
  34 .IR mtracedata ,
  35 whose contents were produced by
  36 .BR mtrace (3).
  37 If
  38 .I binary
  39 is provided, the output of
  40 .B mtrace
  41 also contains the source file name with line number information
  42 for problem locations
  43 (assuming that
  44 .I binary
  45 was compiled with debugging information).
  46 .PP
  47 For more information about the
  48 .BR mtrace (3)
  49 function and
  50 .B mtrace
  51 script usage, see
  52 .BR mtrace (3).
  53 .SH OPTIONS
  54 .TP
  55 .BI \fB\-\-help
  56 Print help and exit.
  57 .TP
  58 .BI \fB\-\-version
  59 Print version information and exit.
  60 .SH BUGS
  61 For bug reporting instructions, please see:
  62 .UR http://www.gnu.org/software/libc/bugs.html
  63 .UE .
  64 .SH SEE ALSO
  65 .BR memusage (1),
  66 .BR mtrace (3)