1 # Copyright 1998, 1999, 2000, 2001, 2002, 2003, 2007, 2008, 2009, 2010, 2011
2 # Free Software Foundation, Inc.
4 # This program is free software; you can redistribute it and/or modify
5 # it under the terms of the GNU General Public License as published by
6 # the Free Software Foundation; either version 3 of the License, or
7 # (at your option) any later version.
9 # This program is distributed in the hope that it will be useful,
10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 # GNU General Public License for more details.
14 # You should have received a copy of the GNU General Public License
15 # along with this program. If not, see <http://www.gnu.org/licenses/>.
17 # This file was written by Elena Zannoni (ezannoni@cygnus.com)
19 # this file tests maintenance commands and help on those.
21 # source file used is break.c
24 #maintenance check-symtabs -- Check consistency of psymtabs and symtabs
25 #maintenance space -- Set the display of space usage
26 #maintenance set -- Set GDB internal variables used by the GDB maintainer
27 #maintenance show -- Show GDB internal variables used by the GDB maintainer
28 #maintenance time -- Set the display of time usage
29 #maintenance demangle -- Demangle a C++ mangled name
30 #maintenance dump-me -- Get fatal error; make debugger dump its core
31 #maintenance print -- Maintenance command for printing GDB internal state
32 #maintenance info -- Commands for showing internal info about the program being debugged
33 #maintenance internal-error -- Give GDB an internal error.
35 #maintenance print dummy-frames -- Print the dummy frame stack
36 #maintenance print statistics -- Print statistics about internal gdb state
37 #maintenance print objfiles -- Print dump of current object file definitions
38 #maintenance print psymbols -- Print dump of current partial symbol definitions
39 #maintenance print msymbols -- Print dump of current minimal symbol definitions
40 #maintenance print symbols -- Print dump of current symbol definitions
41 #maintenance print type -- Print a type chain for a given symbol
42 #maintenance print unwind -- Print unwind table entry at given address
45 #maintenance info sections -- List the BFD sections of the exec and core files
46 #maintenance info breakpoints -- Status of all breakpoints
58 set srcfile ${testfile}.c
59 set srcfile1 ${testfile}1.c
60 set binfile ${objdir}/${subdir}/${testfile}
62 if { [gdb_compile "${srcdir}/${subdir}/${srcfile}" "${binfile}0.o" object {debug nowarnings}] != "" } {
67 if { [gdb_compile "${srcdir}/${subdir}/${srcfile1}" "${binfile}1.o" object {debug nowarnings}] != "" } {
72 if { [gdb_compile "${binfile}0.o ${binfile}1.o" "${binfile}" executable {debug nowarnings}] != "" } {
80 gdb_reinitialize_dir $srcdir/$subdir
82 # The commands we test here produce many lines of output; disable "press
83 # <return> to continue" prompts.
84 gdb_test_no_output "set height 0"
86 # Tests that require that no program is running
88 gdb_file_cmd ${binfile}
90 # Test for a regression where this command would internal-error if the
91 # program wasn't running.
92 gdb_test "maint print registers" "Name.*Nr.*Rel.*Offset.*Size.*Type.*"
94 # Tests that can or should be done with a running program
98 if ![runto_main] then {
99 perror "tests suppressed"
104 # this command does not produce any output
105 # unless there is some problem with the symtabs and psymtabs
106 # so that branch will really never be covered in this tests here!!
109 # guo: on linux this command output is huge. for some reason splitting up
110 # the regexp checks works.
112 send_gdb "maint check-symtabs\n"
114 -re "^maint check-symtabs" {
116 -re "$gdb_prompt $" {
117 pass "maint check-symtabs"
119 timeout { fail "(timeout) maint check-symtabs" }
122 -re ".*$gdb_prompt $" { fail "maint check-symtabs" }
123 timeout { fail "(timeout) maint check-symtabs" }
126 gdb_test "maint space" \
127 "\"maintenance space\" takes a numeric argument\\."
129 gdb_test "maint space 1" \
130 "Space used: $decimal \\(\\+$decimal for this command\\)"
132 gdb_test "maint time" \
133 "\"maintenance time\" takes a numeric argument\\..*Space used: $decimal \\(\\+$decimal for this command\\)"
135 gdb_test "maint time 1" \
136 "Command execution time: $decimal.*Space used: $decimal \\(\\+$decimal for this command\\)"
138 gdb_test "maint time 0" \
139 "Space used: $decimal \\(\\+$decimal for this command\\)"
141 gdb_test_no_output "maint space 0"
143 gdb_test "maint demangle" \
144 "\"maintenance demangle\" takes an argument to demangle\\."
146 gdb_test "maint demangle main" "Can't demangle \"main\""
150 # The timeout value is raised, because printing all the symbols and
151 # statistical information about Cygwin and Windows libraries takes a lot
153 if [istarget "*-*-cygwin*"] {
154 set oldtimeout $timeout
155 set timeout [expr $timeout + 500]
158 send_gdb "maint print statistics\n"
160 -re "Statistics for\[^\n\r\]*break\[^\n\r\]*:\r\n Number of \"minimal\" symbols read: $decimal\r\n Number of \"partial\" symbols read: $decimal\r\n Number of \"full\" symbols read: $decimal\r\n Number of \"types\" defined: $decimal\r\n Number of psym tables \\(not yet expanded\\): $decimal\r\n Number of symbol tables: $decimal\r\n Number of symbol tables with line tables: $decimal\r\n Number of symbol tables with blockvectors: $decimal\r\n Total memory used for objfile obstack: $decimal\r\n Total memory used for psymbol cache: $decimal\r\n Total memory used for macro cache: $decimal\r\n Total memory used for file name cache: $decimal\r\n" {
162 -re "$gdb_prompt $" {
163 pass "maint print statistics"
165 timeout { fail "(timeout) maint print statistics" }
168 -re ".*$gdb_prompt $" { fail "maint print statistics" }
169 timeout { fail "(timeout) maint print statistics" }
172 # There aren't any ...
173 gdb_test_no_output "maint print dummy-frames"
175 send_gdb "maint print objfiles\n"
177 # To avoid timeouts, we avoid expects with many .* patterns that match
178 # many lines. Instead, we keep track of which milestones we've seen
179 # in the output, and stop when we've seen all of them.
186 while {$keep_looking} {
189 -re ".*Object file.*break($EXEEXT)?: Objfile at $hex, bfd at $hex, \[0-9\]* minsyms\[\r\t \]+\n" { set header 1 }
190 -re ".*Psymtabs:\[\r\t \]+\n" { set psymtabs 1 }
191 -re ".*Symtabs:\[\r\t \]+\n" { set symtabs 1 }
193 -re ".*$gdb_prompt $" {
197 fail "(timeout) maint print objfiles"
203 proc maint_pass_if {val name} {
204 if $val { pass $name } else { fail $name }
207 maint_pass_if $header "maint print objfiles: header"
208 maint_pass_if $psymtabs "maint print objfiles: psymtabs"
209 maint_pass_if $symtabs "maint print objfiles: symtabs"
211 gdb_test "maint print psymbols" \
212 "print-psymbols takes an output file name and optional symbol file name" \
213 "maint print psymbols w/o args"
217 send_gdb "maint print psymbols psymbols_output ${srcdir}/${subdir}/${srcfile}\n"
219 -re "^maint print psymbols psymbols_output \[^\n\]*\r\n$gdb_prompt $" {
220 send_gdb "shell ls psymbols_output\n"
222 -re "psymbols_output\r\n$gdb_prompt $" {
223 # We want this grep to be as specific as possible,
224 # so it's less likely to match symbol file names in
225 # psymbols_output. Yes, this actually happened;
226 # poor expect got tons of output, and timed out
227 # trying to match it. --- Jim Blandy <jimb@cygnus.com>
228 send_gdb "shell grep 'main.*function' psymbols_output\n"
230 -re ".main., function, $hex.*$gdb_prompt $" {
231 pass "maint print psymbols 1"
233 -re ".*main. .., function, $hex.*$gdb_prompt $" {
234 pass "maint print psymbols 2"
236 -re ".*$gdb_prompt $" { fail "maint print psymbols" }
237 timeout { fail "(timeout) maint print psymbols" }
239 gdb_test "shell rm -f psymbols_output" ".*"
241 -re ".*$gdb_prompt $" { fail "maint print psymbols" }
242 timeout { fail "(timeout) maint print psymbols" }
245 -re ".*$gdb_prompt $" { fail "maint print psymbols" }
246 timeout { fail "(timeout) maint print psymbols" }
249 gdb_test "maint print msymbols" \
250 "print-msymbols takes an output file name and optional symbol file name" \
251 "maint print msymbols w/o args"
254 send_gdb "maint print msymbols msymbols_output ${binfile}\n"
256 -re "^maint print msymbols msymbols_output \[^\n\]*\r\n$gdb_prompt $" {
257 send_gdb "shell ls msymbols_output\n"
259 -re "msymbols_output\r\n$gdb_prompt $" {
260 send_gdb "shell grep factorial msymbols_output\n"
262 -re "\\\[ *$decimal\\\] \[tT\]\[ \t\]+$hex \\.?factorial.*$gdb_prompt $" {
263 pass "maint print msymbols"
265 -re ".*$gdb_prompt $" { fail "maint print msymbols" }
266 timeout { fail "(timeout) maint print msymbols" }
268 gdb_test "shell rm -f msymbols_output" ".*"
270 -re ".*$gdb_prompt $" { fail "maint print msymbols" }
271 timeout { fail "(timeout) maint print msymbols" }
274 -re ".*$gdb_prompt $" { fail "maint print msymbols" }
275 timeout { fail "(timeout) maint print msymbols" }
278 # Check that maint print msymbols allows relative pathnames
280 gdb_test "cd ${objdir}" \
281 "Working directory [string_to_regexp ${objdir}]\..*" \
284 gdb_test_multiple "maint print msymbols msymbols_output2 ${subdir}/${testfile}" "maint print msymbols" {
285 -re "^maint print msymbols msymbols_output2 \[^\n\]*\r\n$gdb_prompt $" {
286 gdb_test_multiple "shell ls msymbols_output2" "maint print msymbols" {
287 -re "msymbols_output2\r\n$gdb_prompt $" {
288 gdb_test_multiple "shell grep factorial msymbols_output2" "maint print msymbols" {
289 -re "\\\[ *$decimal\\\] \[tT\]\[ \t\]+$hex \\.?factorial.*$gdb_prompt $" {
290 pass "maint print msymbols"
292 -re ".*$gdb_prompt $" {
293 fail "maint print msymbols"
296 fail "(timeout) maint print msymbols"
299 gdb_test "shell rm -f msymbols_output2" ".*"
301 -re ".*$gdb_prompt $" {
302 fail "maint print msymbols"
305 fail "(timeout) maint print msymbols"
309 -re ".*$gdb_prompt $" {
310 fail "maint print msymbols"
313 fail "(timeout) maint print msymbols"
316 gdb_test "cd ${mydir}" \
317 "Working directory [string_to_regexp ${mydir}]\..*" \
320 gdb_test "maint print symbols" \
321 "Arguments missing: an output file name and an optional symbol file name" \
322 "maint print symbols w/o args"
325 # Request symbols for one particular source file so that we don't try to
326 # dump the symbol information for the entire C library - over 500MB nowadays
329 send_gdb "maint print symbols symbols_output ${srcdir}/${subdir}/${srcfile}\n"
331 -re "^maint print symbols symbols_output \[^\n\]*\r\n$gdb_prompt $" {
332 send_gdb "shell ls symbols_output\n"
334 -re "symbols_output\r\n$gdb_prompt $" {
335 # See comments for `maint print psymbols'.
336 send_gdb "shell grep 'main(.*block' symbols_output\n"
338 -re "int main\\(int, char \\*\\*, char \\*\\*\\); block.*$gdb_prompt $" {
339 pass "maint print symbols"
341 -re ".*$gdb_prompt $" { fail "maint print symbols" }
342 timeout { fail "(timeout) maint print symbols" }
344 gdb_test "shell rm -f symbols_output" ".*"
346 -re ".*$gdb_prompt $" { fail "maint print symbols" }
347 timeout { fail "(timeout) maint print symbols" }
350 -re ".*$gdb_prompt $" { fail "maint print symbols" }
351 timeout { fail "(timeout) maint print symbols" }
354 set msg "maint print type"
355 gdb_test_multiple "maint print type argc" $msg {
356 -re "type node $hex\r\nname .int. \\($hex\\)\r\ntagname .<NULL>. \\($hex\\)\r\ncode $hex \\(TYPE_CODE_INT\\)\r\nlength \[24\]\r\nobjfile $hex\r\ntarget_type $hex\r\npointer_type $hex\r\nreference_type $hex\r\ntype_chain $hex\r\ninstance_flags $hex\r\nflags\r\nnfields 0 $hex\r\nvptr_basetype $hex\r\nvptr_fieldno -1\r\n$gdb_prompt $" {
361 if [istarget "hppa*-*-11*"] {
362 setup_xfail hppa*-*-*11* CLLbs14860
363 gdb_test_multiple "maint print unwind &main" "maint print unwind" {
364 -re ".*unwind_table_entry \\($hex\\):\r\n\tregion_start = $hex <main>\r\n\tregion_end = $hex <main\\+\[0-9\]*>\r\n\tflags = Args_stored Save_RP\r\n\tRegion_description = $hex\r\n\tEntry_FR = $hex\r\n\tEntry_GR = $hex\r\n\tTotal_frame_size = $hex\r\n$gdb_prompt $" {
365 pass "maint print unwind"
367 -re ".*unwind_table_entry \\($hex\\):\r\n\tregion_start = $hex <main>\r\n\tregion_end = $hex <main\\+\[0-9\]*>\r\n\tflags = Args_stored Save_RP\r\n\tFLD = $hex\r\n\tFLD = $hex\r\n\tFLD = $hex\r\n\tFLD = $hex\r\n$gdb_prompt $" {
368 xfail "maint print unwind"
373 set oldtimeout $timeout
374 set timeout [expr $timeout + 300]
376 # It'd be nice to check for every possible section. However, that's
377 # problematic, since the relative ordering wanders from release to
378 # release of the compilers. Instead, we'll just check for two
379 # sections which appear to always come out in the same relative
380 # order. (If that changes, then we should just check for one
383 # And by the way: This testpoint will break for PA64, where a.out's
386 # Standard GNU names.
387 set text_section ".text"
388 set data_section ".data"
390 gdb_test_multiple "maint info sections" "maint info sections" {
391 -re "Exec file:\r\n.*break($EXEEXT)?., file type.*ER_RO.*$gdb_prompt $" {
392 # Looks like RealView which uses different section names.
393 set text_section ER_RO
394 set data_section ER_RW
395 pass "maint info sections"
397 -re "Exec file:\r\n.*break($EXEEXT)?., file type.*neardata.*$gdb_prompt $" {
398 # c6x doesn't have .data section. It has .neardata and .fardata section.
399 set data_section ".neardata"
400 pass "maint info sections"
402 -re "Exec file:\r\n.*break($EXEEXT)?., file type.*$gdb_prompt $" {
403 pass "maint info sections"
407 # Test for new option: maint info sections <section name>
408 # If you don't have a .text section, this will require tweaking.
410 gdb_test_multiple "maint info sections $text_section" \
411 "maint info sections .text" {
412 -re ".* \\.bss .*$gdb_prompt $" {
413 fail "maint info sections .text"
415 -re ".* $data_section .*$gdb_prompt $" {
416 fail "maint info sections .text"
418 -re ".* $text_section .*$gdb_prompt $" {
419 pass "maint info sections .text"
423 # Test for new option: CODE section flag
424 # If your data section is tagged CODE, xfail this test.
426 gdb_test_multiple "maint info sections CODE" "maint info sections CODE" {
427 -re ".* $data_section .*$gdb_prompt $" { fail "maint info sections CODE" }
428 -re ".* $text_section .*$gdb_prompt $" { pass "maint info sections CODE" }
431 # Test for new option: DATA section flag
432 # If your text section is tagged DATA, xfail this test.
434 # The "maint info sections DATA" test is marked for XFAIL on Windows,
435 # because Windows has text sections marked DATA.
436 setup_xfail "*-*-*cygwin*"
437 setup_xfail "*-*-*mingw*"
439 gdb_test_multiple "maint info sections DATA" "maint info sections DATA" {
440 -re ".* $text_section .*$gdb_prompt $" { fail "maint info sections DATA" }
441 -re ".* $data_section .*$gdb_prompt $" { pass "maint info sections DATA" }
442 -re ".* .rodata .*$gdb_prompt $" { pass "maint info sections DATA" }
445 set bp_location6 [gdb_get_line_number "set breakpoint 6 here"]
447 gdb_test_multiple "maint info breakpoints" "maint info breakpoints" {
448 -re "Num\[ \t\]+Type\[ \t\]+Disp\[ \t\]+Enb\[ \t\]+Address\[ \t\]+What\r\n1\[ \t\]+breakpoint\[ \t\]+keep\[ \t\]+y\[ \t\]+$hex\[ \t\]+in main at.*break.c:$bp_location6 inf 1\r\n\[ \t\]+breakpoint already hit 1 time\r\n.*$gdb_prompt $" {
449 pass "maint info breakpoints"
451 -re "Num\[ \t\]+Type\[ \t\]+Disp\[ \t\]+Enb\[ \t\]+Address\[ \t\]+What\r\n1\[ \t\]+breakpoint\[ \t\]+keep\[ \t\]+y\[ \t\]+$hex in main at.*break.c:$bp_location6 sspace 1\r\n\[ \t\]+breakpoint already hit 1 time\r\n-1\[ \t\]+shlib events\[ \t\]+keep\[ \t\]+y\[ \t\]+$hex.*breakpoint already hit.*$gdb_prompt $" {
452 pass "maint info breakpoints (with shlib events)"
456 gdb_test "maint print" \
457 "\"maintenance print\" must be followed by the name of a print command\\.\r\nList.*unambiguous\\..*" \
458 "maint print w/o args"
460 gdb_test "maint info" \
461 "\"maintenance info\" must be followed by the name of an info command\\.\r\nList.*unambiguous\\..*" \
462 "maint info w/o args"
465 "\"maintenance\" must be followed by the name of a maintenance command\\.\r\nList.*unambiguous\\..*" \
468 set timeout $oldtimeout
470 #============test help on maint commands
472 gdb_test "help maint" \
473 "Commands for use by GDB maintainers\\..*Includes commands to dump specific internal GDB structures in.*a human readable form, to cause GDB to deliberately dump core,.*to test internal functions such as the C../ObjC demangler, etc\\..*List of maintenance subcommands:.*maintenance check-symtabs.*maintenance demangle.*(maintenance dump-me.*)?maintenance info.*maintenance internal-error.*maintenance print.*maintenance set.*maintenance show.*maintenance space.*maintenance time.*Type.*help maintenance.*followed by maintenance subcommand name for full documentation\\..*Command name abbreviations are allowed if unambiguous\\..*"
475 gdb_test "help maint check-symtabs" \
476 "Check consistency of psymtabs and symtabs\\..*"
478 gdb_test "help maint space" \
479 "Set the display of space usage\\.\r\nIf nonzero, will cause the execution space for each command to be\r\ndisplayed, following the command's output\\..*"
481 gdb_test "help maint time" \
482 "Set the display of time usage\\.\r\nIf nonzero, will cause the execution time for each command to be\r\ndisplayed, following the command's output\\..*"
484 gdb_test "help maint demangle" \
485 "Demangle a C\\+\\+/ObjC mangled name\\.\r\nCall internal GDB demangler routine to demangle a C\\+\\+ link name\r\nand prints the result\\..*"
487 gdb_test "help maint dump-me" \
488 "Get fatal error; make debugger dump its core\\.\r\nGDB sets its handling of SIGQUIT back to SIG_DFL and then sends\r\nitself a SIGQUIT signal\\..*"
490 gdb_test "help maint internal-error" \
491 "Give GDB an internal error\\.\r\nCause GDB to behave as if an internal error was detected\\..*"
493 gdb_test "help maint internal-warning" \
494 "Give GDB an internal warning\\.\r\nCause GDB to behave as if an internal warning was reported\\..*"
496 gdb_test "help maint print statistics" \
497 "Print statistics about internal gdb state\\..*"
499 gdb_test "help maint print dummy-frames" \
500 "Print the contents of the internal dummy-frame stack."
502 gdb_test "help maint print objfiles" \
503 "Print dump of current object file definitions\\..*"
505 gdb_test "help maint print psymbols" \
506 "Print dump of current partial symbol definitions\\.\r\nEntries in the partial symbol table are dumped to file OUTFILE\\.\r\nIf a SOURCE file is specified, dump only that file's partial symbols\\..*"
508 gdb_test "help maint print msymbols" \
509 "Print dump of current minimal symbol definitions\\.\r\nEntries in the minimal symbol table are dumped to file OUTFILE\\.\r\nIf a SOURCE file is specified, dump only that file's minimal symbols\\..*"
511 gdb_test "help maint print symbols" \
512 "Print dump of current symbol definitions\\.\r\nEntries in the full symbol table are dumped to file OUTFILE\\.\r\nIf a SOURCE file is specified, dump only that file's symbols\\..*"
514 gdb_test "help maint print type" \
515 "Print a type chain for a given symbol\\.\r\nFor each node in a type chain, print the raw data for each member of\r\nthe type structure, and the interpretation of the data\\..*"
517 if [istarget "hppa*-*-*"] {
518 gdb_test "help maint print unwind" \
519 "Print unwind table entry at given address\\..*"
522 gdb_test "help maint info sections" \
523 "List the BFD sections of the exec and core files\\..*"
525 gdb_test "help maint info breakpoints" \
526 "Status of all breakpoints, or breakpoint number NUMBER.*"
529 #send_gdb "help maint info breakpoints\n"
531 # -re "Status of all breakpoints, or breakpoint number NUMBER\\.\[ \r\n\t\]+The \"Type\" column indicates one of:\[ \r\n\t\]+breakpoint\[ \t\]+- normal breakpoint\[ \r\n\t\]+watchpoint\[ \t\]+- watchpoint\[ \r\n\t\]+longjmp\[ \t\]+- internal breakpoint used to step through longjmp\\(\\)\[ \r\n\t\]+longjmp resume - internal breakpoint at the target of longjmp\\(\\)\[ \r\n\t\]+until\[ \t\]+- internal breakpoint used by the \"until\" command\[ \r\n\t\]+finish\[ \t\]+- internal breakpoint used by the \"finish\" command\[ \r\n\t\]+The \"Disp\" column contains one of \"keep\", \"del\", or \"dis\" to indicate\[ \r\n\t\]+the disposition of the breakpoint after it gets hit\\. \"dis\" means that the\[ \r\n\t\]+breakpoint will be disabled\\. The \"Address\" and \"What\" columns indicate the\[ \r\n\t\]+address and file.line number respectively\\.\[ \r\n\t\]+Convenience variable \".*\" and default examine address for \"x\"\[ \r\n\t\]+are set to the address of the last breakpoint listed\\.\[ \r\n\t\]+Convenience variable \".bpnum\" contains the number of the last\[ \r\n\t\]+breakpoint set\\..*$gdb_prompt $"\
532 # { pass "help maint info breakpoints" }
533 # -re ".*$gdb_prompt $" { fail "help maint info breakpoints" }
534 # timeout { fail "(timeout) help maint info breakpoints" }
537 gdb_test "help maint info" \
538 "Commands for showing internal info about the program being debugged.*unambiguous\\..*"
540 test_prefix_command_help {"maint print" "maintenance print"} {
541 "Maintenance command for printing GDB internal state\\.\[\r\n\]+"
544 test_prefix_command_help {"maint" "maintenance"} {
545 "Commands for use by GDB maintainers\\.\[\r\n\]+"
546 "Includes commands to dump specific internal GDB structures in\[\r\n\]+"
547 "a human readable form, to cause GDB to deliberately dump core,\[\r\n\]+"
548 "to test internal functions such as the C\\+\\+/ObjC demangler, etc\\.\[\r\n\]+"
551 #set oldtimeout $timeout
552 #set timeout [expr $timeout + 300]
554 gdb_test_multiple "maint dump-me" "maint dump-me" {
555 -re "Should GDB dump core.*\\(y or n\\) $" {
556 gdb_test "n" ".*" "maint dump-me"
560 send_gdb "maint internal-error\n"
562 -re "A problem internal to GDB has been detected" {
563 pass "maint internal-error"
564 if [gdb_internal_error_resync] {
565 pass "internal-error resync"
567 fail "internal-error resync"
570 -re ".*$gdb_prompt $" {
571 fail "maint internal-error"
572 untested "internal-error resync"
575 fail "maint internal-error (timeout)"
576 untested "internal-error resync"
580 #set timeout $oldtimeout