1<html lang="en"> 2<head> 3<title>Objfiles 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="Progspaces-In-Python.html#Progspaces-In-Python" title="Progspaces In Python"> 10<link rel="next" href="Frames-In-Python.html#Frames-In-Python" title="Frames 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="Objfiles-In-Python"></a> 44<p> 45Next: <a rel="next" accesskey="n" href="Frames-In-Python.html#Frames-In-Python">Frames In Python</a>, 46Previous: <a rel="previous" accesskey="p" href="Progspaces-In-Python.html#Progspaces-In-Python">Progspaces 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.14 Objfiles In Python</h5> 52 53<p><a name="index-objfiles-in-python-1808"></a><a name="index-gdb_002eObjfile-1809"></a><a name="index-Objfile-1810"></a><span class="sc">gdb</span> loads symbols for an inferior from various 54symbol-containing files (see <a href="Files.html#Files">Files</a>). These include the primary 55executable file, any shared libraries used by the inferior, and any 56separate debug info files (see <a href="Separate-Debug-Files.html#Separate-Debug-Files">Separate Debug Files</a>). 57<span class="sc">gdb</span> calls these symbol-containing files <dfn>objfiles</dfn>. 58 59 <p>The following objfile-related functions are available in the 60<code>gdb</code> module: 61 62 <p><a name="index-gdb_002ecurrent_005fobjfile-1811"></a> 63 64<div class="defun"> 65— Function: <b>current_objfile</b><var><a name="index-current_005fobjfile-1812"></a></var><br> 66<blockquote><p>When auto-loading a Python script (see <a href="Auto_002dloading.html#Auto_002dloading">Auto-loading</a>), <span class="sc">gdb</span> 67sets the “current objfile” to the corresponding objfile. This 68function returns the current objfile. If there is no current objfile, 69this function returns <code>None</code>. 70</p></blockquote></div> 71 72 <p><a name="index-gdb_002eobjfiles-1813"></a> 73 74<div class="defun"> 75— Function: <b>objfiles</b><var><a name="index-objfiles-1814"></a></var><br> 76<blockquote><p>Return a sequence of all the objfiles current known to <span class="sc">gdb</span>. 77See <a href="Objfiles-In-Python.html#Objfiles-In-Python">Objfiles In Python</a>. 78</p></blockquote></div> 79 80 <p>Each objfile is represented by an instance of the <code>gdb.Objfile</code> 81class. 82 83<div class="defun"> 84— Instance Variable of Objfile: <b>filename</b><var><a name="index-filename-1815"></a></var><br> 85<blockquote><p>The file name of the objfile as a string. 86</p></blockquote></div> 87 88<div class="defun"> 89— Instance Variable of Objfile: <b>pretty_printers</b><var><a name="index-pretty_005fprinters-1816"></a></var><br> 90<blockquote><p>The <code>pretty_printers</code> attribute is a list of functions. It is 91used to look up pretty-printers. A <code>Value</code> is passed to each 92function in order; if the function returns <code>None</code>, then the 93search continues. Otherwise, the return value should be an object 94which is used to format the value. See <a href="Pretty-Printing-API.html#Pretty-Printing-API">Pretty Printing API</a>, for more 95information. 96</p></blockquote></div> 97 98 </body></html> 99 100