1<html lang="en"> 2<head> 3<title>Progspaces 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="Functions-In-Python.html#Functions-In-Python" title="Functions In Python"> 10<link rel="next" href="Objfiles-In-Python.html#Objfiles-In-Python" title="Objfiles 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="Progspaces-In-Python"></a> 44<p> 45Next: <a rel="next" accesskey="n" href="Objfiles-In-Python.html#Objfiles-In-Python">Objfiles In Python</a>, 46Previous: <a rel="previous" accesskey="p" href="Functions-In-Python.html#Functions-In-Python">Functions 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.13 Program Spaces In Python</h5> 52 53<p><a name="index-progspaces-in-python-1799"></a><a name="index-gdb_002eProgspace-1800"></a><a name="index-Progspace-1801"></a>A program space, or <dfn>progspace</dfn>, represents a symbolic view 54of an address space. 55It consists of all of the objfiles of the program. 56See <a href="Objfiles-In-Python.html#Objfiles-In-Python">Objfiles In Python</a>. 57See <a href="Inferiors-and-Programs.html#Inferiors-and-Programs">program spaces</a>, for more details 58about program spaces. 59 60 <p>The following progspace-related functions are available in the 61<code>gdb</code> module: 62 63 <p><a name="index-gdb_002ecurrent_005fprogspace-1802"></a> 64 65<div class="defun"> 66— Function: <b>current_progspace</b><var><a name="index-current_005fprogspace-1803"></a></var><br> 67<blockquote><p>This function returns the program space of the currently selected inferior. 68See <a href="Inferiors-and-Programs.html#Inferiors-and-Programs">Inferiors and Programs</a>. 69</p></blockquote></div> 70 71 <p><a name="index-gdb_002eprogspaces-1804"></a> 72 73<div class="defun"> 74— Function: <b>progspaces</b><var><a name="index-progspaces-1805"></a></var><br> 75<blockquote><p>Return a sequence of all the progspaces currently known to <span class="sc">gdb</span>. 76</p></blockquote></div> 77 78 <p>Each progspace is represented by an instance of the <code>gdb.Progspace</code> 79class. 80 81<div class="defun"> 82— Instance Variable of Progspace: <b>filename</b><var><a name="index-filename-1806"></a></var><br> 83<blockquote><p>The file name of the progspace as a string. 84</p></blockquote></div> 85 86<div class="defun"> 87— Instance Variable of Progspace: <b>pretty_printers</b><var><a name="index-pretty_005fprinters-1807"></a></var><br> 88<blockquote><p>The <code>pretty_printers</code> attribute is a list of functions. It is 89used to look up pretty-printers. A <code>Value</code> is passed to each 90function in order; if the function returns <code>None</code>, then the 91search continues. Otherwise, the return value should be an object 92which is used to format the value. See <a href="Pretty-Printing-API.html#Pretty-Printing-API">Pretty Printing API</a>, for more 93information. 94</p></blockquote></div> 95 96 </body></html> 97 98