108 lines
		
	
	
	
		
			4.4 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
			
		
		
	
	
			108 lines
		
	
	
	
		
			4.4 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
<HTML>
 | 
						|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 | 
						|
<!-- Created on March, 27  2008 by texi2html 1.64 -->
 | 
						|
<!-- 
 | 
						|
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
 | 
						|
            Karl Berry  <karl@freefriends.org>
 | 
						|
            Olaf Bachmann <obachman@mathematik.uni-kl.de>
 | 
						|
            and many others.
 | 
						|
Maintained by: Olaf Bachmann <obachman@mathematik.uni-kl.de>
 | 
						|
Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
 | 
						|
 
 | 
						|
-->
 | 
						|
<HEAD>
 | 
						|
<TITLE>Debugging with GDB: Footnotes</TITLE>
 | 
						|
 | 
						|
<META NAME="description" CONTENT="Debugging with GDB: Footnotes">
 | 
						|
<META NAME="keywords" CONTENT="Debugging with GDB: Footnotes">
 | 
						|
<META NAME="resource-type" CONTENT="document">
 | 
						|
<META NAME="distribution" CONTENT="global">
 | 
						|
<META NAME="Generator" CONTENT="texi2html 1.64">
 | 
						|
 | 
						|
</HEAD>
 | 
						|
 | 
						|
<BODY LANG="" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
 | 
						|
 | 
						|
<A NAME="gdb_fot.html"></A>
 | 
						|
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 | 
						|
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb.html#SEC_Top">Top</A>]</TD>
 | 
						|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_toc.html#SEC_Contents">Contents</A>]</TD>
 | 
						|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_38.html#SEC764">Index</A>]</TD>
 | 
						|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_abt.html#SEC_About"> ? </A>]</TD>
 | 
						|
</TR></TABLE>
 | 
						|
<H1>Footnotes</H1>
 | 
						|
<H3><A NAME="FOOT1" HREF="gdb_3.html#DOCF1">(1)</A></H3>
 | 
						|
<P>On
 | 
						|
DOS/Windows systems, the home directory is the one pointed to by the
 | 
						|
<CODE>HOME</CODE> environment variable.
 | 
						|
<H3><A NAME="FOOT2" HREF="gdb_5.html#DOCF2">(2)</A></H3>
 | 
						|
<P>Currently, only
 | 
						|
GNU/Linux.
 | 
						|
<H3><A NAME="FOOT3" HREF="gdb_7.html#DOCF3">(3)</A></H3>
 | 
						|
<P>
 | 
						|
Note that embedded programs (the so-called "free-standing"
 | 
						|
environment) are not required to have a <CODE>main</CODE> function as the
 | 
						|
entry point.  They could even have multiple entry points.
 | 
						|
<H3><A NAME="FOOT4" HREF="gdb_8.html#DOCF4">(4)</A></H3>
 | 
						|
<P>
 | 
						|
The only restriction is that your editor (say <CODE>ex</CODE>), recognizes the
 | 
						|
following command-line syntax:
 | 
						|
<TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>ex +<VAR>number</VAR> file
 | 
						|
</FONT></pre></td></tr></table>The optional numeric value +<VAR>number</VAR> specifies the number of the line in
 | 
						|
the file where to start editing.
 | 
						|
<H3><A NAME="FOOT5" HREF="gdb_9.html#DOCF5">(5)</A></H3>
 | 
						|
<P><SAMP>`b'</SAMP> cannot be used because these format letters are also
 | 
						|
used with the <CODE>x</CODE> command, where <SAMP>`b'</SAMP> stands for "byte";
 | 
						|
see <A HREF="gdb_9.html#SEC64">Examining Memory</A>.
 | 
						|
<H3><A NAME="FOOT6" HREF="gdb_9.html#DOCF6">(6)</A></H3>
 | 
						|
<P>This is a way of removing
 | 
						|
one word from the stack, on machines where stacks grow downward in
 | 
						|
memory (most machines, nowadays).  This assumes that the innermost
 | 
						|
stack frame is selected; setting <CODE>$sp</CODE> is not allowed when other
 | 
						|
stack frames are selected.  To pop entire frames off the stack,
 | 
						|
regardless of machine architecture, use <CODE>return</CODE>;
 | 
						|
see <A HREF="gdb_15.html#SEC151">Returning from a Function</A>.
 | 
						|
<H3><A NAME="FOOT7" HREF="gdb_18.html#DOCF7">(7)</A></H3>
 | 
						|
<P>If you choose a port number that
 | 
						|
conflicts with another service, <CODE>gdbserver</CODE> prints an error message
 | 
						|
and exits.
 | 
						|
<H3><A NAME="FOOT8" HREF="gdb_30.html#DOCF8">(8)</A></H3>
 | 
						|
<P>In
 | 
						|
<TT>`gdb-6.8/gdb/refcard.ps'</TT> of the version 6.8
 | 
						|
release.
 | 
						|
<H3><A NAME="FOOT9" HREF="gdb_33.html#DOCF9">(9)</A></H3>
 | 
						|
<P>The <SAMP>`qP'</SAMP> and <SAMP>`qL'</SAMP>
 | 
						|
packets predate these conventions, and have arguments without any terminator
 | 
						|
for the packet name; we suspect they are in widespread use in places that
 | 
						|
are difficult to upgrade.  The <SAMP>`qC'</SAMP> packet has no arguments, but some
 | 
						|
existing stubs (e.g. RedBoot) are known to not check for the end of the
 | 
						|
packet.
 | 
						|
<HR SIZE=1>
 | 
						|
<BR>  
 | 
						|
<FONT SIZE="-1">
 | 
						|
 | 
						|
<address>
 | 
						|
 | 
						|
<p>Please send FSF & GNU inquiries & questions to <a
 | 
						|
href="mailto:gnu@gnu.org">gnu@gnu.org</a>.  There are also <a
 | 
						|
href="http://www.gnu.org/home.html#ContactInfo">other ways to
 | 
						|
contact</a> the FSF.</p>
 | 
						|
 | 
						|
<p>These pages are maintained by <a
 | 
						|
href="http://www.gnu.org/software/gdb/">the GDB developers</a>.</p>
 | 
						|
 | 
						|
<p>Copyright Free Software Foundation, Inc., 59 Temple Place - Suite
 | 
						|
330, Boston, MA 02111, USA.</p>
 | 
						|
 | 
						|
<p>Verbatim copying and distribution of this entire article is
 | 
						|
permitted in any medium, provided this notice is preserved.</p>
 | 
						|
 | 
						|
</address>
 | 
						|
 | 
						|
This document was generated
 | 
						|
by <I>GDB Administrator</I> on <I>March, 27  2008</I>
 | 
						|
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
 | 
						|
"><I>texi2html</I></A>
 | 
						|
 | 
						|
</BODY>
 | 
						|
</HTML>
 |