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