kde-dev-scripts/doc/man-extend_dmalloc.1.docbook

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
0003 <!ENTITY % English "INCLUDE">
0004 ]>
0005
0006 <refentry lang="&language;">
0007 <refentryinfo>
0008 <author><personname><firstname>Ben</firstname><surname>Burton</surname></personname>
0009 <email>bab@debian.org</email></author>
0010 <date>2003-04-07</date>
0011 </refentryinfo>
0012
0013 <refmeta>
0014 <refentrytitle><command>extend_dmalloc</command></refentrytitle>
0015 <manvolnum>1</manvolnum>
0016 </refmeta>
0017
0018 <refnamediv>
0019 <refname><command>extend_dmalloc</command></refname>
0020 <refpurpose>Analyze return-addresses from dmalloc logfiles.</refpurpose>
0021 </refnamediv>
0022
0023 <refsynopsisdiv>
0024 <cmdsynopsis>
0025 <command>extend_dmalloc</command>
0026 <group><option><replaceable>dmalloc-log</replaceable> <command>binary</command></option></group>
0027 </cmdsynopsis>
0028 </refsynopsisdiv>
0029
0030 <refsect1>
0031 <title>Description</title>
0032
0033 <para><command>extend_dmalloc</command> will run <command>gdb</command>(1) to get information on the return-addresses from a <command>dmalloc</command>(1) logfile. Specifically it will examine any <literal>ra=</literal> lines and try to get the corresponding line numbers</para>
0034
0035 <para>The argument
0036 <option><command>binary</command></option>
0037 must be the binary that generated the log
0038 <filename>dmalloc-log</filename>.</para>
0039
0040 <para>This utility is part of the &kde; Software Development
0041 Kit.</para>
0042
0043 </refsect1>
0044
0045
0046 <refsect1>
0047 <title>Notes</title>
0048 <para>You may wish to direct the output from
0049 <command>extend_dmalloc</command> to a file, since otherwise
0050 <command>gdb</command> seems to prompt for a return as if you are at
0051 the end of a page. </para>
0052 </refsect1>
0053
0054 </refentry>