From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-11509-listarch-gdb-patches=sourceware.cygnus.com@sources.redhat.com>
Received: (qmail 2252 invoked by alias); 26 Dec 2001 19:17:49 -0000
Mailing-List: contact gdb-patches-help@sources.redhat.com; run by ezmlm
Precedence: bulk
List-Subscribe: <mailto:gdb-patches-subscribe@sources.redhat.com>
List-Archive: <http://sources.redhat.com/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sources.redhat.com>
List-Help: <mailto:gdb-patches-help@sources.redhat.com>, <http://sources.redhat.com/ml/#faqs>
Sender: gdb-patches-owner@sources.redhat.com
Received: (qmail 2207 invoked from network); 26 Dec 2001 19:17:46 -0000
Received: from unknown (HELO cygnus.com) (205.180.230.5)
  by sources.redhat.com with SMTP; 26 Dec 2001 19:17:46 -0000
Received: from reddwarf.cygnus.com (reddwarf.cygnus.com [205.180.231.12])
	by runyon.cygnus.com (8.8.7-cygnus/8.8.7) with ESMTP id LAA28578
	for <gdb-patches@sources.redhat.com>; Wed, 26 Dec 2001 11:17:46 -0800 (PST)
Received: (from msnyder@localhost)
	by reddwarf.cygnus.com (8.11.2/8.11.2) id fBQJDiF26789
	for gdb-patches@sources.redhat.com; Wed, 26 Dec 2001 11:13:44 -0800
Date: Wed, 26 Dec 2001 11:17:00 -0000
From: Michael Snyder <msnyder@cygnus.com>
Message-Id: <200112261913.fBQJDiF26789@reddwarf.cygnus.com>
To: gdb-patches@sources.redhat.com
Subject: [RFA] Doc for "maint info sections" command
X-SW-Source: 2001-12/txt/msg00576.txt.bz2

Eli, 
I haven't tested this, and I'm not sure whether the @table operator
can be nested?

Michael

2001-12-26  Michael Snyder  <msnyder@redhat.com>

	* gdb.texinfo (maint info sections): Document.

Index: gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.59
diff -c -3 -p -r1.59 gdb.texinfo
*** gdb.texinfo	2001/11/30 23:03:09	1.59
--- gdb.texinfo	2001/12/26 19:05:14
*************** use by @value{GDBN}, and the files from 
*** 9347,9352 ****
--- 9347,9376 ----
  command @code{help target} lists all possible targets rather than
  current ones.
  
+ @kindex maint info sections
+ @item maint info sections
+ Another command that can give you extra information about program sections
+ is @code{maint info sections}.  In addition to the section information
+ displayed by @code{info files}, this command displays the flags and file
+ offset of each section in the executable and core dump files.  In addition,
+ @code{maint info sections} provides the following command options (which
+ may be arbitrarily combined):
+ 
+ @table @code
+ @kindex maint info sections ALLOBJ
+ @item ALLOBJ
+ Display sections for all loaded object files, including shared libraries.
+ @kindex maint info sections @samp{<section name(s)>}
+ @item @samp{<section name(s)>}
+ Display info only for section(s) matching the listed name(s).
+ @kindex maint info sections @samp{<section flag(s)>}
+ @item @samp{<section flag(s)>}
+ Display info only for sections for which @samp{<section flag(s)>} are true.
+ The section flags that @value{GDBN} currently knows about are @code{ALLOC,
+ LOAD, RELOC, READONLY, CODE, DATA, ROM, CONSTRUCTOR, HAS_CONTENTS, 
+ NEVER_LOAD, COFF_SHARED_LIBRARY,} and @code{IS_COMMON}.
+ @end table
+ 
  @end table
  
  All file-specifying commands allow both absolute and relative file names