1 # Copyright 1998-2013 Free Software Foundation, Inc.
3 # This program is free software; you can redistribute it and/or modify
4 # it under the terms of the GNU General Public License as published by
5 # the Free Software Foundation; either version 3 of the License, or
6 # (at your option) any later version.
8 # This program is distributed in the hope that it will be useful,
9 # but WITHOUT ANY WARRANTY; without even the implied warranty of
10 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 # GNU General Public License for more details.
13 # You should have received a copy of the GNU General Public License
14 # along with this program. If not, see <http://www.gnu.org/licenses/>.
16 # This file was written by Elena Zannoni (ezannoni@cygnus.com)
18 # this file tests maintenance commands and help on those.
20 # source file used is break.c
23 #maintenance check-psymtabs -- Check consistency of psymtabs vs symtabs
24 #maintenance check-symtabs -- Check consistency of symtabs
25 #maintenance expand-symtabs -- Expand symtabs matching a file regexp
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 demangle -- Demangle a C++ mangled name
29 #maintenance dump-me -- Get fatal error; make debugger dump its core
30 #maintenance print -- Maintenance command for printing GDB internal state
31 #maintenance info -- Commands for showing internal info about the program being debugged
32 #maintenance internal-error -- Give GDB an internal error.
34 #maintenance print dummy-frames -- Print the dummy frame stack
35 #maintenance print statistics -- Print statistics about internal gdb state
36 #maintenance print objfiles -- Print dump of current object file definitions
37 #maintenance print psymbols -- Print dump of current partial symbol definitions
38 #maintenance print msymbols -- Print dump of current minimal symbol definitions
39 #maintenance print symbols -- Print dump of current symbol definitions
40 #maintenance print type -- Print a type chain for a given symbol
41 #maintenance print unwind -- Print unwind table entry at given address
44 #maintenance info sections -- List the BFD sections of the exec and core files
45 #maintenance info breakpoints -- Status of all breakpoints
51 set srcfile ${testfile}.c
52 set srcfile1 ${testfile}1.c
53 set binfile ${objdir}/${subdir}/${testfile}
55 if { [gdb_compile "${srcdir}/${subdir}/${srcfile}" "${binfile}0.o" object {debug nowarnings}] != "" } {
60 if { [gdb_compile "${srcdir}/${subdir}/${srcfile1}" "${binfile}1.o" object {debug nowarnings}] != "" } {
65 if { [gdb_compile "${binfile}0.o ${binfile}1.o" "${binfile}" executable {debug nowarnings}] != "" } {
73 gdb_reinitialize_dir $srcdir/$subdir
75 # The commands we test here produce many lines of output; disable "press
76 # <return> to continue" prompts.
77 gdb_test_no_output "set height 0"
79 # Tests that require that no program is running
81 gdb_file_cmd ${binfile}
83 # Test for a regression where this command would internal-error if the
84 # program wasn't running.
85 gdb_test "maint print registers" "Name.*Nr.*Rel.*Offset.*Size.*Type.*"
87 # Test "mt expand-symtabs" here as it's easier to verify before we
89 gdb_test_no_output "mt set per on" "mt set per on for expand-symtabs"
90 gdb_test_multiple "mt expand-symtabs $subdir/break\[.\]c$" \
92 -re "#primary symtabs: 1 \\(\[+\]1\\),.*$gdb_prompt $" {
93 # This should expand exactly one (primary) symtab.
94 pass "mt expand-symtabs"
97 gdb_test "mt set per off" ".*" "mt set per off for expand-symtabs"
99 # Tests that can or should be done with a running program
103 if ![runto_main] then {
104 perror "tests suppressed"
107 # If we're using .gdb_index there will be no psymtabs.
109 gdb_test_multiple "maint info sections .gdb_index" "check for .gdb_index" {
110 -re ": .gdb_index.*$gdb_prompt $" {
113 -re ".*$gdb_prompt $" {
114 ;# Nothing to do, present to avoid a FAIL.
119 # this command does not produce any output
120 # unless there is some problem with the symtabs and psymtabs
121 # so that branch will really never be covered in this tests here!!
124 # guo: on linux this command output is huge. for some reason splitting up
125 # the regexp checks works.
127 send_gdb "maint check-psymtabs\n"
129 -re "^maint check-psymtabs" {
131 -re "$gdb_prompt $" {
132 pass "maint check-psymtabs"
134 timeout { fail "(timeout) maint check-psymtabs" }
137 -re ".*$gdb_prompt $" { fail "maint check-psymtabs" }
138 timeout { fail "(timeout) maint check-psymtabs" }
141 # This command does not produce any output unless there is some problem
142 # with the symtabs, so that branch will really never be covered in the
144 gdb_test_no_output "maint check-symtabs"
146 gdb_test_no_output "maint set per-command on"
148 gdb_test "maint set per-command off" \
149 "Command execution time: \[0-9.\]+ \\(cpu\\), \[0-9.\]+ \\(wall\\)\[\r\n\]+Space used: $decimal \\(\\+$decimal for this command\\)\[\r\n\]+#symtabs: $decimal \\(\\+$decimal\\), #primary symtabs: $decimal \\(\\+$decimal\\), #blocks: $decimal \\(\\+$decimal\\)"
151 gdb_test "maint demangle" \
152 "\"maintenance demangle\" takes an argument to demangle\\."
154 gdb_test "maint demangle main" "Can't demangle \"main\""
158 # The timeout value is raised, because printing all the symbols and
159 # statistical information about Cygwin and Windows libraries takes a lot
161 if [istarget "*-*-cygwin*"] {
162 set oldtimeout $timeout
163 set timeout [expr $timeout + 500]
166 send_gdb "maint print statistics\n"
168 -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 read CUs: $decimal\r\n Number of unread CUs: $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 BFD 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" {
170 -re "$gdb_prompt $" {
171 pass "maint print statistics"
173 timeout { fail "(timeout) maint print statistics" }
176 -re ".*$gdb_prompt $" { fail "maint print statistics" }
177 timeout { fail "(timeout) maint print statistics" }
180 # There aren't any ...
181 gdb_test_no_output "maint print dummy-frames"
183 send_gdb "maint print objfiles\n"
185 # To avoid timeouts, we avoid expects with many .* patterns that match
186 # many lines. Instead, we keep track of which milestones we've seen
187 # in the output, and stop when we've seen all of them.
194 while {$keep_looking} {
197 -re ".*Object file.*break($EXEEXT)?: Objfile at $hex, bfd at $hex, \[0-9\]* minsyms\[\r\t \]+\n" { set header 1 }
198 -re ".*Psymtabs:\[\r\t \]+\n" { set psymtabs 1 }
199 -re ".*Symtabs:\[\r\t \]+\n" { set symtabs 1 }
201 -re ".*$gdb_prompt $" {
205 fail "(timeout) maint print objfiles"
211 proc maint_pass_if {val name} {
212 if $val { pass $name } else { fail $name }
215 maint_pass_if $header "maint print objfiles: header"
216 if { ! $have_gdb_index } {
217 maint_pass_if $psymtabs "maint print objfiles: psymtabs"
219 maint_pass_if $symtabs "maint print objfiles: symtabs"
221 gdb_test "maint print psymbols" \
222 "print-psymbols takes an output file name and optional symbol file name" \
223 "maint print psymbols w/o args"
225 if { ! $have_gdb_index } {
226 send_gdb "maint print psymbols psymbols_output ${srcdir}/${subdir}/${srcfile}\n"
228 -re "^maint print psymbols psymbols_output \[^\n\]*\r\n$gdb_prompt $" {
229 send_gdb "shell ls psymbols_output\n"
231 -re "psymbols_output\r\n$gdb_prompt $" {
232 # We want this grep to be as specific as possible,
233 # so it's less likely to match symbol file names in
234 # psymbols_output. Yes, this actually happened;
235 # poor expect got tons of output, and timed out
236 # trying to match it. --- Jim Blandy <jimb@cygnus.com>
237 send_gdb "shell grep 'main.*function' psymbols_output\n"
239 -re ".main., function, $hex.*$gdb_prompt $" {
240 pass "maint print psymbols 1"
242 -re ".*main. .., function, $hex.*$gdb_prompt $" {
243 pass "maint print psymbols 2"
245 -re ".*$gdb_prompt $" { fail "maint print psymbols" }
246 timeout { fail "(timeout) maint print psymbols" }
248 gdb_test "shell rm -f psymbols_output" ".*"
250 -re ".*$gdb_prompt $" { fail "maint print psymbols" }
251 timeout { fail "(timeout) maint print psymbols" }
254 -re ".*$gdb_prompt $" { fail "maint print psymbols" }
255 timeout { fail "(timeout) maint print psymbols" }
259 gdb_test "maint print msymbols" \
260 "print-msymbols takes an output file name and optional symbol file name" \
261 "maint print msymbols w/o args"
264 send_gdb "maint print msymbols msymbols_output ${binfile}\n"
266 -re "^maint print msymbols msymbols_output \[^\n\]*\r\n$gdb_prompt $" {
267 send_gdb "shell ls msymbols_output\n"
269 -re "msymbols_output\r\n$gdb_prompt $" {
270 send_gdb "shell grep factorial msymbols_output\n"
272 -re "\\\[ *$decimal\\\] \[tT\]\[ \t\]+$hex \\.?factorial.*$gdb_prompt $" {
273 pass "maint print msymbols"
275 -re ".*$gdb_prompt $" { fail "maint print msymbols" }
276 timeout { fail "(timeout) maint print msymbols" }
278 gdb_test "shell rm -f msymbols_output" ".*"
280 -re ".*$gdb_prompt $" { fail "maint print msymbols" }
281 timeout { fail "(timeout) maint print msymbols" }
284 -re ".*$gdb_prompt $" { fail "maint print msymbols" }
285 timeout { fail "(timeout) maint print msymbols" }
288 # Check that maint print msymbols allows relative pathnames
290 gdb_test "cd ${objdir}" \
291 "Working directory [string_to_regexp ${objdir}]\..*" \
294 gdb_test_multiple "maint print msymbols msymbols_output2 ${subdir}/${testfile}" "maint print msymbols" {
295 -re "^maint print msymbols msymbols_output2 \[^\n\]*\r\n$gdb_prompt $" {
296 gdb_test_multiple "shell ls msymbols_output2" "maint print msymbols" {
297 -re "msymbols_output2\r\n$gdb_prompt $" {
298 gdb_test_multiple "shell grep factorial msymbols_output2" "maint print msymbols" {
299 -re "\\\[ *$decimal\\\] \[tT\]\[ \t\]+$hex \\.?factorial.*$gdb_prompt $" {
300 pass "maint print msymbols"
302 -re ".*$gdb_prompt $" {
303 fail "maint print msymbols"
306 fail "(timeout) maint print msymbols"
309 gdb_test "shell rm -f msymbols_output2" ".*"
311 -re ".*$gdb_prompt $" {
312 fail "maint print msymbols"
315 fail "(timeout) maint print msymbols"
319 -re ".*$gdb_prompt $" {
320 fail "maint print msymbols"
323 fail "(timeout) maint print msymbols"
326 gdb_test "cd ${mydir}" \
327 "Working directory [string_to_regexp ${mydir}]\..*" \
330 gdb_test "maint print symbols" \
331 "Arguments missing: an output file name and an optional symbol file name" \
332 "maint print symbols w/o args"
335 # Request symbols for one particular source file so that we don't try to
336 # dump the symbol information for the entire C library - over 500MB nowadays
339 send_gdb "maint print symbols symbols_output ${srcdir}/${subdir}/${srcfile}\n"
341 -re "^maint print symbols symbols_output \[^\n\]*\r\n$gdb_prompt $" {
342 send_gdb "shell ls symbols_output\n"
344 -re "symbols_output\r\n$gdb_prompt $" {
345 # See comments for `maint print psymbols'.
346 send_gdb "shell grep 'main(.*block' symbols_output\n"
348 -re "int main\\(int, char \\*\\*, char \\*\\*\\); block.*$gdb_prompt $" {
349 pass "maint print symbols"
351 -re ".*$gdb_prompt $" { fail "maint print symbols" }
352 timeout { fail "(timeout) maint print symbols" }
354 gdb_test "shell rm -f symbols_output" ".*"
356 -re ".*$gdb_prompt $" { fail "maint print symbols" }
357 timeout { fail "(timeout) maint print symbols" }
360 -re ".*$gdb_prompt $" { fail "maint print symbols" }
361 timeout { fail "(timeout) maint print symbols" }
364 set msg "maint print type"
365 gdb_test_multiple "maint print type argc" $msg {
366 -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 $" {
371 if [istarget "hppa*-*-11*"] {
372 setup_xfail hppa*-*-*11* CLLbs14860
373 gdb_test_multiple "maint print unwind &main" "maint print unwind" {
374 -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 $" {
375 pass "maint print unwind"
377 -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 $" {
378 xfail "maint print unwind"
383 set oldtimeout $timeout
384 set timeout [expr $timeout + 300]
386 # It'd be nice to check for every possible section. However, that's
387 # problematic, since the relative ordering wanders from release to
388 # release of the compilers. Instead, we'll just check for two
389 # sections which appear to always come out in the same relative
390 # order. (If that changes, then we should just check for one
393 # And by the way: This testpoint will break for PA64, where a.out's
396 # Standard GNU names.
397 set text_section ".text"
398 set data_section ".data"
400 gdb_test_multiple "maint info sections" "maint info sections" {
401 -re "Exec file:\r\n.*break($EXEEXT)?., file type.*ER_RO.*$gdb_prompt $" {
402 # Looks like RealView which uses different section names.
403 set text_section ER_RO
404 set data_section ER_RW
405 pass "maint info sections"
407 -re "Exec file:\r\n.*break($EXEEXT)?., file type.*neardata.*$gdb_prompt $" {
408 # c6x doesn't have .data section. It has .neardata and .fardata section.
409 set data_section ".neardata"
410 pass "maint info sections"
412 -re "Exec file:\r\n.*break($EXEEXT)?., file type.*$gdb_prompt $" {
413 pass "maint info sections"
417 # Test for new option: maint info sections <section name>
418 # If you don't have a .text section, this will require tweaking.
420 gdb_test_multiple "maint info sections $text_section" \
421 "maint info sections .text" {
422 -re ".* \\.bss .*$gdb_prompt $" {
423 fail "maint info sections .text"
425 -re ".* $data_section .*$gdb_prompt $" {
426 fail "maint info sections .text"
428 -re ".* $text_section .*$gdb_prompt $" {
429 pass "maint info sections .text"
433 # Test for new option: CODE section flag
434 # If your data section is tagged CODE, xfail this test.
436 gdb_test_multiple "maint info sections CODE" "maint info sections CODE" {
437 -re ".* $data_section .*$gdb_prompt $" { fail "maint info sections CODE" }
438 -re ".* $text_section .*$gdb_prompt $" { pass "maint info sections CODE" }
441 # Test for new option: DATA section flag
442 # If your text section is tagged DATA, xfail this test.
444 # The "maint info sections DATA" test is marked for XFAIL on Windows,
445 # because Windows has text sections marked DATA.
446 setup_xfail "*-*-*cygwin*"
447 setup_xfail "*-*-*mingw*"
449 gdb_test_multiple "maint info sections DATA" "maint info sections DATA" {
450 -re ".* $text_section .*$gdb_prompt $" { fail "maint info sections DATA" }
451 -re ".* $data_section .*$gdb_prompt $" { pass "maint info sections DATA" }
452 -re ".* .rodata .*$gdb_prompt $" { pass "maint info sections DATA" }
455 set bp_location6 [gdb_get_line_number "set breakpoint 6 here"]
457 gdb_test_multiple "maint info breakpoints" "maint info breakpoints" {
458 -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 $" {
459 pass "maint info breakpoints"
461 -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 $" {
462 pass "maint info breakpoints (with shlib events)"
466 gdb_test "maint print" \
467 "\"maintenance print\" must be followed by the name of a print command\\.\r\nList.*unambiguous\\..*" \
468 "maint print w/o args"
470 gdb_test "maint info" \
471 "\"maintenance info\" must be followed by the name of an info command\\.\r\nList.*unambiguous\\..*" \
472 "maint info w/o args"
475 "\"maintenance\" must be followed by the name of a maintenance command\\.\r\nList.*unambiguous\\..*" \
478 set timeout $oldtimeout
480 #============test help on maint commands
482 gdb_test "help maint" \
483 "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 info.*maintenance internal-error.*maintenance print.*maintenance set.*maintenance show.*Type.*help maintenance.*followed by maintenance subcommand name for full documentation\\..*Command name abbreviations are allowed if unambiguous\\..*"
485 gdb_test "help maint info" \
486 "Commands for showing internal info about the program being debugged.*unambiguous\\..*"
488 test_prefix_command_help {"maint print" "maintenance print"} {
489 "Maintenance command for printing GDB internal state\\.\[\r\n\]+"
492 test_prefix_command_help {"maint" "maintenance"} {
493 "Commands for use by GDB maintainers\\.\[\r\n\]+"
494 "Includes commands to dump specific internal GDB structures in\[\r\n\]+"
495 "a human readable form, to cause GDB to deliberately dump core,\[\r\n\]+"
496 "to test internal functions such as the C\\+\\+/ObjC demangler, etc\\.\[\r\n\]+"
499 #set oldtimeout $timeout
500 #set timeout [expr $timeout + 300]
502 gdb_test_multiple "maint dump-me" "maint dump-me" {
503 -re "Should GDB dump core.*\\(y or n\\) $" {
504 gdb_test "n" ".*" "maint dump-me"
508 send_gdb "maint internal-error\n"
510 -re "A problem internal to GDB has been detected" {
511 pass "maint internal-error"
512 if [gdb_internal_error_resync] {
513 pass "internal-error resync"
515 fail "internal-error resync"
518 -re ".*$gdb_prompt $" {
519 fail "maint internal-error"
520 untested "internal-error resync"
523 fail "maint internal-error (timeout)"
524 untested "internal-error resync"
528 #set timeout $oldtimeout