1 # Copyright (C) 2008-2012 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 is part of the GDB testsuite. It tests the mechanism
17 # exposing values to Python.
23 load_lib gdb-python.exp
25 set testfile "py-value"
26 set srcfile ${testfile}.c
27 set binfile ${objdir}/${subdir}/${testfile}
29 # Build inferior to language specification.
30 proc build_inferior {exefile lang} {
31 global srcdir subdir srcfile testfile hex
33 if { [gdb_compile "${srcdir}/${subdir}/${srcfile}" "${exefile}" executable "debug $lang"] != "" } {
34 untested "Couldn't compile ${srcfile} in $lang mode"
39 proc test_value_creation {} {
42 gdb_py_test_silent_cmd "python i = gdb.Value (True)" "create boolean value" 1
43 gdb_py_test_silent_cmd "python i = gdb.Value (5)" "create integer value" 1
44 gdb_py_test_silent_cmd "python i = gdb.Value (5L)" "create long value" 1
45 gdb_py_test_silent_cmd "python f = gdb.Value (1.25)" "create double value" 1
46 gdb_py_test_silent_cmd "python a = gdb.Value ('string test')" "create 8-bit string value" 1
47 gdb_test "python print a" "\"string test\"" "print 8-bit string"
48 gdb_test "python print a.__class__" "<type 'gdb.Value'>" "verify type of 8-bit string"
49 gdb_py_test_silent_cmd "python a = gdb.Value (u'unicode test')" "create unicode value" 1
50 gdb_test "python print a" "\"unicode test\"" "print Unicode string"
51 gdb_test "python print a.__class__" "<type 'gdb.Value'>" "verify type of unicode string"
53 # Test address attribute is None in a non-addressable value
54 gdb_test "python print 'result =', i.address" "= None" "Test address attribute in non-addressable value"
57 proc test_value_numeric_ops {} {
60 gdb_py_test_silent_cmd "python i = gdb.Value (5)" "create first integer value" 0
61 gdb_py_test_silent_cmd "python j = gdb.Value (2)" "create second integer value" 0
62 gdb_py_test_silent_cmd "python f = gdb.Value (1.25)" "create first double value" 0
63 gdb_py_test_silent_cmd "python g = gdb.Value (2.5)" "create second double value" 0
64 gdb_test "python print 'result = ' + str(i+j)" " = 7" "add two integer values"
65 gdb_test "python print (i+j).__class__" "<type 'gdb.Value'>" "verify type of integer add result"
67 gdb_test "python print 'result = ' + str(f+g)" " = 3.75" "add two double values"
68 gdb_test "python print 'result = ' + str(i-j)" " = 3" "subtract two integer values"
69 gdb_test "python print 'result = ' + str(f-g)" " = -1.25" "subtract two double values"
70 gdb_test "python print 'result = ' + str(i*j)" " = 10" "multiply two integer values"
71 gdb_test "python print 'result = ' + str(f*g)" " = 3.125" "multiply two double values"
72 gdb_test "python print 'result = ' + str(i/j)" " = 2" "divide two integer values"
73 gdb_test "python print 'result = ' + str(f/g)" " = 0.5" "divide two double values"
74 gdb_test "python print 'result = ' + str(i%j)" " = 1" "take remainder of two integer values"
75 # Remainder of float is implemented in Python but not in GDB's value system.
77 gdb_test "python print 'result = ' + str(i**j)" " = 25" "integer value raised to the power of another integer value"
78 gdb_test "python print 'result = ' + str(g**j)" " = 6.25" "double value raised to the power of integer value"
80 gdb_test "python print 'result = ' + str(-i)" " = -5" "negated integer value"
81 gdb_test "python print 'result = ' + str(+i)" " = 5" "positive integer value"
82 gdb_test "python print 'result = ' + str(-f)" " = -1.25" "negated double value"
83 gdb_test "python print 'result = ' + str(+f)" " = 1.25" "positive double value"
84 gdb_test "python print 'result = ' + str(abs(j-i))" " = 3" "absolute of integer value"
85 gdb_test "python print 'result = ' + str(abs(f-g))" " = 1.25" "absolute of double value"
87 # Test gdb.Value mixed with Python types.
89 gdb_test "python print 'result = ' + str(i-1)" " = 4" "subtract integer value from python integer"
90 gdb_test "python print (i-1).__class__" "<type 'gdb.Value'>" "verify type of mixed integer subtraction result"
91 gdb_test "python print 'result = ' + str(f+1.5)" " = 2.75" "add double value with python float"
93 gdb_test "python print 'result = ' + str(1-i)" " = -4" "subtract python integer from integer value"
94 gdb_test "python print 'result = ' + str(1.5+f)" " = 2.75" "add python float with double value"
97 gdb_test "print evalue" " = TWO"
98 gdb_test_no_output "python evalue = gdb.history (0)"
99 gdb_test "python print int (evalue)" "2"
101 # Test pointer arithmethic
103 # First, obtain the pointers
104 gdb_test "print (void *) 2" ".*" ""
105 gdb_test_no_output "python a = gdb.history (0)" ""
106 gdb_test "print (void *) 5" ".*" ""
107 gdb_test_no_output "python b = gdb.history (0)" ""
109 gdb_test "python print 'result = ' + str(a+5)" " = 0x7" "add pointer value with python integer"
110 gdb_test "python print 'result = ' + str(b-2)" " = 0x3" "subtract python integer from pointer value"
111 gdb_test "python print 'result = ' + str(b-a)" " = 3" "subtract two pointer values"
113 # Test some invalid operations.
115 gdb_test_multiple "python print 'result = ' + str(i+'foo')" "catch error in python type conversion" {
116 -re "Argument to arithmetic operation not a number or boolean.*$gdb_prompt $" {pass "catch error in python type conversion"}
117 -re "result = .*$gdb_prompt $" {fail "catch error in python type conversion"}
118 -re "$gdb_prompt $" {fail "catch error in python type conversion"}
121 gdb_test_multiple "python print 'result = ' + str(i+gdb.Value('foo'))" "catch throw of GDB error" {
122 -re "Traceback.*$gdb_prompt $" {pass "catch throw of GDB error"}
123 -re "result = .*$gdb_prompt $" {fail "catch throw of GDB error"}
124 -re "$gdb_prompt $" {fail "catch throw of GDB error"}
128 proc test_value_boolean {} {
129 # First, define a useful function to test booleans.
130 gdb_py_test_multiple "define function to test booleans" \
132 "def test_bool (val):" "" \
139 gdb_test "py test_bool (gdb.Value (True))" "yay" "check evaluation of true boolean value in expression"
141 gdb_test "py test_bool (gdb.Value (False))" "nay" "check evaluation of false boolean value in expression"
143 gdb_test "py test_bool (gdb.Value (5))" "yay" "check evaluation of true integer value in expression"
145 gdb_test "py test_bool (gdb.Value (0))" "nay" "check evaluation of false integer value in expression"
147 gdb_test "py test_bool (gdb.Value (5.2))" "yay" "check evaluation of true integer value in expression"
149 gdb_test "py test_bool (gdb.Value (0.0))" "nay" "check evaluation of false integer value in expression"
152 proc test_value_compare {} {
153 gdb_test "py print gdb.Value (1) < gdb.Value (1)" "False" "less than, equal"
154 gdb_test "py print gdb.Value (1) < gdb.Value (2)" "True" "less than, less"
155 gdb_test "py print gdb.Value (2) < gdb.Value (1)" "False" "less than, greater"
156 gdb_test "py print gdb.Value (2) < None" "False" "less than, None"
158 gdb_test "py print gdb.Value (1) <= gdb.Value (1)" "True" "less or equal, equal"
159 gdb_test "py print gdb.Value (1) <= gdb.Value (2)" "True" "less or equal, less"
160 gdb_test "py print gdb.Value (2) <= gdb.Value (1)" "False" "less or equal, greater"
161 gdb_test "py print gdb.Value (2) <= None" "False" "less or equal, None"
163 gdb_test "py print gdb.Value (1) == gdb.Value (1)" "True" "equality of gdb.Values"
164 gdb_test "py print gdb.Value (1) == gdb.Value (2)" "False" "inequality of gdb.Values"
165 gdb_test "py print gdb.Value (1) == 1.0" "True" "equality of gdb.Value with Python value"
166 gdb_test "py print gdb.Value (1) == 2" "False" "inequality of gdb.Value with Python value"
167 gdb_test "py print gdb.Value (1) == None" "False" "inequality of gdb.Value with None"
169 gdb_test "py print gdb.Value (1) != gdb.Value (1)" "False" "inequality, false"
170 gdb_test "py print gdb.Value (1) != gdb.Value (2)" "True" "inequality, true"
171 gdb_test "py print gdb.Value (1) != None" "True" "inequality, None"
173 gdb_test "py print gdb.Value (1) > gdb.Value (1)" "False" "greater than, equal"
174 gdb_test "py print gdb.Value (1) > gdb.Value (2)" "False" "greater than, less"
175 gdb_test "py print gdb.Value (2) > gdb.Value (1)" "True" "greater than, greater"
176 gdb_test "py print gdb.Value (2) > None" "True" "greater than, None"
178 gdb_test "py print gdb.Value (1) >= gdb.Value (1)" "True" "greater or equal, equal"
179 gdb_test "py print gdb.Value (1) >= gdb.Value (2)" "False" "greater or equal, less"
180 gdb_test "py print gdb.Value (2) >= gdb.Value (1)" "True" "greater or equal, greater"
181 gdb_test "py print gdb.Value (2) >= None" "True" "greater or equal, None"
184 proc test_value_in_inferior {} {
188 gdb_breakpoint [gdb_get_line_number "break to inspect struct and union"]
190 gdb_continue_to_breakpoint "break to inspect struct and union"
192 # Just get inferior variable s in the value history, available to python.
193 gdb_test "print s" " = {a = 3, b = 5}" ""
195 gdb_py_test_silent_cmd "python s = gdb.history (0)" "get value from history" 1
197 gdb_test "python print 'result = ' + str(s\['a'\])" " = 3" "access element inside struct using 8-bit string name"
198 gdb_test "python print 'result = ' + str(s\[u'a'\])" " = 3" "access element inside struct using unicode name"
200 # Test dereferencing the argv pointer
202 # Just get inferior variable argv the value history, available to python.
203 gdb_test "print argv" " = \\(char \\*\\*\\) 0x.*" ""
205 gdb_py_test_silent_cmd "python argv = gdb.history (0)" "" 0
206 gdb_py_test_silent_cmd "python arg0 = argv.dereference ()" "dereference value" 1
208 # Check that the dereferenced value is sane
209 if { ! [target_info exists noargs] } {
210 gdb_test "python print arg0" "0x.*$testfile\"" "verify dereferenced value"
213 # Smoke-test is_optimized_out attribute
214 gdb_test "python print 'result =', arg0.is_optimized_out" "= False" "Test is_optimized_out attribute"
216 # Test address attribute
217 gdb_test "python print 'result =', arg0.address" "= 0x\[\[:xdigit:\]\]+" "Test address attribute"
219 # Test displaying a variable that is temporarily at a bad address.
220 # But if we can examine what's at memory address 0, then we'll also be
221 # able to display it without error. Don't run the test in that case.
223 gdb_test_multiple "x 0" "memory at address 0" {
224 -re "0x0:\[ \t\]*Cannot access memory at address 0x0\r\n$gdb_prompt $" { }
225 -re "0x0:\[ \t\]*Error accessing memory address 0x0\r\n$gdb_prompt $" { }
226 -re "\r\n$gdb_prompt $" {
232 set test "parse_and_eval with memory error"
236 gdb_test "python print gdb.parse_and_eval('*(int*)0')" "gdb.MemoryError: Cannot access memory at address 0x0.*" $test
239 # Test Python lazy value handling
240 set test "memory error and lazy values"
244 gdb_test "python inval = gdb.parse_and_eval('*(int*)0')"
245 gdb_test "python print inval.is_lazy" "True"
246 gdb_test "python inval2 = inval+1" "gdb.MemoryError: Cannot access memory at address 0x0.*" $test
247 gdb_test "python inval.fetch_lazy ()" "gdb.MemoryError: Cannot access memory at address 0x0.*" $test
249 gdb_test "python argc_lazy = gdb.parse_and_eval('argc')"
250 gdb_test "python argc_notlazy = gdb.parse_and_eval('argc')"
251 gdb_test "python argc_notlazy.fetch_lazy()"
252 gdb_test "python print argc_lazy.is_lazy" "True"
253 gdb_test "python print argc_notlazy.is_lazy" "False"
254 gdb_test "print argc" " = 1" "sanity check argc"
255 gdb_test "python print argc_lazy.is_lazy" "\r\nTrue"
256 gdb_test_no_output "set argc=2"
257 gdb_test "python print argc_notlazy" "\r\n1"
258 gdb_test "python print argc_lazy" "\r\n2"
259 gdb_test "python print argc_lazy.is_lazy" "False"
261 # Test string fetches, both partial and whole.
262 gdb_test "print st" "\"divide et impera\""
263 gdb_py_test_silent_cmd "python st = gdb.history (0)" "get value from history" 1
264 gdb_test "python print st.string ()" "divide et impera" "Test string with no length"
265 gdb_test "python print st.string (length = -1)" "divide et impera" "Test string (length = -1) is all of the string"
266 gdb_test "python print st.string (length = 6)" "divide"
267 gdb_test "python print \"---\"+st.string (length = 0)+\"---\"" "------" "Test string (length = 0) is empty"
268 gdb_test "python print len(st.string (length = 0))" "0" "Test length is 0"
271 # Fetch a string that has embedded nulls.
272 gdb_test "print nullst" "\"divide\\\\000et\\\\000impera\".*"
273 gdb_py_test_silent_cmd "python nullst = gdb.history (0)" "get value from history" 1
274 gdb_test "python print nullst.string ()" "divide" "Test string to first null"
275 # Python cannot print strings that contain the null (\0) character.
276 # For the purposes of this test, use repr()
277 gdb_py_test_silent_cmd "python nullst = nullst.string (length = 9)" "get string beyond null" 1
278 gdb_test "python print repr(nullst)" "u'divide\\\\x00et'"
281 proc test_lazy_strings {} {
285 gdb_test "print sptr" "\"pointer\""
286 gdb_py_test_silent_cmd "python sptr = gdb.history (0)" "Get value from history" 1
288 gdb_py_test_silent_cmd "python lstr = sptr.lazy_string()" "Aquire lazy string" 1
289 gdb_test "python print lstr.type" "const char \*." "Test type name equality"
290 gdb_test "python print sptr.type" "const char \*." "Test type name equality"
291 gdb_test "print sn" "0x0"
292 gdb_py_test_silent_cmd "python snptr = gdb.history (0)" "Get value from history" 1
293 gdb_test "python snstr = snptr.lazy_string(length=5)" ".*Cannot create a lazy string with address.*" "Test lazy string"
294 gdb_py_test_silent_cmd "python snstr = snptr.lazy_string(length=0)" "Succesfully create a lazy string" 1
295 gdb_test "python print snstr.length" "0" "Test lazy string length"
296 gdb_test "python print snstr.address" "0" "Test lazy string address"
300 proc test_inferior_function_call {} {
301 global gdb_prompt hex decimal
303 # Correct inferior call without arguments.
304 gdb_test "p/x fp1" " = $hex.*"
305 gdb_py_test_silent_cmd "python fp1 = gdb.history (0)" "get value from history" 1
306 gdb_test "python fp1 = fp1.dereference()" ""
307 gdb_test "python result = fp1()" ""
308 gdb_test "python print result" "void"
310 # Correct inferior call with arguments.
311 gdb_test "p/x fp2" " = $hex.*"
312 gdb_py_test_silent_cmd "python fp2 = gdb.history (0)" "get value from history" 1
313 gdb_test "python fp2 = fp2.dereference()" ""
314 gdb_test "python result2 = fp2(10,20)" ""
315 gdb_test "python print result2" "30"
317 # Incorrect to call an int value.
318 gdb_test "p i" " = $decimal.*"
319 gdb_py_test_silent_cmd "python i = gdb.history (0)" "get value from history" 1
320 gdb_test "python result3 = i()" ".*Value is not callable.*"
322 # Incorrect number of arguments.
323 gdb_test "p/x fp2" " = $hex.*"
324 gdb_py_test_silent_cmd "python fp3 = gdb.history (0)" "get value from history" 1
325 gdb_test "python fp3 = fp3.dereference()" ""
326 gdb_test "python result2 = fp3(10)" ".*Too few arguments in function call.*"
329 # A few objfile tests.
330 proc test_objfiles {} {
331 gdb_test "python\nok=False\nfor file in gdb.objfiles():\n if 'py-value' in file.filename:\n ok=True\nprint ok\nend" "True" \
332 "py-value in file.filename"
334 gdb_test "python print gdb.objfiles()\[0\].pretty_printers" "\\\[\\\]"
336 gdb_test "python gdb.objfiles()\[0\].pretty_printers = 0" \
337 "pretty_printers attribute must be a list.*Error while executing Python code."
340 proc test_value_after_death {} {
341 # Construct a type while the inferior is still running.
342 gdb_py_test_silent_cmd "python ptrtype = gdb.lookup_type('PTR')" \
345 # Kill the inferior and remove the symbols.
346 gdb_test "kill" "" "kill the inferior" \
347 "Kill the program being debugged. .y or n. $" \
349 gdb_test "file" "" "Discard the symbols" \
350 "Discard symbol table from.*y or n. $" \
353 # Now create a value using that type. Relies on arg0, created by
354 # test_value_in_inferior.
355 gdb_py_test_silent_cmd "python castval = arg0.cast(ptrtype.pointer())" \
358 # Make sure the type is deleted.
359 gdb_py_test_silent_cmd "python ptrtype = None" \
362 # Now see if the value's type is still valid.
363 gdb_test "python print castval.type" "PTR ." \
367 # Regression test for invalid subscript operations. The bug was that
368 # the type of the value was not being checked before allowing a
369 # subscript operation to proceed.
371 proc test_subscript_regression {exefile lang} {
375 # Start with a fresh gdb.
378 gdb_reinitialize_dir $srcdir/$subdir
381 if ![runto_main ] then {
382 perror "couldn't run to breakpoint"
386 if {$lang == "c++"} {
387 gdb_breakpoint [gdb_get_line_number "break to inspect pointer by reference"]
388 gdb_continue_to_breakpoint "break to inspect pointer by reference"
390 gdb_py_test_silent_cmd "print rptr_int" \
392 gdb_py_test_silent_cmd "python rptr = gdb.history(0)" \
393 "Obtains value from GDB" 1
394 gdb_test "python print rptr\[0\]" "2" "Check pointer passed as reference"
396 # Just the most basic test of dynamic_cast -- it is checked in
398 gdb_test "python print bool(gdb.parse_and_eval('base').dynamic_cast(gdb.lookup_type('Derived').pointer()))" \
402 gdb_test "python print gdb.parse_and_eval('base').dynamic_type" \
404 # A static type case.
405 gdb_test "python print gdb.parse_and_eval('5').dynamic_type" \
409 gdb_breakpoint [gdb_get_line_number "break to inspect struct and union"]
410 gdb_continue_to_breakpoint "break to inspect struct and union"
412 gdb_py_test_silent_cmd "python intv = gdb.Value(1)" \
413 "Create a value for subscript test" 1
414 gdb_py_test_silent_cmd "python stringv = gdb.Value(\"foo\")" \
415 "Create a value for subscript test" 1
417 # Try to access an int with a subscript. This should fail.
418 gdb_test "python print intv" "1" "Baseline print of a Python value"
419 gdb_test "python print intv\[0\]" "gdb.error: Cannot subscript requested type.*" \
420 "Attempt to access an integer with a subscript"
422 # Try to access a string with a subscript. This should pass.
423 gdb_test "python print stringv" "foo." "Baseline print of a Python value"
424 gdb_test "python print stringv\[0\]" "f." "Attempt to access a string with a subscript"
426 # Try to access an int array via a pointer with a subscript. This should pass.
427 gdb_py_test_silent_cmd "print p" "Build pointer to array" 1
428 gdb_py_test_silent_cmd "python pointer = gdb.history(0)" "" 1
429 gdb_test "python print pointer\[0\]" "1" "Access array via pointer with int subscript"
430 gdb_test "python print pointer\[intv\]" "2" "Access array via pointer with value subscript"
432 # Try to access a single dimension array with a subscript to the
433 # result. This should fail.
434 gdb_test "python print pointer\[intv\]\[0\]" "gdb.error: Cannot subscript requested type.*" \
435 "Attempt to access an integer with a subscript"
437 # Lastly, test subscript access to an array with multiple
438 # dimensions. This should pass.
439 gdb_py_test_silent_cmd "print {\"fu \",\"foo\",\"bar\"}" "Build array" 1
440 gdb_py_test_silent_cmd "python marray = gdb.history(0)" "" 1
441 gdb_test "python print marray\[1\]\[2\]" "o." "Test multiple subscript"
444 # A few tests of gdb.parse_and_eval.
445 proc test_parse_and_eval {} {
446 gdb_test "python print gdb.parse_and_eval ('23')" "23" \
447 "parse_and_eval constant test"
448 gdb_test "python print gdb.parse_and_eval ('5 + 7')" "12" \
449 "parse_and_eval simple expression test"
450 gdb_test "python print type(gdb.parse_and_eval ('5 + 7'))" \
451 ".type 'gdb.Value'."\
452 "parse_and_eval type test"
455 # Test that values are hashable.
456 proc test_value_hash {} {
457 gdb_py_test_multiple "Simple Python value dictionary" \
459 "one = gdb.Value(1)" "" \
460 "two = gdb.Value(2)" "" \
461 "three = gdb.Value(3)" "" \
462 "vdict = {one:\"one str\",two:\"two str\",three:\"three str\"}" "" \
464 gdb_test "python print vdict\[one\]" "one str" "Test dictionary hash"
465 gdb_test "python print vdict\[two\]" "two str" "Test dictionary hash"
466 gdb_test "python print vdict\[three\]" "three str" "Test dictionary hash"
467 gdb_test "python print one.__hash__() == hash(one)" "True" "Test inbuilt hash"
470 # Build C and C++ versions of executable
471 build_inferior "${binfile}" "c"
472 build_inferior "${binfile}-cxx" "c++"
474 # Start with a fresh gdb.
478 gdb_reinitialize_dir $srcdir/$subdir
481 # Skip all tests if Python scripting is not enabled.
482 if { [skip_python_tests] } { continue }
485 test_value_numeric_ops
492 # The following tests require execution.
494 if ![runto_main] then {
495 fail "Can't run to main"
499 test_value_in_inferior
500 test_inferior_function_call
502 test_value_after_death
504 # Test either C or C++ values.
505 test_subscript_regression "${binfile}" "c"
506 test_subscript_regression "${binfile}-cxx" "c++"