Browse Source
* NEWS: Document it. * data-directory/Makefile.in (PYTHON_FILES): Add gdb/types.py. * python/lib/gdb/types.py: New file. testsuite/ * lib/gdb-python.exp (gdb_check_python_config): New function. * gdb.python/Makefile.in (EXECUTABLES): Add lib-types. * gdb.python/lib-types.cc: New file. * gdb.python/lib-types.exp: New file. doc/ * gdb.texinfo (Python): Add "Python modules". (Types in Python): Add reference to gdb.types section. (Python modules): New node.binutils-2_21-branch
11 changed files with 392 additions and 2 deletions
@ -0,0 +1,91 @@ |
|||
# Type utilities. |
|||
# Copyright (C) 2010 Free Software Foundation, Inc. |
|||
|
|||
# This program is free software; you can redistribute it and/or modify |
|||
# it under the terms of the GNU General Public License as published by |
|||
# the Free Software Foundation; either version 3 of the License, or |
|||
# (at your option) any later version. |
|||
# |
|||
# This program is distributed in the hope that it will be useful, |
|||
# but WITHOUT ANY WARRANTY; without even the implied warranty of |
|||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
|||
# GNU General Public License for more details. |
|||
# |
|||
# You should have received a copy of the GNU General Public License |
|||
# along with this program. If not, see <http://www.gnu.org/licenses/>. |
|||
|
|||
"""Utilities for working with gdb.Types.""" |
|||
|
|||
import gdb |
|||
|
|||
|
|||
def get_basic_type(type_): |
|||
"""Return the "basic" type of a type. |
|||
|
|||
Arguments: |
|||
type_: The type to reduce to its basic type. |
|||
|
|||
Returns: |
|||
type_ with const/volatile is stripped away, |
|||
and typedefs/references converted to the underlying type. |
|||
""" |
|||
|
|||
while (type_.code == gdb.TYPE_CODE_REF or |
|||
type_.code == gdb.TYPE_CODE_TYPEDEF): |
|||
if type_.code == gdb.TYPE_CODE_REF: |
|||
type_ = type_.target() |
|||
else: |
|||
type_ = type_.strip_typedefs() |
|||
return type_.unqualified() |
|||
|
|||
|
|||
def has_field(type_, field): |
|||
"""Return True if a type has the specified field. |
|||
|
|||
Arguments: |
|||
type_: The type to examine. |
|||
It must be one of gdb.TYPE_CODE_STRUCT, gdb.TYPE_CODE_UNION. |
|||
field: The name of the field to look up. |
|||
|
|||
Returns: |
|||
True if the field is present either in type_ or any baseclass. |
|||
|
|||
Raises: |
|||
TypeError: The type is not a struct or union. |
|||
""" |
|||
|
|||
type_ = get_basic_type(type_) |
|||
if (type_.code != gdb.TYPE_CODE_STRUCT and |
|||
type_.code != gdb.TYPE_CODE_UNION): |
|||
raise TypeError("not a struct or union") |
|||
for f in type_.fields(): |
|||
if f.is_base_class: |
|||
if has_field(f.type, field): |
|||
return True |
|||
else: |
|||
# NOTE: f.name could be None |
|||
if f.name == field: |
|||
return True |
|||
return False |
|||
|
|||
|
|||
def make_enum_dict(enum_type): |
|||
"""Return a dictionary from a program's enum type. |
|||
|
|||
Arguments: |
|||
enum_type: The enum to compute the dictionary for. |
|||
|
|||
Returns: |
|||
The dictionary of the enum. |
|||
|
|||
Raises: |
|||
TypeError: The type is not an enum. |
|||
""" |
|||
|
|||
if enum_type.code != gdb.TYPE_CODE_ENUM: |
|||
raise TypeError("not an enum type") |
|||
enum_dict = {} |
|||
for field in enum_type.fields(): |
|||
# The enum's value is stored in "bitpos". |
|||
enum_dict[field.name] = field.bitpos |
|||
return enum_dict |
|||
@ -0,0 +1,61 @@ |
|||
/* This testcase is part of GDB, the GNU debugger.
|
|||
|
|||
Copyright 2010 Free Software Foundation, Inc. |
|||
|
|||
This program is free software; you can redistribute it and/or modify |
|||
it under the terms of the GNU General Public License as published by |
|||
the Free Software Foundation; either version 3 of the License, or |
|||
(at your option) any later version. |
|||
|
|||
This program is distributed in the hope that it will be useful, |
|||
but WITHOUT ANY WARRANTY; without even the implied warranty of |
|||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
|||
GNU General Public License for more details. |
|||
|
|||
You should have received a copy of the GNU General Public License |
|||
along with this program. If not, see <http://www.gnu.org/licenses/>. */
|
|||
|
|||
class class1 |
|||
{ |
|||
public: |
|||
class1 (int _x) : x (_x) {} |
|||
int x; |
|||
}; |
|||
|
|||
class1 class1_obj (42); |
|||
const class1 const_class1_obj (42); |
|||
volatile class1 volatile_class1_obj (42); |
|||
const volatile class1 const_volatile_class1_obj (42); |
|||
|
|||
typedef class1 typedef_class1; |
|||
|
|||
typedef_class1 typedef_class1_obj (42); |
|||
|
|||
class1& class1_ref_obj (class1_obj); |
|||
|
|||
typedef const typedef_class1 typedef_const_typedef_class1; |
|||
|
|||
typedef_const_typedef_class1 typedef_const_typedef_class1_obj (42); |
|||
|
|||
typedef typedef_const_typedef_class1& typedef_const_typedef_class1_ref; |
|||
|
|||
typedef_const_typedef_class1_ref typedef_const_typedef_class1_ref_obj (typedef_const_typedef_class1_obj); |
|||
|
|||
class subclass1 : public class1 |
|||
{ |
|||
public: |
|||
subclass1 (int _x, int _y) : class1 (_x), y (_y) {} |
|||
int y; |
|||
}; |
|||
|
|||
subclass1 subclass1_obj (42, 43); |
|||
|
|||
enum enum1 { A, B, C }; |
|||
|
|||
enum1 enum1_obj (A); |
|||
|
|||
int |
|||
main () |
|||
{ |
|||
return 0; |
|||
} |
|||
@ -0,0 +1,143 @@ |
|||
# Copyright (C) 2010 Free Software Foundation, Inc. |
|||
|
|||
# This program is free software; you can redistribute it and/or modify |
|||
# it under the terms of the GNU General Public License as published by |
|||
# the Free Software Foundation; either version 3 of the License, or |
|||
# (at your option) any later version. |
|||
# |
|||
# This program is distributed in the hope that it will be useful, |
|||
# but WITHOUT ANY WARRANTY; without even the implied warranty of |
|||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
|||
# GNU General Public License for more details. |
|||
# |
|||
# You should have received a copy of the GNU General Public License |
|||
# along with this program. If not, see <http://www.gnu.org/licenses/>. |
|||
|
|||
# This file is part of the GDB testsuite. |
|||
# It tests the types.py module. |
|||
|
|||
if $tracelevel then { |
|||
strace $tracelevel |
|||
} |
|||
|
|||
load_lib gdb-python.exp |
|||
|
|||
set testfile "lib-types" |
|||
set srcfile ${testfile}.cc |
|||
set binfile ${objdir}/${subdir}/${testfile} |
|||
if { [gdb_compile "${srcdir}/${subdir}/${srcfile}" "${binfile}" executable {debug c++}] != "" } { |
|||
untested "Couldn't compile ${srcfile}" |
|||
return -1 |
|||
} |
|||
|
|||
# Start with a fresh gdb. |
|||
gdb_exit |
|||
gdb_start |
|||
gdb_reinitialize_dir $srcdir/$subdir |
|||
gdb_load ${binfile} |
|||
|
|||
# Skip all tests if Python scripting is not enabled. |
|||
if { [skip_python_tests] } { continue } |
|||
|
|||
if ![runto_main] then { |
|||
fail "Can't run to main" |
|||
return 0 |
|||
} |
|||
|
|||
# Ensure sys.path, et.al. are initialized properly. |
|||
gdb_check_python_config |
|||
|
|||
gdb_test_no_output "python import gdb.types" |
|||
|
|||
# test get_basic_type const stripping |
|||
gdb_test_no_output "python const_class1_obj = gdb.parse_and_eval ('const_class1_obj')" |
|||
gdb_test_no_output "python basic_type_const_class1_obj = gdb.types.get_basic_type (const_class1_obj.type)" |
|||
gdb_test "python print str (const_class1_obj.type)" "const class1" |
|||
set test "const stripping" |
|||
gdb_test_multiple "python print str (basic_type_const_class1_obj)" $test { |
|||
-re "\[\r\n\]+class1\[\r\n\]+$gdb_prompt $" { |
|||
pass $test |
|||
} |
|||
} |
|||
|
|||
# test get_basic_type volatile stripping |
|||
gdb_test_no_output "python volatile_class1_obj = gdb.parse_and_eval ('volatile_class1_obj')" |
|||
gdb_test_no_output "python basic_type_volatile_class1_obj = gdb.types.get_basic_type (volatile_class1_obj.type)" |
|||
gdb_test "python print str (volatile_class1_obj.type)" "volatile class1" |
|||
set test "volatile stripping" |
|||
gdb_test_multiple "python print str (basic_type_volatile_class1_obj)" $test { |
|||
-re "\[\r\n\]+class1\[\r\n\]+$gdb_prompt $" { |
|||
pass $test |
|||
} |
|||
} |
|||
|
|||
# test get_basic_type volatile+const stripping |
|||
gdb_test_no_output "python const_volatile_class1_obj = gdb.parse_and_eval ('const_volatile_class1_obj')" |
|||
gdb_test_no_output "python basic_type_const_volatile_class1_obj = gdb.types.get_basic_type (const_volatile_class1_obj.type)" |
|||
gdb_test "python print str (const_volatile_class1_obj.type)" "const volatile class1" |
|||
set test "volatile+const stripping" |
|||
gdb_test_multiple "python print str (basic_type_const_volatile_class1_obj)" $test { |
|||
-re "\[\r\n\]+class1\[\r\n\]+$gdb_prompt $" { |
|||
pass $test |
|||
} |
|||
} |
|||
|
|||
# test get_basic_type typedef stripping |
|||
gdb_test_no_output "python typedef_class1_obj = gdb.parse_and_eval ('typedef_class1_obj')" |
|||
gdb_test_no_output "python basic_type_typedef_class1_obj = gdb.types.get_basic_type (typedef_class1_obj.type)" |
|||
gdb_test "python print str (typedef_class1_obj.type)" "typedef_class1" |
|||
set test "typedef stripping" |
|||
gdb_test_multiple "python print str (basic_type_typedef_class1_obj)" $test { |
|||
-re "\[\r\n\]+class1\[\r\n\]+$gdb_prompt $" { |
|||
pass $test |
|||
} |
|||
} |
|||
|
|||
# test get_basic_type reference stripping |
|||
gdb_test_no_output "python class1_ref_obj = gdb.parse_and_eval ('class1_ref_obj')" |
|||
gdb_test_no_output "python basic_type_class1_ref_obj = gdb.types.get_basic_type (class1_ref_obj.type)" |
|||
gdb_test "python print str (class1_ref_obj.type)" "class1 &" |
|||
set test "reference stripping" |
|||
gdb_test_multiple "python print str (basic_type_class1_ref_obj)" $test { |
|||
-re "\[\r\n\]+class1\[\r\n\]+$gdb_prompt $" { |
|||
pass $test |
|||
} |
|||
} |
|||
|
|||
# test nested typedef stripping |
|||
gdb_test_no_output "python typedef_const_typedef_class1_obj = gdb.parse_and_eval ('typedef_const_typedef_class1_obj')" |
|||
gdb_test_no_output "python basic_type_typedef_const_typedef_class1_obj = gdb.types.get_basic_type (typedef_const_typedef_class1_obj.type)" |
|||
gdb_test "python print str (typedef_class1_obj.type)" "typedef_class1" |
|||
set test "nested typedef stripping" |
|||
gdb_test_multiple "python print str (basic_type_typedef_const_typedef_class1_obj)" $test { |
|||
-re "\[\r\n\]+class1\[\r\n\]+$gdb_prompt $" { |
|||
pass $test |
|||
} |
|||
} |
|||
|
|||
# test nested typedef/reference stripping |
|||
gdb_test_no_output "python typedef_const_typedef_class1_ref_obj = gdb.parse_and_eval ('typedef_const_typedef_class1_ref_obj')" |
|||
gdb_test_no_output "python basic_type_typedef_const_typedef_class1_ref_obj = gdb.types.get_basic_type (typedef_const_typedef_class1_ref_obj.type)" |
|||
gdb_test "python print str (typedef_const_typedef_class1_ref_obj.type)" "const typedef_const_typedef_class1_ref" |
|||
set test "nested typedef/ref stripping" |
|||
gdb_test_multiple "python print str (basic_type_typedef_const_typedef_class1_ref_obj)" $test { |
|||
-re "\[\r\n\]+class1\[\r\n\]+$gdb_prompt $" { |
|||
pass $test |
|||
} |
|||
} |
|||
|
|||
# test has_field on simple class |
|||
gdb_test_no_output "python class1_obj = gdb.parse_and_eval ('class1_obj')" |
|||
gdb_test "python print gdb.types.has_field (class1_obj.type, 'x')" "True" |
|||
gdb_test "python print gdb.types.has_field (class1_obj.type, 'nope')" "False" |
|||
|
|||
# test has_field in base class |
|||
gdb_test_no_output "python subclass1_obj = gdb.parse_and_eval ('subclass1_obj')" |
|||
gdb_test "python print gdb.types.has_field (subclass1_obj.type, 'x')" "True" |
|||
|
|||
# test make_enum_dict |
|||
gdb_test_no_output "python enum1_obj = gdb.parse_and_eval ('enum1_obj')" |
|||
gdb_test_no_output "python enum1_dict = gdb.types.make_enum_dict (enum1_obj.type)" |
|||
gdb_test_no_output "python enum1_list = enum1_dict.items ()" |
|||
gdb_test_no_output "python enum1_list.sort ()" |
|||
gdb_test "python print enum1_list" {\[\('A', 0L\), \('B', 1L\), \('C', 2L\)\]} |
|||
Loading…
Reference in new issue