1<html lang="en"> 2<head> 3<title>Symbol Tables In Python - Debugging with GDB</title> 4<meta http-equiv="Content-Type" content="text/html"> 5<meta name="description" content="Debugging with GDB"> 6<meta name="generator" content="makeinfo 4.13"> 7<link title="Top" rel="start" href="index.html#Top"> 8<link rel="up" href="Python-API.html#Python-API" title="Python API"> 9<link rel="prev" href="Symbols-In-Python.html#Symbols-In-Python" title="Symbols In Python"> 10<link rel="next" href="Lazy-Strings-In-Python.html#Lazy-Strings-In-Python" title="Lazy Strings In Python"> 11<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> 12<!-- 13Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 141998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 15Free Software Foundation, Inc. 16 17Permission is granted to copy, distribute and/or modify this document 18under the terms of the GNU Free Documentation License, Version 1.3 or 19any later version published by the Free Software Foundation; with the 20Invariant Sections being ``Free Software'' and ``Free Software Needs 21Free Documentation'', with the Front-Cover Texts being ``A GNU Manual,'' 22and with the Back-Cover Texts as in (a) below. 23 24(a) The FSF's Back-Cover Text is: ``You are free to copy and modify 25this GNU Manual. Buying copies from GNU Press supports the FSF in 26developing GNU and promoting software freedom.''--> 27<meta http-equiv="Content-Style-Type" content="text/css"> 28<style type="text/css"><!-- 29 pre.display { font-family:inherit } 30 pre.format { font-family:inherit } 31 pre.smalldisplay { font-family:inherit; font-size:smaller } 32 pre.smallformat { font-family:inherit; font-size:smaller } 33 pre.smallexample { font-size:smaller } 34 pre.smalllisp { font-size:smaller } 35 span.sc { font-variant:small-caps } 36 span.roman { font-family:serif; font-weight:normal; } 37 span.sansserif { font-family:sans-serif; font-weight:normal; } 38--></style> 39<link rel="stylesheet" type="text/css" href="../cs.css"> 40</head> 41<body> 42<div class="node"> 43<a name="Symbol-Tables-In-Python"></a> 44<p> 45Next: <a rel="next" accesskey="n" href="Lazy-Strings-In-Python.html#Lazy-Strings-In-Python">Lazy Strings In Python</a>, 46Previous: <a rel="previous" accesskey="p" href="Symbols-In-Python.html#Symbols-In-Python">Symbols In Python</a>, 47Up: <a rel="up" accesskey="u" href="Python-API.html#Python-API">Python API</a> 48<hr> 49</div> 50 51<h5 class="subsubsection">23.2.2.18 Symbol table representation in Python.</h5> 52 53<p><a name="index-symbol-tables-in-python-1896"></a><a name="index-gdb_002eSymtab-1897"></a><a name="index-gdb_002eSymtab_005fand_005fline-1898"></a> 54Access to symbol table data maintained by <span class="sc">gdb</span> on the inferior 55is exposed to Python via two objects: <code>gdb.Symtab_and_line</code> and 56<code>gdb.Symtab</code>. Symbol table and line data for a frame is returned 57from the <code>find_sal</code> method in <code>gdb.Frame</code> object. 58See <a href="Frames-In-Python.html#Frames-In-Python">Frames In Python</a>. 59 60 <p>For more information on <span class="sc">gdb</span>'s symbol table management, see 61<a href="Symbols.html#Symbols">Examining the Symbol Table</a>, for more information. 62 63 <p>A <code>gdb.Symtab_and_line</code> object has the following attributes: 64 65 <dl> 66 67 <div class="defun"> 68— Instance Variable of Symtab_and_line: <b>symtab</b><var><a name="index-symtab-1899"></a></var><br> 69<blockquote> <p>The symbol table object (<code>gdb.Symtab</code>) for this frame. 70This attribute is not writable. 71</p></blockquote></div> 72 73 <div class="defun"> 74— Instance Variable of Symtab_and_line: <b>pc</b><var><a name="index-pc-1900"></a></var><br> 75<blockquote> <p>Indicates the current program counter address. This attribute is not 76writable. 77</p></blockquote></div> 78 79 <div class="defun"> 80— Instance Variable of Symtab_and_line: <b>line</b><var><a name="index-line-1901"></a></var><br> 81<blockquote> <p>Indicates the current line number for this object. This 82attribute is not writable. 83</p></blockquote></div> 84 </dl> 85 86 <p>A <code>gdb.Symtab</code> object has the following attributes: 87 88 <dl> 89 90 <div class="defun"> 91— Instance Variable of Symtab: <b>filename</b><var><a name="index-filename-1902"></a></var><br> 92<blockquote> <p>The symbol table's source filename. This attribute is not writable. 93</p></blockquote></div> 94 95 <div class="defun"> 96— Instance Variable of Symtab: <b>objfile</b><var><a name="index-objfile-1903"></a></var><br> 97<blockquote> <p>The symbol table's backing object file. See <a href="Objfiles-In-Python.html#Objfiles-In-Python">Objfiles In Python</a>. 98This attribute is not writable. 99</p></blockquote></div> 100 </dl> 101 102 <p>The following methods are provided: 103 104 <dl> 105 106 <div class="defun"> 107— Method on Symtab: <b>fullname</b><var><a name="index-fullname-on-Symtab-1904"></a></var><br> 108<blockquote> <p>Return the symbol table's source absolute file name. 109</p></blockquote></div> 110 </dl> 111 112 </body></html> 113 114