1 usage: valgrind [options] prog-and-args
3 tool-selection option, with default in [ ]:
4 --tool=<name> use the Valgrind tool named <name> [memcheck]
6 basic user options for all Valgrind tools, with defaults in [ ]:
7 -h --help show this message
8 --help-debug show this message, plus debugging options
10 -q --quiet run silently; only print error msgs
11 -v --verbose be more verbose -- show misc extra info
12 --trace-children=no|yes Valgrind-ise child processes (follow execve)? [no]
13 --trace-children-skip=patt1,patt2,... specifies a list of executables
14 that --trace-children=yes should not trace into
15 --trace-children-skip-by-arg=patt1,patt2,... same as --trace-children-skip=
16 but check the argv[] entries for children, rather
17 than the exe name, to make a follow/no-follow decision
18 --child-silent-after-fork=no|yes omit child output between fork & exec? [no]
19 --vgdb=no|yes|full activate gdbserver? [yes]
20 full is slower but provides precise watchpoint/step
21 --vgdb-error=<number> invoke gdbserver after <number> errors [999999999]
22 --track-fds=no|yes track open file descriptors? [no]
23 --time-stamp=no|yes add timestamps to log messages? [no]
24 --log-fd=<number> log messages to file descriptor [2=stderr]
25 --log-file=<file> log messages to <file>
26 --log-socket=ipaddr:port log messages to socket ipaddr:port
28 user options for Valgrind tools that report errors:
29 --xml=yes emit error output in XML (some tools only)
30 --xml-fd=<number> XML output to file descriptor
31 --xml-file=<file> XML output to <file>
32 --xml-socket=ipaddr:port XML output to socket ipaddr:port
33 --xml-user-comment=STR copy STR verbatim into XML output
34 --demangle=no|yes automatically demangle C++ names? [yes]
35 --num-callers=<number> show <number> callers in stack traces [12]
36 --error-limit=no|yes stop showing new errors if too many? [yes]
37 --error-exitcode=<number> exit code to return if errors found [0=disable]
38 --show-below-main=no|yes continue stack traces below main() [no]
39 --suppressions=<filename> suppress errors described in <filename>
40 --gen-suppressions=no|yes|all print suppressions for errors? [no]
41 --db-attach=no|yes start debugger when errors detected? [no]
42 --db-command=<command> command to start debugger [... -nw %f %p]
43 --input-fd=<number> file descriptor for input [0=stdin]
44 --dsymutil=no|yes run dsymutil on Mac OS X when helpful? [no]
45 --max-stackframe=<number> assume stack switch for SP changes larger
46 than <number> bytes [2000000]
47 --main-stacksize=<number> set size of main thread's stack (in bytes)
48 [use current 'ulimit' value]
50 user options for Valgrind tools that replace malloc:
51 --alignment=<number> set minimum alignment of heap allocations [...]
53 uncommon user options for all Valgrind tools:
54 --fullpath-after= (with nothing after the '=')
55 show full source paths in call stacks
56 --fullpath-after=string like --fullpath-after=, but only show the
57 part of the path after 'string'. Allows removal
58 of path prefixes. Use this flag multiple times
59 to specify a set of prefixes to remove.
60 --smc-check=none|stack|all checks for self-modifying code: none,
61 only for code found in stacks, or all [stack]
62 --read-var-info=yes|no read debug info on stack and global variables
63 and use it to print better error messages in
64 tools that make use of it (Memcheck, Helgrind,
66 --vgdb-poll=<number> gdbserver poll max every <number> basic blocks [5000]
67 --vgdb-shadow-registers=no|yes let gdb see the shadow registers [no]
68 --vgdb-prefix=<prefix> prefix for vgdb FIFOs [/tmp/vgdb-pipe]
69 --run-libc-freeres=no|yes free up glibc memory at exit on Linux? [yes]
70 --sim-hints=hint1,hint2,... known hints:
71 lax-ioctls, enable-outer [none]
72 --kernel-variant=variant1,variant2,... known variants: bproc [none]
73 handle non-standard kernel variants
74 --show-emwarns=no|yes show warnings about emulation limits? [no]
75 --require-text-symbol=:sonamepattern:symbolpattern abort run if the
76 stated shared object doesn't have the stated
77 text symbol. Patterns can contain ? and *.
79 user options for Nulgrind:
82 Extra options read from ~/.valgrindrc, $VALGRIND_OPTS, ./.valgrindrc
84 Nulgrind is Copyright (C) 2002-2010, and GNU GPL'd, by Nicholas Nethercote.
85 Valgrind is Copyright (C) 2000-2010, and GNU GPL'd, by Julian Seward et al.
86 LibVEX is Copyright (C) 2004-2010, and GNU GPL'd, by OpenWorks LLP et al.
88 Bug reports, feedback, admiration, abuse, etc, to: www.valgrind.org.