Home | History | Annotate | Download | only in tests
      1 usage: valgrind [options] prog-and-args
      2 
      3   tool-selection option, with default in [ ]:
      4     --tool=<name>             use the Valgrind tool named <name> [memcheck]
      5 
      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
      9     --version                 show version
     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                               to get started quickly, use --vgdb-error=0
     23                               and follow the on-screen directions
     24     --track-fds=no|yes        track open file descriptors? [no]
     25     --time-stamp=no|yes       add timestamps to log messages? [no]
     26     --log-fd=<number>         log messages to file descriptor [2=stderr]
     27     --log-file=<file>         log messages to <file>
     28     --log-socket=ipaddr:port  log messages to socket ipaddr:port
     29 
     30   user options for Valgrind tools that report errors:
     31     --xml=yes                 emit error output in XML (some tools only)
     32     --xml-fd=<number>         XML output to file descriptor
     33     --xml-file=<file>         XML output to <file>
     34     --xml-socket=ipaddr:port  XML output to socket ipaddr:port
     35     --xml-user-comment=STR    copy STR verbatim into XML output
     36     --demangle=no|yes         automatically demangle C++ names? [yes]
     37     --num-callers=<number>    show <number> callers in stack traces [12]
     38     --error-limit=no|yes      stop showing new errors if too many? [yes]
     39     --error-exitcode=<number> exit code to return if errors found [0=disable]
     40     --show-below-main=no|yes  continue stack traces below main() [no]
     41     --suppressions=<filename> suppress errors described in <filename>
     42     --gen-suppressions=no|yes|all    print suppressions for errors? [no]
     43     --db-attach=no|yes        start debugger when errors detected? [no]
     44     --db-command=<command>    command to start debugger [... -nw %f %p]
     45     --input-fd=<number>       file descriptor for input [0=stdin]
     46     --dsymutil=no|yes         run dsymutil on Mac OS X when helpful? [no]
     47     --max-stackframe=<number> assume stack switch for SP changes larger
     48                               than <number> bytes [2000000]
     49     --main-stacksize=<number> set size of main thread's stack (in bytes)
     50                               [use current 'ulimit' value]
     51 
     52   user options for Valgrind tools that replace malloc:
     53     --alignment=<number>      set minimum alignment of heap allocations [not used by this tool]
     54     --redzone-size=<number>   set minimum size of redzones added before/after
     55                               heap blocks (in bytes). [not used by this tool]
     56 
     57   uncommon user options for all Valgrind tools:
     58     --fullpath-after=         (with nothing after the '=')
     59                               show full source paths in call stacks
     60     --fullpath-after=string   like --fullpath-after=, but only show the
     61                               part of the path after 'string'.  Allows removal
     62                               of path prefixes.  Use this flag multiple times
     63                               to specify a set of prefixes to remove.
     64     --smc-check=none|stack|all|all-non-file [stack]
     65                               checks for self-modifying code: none, only for
     66                               code found in stacks, for all code, or for all
     67                               code except that from file-backed mappings
     68     --read-var-info=yes|no    read debug info on stack and global variables
     69                               and use it to print better error messages in
     70                               tools that make use of it (Memcheck, Helgrind,
     71                               DRD) [no]
     72     --vgdb-poll=<number>      gdbserver poll max every <number> basic blocks [5000]
     73     --vgdb-shadow-registers=no|yes   let gdb see the shadow registers [no]
     74     --vgdb-prefix=<prefix>    prefix for vgdb FIFOs [/tmp/vgdb-pipe]
     75     --run-libc-freeres=no|yes free up glibc memory at exit on Linux? [yes]
     76     --sim-hints=hint1,hint2,...  known hints:
     77                                  lax-ioctls, enable-outer, fuse-compatible [none]
     78     --fair-sched=no|yes|try   schedule threads fairly on multicore systems [no]
     79     --kernel-variant=variant1,variant2,...  known variants: bproc [none]
     80                               handle non-standard kernel variants
     81     --show-emwarns=no|yes     show warnings about emulation limits? [no]
     82     --require-text-symbol=:sonamepattern:symbolpattern    abort run if the
     83                               stated shared object doesn't have the stated
     84                               text symbol.  Patterns can contain ? and *.
     85     --soname-synonyms=syn1=pattern1,syn2=pattern2,... synonym soname
     86               specify patterns for function wrapping or replacement.
     87               To use a non-libc malloc library that is
     88                   in the main exe:  --soname-synonyms=somalloc=NONE
     89                   in libxyzzy.so:   --soname-synonyms=somalloc=libxyzzy.so
     90 
     91   user options for Nulgrind:
     92     (none)
     93 
     94   Extra options read from ~/.valgrindrc, $VALGRIND_OPTS, ./.valgrindrc
     95 
     96   Nulgrind is Copyright (C) 2002-2012, and GNU GPL'd, by Nicholas Nethercote.
     97   Valgrind is Copyright (C) 2000-2012, and GNU GPL'd, by Julian Seward et al.
     98   LibVEX is Copyright (C) 2004-2012, and GNU GPL'd, by OpenWorks LLP et al.
     99 
    100   Bug reports, feedback, admiration, abuse, etc, to: www.valgrind.org.
    101 
    102