\textit{For a constant form there is no way to
express the absence of a default value.}
-\item A \livelink{chap:DWATconstvalue}{DW\-\_AT\-\_const\-\_value} attribute for an entry describing a
+\item A \livelink{chap:DWATconstvalue}{DW\-\_AT\-\_const\-\_value} attribute
+for
+\hypertarget{chap:DWATconstvalueconstantobject}
+an entry describing a
variable or formal parameter whose value is constant and not
represented by an object in the address space of the program,
or an entry describing a named constant. (Note that such
\item A \livelink{chap:DWATconstexpr}{DW\-\_AT\-\_const\-\_expr} attribute,
-which is a \livelink{chap:flag}{flag}, if a
+which
+\hypertarget{chap:DWATconstexprcompiletimeconstantobject}
+is a \livelink{chap:flag}{flag}, if a
variable entry represents a C++ object declared with the
-constexpr specifier. This attributes indicates that the
+\textit{constexpr} specifier. This attributes indicates that the
variable can be evaluated as a compile\dash time constant.
\textit{In C++,
&\livelink{chap:DWATbytestridesubrangestridedimensionofarraytype}{Subrange stride (dimension of array type)} \\
&\livelink{chap:DWATbytestrideenumerationstridedimensionofarraytype}{Enumeration stride (dimension of array type)} \\
\livetarg{chap:DWATcallcolumn}{DW\-\_AT\-\_call\-\_column}
-&Column position of inlined subroutine call \\
+&\livelink{chap:DWATcallcolumncolumnpositionofinlinedsubroutinecall}{Column position of inlined subroutine call}\\
\livetarg{chap:DWATcallfile}{DW\-\_AT\-\_call\-\_file}
-&File containing inlined subroutine call \\
+&\livelink{chap:DWATcallfilefilecontaininginlinedsubroutinecall}{File containing inlined subroutine call} \\
\livetarg{chap:DWATcallline}{DW\-\_AT\-\_call\-\_line}
-&Line number of inlined subroutine call \\
+&\livelink{chap:DWATcalllinelinenumberofinlinedsubroutinecall}{Line number of inlined subroutine call} \\
\livetarg{chap:DWATcallingconvention}{DW\-\_AT\-\_calling\-\_convention}
-&Subprogram calling convention \\
-&\livetarg{chap:DWATcommonreference}{DW\-\_AT\-\_common\-\_reference} \\
-&Common \livelink{chap:commonblockreferenceattribute} usage \\
+&\livelink{chap:DWATcallingconventionsubprogramcallingconvention}{Subprogram calling convention} \\
+\livetarg{chap:DWATcommonreference}{DW\-\_AT\-\_common\-\_reference}
+&\livelink{chap:commonreferencecommonblockusage}{Common block usage} \\
\livetarg{chap:DWATcompdir}{DW\-\_AT\-\_comp\-\_dir}
-&Compilation directory \\
+&\livelink{chap:DWATcompdircompilationdirectory}{Compilation directory} \\
\livetarg{chap:DWATconstvalue}{DW\-\_AT\-\_const\-\_value}
-&Constant object \\
-\livelink{chap:DWATconstvalue}{DW\-\_AT\-\_const\-\_value}
-&Enumeration literal value \\
-&Template value parameter \\
+&\livelink{chap:DWATconstvalueconstantobject}{Constant object} \\
+&\livelink{chap:DWATconstvalueenumerationliteralvalue}{Enumeration literal value} \\
+&\livelink{chap:DWATconstvaluetemplatevalueparameter}{Template value parameter} \\
\livetarg{chap:DWATconstexpr}{DW\-\_AT\-\_const\-\_expr}
-&Compile\dash time constant object \\
-&Compile\dash time constant function \\
+&\livelink{chap:DWATconstexprcompiletimeconstantobject}{Compile-time constant object} \\
+&\livelink{chap:DWATconstexprcompiletimeconstantfunction}{Compile-time constant function} \\
\livetarg{chap:DWATcontainingtype}{DW\-\_AT\-\_containing\-\_type}
-&Containing type of pointer to member type \\
+&\livelink{chap:DWATcontainingtypecontainingtypeofpointertomembertype}{Containing type of pointer to member type} \\
\livetarg{chap:DWATcount}{DW\-\_AT\-\_count}
-&Elements of subrange type \\
+&\livelink{chap:DWATcountelementsofsubrangetype}{Elements of subrange type} \\
\livetarg{chap:DWATdatabitoffset}{DW\-\_AT\-\_data\-\_bit\-\_offset}
&Base type bit location \\
&Data member bit location \\
information for this compilation unit
(see Section \refersec{chap:macroinformation}).
-\item A \livelink{chap:DWATcompdir}{DW\-\_AT\-\_comp\-\_dir} attribute whose value is a
+\item A
+\livelink{chap:DWATcompdir}{DW\-\_AT\-\_comp\-\_dir}
+attribute
+\hypertarget{chap:DWATcompdircompilationdirectory}
+whose value is a
null\dash terminated string containing the current working directory
of the compilation command that produced this compilation
unit in whatever form makes sense for the host system.
and will therefore not be safe to call from within a debugger.
}
-A subroutine entry may contain a \livelink{chap:DWATcallingconvention}{DW\-\_AT\-\_calling\-\_convention}
+A subroutine entry may
+\hypertarget{chap:DWATcallingconventionsubprogramcallingconvention}
+contain a
+\livelink{chap:DWATcallingconvention}{DW\-\_AT\-\_calling\-\_convention}
attribute, whose value is an integer constant. The set of
calling convention codes is given in
Figure \refersec{fig:callingconventioncodes}.
has a child entry with the
tag \livetarg{chap:DWTAGcommoninclusion}{DW\-\_TAG\-\_common\-\_inclusion}.
The
+\hypertarget{chap:commonreferencecommonblockusage}
common inclusion entry has a
\livelink{chap:DWATcommonreference}{DW\-\_AT\-\_common\-\_reference} attribute
whose value is a reference to the debugging information entry
the inline expansion (see
Section \refersec{chap:entryaddress}).
-An inlined subroutine entry may also have \livelink{chap:DWATcallfile}{DW\-\_AT\-\_call\-\_file},
+% Positions of the 3 targets here is a bit arbitrary.
+An inlined
+\hypertarget{chap:DWATcalllinelinenumberofinlinedsubroutinecall}
+subroutine
+\hypertarget{chap:DWATcallcolumncolumnpositionofinlinedsubroutinecall}
+entry
+\hypertarget{chap:DWATcallfilefilecontaininginlinedsubroutinecall}
+may also have \livelink{chap:DWATcallfile}{DW\-\_AT\-\_call\-\_file},
\livelink{chap:DWATcallline}{DW\-\_AT\-\_call\-\_line} and \livelink{chap:DWATcallcolumn}{DW\-\_AT\-\_call\-\_column} attributes,
each of whose
value is an integer constant. These attributes represent the
describe the coordinates of the subroutine declaration that
was inlined, rather they describe the coordinates of the call.
-An inlined subroutine entry may have a \livelink{chap:DWATconstexpr}{DW\-\_AT\-\_const\-\_expr}
+An inlined subroutine entry
+\hypertarget{chap:DWATconstexprcompiletimeconstantfunction}
+may have a
+\livelink{chap:DWATconstexpr}{DW\-\_AT\-\_const\-\_expr}
attribute, which is a \livelink{chap:flag}{flag}
whose presence indicates that the
subroutine has been evaluated as a compile\dash time constant. Such
Each
such entry may have a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, whose value is
a null\dash terminated string containing the name of the formal
-value parameter as it appears in the source program. The
+value parameter as it appears in the source program.
+The
+\hypertarget{chap:DWATconstvaluetemplatevalueparameter}
template value parameter entry also has a \livelink{chap:DWATtype}{DW\-\_AT\-\_type} attribute
describing the type of the parameterized value. Finally,
the template value parameter entry has a \livelink{chap:DWATconstvalue}{DW\-\_AT\-\_const\-\_value}
enumerator entries appear in the same order as the declarations
of the enumeration literals in the source program.
-Each enumerator entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, whose
+Each enumerator entry has a
+\livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, whose
value is a null\dash terminated string containing the name of the
-enumeration literal as it appears in the source program. Each
-enumerator entry also has a \livelink{chap:DWATconstvalue}{DW\-\_AT\-\_const\-\_value} attribute,
+\hypertarget{chap:DWATconstvalueenumerationliteralvalue}
+enumeration literal as it appears in the source program.
+Each enumerator entry also has a
+\livelink{chap:DWATconstvalue}{DW\-\_AT\-\_const\-\_value} attribute,
whose value is the actual numeric value of the enumerator as
represented on the target system.
The subrange entry may have the attributes \livelink{chap:DWATlowerbound}{DW\-\_AT\-\_lower\-\_bound}
and \livelink{chap:DWATupperbound}{DW\-\_AT\-\_upper\-\_bound} to specify, respectively, the lower
and upper bound values of the subrange. The \livelink{chap:DWATupperbound}{DW\-\_AT\-\_upper\-\_bound}
-attribute may be replaced by a \livelink{chap:DWATcount}{DW\-\_AT\-\_count} attribute, whose
+attribute
+\hypertarget{chap:DWATcountelementsofsubrangetype}
+may be replaced by a
+\livelink{chap:DWATcount}{DW\-\_AT\-\_count} attribute, whose
value describes the number of elements in the subrange rather
than the value of the last element. The value of each of
these attributes is determined as described in
describe the type of the class or structure member to which
objects of this type may point.
-The pointer to member entry also has a \livelink{chap:DWATcontainingtype}{DW\-\_AT\-\_containing\-\_type}
+The pointer to member entry also
+\hypertarget{chap:DWATcontainingtypecontainingtypeofpointertomembertype}
+has a
+\livelink{chap:DWATcontainingtype}{DW\-\_AT\-\_containing\-\_type}
attribute, whose value is a reference to a debugging
information entry for the class or structure to whose members
objects of this type may point.