mirror of
https://github.com/Zenithsiz/ftmemsim-valgrind.git
synced 2026-02-04 02:18:37 +00:00
fd4e3fb0ff
debuginfod is an HTTP server for distributing ELF/DWARF debugging information. When a debuginfo file cannot be found locally, Valgrind is able to query debuginfod servers for the file using its build-id. readelf.c: Add debuginfod_find_debug_file(). Spawns a child process to exec `debuginfod-find` in order to query servers for the debuginfo file. Also add helper debuginfod_find_path(). pub_core_pathscan.h: Moved from priv_initimg_pathscan.h in order to use VG_(find_executable)() in readelf.c. docs: Add information regarding debuginfod to valgrind.1 memcheck/tests/linux: Add new test debuginfod-check. tests/vg_regtest.in: Clear $DEBUGINFOD_URLS before running any tests. https://bugs.kde.org/show_bug.cgi?id=432215
287 lines
7.7 KiB
XML
287 lines
7.7 KiB
XML
<?xml version="1.0"?> <!-- -*- sgml -*- -->
|
|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
|
|
[ <!ENTITY % vg-entities SYSTEM "vg-entities.xml"> %vg-entities; ]>
|
|
|
|
|
|
<refentry id="valgrind">
|
|
|
|
<refmeta>
|
|
<refentrytitle>VALGRIND</refentrytitle>
|
|
<manvolnum>1</manvolnum>
|
|
<refmiscinfo class="source">Release &rel-version;</refmiscinfo>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>valgrind</refname>
|
|
<refpurpose>a suite of tools for debugging and profiling programs</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<cmdsynopsis>
|
|
<command>valgrind</command>
|
|
<arg><replaceable>valgrind-options</replaceable></arg>
|
|
<arg><replaceable>your-program</replaceable></arg>
|
|
<arg><replaceable>your-program-options</replaceable></arg>
|
|
</cmdsynopsis>
|
|
</refsynopsisdiv>
|
|
|
|
|
|
<refsect1 id="description">
|
|
<title>Description</title>
|
|
|
|
<para><command>Valgrind</command> is a flexible program for debugging
|
|
and profiling Linux executables. It consists of a core, which provides
|
|
a synthetic CPU in software, and a series of debugging and profiling tools.
|
|
The architecture is modular, so that new tools can be created easily and
|
|
without disturbing the existing structure.</para>
|
|
|
|
<para>Some of the options described below work with all Valgrind tools, and
|
|
some only work with a few or one. The section MEMCHECK OPTIONS and those
|
|
below it describe tool-specific options.</para>
|
|
|
|
<para>This manual page covers only basic usage and options. For more
|
|
comprehensive information, please see the HTML documentation on your
|
|
system: <filename>&vg-docs-path;</filename>, or online:
|
|
<filename>&vg-docs-url;</filename>.</para>
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1 id="tool-selection-options">
|
|
<title>Tool Selection Options</title>
|
|
|
|
<xi:include href="manual-core.xml" xpointer="tool.opts.para"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
<xi:include href="manual-core.xml" xpointer="tool.opts.list"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1 id="basic-options">
|
|
<title>Basic Options</title>
|
|
|
|
<xi:include href="manual-core.xml" xpointer="basic.opts.para"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
<xi:include href="manual-core.xml" xpointer="basic.opts.list"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1 id="error-related-options">
|
|
<title>Error-Related Options</title>
|
|
|
|
<xi:include href="manual-core.xml" xpointer="error-related.opts.para"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
<xi:include href="manual-core.xml" xpointer="error-related.opts.list"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1 id="malloc-related-options">
|
|
<title>malloc()-related Options</title>
|
|
|
|
<xi:include href="manual-core.xml" xpointer="malloc-related.opts.para"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
<xi:include href="manual-core.xml" xpointer="malloc-related.opts.list"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1 id="uncommon-options">
|
|
<title>Uncommon Options</title>
|
|
|
|
|
|
<xi:include href="manual-core.xml" xpointer="uncommon.opts.para"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
<xi:include href="manual-core.xml" xpointer="uncommon.opts.list"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1 id="debugging-valgrind-options">
|
|
<title>Debugging Valgrind Options</title>
|
|
|
|
<xi:include href="manual-core.xml" xpointer="debug.opts.para"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1 id="memcheck-options">
|
|
<title>Memcheck Options</title>
|
|
|
|
<xi:include href="../../memcheck/docs/mc-manual.xml"
|
|
xpointer="mc.opts.list"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1 id="cachegrind-options">
|
|
<title>Cachegrind Options</title>
|
|
|
|
<xi:include href="../../cachegrind/docs/cg-manual.xml"
|
|
xpointer="cg.opts.list"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1 id="callgrind-options">
|
|
<title>Callgrind Options</title>
|
|
|
|
<xi:include href="../../callgrind/docs/cl-manual.xml"
|
|
xpointer="cl.opts.list.creation"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
<xi:include href="../../callgrind/docs/cl-manual.xml"
|
|
xpointer="cl.opts.list.activity"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
<xi:include href="../../callgrind/docs/cl-manual.xml"
|
|
xpointer="cl.opts.list.collection"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
<xi:include href="../../callgrind/docs/cl-manual.xml"
|
|
xpointer="cl.opts.list.simulation"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1 id="helgrind-options">
|
|
<title>Helgrind Options</title>
|
|
|
|
<xi:include href="../../helgrind/docs/hg-manual.xml"
|
|
xpointer="hg.opts.list"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1 id="drd-options">
|
|
<title>DRD Options</title>
|
|
|
|
<xi:include href="../../drd/docs/drd-manual.xml"
|
|
xpointer="drd.opts.list"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
<xi:include href="../../drd/docs/drd-manual.xml"
|
|
xpointer="drd.debugopts.list"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1 id="massif-options">
|
|
<title>Massif Options</title>
|
|
|
|
<xi:include href="../../massif/docs/ms-manual.xml"
|
|
xpointer="ms.opts.list"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1 id="bbv-options">
|
|
<title>BBV Options</title>
|
|
|
|
<xi:include href="../../exp-bbv/docs/bbv-manual.xml"
|
|
xpointer="bbv.opts.list"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
</refsect1>
|
|
|
|
|
|
<refsect1 id="lackey-options">
|
|
<title>Lackey Options</title>
|
|
|
|
<xi:include href="../../lackey/docs/lk-manual.xml"
|
|
xpointer="lk.opts.list"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
|
|
</refsect1>
|
|
|
|
<refsect1 id="debuginfod">
|
|
<title>Debuginfod</title>
|
|
|
|
<xi:include href="manual-core.xml"
|
|
xpointer="debuginfod.para.1"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
<xi:include href="manual-core.xml"
|
|
xpointer="debuginfod.para.2"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
<xi:include href="manual-core.xml"
|
|
xpointer="debuginfod.para.3"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude" />
|
|
</refsect1>
|
|
|
|
<refsect1 id="see_also">
|
|
<title>See Also</title>
|
|
|
|
<para>
|
|
cg_annotate(1),
|
|
callgrind_annotate(1),
|
|
callgrind_control(1),
|
|
ms_print(1),
|
|
<filename>&vg-docs-path;</filename> or
|
|
<filename>&vg-docs-url;</filename>,
|
|
<ulink id="&vg-gdbserver-id;"
|
|
xreflabel="&vg-gdbserver-label;"
|
|
url="&vg-gdbserver-url;">&vg-gdbserver-label;</ulink>
|
|
<ulink id="&vg-vgdb-id;"
|
|
xreflabel="&vg-vgdb-label;"
|
|
url="&vg-vgdb-url;">&vg-vgdb-label;</ulink>,
|
|
<ulink id="&vg-monitor-id;"
|
|
xreflabel="&vg-monitor-label;"
|
|
url="&vg-monitor-url;">&vg-monitor-label;</ulink>,
|
|
<ulink id="&vg-comment-id;"
|
|
xreflabel="&vg-comment-label;"
|
|
url="&vg-comment-url;">&vg-comment-label;</ulink>,
|
|
<ulink id="&vg-pthreads-perf-sched-id;"
|
|
xreflabel="&vg-pthreads-perf-sched-label;"
|
|
url="&vg-pthreads-perf-sched-url;">&vg-pthreads-perf-sched-label;</ulink>,
|
|
<ulink id="&vg-cg-manual-id;"
|
|
xreflabel="&vg-cg-manual-label;"
|
|
url="&vg-cg-manual-url;">&vg-cg-manual-label;</ulink>.
|
|
<ulink id="&vg-xtree-id;"
|
|
xreflabel="&vg-xtree-label;"
|
|
url="&vg-xtree-url;">&vg-xtree-label;</ulink>
|
|
</para>
|
|
|
|
</refsect1>
|
|
|
|
|
|
<refsect1 id="author">
|
|
<title>Author</title>
|
|
|
|
<para>See the AUTHORS file in the valgrind distribution for a
|
|
comprehensive list of authors.</para>
|
|
<para>This manpage was written by Andres Roldan <aroldan@debian.org>
|
|
and the Valgrind developers.</para>
|
|
|
|
</refsect1>
|
|
|
|
|
|
</refentry>
|
|
|