135 lines
6.4 KiB
HTML
135 lines
6.4 KiB
HTML
<HTML>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<!-- Created on March, 13 2002 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>STABS: Constants</TITLE>
|
|
|
|
<META NAME="description" CONTENT="STABS: Constants">
|
|
<META NAME="keywords" CONTENT="STABS: Constants">
|
|
<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="SEC16"></A>
|
|
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
|
|
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="stabs_2.html#SEC15"> < </A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="stabs_4.html#SEC17"> > </A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="stabs_4.html#SEC17"> << </A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="stabs.html#SEC_Top"> Up </A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="stabs_4.html#SEC17"> >> </A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="stabs.html#SEC_Top">Top</A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="stabs_toc.html#SEC_Contents">Contents</A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="stabs_14.html#SEC90">Index</A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="stabs_abt.html#SEC_About"> ? </A>]</TD>
|
|
</TR></TABLE>
|
|
<H1> 3. Constants </H1>
|
|
<!--docid::SEC16::-->
|
|
<P>
|
|
|
|
The <SAMP>`c'</SAMP> symbol descriptor indicates that this stab represents a
|
|
constant. This symbol descriptor is an exception to the general rule
|
|
that symbol descriptors are followed by type information. Instead, it
|
|
is followed by <SAMP>`='</SAMP> and one of the following:
|
|
</P><P>
|
|
|
|
<DL COMPACT>
|
|
<DT><CODE>b <VAR>value</VAR></CODE>
|
|
<DD>Boolean constant. <VAR>value</VAR> is a numeric value; I assume it is 0 for
|
|
false or 1 for true.
|
|
<P>
|
|
|
|
<DT><CODE>c <VAR>value</VAR></CODE>
|
|
<DD>Character constant. <VAR>value</VAR> is the numeric value of the constant.
|
|
<P>
|
|
|
|
<DT><CODE>e <VAR>type-information</VAR> , <VAR>value</VAR></CODE>
|
|
<DD>Constant whose value can be represented as integral.
|
|
<VAR>type-information</VAR> is the type of the constant, as it would appear
|
|
after a symbol descriptor (see section <A HREF="stabs_1.html#SEC4">1.3 The String Field</A>). <VAR>value</VAR> is the
|
|
numeric value of the constant. GDB 4.9 does not actually get the right
|
|
value if <VAR>value</VAR> does not fit in a host <CODE>int</CODE>, but it does not
|
|
do anything violent, and future debuggers could be extended to accept
|
|
integers of any size (whether unsigned or not). This constant type is
|
|
usually documented as being only for enumeration constants, but GDB has
|
|
never imposed that restriction; I don't know about other debuggers.
|
|
<P>
|
|
|
|
<DT><CODE>i <VAR>value</VAR></CODE>
|
|
<DD>Integer constant. <VAR>value</VAR> is the numeric value. The type is some
|
|
sort of generic integer type (for GDB, a host <CODE>int</CODE>); to specify
|
|
the type explicitly, use <SAMP>`e'</SAMP> instead.
|
|
<P>
|
|
|
|
<DT><CODE>r <VAR>value</VAR></CODE>
|
|
<DD>Real constant. <VAR>value</VAR> is the real value, which can be <SAMP>`INF'</SAMP>
|
|
(optionally preceded by a sign) for infinity, <SAMP>`QNAN'</SAMP> for a quiet
|
|
NaN (not-a-number), or <SAMP>`SNAN'</SAMP> for a signalling NaN. If it is a
|
|
normal number the format is that accepted by the C library function
|
|
<CODE>atof</CODE>.
|
|
<P>
|
|
|
|
<DT><CODE>s <VAR>string</VAR></CODE>
|
|
<DD>String constant. <VAR>string</VAR> is a string enclosed in either <SAMP>`''</SAMP>
|
|
(in which case <SAMP>`''</SAMP> characters within the string are represented as
|
|
<SAMP>`\''</SAMP> or <SAMP>`"'</SAMP> (in which case <SAMP>`"'</SAMP> characters within the
|
|
string are represented as <SAMP>`\"'</SAMP>).
|
|
<P>
|
|
|
|
<DT><CODE>S <VAR>type-information</VAR> , <VAR>elements</VAR> , <VAR>bits</VAR> , <VAR>pattern</VAR></CODE>
|
|
<DD>Set constant. <VAR>type-information</VAR> is the type of the constant, as it
|
|
would appear after a symbol descriptor (see section <A HREF="stabs_1.html#SEC4">1.3 The String Field</A>).
|
|
<VAR>elements</VAR> is the number of elements in the set (does this means
|
|
how many bits of <VAR>pattern</VAR> are actually used, which would be
|
|
redundant with the type, or perhaps the number of bits set in
|
|
<VAR>pattern</VAR>? I don't get it), <VAR>bits</VAR> is the number of bits in the
|
|
constant (meaning it specifies the length of <VAR>pattern</VAR>, I think),
|
|
and <VAR>pattern</VAR> is a hexadecimal representation of the set. AIX
|
|
documentation refers to a limit of 32 bytes, but I see no reason why
|
|
this limit should exist. This form could probably be used for arbitrary
|
|
constants, not just sets; the only catch is that <VAR>pattern</VAR> should be
|
|
understood to be target, not host, byte order and format.
|
|
</DL>
|
|
<P>
|
|
|
|
The boolean, character, string, and set constants are not supported by
|
|
GDB 4.9, but it ignores them. GDB 4.8 and earlier gave an error
|
|
message and refused to read symbols from the file containing the
|
|
constants.
|
|
</P><P>
|
|
|
|
The above information is followed by <SAMP>`;'</SAMP>.
|
|
</P><P>
|
|
|
|
<A NAME="Variables"></A>
|
|
<HR SIZE="6">
|
|
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
|
|
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="stabs_4.html#SEC17"> << </A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="stabs_4.html#SEC17"> >> </A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="stabs.html#SEC_Top">Top</A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="stabs_toc.html#SEC_Contents">Contents</A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="stabs_14.html#SEC90">Index</A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="stabs_abt.html#SEC_About"> ? </A>]</TD>
|
|
</TR></TABLE>
|
|
<BR>
|
|
<FONT SIZE="-1">
|
|
This document was generated
|
|
by <I>GDB Administrator</I> on <I>March, 13 2002</I>
|
|
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
|
|
"><I>texi2html</I></A>
|
|
|
|
</BODY>
|
|
</HTML>
|