From 770e7545ebcff0d403d98d5a3b2e231d1ed79db8 Mon Sep 17 00:00:00 2001 From: Peter Schiffer Date: Sat, 30 Aug 2014 15:17:57 +0200 Subject: [PATCH] mtrace.1: New page describing the glibc mtrace(1) command Page submitted by Jan Chaloupka. Signed-off-by: Michael Kerrisk --- man1/mtrace.1 | 65 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 man1/mtrace.1 diff --git a/man1/mtrace.1 b/man1/mtrace.1 new file mode 100644 index 000000000..bb235bdaa --- /dev/null +++ b/man1/mtrace.1 @@ -0,0 +1,65 @@ +.\" Copyright (c) 2013, Peter Schiffer (pschiffe@redhat.com) +.\" +.\" %%%LICENSE_START(GPLv2+_DOC_FULL) +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 2 of +.\" the License, or (at your option) any later version. +.\" +.\" The GNU General Public License's references to "object code" +.\" and "executables" are to be interpreted as the output of any +.\" document formatting or typesetting system, including +.\" intermediate and printed output. +.\" +.\" This manual is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public +.\" License along with this manual; if not, see +.\" . +.\" %%%LICENSE_END +.TH MTRACE 1 2013-04-10 "GNU glibc 2.18" "Memory diagnostic tools" +.SH NAME +mtrace \- interpret the malloc trace log +.SH SYNOPSIS +.BR mtrace " [\fIOPTION\fR]... [\fIBINARY\fR] \fIMTRACEDATA\fR" +.SH DESCRIPTION +.B mtrace +is a Perl script used to interpret and provide human readable output +of the trace log created by +.BR mtrace (3) +function stored in the +.B MTRACEDATA +file. +If +.B BINARY +is provided, output of +.B mtrace +also contains source file name with line number information +of problem location +(assuming that +.B BINARY +was compiled with debugging information). + +For more information about +.BR mtrace (3) +function and +.B mtrace +script usage, refer to the +.BR mtrace (3) +manual page. +.SH OPTIONS +.TP +.BI \fB\-\-help +Print help and exit. +.TP +.BI \fB\-\-version +Print version information and exit. +.SH BUGS +For bug reporting instructions, please see: +. +.SH SEE ALSO +.BR mtrace (3) +