sewardj | 3b29048 | 2011-05-06 21:02:55 +0000 | [diff] [blame] | 1 | general valgrind monitor commands: |
philippe | c336038 | 2012-10-21 14:37:14 +0000 | [diff] [blame] | 2 | help [debug] : monitor command help. With debug: + debugging commands |
sewardj | 30b3eca | 2011-06-28 08:20:39 +0000 | [diff] [blame] | 3 | v.wait [<ms>] : sleep <ms> (default 0) then continue |
| 4 | v.info all_errors : show all errors found so far |
| 5 | v.info last_error : show last error found |
philippe | 07c0852 | 2014-05-14 20:39:27 +0000 | [diff] [blame] | 6 | v.info location <addr> : show information about location <addr> |
philippe | 02ea413 | 2013-09-04 21:42:43 +0000 | [diff] [blame] | 7 | v.info n_errs_found [msg] : show the nr of errors found so far and the given msg |
philippe | c336038 | 2012-10-21 14:37:14 +0000 | [diff] [blame] | 8 | v.info open_fds : show open file descriptors (only if --track-fds=yes) |
sewardj | 30b3eca | 2011-06-28 08:20:39 +0000 | [diff] [blame] | 9 | v.kill : kill the Valgrind process |
| 10 | v.set gdb_output : set valgrind output to gdb |
| 11 | v.set log_output : set valgrind output to log |
| 12 | v.set mixed_output : set valgrind output to log, interactive output to gdb |
philippe | 4620765 | 2013-01-20 17:11:58 +0000 | [diff] [blame] | 13 | v.set merge-recursive-frames <num> : merge recursive calls in max <num> frames |
sewardj | 30b3eca | 2011-06-28 08:20:39 +0000 | [diff] [blame] | 14 | v.set vgdb-error <errornr> : debug me at error >= <errornr> |
sewardj | 3b29048 | 2011-05-06 21:02:55 +0000 | [diff] [blame] | 15 | memcheck monitor commands: |
sewardj | 30b3eca | 2011-06-28 08:20:39 +0000 | [diff] [blame] | 16 | get_vbits <addr> [<len>] |
sewardj | 3b29048 | 2011-05-06 21:02:55 +0000 | [diff] [blame] | 17 | returns validity bits for <len> (or 1) bytes at <addr> |
| 18 | bit values 0 = valid, 1 = invalid, __ = unaddressable byte |
sewardj | 30b3eca | 2011-06-28 08:20:39 +0000 | [diff] [blame] | 19 | Example: get_vbits 0x........ 10 |
| 20 | make_memory [noaccess|undefined |
| 21 | |defined|Definedifaddressable] <addr> [<len>] |
sewardj | 3b29048 | 2011-05-06 21:02:55 +0000 | [diff] [blame] | 22 | mark <len> (or 1) bytes at <addr> with the given accessibility |
sewardj | 30b3eca | 2011-06-28 08:20:39 +0000 | [diff] [blame] | 23 | check_memory [addressable|defined] <addr> [<len>] |
sewardj | 3b29048 | 2011-05-06 21:02:55 +0000 | [diff] [blame] | 24 | check that <len> (or 1) bytes at <addr> have the given accessibility |
| 25 | and outputs a description of <addr> |
philippe | 2193a7c | 2012-12-08 17:54:16 +0000 | [diff] [blame] | 26 | leak_check [full*|summary] |
| 27 | [kinds kind1,kind2,...|reachable|possibleleak*|definiteleak] |
philippe | ab1fce9 | 2013-09-29 13:47:32 +0000 | [diff] [blame] | 28 | [heuristics heur1,heur2,...] |
sewardj | c8bd1df | 2011-06-26 12:41:33 +0000 | [diff] [blame] | 29 | [increased*|changed|any] |
philippe | 8423490 | 2012-01-14 13:53:13 +0000 | [diff] [blame] | 30 | [unlimited*|limited <max_loss_records_output>] |
sewardj | 3b29048 | 2011-05-06 21:02:55 +0000 | [diff] [blame] | 31 | * = defaults |
sewardj | 122f6af | 2014-09-03 21:58:54 +0000 | [diff] [blame] | 32 | where kind is one of: |
| 33 | definite indirect possible reachable all none |
| 34 | where heur is one of: |
| 35 | stdstring length64 newarray multipleinheritance all none* |
| 36 | Examples: leak_check |
| 37 | leak_check summary any |
| 38 | leak_check full kinds indirect,possible |
| 39 | leak_check full reachable any limited 100 |
philippe | a22f59d | 2012-01-26 23:13:52 +0000 | [diff] [blame] | 40 | block_list <loss_record_nr> |
| 41 | after a leak search, shows the list of blocks of <loss_record_nr> |
| 42 | who_points_at <addr> [<len>] |
| 43 | shows places pointing inside <len> (default 1) bytes at <addr> |
| 44 | (with len 1, only shows "start pointers" pointing exactly to <addr>, |
| 45 | with len > 1, will also show "interior pointers") |
sewardj | 3b29048 | 2011-05-06 21:02:55 +0000 | [diff] [blame] | 46 | general valgrind monitor commands: |
philippe | c336038 | 2012-10-21 14:37:14 +0000 | [diff] [blame] | 47 | help [debug] : monitor command help. With debug: + debugging commands |
sewardj | 30b3eca | 2011-06-28 08:20:39 +0000 | [diff] [blame] | 48 | v.wait [<ms>] : sleep <ms> (default 0) then continue |
| 49 | v.info all_errors : show all errors found so far |
| 50 | v.info last_error : show last error found |
philippe | 07c0852 | 2014-05-14 20:39:27 +0000 | [diff] [blame] | 51 | v.info location <addr> : show information about location <addr> |
philippe | 02ea413 | 2013-09-04 21:42:43 +0000 | [diff] [blame] | 52 | v.info n_errs_found [msg] : show the nr of errors found so far and the given msg |
philippe | c336038 | 2012-10-21 14:37:14 +0000 | [diff] [blame] | 53 | v.info open_fds : show open file descriptors (only if --track-fds=yes) |
sewardj | 30b3eca | 2011-06-28 08:20:39 +0000 | [diff] [blame] | 54 | v.kill : kill the Valgrind process |
| 55 | v.set gdb_output : set valgrind output to gdb |
| 56 | v.set log_output : set valgrind output to log |
| 57 | v.set mixed_output : set valgrind output to log, interactive output to gdb |
philippe | 4620765 | 2013-01-20 17:11:58 +0000 | [diff] [blame] | 58 | v.set merge-recursive-frames <num> : merge recursive calls in max <num> frames |
sewardj | 30b3eca | 2011-06-28 08:20:39 +0000 | [diff] [blame] | 59 | v.set vgdb-error <errornr> : debug me at error >= <errornr> |
sewardj | 3b29048 | 2011-05-06 21:02:55 +0000 | [diff] [blame] | 60 | debugging valgrind internals monitor commands: |
philippe | 6ec8d63 | 2013-01-23 22:10:28 +0000 | [diff] [blame] | 61 | v.do expensive_sanity_check_general : do an expensive sanity check now |
sewardj | 30b3eca | 2011-06-28 08:20:39 +0000 | [diff] [blame] | 62 | v.info gdbserver_status : show gdbserver status |
philippe | 93a6a8d | 2012-04-27 22:59:43 +0000 | [diff] [blame] | 63 | v.info memory [aspacemgr] : show valgrind heap memory stats |
| 64 | (with aspacemgr arg, also shows valgrind segments on log ouput) |
philippe | 53bc8bc | 2013-01-10 22:35:33 +0000 | [diff] [blame] | 65 | v.info exectxt : show stacktraces and stats of all execontexts |
sewardj | d6e13d8 | 2011-10-22 20:23:30 +0000 | [diff] [blame] | 66 | v.info scheduler : show valgrind thread state and stacktrace |
philippe | 8587b54 | 2013-12-15 20:24:43 +0000 | [diff] [blame] | 67 | v.info stats : show various valgrind and tool stats |
sewardj | 30b3eca | 2011-06-28 08:20:39 +0000 | [diff] [blame] | 68 | v.set debuglog <level> : set valgrind debug log level to <level> |
philippe | 180a750 | 2014-04-20 13:41:10 +0000 | [diff] [blame] | 69 | v.set hostvisibility [yes*|no] : (en/dis)ables access by gdb/gdbserver to |
| 70 | Valgrind internal host status/memory |
sewardj | 30b3eca | 2011-06-28 08:20:39 +0000 | [diff] [blame] | 71 | v.translate <addr> [<traceflags>] : debug translation of <addr> with <traceflags> |
sewardj | 3b29048 | 2011-05-06 21:02:55 +0000 | [diff] [blame] | 72 | (default traceflags 0b00100000 : show after instrumentation) |
| 73 | An additional flag 0b100000000 allows to show gdbserver instrumentation |
sewardj | 3b29048 | 2011-05-06 21:02:55 +0000 | [diff] [blame] | 74 | memcheck monitor commands: |
sewardj | 30b3eca | 2011-06-28 08:20:39 +0000 | [diff] [blame] | 75 | get_vbits <addr> [<len>] |
sewardj | 3b29048 | 2011-05-06 21:02:55 +0000 | [diff] [blame] | 76 | returns validity bits for <len> (or 1) bytes at <addr> |
| 77 | bit values 0 = valid, 1 = invalid, __ = unaddressable byte |
sewardj | 30b3eca | 2011-06-28 08:20:39 +0000 | [diff] [blame] | 78 | Example: get_vbits 0x........ 10 |
| 79 | make_memory [noaccess|undefined |
| 80 | |defined|Definedifaddressable] <addr> [<len>] |
sewardj | 3b29048 | 2011-05-06 21:02:55 +0000 | [diff] [blame] | 81 | mark <len> (or 1) bytes at <addr> with the given accessibility |
sewardj | 30b3eca | 2011-06-28 08:20:39 +0000 | [diff] [blame] | 82 | check_memory [addressable|defined] <addr> [<len>] |
sewardj | 3b29048 | 2011-05-06 21:02:55 +0000 | [diff] [blame] | 83 | check that <len> (or 1) bytes at <addr> have the given accessibility |
| 84 | and outputs a description of <addr> |
philippe | 2193a7c | 2012-12-08 17:54:16 +0000 | [diff] [blame] | 85 | leak_check [full*|summary] |
| 86 | [kinds kind1,kind2,...|reachable|possibleleak*|definiteleak] |
philippe | ab1fce9 | 2013-09-29 13:47:32 +0000 | [diff] [blame] | 87 | [heuristics heur1,heur2,...] |
sewardj | c8bd1df | 2011-06-26 12:41:33 +0000 | [diff] [blame] | 88 | [increased*|changed|any] |
philippe | 8423490 | 2012-01-14 13:53:13 +0000 | [diff] [blame] | 89 | [unlimited*|limited <max_loss_records_output>] |
sewardj | 3b29048 | 2011-05-06 21:02:55 +0000 | [diff] [blame] | 90 | * = defaults |
sewardj | 122f6af | 2014-09-03 21:58:54 +0000 | [diff] [blame] | 91 | where kind is one of: |
| 92 | definite indirect possible reachable all none |
| 93 | where heur is one of: |
| 94 | stdstring length64 newarray multipleinheritance all none* |
| 95 | Examples: leak_check |
| 96 | leak_check summary any |
| 97 | leak_check full kinds indirect,possible |
| 98 | leak_check full reachable any limited 100 |
philippe | a22f59d | 2012-01-26 23:13:52 +0000 | [diff] [blame] | 99 | block_list <loss_record_nr> |
| 100 | after a leak search, shows the list of blocks of <loss_record_nr> |
| 101 | who_points_at <addr> [<len>] |
| 102 | shows places pointing inside <len> (default 1) bytes at <addr> |
| 103 | (with len 1, only shows "start pointers" pointing exactly to <addr>, |
| 104 | with len > 1, will also show "interior pointers") |
sewardj | 3b29048 | 2011-05-06 21:02:55 +0000 | [diff] [blame] | 105 | monitor command request to kill this process |