1 # Copyright 2002-2022 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 Michael Snyder (msnyder@redhat.com)
17 # This is a test for the gdb command "dump".
27 set formats {binary ihex srec tekhex verilog}
29 if [istarget "alpha*-*-*"] then {
30 # SREC etc cannot handle 64-bit addresses. Force the test
31 # program into the low 31 bits of the address space.
32 lappend options "additional_flags=-Wl,-taso"
35 # Runs the command 'print zero_all ()'. Uses the PRINT_ZERO_ALL_COUNT
36 # global to ensure the test names are unique.
37 set print_zero_all_count 0
38 proc print_zero_all { } {
39 global print_zero_all_count
41 incr print_zero_all_count
42 gdb_test "print zero_all ()" " = void" \
43 "call ${print_zero_all_count} to zero_all function"
46 # Debian9/Ubuntu16.10 onwards default to PIE enabled. Ensure it is disabled as
47 # this causes addresses to be out of range for IHEX.
48 lappend options {nopie}
50 if { [gdb_compile "${srcdir}/${subdir}/${srcfile}" "${binfile}" executable ${options}] != "" } {
51 untested "failed to compile"
55 # Start with a fresh gdb.
59 gdb_reinitialize_dir $srcdir/$subdir
61 gdb_test "dump mem /dev/null 0x10 0x20" "Cannot access memory at address 0x10" \
62 "inaccessible memory is reported"
66 # Check the address of a variable. If it is bigger than 32-bit,
67 # assume our target has 64-bit addresses that are not supported by SREC,
68 # IHEX and TEKHEX. We skip those tests then.
69 set max_32bit_address "0xffffffff"
70 set data_address [get_hexadecimal_valueof "&intarray" 0x100000000]
71 if {${data_address} > ${max_32bit_address}} then {
75 # Clean up any stale output files from previous test runs
79 intarr1.bin intarr1b.bin intarr1.ihex
80 intarr1.srec intarr1.tekhex intarr1.verilog
81 intarr2.bin intarr2b.bin intarr2.ihex
82 intarr2.srec intarr2.tekhex intarr2.verilog
83 intstr1.bin intstr1b.bin intstr1.ihex
84 intstr1.srec intstr1.tekhex intstr1.verilog
85 intstr2.bin intstr2b.bin intstr2.ihex
86 intstr2.srec intstr2.tekhex intstr2.verilog
90 # This loop sets variables dynamically -- each name listed in
91 # $ALL_FILES is both a file name and a variable name.
92 foreach file $all_files {
93 if {[is_remote host]} {
96 set this_name [standard_output_file $file]
99 lappend filenames [set ${file} $this_name]
102 remote_exec host "rm -f $filenames"
106 # Run target program until data structs are initialized.
108 if { ! [ runto checkpoint1 ] } then {
109 untested "couldn't run to checkpoint"
113 # Get the endianness for the later use with endianless formats.
115 set endian [get_endianness]
117 # Now generate some dump files.
119 proc make_dump_file { command msg } {
122 gdb_test_multiple "${command}" "$msg" {
123 -re ".*\[Ee\]rror.*$gdb_prompt $" { fail $msg }
124 -re ".*\[Ww\]arning.*$gdb_prompt $" { fail $msg }
125 -re ".*\[Uu\]ndefined .*$gdb_prompt $" { fail $msg }
126 -re ".*$gdb_prompt $" { pass $msg }
130 make_dump_file "dump val [set intarr1.bin] intarray" \
131 "dump array as value, default"
133 make_dump_file "dump val [set intstr1.bin] intstruct" \
134 "dump struct as value, default"
136 make_dump_file "dump bin val [set intarr1b.bin] intarray" \
137 "dump array as value, binary"
139 make_dump_file "dump bin val [set intstr1b.bin] intstruct" \
140 "dump struct as value, binary"
142 make_dump_file "dump srec val [set intarr1.srec] intarray" \
143 "dump array as value, srec"
145 make_dump_file "dump srec val [set intstr1.srec] intstruct" \
146 "dump struct as value, srec"
148 make_dump_file "dump ihex val [set intarr1.ihex] intarray" \
149 "dump array as value, intel hex"
151 make_dump_file "dump ihex val [set intstr1.ihex] intstruct" \
152 "dump struct as value, intel hex"
154 make_dump_file "dump tekhex val [set intarr1.tekhex] intarray" \
155 "dump array as value, tekhex"
157 make_dump_file "dump tekhex val [set intstr1.tekhex] intstruct" \
158 "dump struct as value, tekhex"
160 make_dump_file "dump verilog val [set intarr1.verilog] intarray" \
161 "dump array as value, verilog"
163 make_dump_file "dump verilog val [set intstr1.verilog] intstruct" \
164 "dump struct as value, verilog"
166 proc capture_value { expression args } {
171 if {[llength $args] > 0} {
172 # Convert $args into a simple string and don't use EXPRESSION
174 set test "[join $args]; capture"
176 set test "capture $expression"
178 gdb_test_multiple "print ${expression}" "$test" {
179 -re "\\$\[0-9\]+ = (\[^\r\n\]+).*$gdb_prompt $" {
180 set output_string "$expect_out(1,string)"
183 -re "(Cannot access memory at address \[^\r\n\]+).*$gdb_prompt $" {
184 # Even a failed value is valid
185 set output_string "$expect_out(1,string)"
189 return $output_string
192 # POINTER is a pointer and this proc captures the value of POINTER along
193 # with POINTER's type. For example, POINTER is "&intarray", this proc will
194 # call "p &intarray", capture "(int (*)[32]) 0x804a0e0", and return this
197 proc capture_pointer_with_type { pointer } {
201 set test "capture type of pointer $pointer"
203 gdb_test_multiple "p ${pointer}" $test {
204 -re "\\$\[0-9\]+ = .*$gdb_prompt $" {
205 # Expected output of "p ${pointer}" is like "$7 = (int (*)[32]) 0x804a0e0",
206 # and we want to extract "(int (*)[32]) 0x804a0e0" from it via
208 if [regexp " \\(.*\\).* 0x\[0-9a-fA-F\]+" $expect_out(0,string) output_string] {
209 # OUTPUT_STRING is expected to be like "(int (*)[32]) 0x804a0e0".
217 return $output_string
220 set array_start [capture_value "/x &intarray\[0\]"]
221 set array_end [capture_value "/x &intarray\[32\]"]
222 set struct_start [capture_value "/x &intstruct"]
223 set struct_end [capture_value "/x &intstruct + 1"]
225 set array_val [capture_value "intarray"]
226 set struct_val [capture_value "intstruct"]
228 set array_ptr_type [capture_pointer_with_type "&intarray"]
229 set struct_ptr_type [capture_pointer_with_type "&intstruct"]
231 make_dump_file "dump mem [set intarr2.bin] $array_start $array_end" \
232 "dump array as memory, default"
234 make_dump_file "dump mem [set intstr2.bin] $struct_start $struct_end" \
235 "dump struct as memory, default"
237 make_dump_file "dump bin mem [set intarr2b.bin] $array_start $array_end" \
238 "dump array as memory, binary"
240 make_dump_file "dump bin mem [set intstr2b.bin] $struct_start $struct_end" \
241 "dump struct as memory, binary"
243 make_dump_file "dump srec mem [set intarr2.srec] $array_start $array_end" \
244 "dump array as memory, srec"
246 make_dump_file "dump srec mem [set intstr2.srec] $struct_start $struct_end" \
247 "dump struct as memory, srec"
249 make_dump_file "dump ihex mem [set intarr2.ihex] $array_start $array_end" \
250 "dump array as memory, ihex"
252 make_dump_file "dump ihex mem [set intstr2.ihex] $struct_start $struct_end" \
253 "dump struct as memory, ihex"
255 make_dump_file "dump tekhex mem [set intarr2.tekhex] $array_start $array_end" \
256 "dump array as memory, tekhex"
258 make_dump_file "dump tekhex mem [set intstr2.tekhex] $struct_start $struct_end" \
259 "dump struct as memory, tekhex"
261 make_dump_file "dump verilog mem [set intarr2.verilog] $array_start $array_end" \
262 "dump array as memory, verilog"
264 make_dump_file "dump verilog mem [set intstr2.verilog] $struct_start $struct_end" \
265 "dump struct as memory, verilog"
267 # test complex expressions
269 "dump srec mem [set intarr3.srec] &intarray \(char *\) &intarray + sizeof intarray" \
270 "dump array as mem, srec, expressions"
272 proc test_restore_saved_value { restore_args msg oldval newval } {
275 gdb_test "restore $restore_args" \
277 "$msg; file restored ok"
278 if { ![string compare $oldval \
279 [capture_value $newval "$msg"]] } then {
280 pass "$msg; value restored ok"
282 fail "$msg; value restored ok"
286 if ![string compare $is64bitonly "no"] then {
289 test_restore_saved_value "[set intarr1.srec]" "array as value, srec" \
290 $array_val "intarray"
292 test_restore_saved_value "[set intstr1.srec]" "struct as value, srec" \
293 $struct_val "intstruct"
297 test_restore_saved_value "[set intarr2.srec]" "array as memory, srec" \
298 $array_val "intarray"
300 test_restore_saved_value "[set intstr2.srec]" "struct as memory, srec" \
301 $struct_val "intstruct"
305 test_restore_saved_value "[set intarr1.ihex]" "array as value, ihex" \
306 $array_val "intarray"
308 test_restore_saved_value "[set intstr1.ihex]" "struct as value, ihex" \
309 $struct_val "intstruct"
313 test_restore_saved_value "[set intarr2.ihex]" "array as memory, ihex" \
314 $array_val "intarray"
316 test_restore_saved_value "[set intstr2.ihex]" "struct as memory, ihex" \
317 $struct_val "intstruct"
321 test_restore_saved_value "[set intarr1.tekhex]" "array as value, tekhex" \
322 $array_val "intarray"
324 test_restore_saved_value "[set intstr1.tekhex]" "struct as value, tekhex" \
325 $struct_val "intstruct"
329 test_restore_saved_value "[set intarr2.tekhex]" "array as memory, tekhex" \
330 $array_val "intarray"
332 test_restore_saved_value "[set intstr2.tekhex]" "struct as memory, tekhex" \
333 $struct_val "intstruct"
338 test_restore_saved_value "[set intarr1.bin] binary $array_start" \
339 "array as value, binary" \
340 $array_val "intarray"
342 test_restore_saved_value "[set intstr1.bin] binary $struct_start" \
343 "struct as value, binary" \
344 $struct_val "intstruct"
348 test_restore_saved_value "[set intarr2.bin] binary $array_start" \
349 "array as memory, binary" \
350 $array_val "intarray"
352 test_restore_saved_value "[set intstr2.bin] binary $struct_start" \
353 "struct as memory, binary" \
354 $struct_val "intstruct"
356 # test restore with offset.
358 set array2_start [capture_value "/x &intarray2\[0\]"]
359 set struct2_start [capture_value "/x &intstruct2"]
361 [capture_value "(char *) &intarray2 - (char *) &intarray"]
363 [capture_value "(char *) &intstruct2 - (char *) &intstruct"]
368 if ![string compare $is64bitonly "no"] then {
369 test_restore_saved_value "[set intarr1.srec] $array2_offset" \
371 $array_val "intarray2"
373 test_restore_saved_value "[set intstr1.srec] $struct2_offset" \
374 "struct copy, srec" \
375 $struct_val "intstruct2"
379 test_restore_saved_value "[set intarr1.ihex] $array2_offset" \
381 $array_val "intarray2"
383 test_restore_saved_value "[set intstr1.ihex] $struct2_offset" \
384 "struct copy, ihex" \
385 $struct_val "intstruct2"
389 test_restore_saved_value "[set intarr1.tekhex] $array2_offset" \
390 "array copy, tekhex" \
391 $array_val "intarray2"
393 test_restore_saved_value "[set intstr1.tekhex] $struct2_offset" \
394 "struct copy, tekhex" \
395 $struct_val "intstruct2"
400 test_restore_saved_value "[set intarr1.bin] binary $array2_start" \
401 "array copy, binary" \
402 $array_val "intarray2"
404 test_restore_saved_value "[set intstr1.bin] binary $struct2_start" \
405 "struct copy, binary" \
406 $struct_val "intstruct2"
409 # test restore with start/stop addresses.
411 # For this purpose, we will restore just the third element of the array,
412 # and check to see that adjacent elements are not modified.
414 # We will need the address and offset of the third and fourth elements.
417 set element3_start [capture_value "/x &intarray\[3\]"]
418 set element4_start [capture_value "/x &intarray\[4\]"]
419 set element3_offset \
420 [capture_value "/x (char *) &intarray\[3\] - (char *) &intarray\[0\]"]
421 set element4_offset \
422 [capture_value "/x (char *) &intarray\[4\] - (char *) &intarray\[0\]"]
424 if ![string compare $is64bitonly "no"] then {
427 test_restore_saved_value "[set intarr1.srec] 0 $element3_start $element4_start" \
428 "array partial, srec" 4 "intarray\[3\]"
430 gdb_test "print intarray\[2\] == 0" " = 1" "element 2 not changed - 1"
431 gdb_test "print intarray\[4\] == 0" " = 1" "element 4 not changed - 1"
435 test_restore_saved_value "[set intarr1.ihex] 0 $element3_start $element4_start" \
436 "array partial, ihex" 4 "intarray\[3\]"
438 gdb_test "print intarray\[2\] == 0" " = 1" "element 2 not changed - 2"
439 gdb_test "print intarray\[4\] == 0" " = 1" "element 4 not changed - 2"
443 test_restore_saved_value "[set intarr1.tekhex] 0 $element3_start $element4_start" \
444 "array partial, tekhex" 4 "intarray\[3\]"
446 gdb_test "print intarray\[2\] == 0" " = 1" "element 2 not changed - 3"
447 gdb_test "print intarray\[4\] == 0" " = 1" "element 4 not changed - 3"
452 test_restore_saved_value \
453 "[set intarr1.bin] binary $array_start $element3_offset $element4_offset" \
454 "array partial, binary" 4 "intarray\[3\]"
456 gdb_test "print intarray\[2\] == 0" " = 1" "element 2 not changed - 4"
457 gdb_test "print intarray\[4\] == 0" " = 1" "element 4 not changed - 4"
459 if ![string compare $is64bitonly "no"] then {
462 # restore with expressions
463 test_restore_saved_value \
464 "[set intarr3.srec] (char*)${array2_start}-(char*)${array_start} &intarray\[3\] &intarray\[4\]" \
465 "array partial with expressions" 4 "intarray2\[3\]"
467 gdb_test "print intarray2\[2\] == 0" " = 1" "element 2 not changed, == 4"
468 gdb_test "print intarray2\[4\] == 0" " = 1" "element 4 not changed, == 4"
472 # Test writing a file of each format to a directory that does not exist.
474 foreach_with_prefix format $formats {
475 gdb_test "dump $format memory /tmp/non/existent/directory/file $array_start $array_end" \
476 "/tmp/non/existent/directory/file: No such file or directory." \
477 "dump to non-existent directory"
480 # Now start a fresh gdb session, and reload the saved value files.
484 gdb_file_cmd ${binfile}
486 # Now fix the endianness at the correct state.
488 gdb_test_multiple "set endian $endian" "set endianness" {
489 -re ".* (big|little) endian.*$gdb_prompt $" {
490 pass "setting $endian endianness"
494 # Reload saved values one by one, and compare.
496 if { ![string compare $array_val \
497 [capture_value "intarray" "file binfile; intarray"]] } then {
498 fail "start with intarray un-initialized"
500 pass "start with intarray un-initialized"
503 if { ![string compare $struct_val \
504 [capture_value "intstruct" "file binfile; intstruct"]] } then {
505 fail "start with intstruct un-initialized"
507 pass "start with intstruct un-initialized"
510 proc test_reload_saved_value { filename msg oldval newval } {
513 gdb_file_cmd $filename
514 if { ![string compare $oldval \
515 [capture_value $newval "$msg"]] } then {
516 pass "$msg; value restored ok"
518 fail "$msg; value restored ok"
522 # srec format can not be loaded for 64-bit-only platforms
523 if ![string compare $is64bitonly "no"] then {
524 test_reload_saved_value "[set intarr1.srec]" "reload array as value, srec" \
525 $array_val "\*$array_ptr_type"
526 test_reload_saved_value "[set intstr1.srec]" "reload struct as value, srec" \
527 $struct_val "\*$struct_ptr_type"
528 test_reload_saved_value "[set intarr2.srec]" "reload array as memory, srec" \
529 $array_val "\*$array_ptr_type"
530 test_reload_saved_value "[set intstr2.srec]" "reload struct as memory, srec" \
531 $struct_val "\*$struct_ptr_type"
534 # ihex format can not be loaded for 64-bit-only platforms
535 if ![string compare $is64bitonly "no"] then {
537 test_reload_saved_value "[set intarr1.ihex]" \
538 "reload array as value, intel hex" \
539 $array_val "\*$array_ptr_type"
540 test_reload_saved_value "[set intstr1.ihex]" \
541 "reload struct as value, intel hex" \
542 $struct_val "\*$struct_ptr_type"
543 test_reload_saved_value "[set intarr2.ihex]" \
544 "reload array as memory, intel hex" \
545 $array_val "\*$array_ptr_type"
546 test_reload_saved_value "[set intstr2.ihex]" \
547 "reload struct as memory, intel hex" \
548 $struct_val "\*$struct_ptr_type"
551 # tekhex format can not be loaded for 64-bit-only platforms
552 if ![string compare $is64bitonly "no"] then {
553 test_reload_saved_value "[set intarr1.tekhex]" \
554 "reload array as value, tekhex" \
555 $array_val "\*$array_ptr_type"
556 test_reload_saved_value "[set intstr1.tekhex]" \
557 "reload struct as value, tekhex" \
558 $struct_val "\*$struct_ptr_type"
559 test_reload_saved_value "[set intarr2.tekhex]" \
560 "reload array as memory, tekhex" \
561 $array_val "\*$array_ptr_type"
562 test_reload_saved_value "[set intstr2.tekhex]" \
563 "reload struct as memory, tekhex" \
564 $struct_val "\*$struct_ptr_type"
569 remote_exec host "rm -f $filenames"