\doxysection{Locations of data:\+ DWARF2-\/\+DWARF5 }
\hypertarget{group__locations}{}\label{group__locations}\index{Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}}
\doxysubsubsection*{Macros}
\begin{DoxyCompactItemize}
\item 
\Hypertarget{group__locations_gaa5d01e009c2e6dd08ad3d520e9661576}\label{group__locations_gaa5d01e009c2e6dd08ad3d520e9661576} 
\+\#define {\bfseries DW\+\_\+\+LKIND\+\_\+expression}~0 /\+\texorpdfstring{$\ast$}{*} DWARF2,3,4,5 \texorpdfstring{$\ast$}{*}/\+
\item 
\Hypertarget{group__locations_gac92ff00ad4dc9342abc1cd0ddf990aa1}\label{group__locations_gac92ff00ad4dc9342abc1cd0ddf990aa1} 
\+\#define {\bfseries DW\+\_\+\+LKIND\+\_\+loclist}~1 /\+\texorpdfstring{$\ast$}{*} DWARF 2,3,4 \texorpdfstring{$\ast$}{*}/\+
\item 
\Hypertarget{group__locations_ga21741e0f5cb1ff3c1710a58e278c6c1c}\label{group__locations_ga21741e0f5cb1ff3c1710a58e278c6c1c} 
\+\#define {\bfseries DW\+\_\+\+LKIND\+\_\+\+GNU\+\_\+exp\+\_\+list}~2 /\+\texorpdfstring{$\ast$}{*} GNU DWARF4 .dwo extension \texorpdfstring{$\ast$}{*}/\+
\item 
\Hypertarget{group__locations_gaaa2f120881747aa8f500b98ecdd6a83c}\label{group__locations_gaaa2f120881747aa8f500b98ecdd6a83c} 
\+\#define {\bfseries DW\+\_\+\+LKIND\+\_\+loclists}~5 /\+\texorpdfstring{$\ast$}{*} DWARF5 loclists \texorpdfstring{$\ast$}{*}/\+
\item 
\Hypertarget{group__locations_gaa246baf43df2f12960ad7ce898d7139b}\label{group__locations_gaa246baf43df2f12960ad7ce898d7139b} 
\+\#define {\bfseries DW\+\_\+\+LKIND\+\_\+unknown}~99
\end{DoxyCompactItemize}
\doxysubsubsection*{Functions}
\begin{DoxyCompactItemize}
\item 
DW\+\_\+\+API int \doxymbox{\hyperlink{group__locations_ga63391b01dedf669137d7b8f004d26040}{dwarf\+\_\+get\+\_\+loclist\+\_\+c}} (\doxymbox{\hyperlink{group__allstructs_ga3b8f8b4e43653647a2face222040a915}{Dwarf\+\_\+\+Attribute}} dw\+\_\+attr, \doxymbox{\hyperlink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c}} \texorpdfstring{$\ast$}{*}dw\+\_\+loclist\+\_\+head, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+locentry\+\_\+count, \doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}dw\+\_\+error)
\begin{DoxyCompactList}\small\item\em Location Lists and Expressions. \end{DoxyCompactList}\item 
DW\+\_\+\+API int \doxymbox{\hyperlink{group__locations_gaab8bf7b5adbf7c5021ac3fb87270a5af}{dwarf\+\_\+get\+\_\+loclist\+\_\+head\+\_\+kind}} (\doxymbox{\hyperlink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c}} dw\+\_\+loclist\+\_\+head, unsigned int \texorpdfstring{$\ast$}{*}dw\+\_\+lkind, \doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}dw\+\_\+error)
\begin{DoxyCompactList}\small\item\em Know what kind of location data it is. \end{DoxyCompactList}\item 
DW\+\_\+\+API int \doxymbox{\hyperlink{group__locations_ga889f24f93fe1ff22a64772fd42baf822}{dwarf\+\_\+get\+\_\+locdesc\+\_\+entry\+\_\+d}} (\doxymbox{\hyperlink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c}} dw\+\_\+loclist\+\_\+head, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} dw\+\_\+index, \doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}dw\+\_\+lle\+\_\+value\+\_\+out, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+rawlowpc, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+rawhipc, \doxymbox{\hyperlink{group__basicdatatypes_ga32afecc94a71aae2be36aa279f1dded8}{Dwarf\+\_\+\+Bool}} \texorpdfstring{$\ast$}{*}dw\+\_\+debug\+\_\+addr\+\_\+unavailable, \doxymbox{\hyperlink{group__basicdatatypes_ga16ddc0e584ea1a17237ccf1617f31075}{Dwarf\+\_\+\+Addr}} \texorpdfstring{$\ast$}{*}dw\+\_\+lowpc\+\_\+cooked, \doxymbox{\hyperlink{group__basicdatatypes_ga16ddc0e584ea1a17237ccf1617f31075}{Dwarf\+\_\+\+Addr}} \texorpdfstring{$\ast$}{*}dw\+\_\+hipc\+\_\+cooked, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+locexpr\+\_\+op\+\_\+count\+\_\+out, \doxymbox{\hyperlink{group__allstructs_gabcb72d212aafc296a1fe1bb92689e9b8}{Dwarf\+\_\+\+Locdesc\+\_\+c}} \texorpdfstring{$\ast$}{*}dw\+\_\+locentry\+\_\+out, \doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}dw\+\_\+loclist\+\_\+source\+\_\+out, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+expression\+\_\+offset\+\_\+out, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+locdesc\+\_\+offset\+\_\+out, \doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}dw\+\_\+error)
\begin{DoxyCompactList}\small\item\em Retrieve the details(\+\_\+d) of a location expression. \end{DoxyCompactList}\item 
DW\+\_\+\+API int \doxymbox{\hyperlink{group__locations_ga8b3ebddae8d5dc0f617ce87e3eb4133f}{dwarf\+\_\+get\+\_\+locdesc\+\_\+entry\+\_\+e}} (\doxymbox{\hyperlink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c}} dw\+\_\+loclist\+\_\+head, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} dw\+\_\+index, \doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}dw\+\_\+lle\+\_\+value\+\_\+out, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+rawlowpc, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+rawhipc, \doxymbox{\hyperlink{group__basicdatatypes_ga32afecc94a71aae2be36aa279f1dded8}{Dwarf\+\_\+\+Bool}} \texorpdfstring{$\ast$}{*}dw\+\_\+debug\+\_\+addr\+\_\+unavailable, \doxymbox{\hyperlink{group__basicdatatypes_ga16ddc0e584ea1a17237ccf1617f31075}{Dwarf\+\_\+\+Addr}} \texorpdfstring{$\ast$}{*}dw\+\_\+lowpc\+\_\+cooked, \doxymbox{\hyperlink{group__basicdatatypes_ga16ddc0e584ea1a17237ccf1617f31075}{Dwarf\+\_\+\+Addr}} \texorpdfstring{$\ast$}{*}dw\+\_\+hipc\+\_\+cooked, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+locexpr\+\_\+op\+\_\+count\+\_\+out, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+lle\+\_\+bytecount, \doxymbox{\hyperlink{group__allstructs_gabcb72d212aafc296a1fe1bb92689e9b8}{Dwarf\+\_\+\+Locdesc\+\_\+c}} \texorpdfstring{$\ast$}{*}dw\+\_\+locentry\+\_\+out, \doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}dw\+\_\+loclist\+\_\+source\+\_\+out, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+expression\+\_\+offset\+\_\+out, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+locdesc\+\_\+offset\+\_\+out, \doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}dw\+\_\+error)
\begin{DoxyCompactList}\small\item\em Retrieve the details(\+\_\+e) of a location expression. \end{DoxyCompactList}\item 
DW\+\_\+\+API int \doxymbox{\hyperlink{group__locations_ga736d9d65b47aa08977785f3c0629b064}{dwarf\+\_\+get\+\_\+location\+\_\+op\+\_\+value\+\_\+c}} (\doxymbox{\hyperlink{group__allstructs_gabcb72d212aafc296a1fe1bb92689e9b8}{Dwarf\+\_\+\+Locdesc\+\_\+c}} dw\+\_\+locdesc, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} dw\+\_\+index, \doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}dw\+\_\+operator\+\_\+out, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+operand1, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+operand2, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+operand3, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+offset\+\_\+for\+\_\+branch, \doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}dw\+\_\+error)
\begin{DoxyCompactList}\small\item\em Get the raw values from a single location operation. \end{DoxyCompactList}\item 
DW\+\_\+\+API int \doxymbox{\hyperlink{group__locations_ga2061570ef695cfd9aa71e428845fef37}{dwarf\+\_\+loclist\+\_\+from\+\_\+expr\+\_\+c}} (\doxymbox{\hyperlink{group__allstructs_gac2ba1e1c1b70a3191506b414195ca807}{Dwarf\+\_\+\+Debug}} dw\+\_\+dbg, \doxymbox{\hyperlink{group__basicdatatypes_ga376c1939313af42401fc67bc998fdd2c}{Dwarf\+\_\+\+Ptr}} dw\+\_\+expression\+\_\+in, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} dw\+\_\+expression\+\_\+length, \doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}} dw\+\_\+address\+\_\+size, \doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}} dw\+\_\+offset\+\_\+size, \doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}} dw\+\_\+dwarf\+\_\+version, \doxymbox{\hyperlink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c}} \texorpdfstring{$\ast$}{*}dw\+\_\+loc\+\_\+head, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+listlen, \doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}dw\+\_\+error)
\begin{DoxyCompactList}\small\item\em Generate a \doxylink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c} from an expression block. \end{DoxyCompactList}\item 
DW\+\_\+\+API void \doxymbox{\hyperlink{group__locations_ga15258867c631414fb4ed048249374e05}{dwarf\+\_\+dealloc\+\_\+loc\+\_\+head\+\_\+c}} (\doxymbox{\hyperlink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c}} dw\+\_\+head)
\begin{DoxyCompactList}\small\item\em Dealloc (free) all memory allocated for \doxylink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c}. \end{DoxyCompactList}\item 
DW\+\_\+\+API int \doxymbox{\hyperlink{group__locations_gadb9d0258969de3bccd1a905840ca7256}{dwarf\+\_\+load\+\_\+loclists}} (\doxymbox{\hyperlink{group__allstructs_gac2ba1e1c1b70a3191506b414195ca807}{Dwarf\+\_\+\+Debug}} dw\+\_\+dbg, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+loclists\+\_\+count, \doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}dw\+\_\+error)
\begin{DoxyCompactList}\small\item\em Load Loclists. \end{DoxyCompactList}\item 
DW\+\_\+\+API int \doxymbox{\hyperlink{group__locations_ga502c7c9939ad6be527f58940c7e43b63}{dwarf\+\_\+get\+\_\+loclist\+\_\+offset\+\_\+index\+\_\+value}} (\doxymbox{\hyperlink{group__allstructs_gac2ba1e1c1b70a3191506b414195ca807}{Dwarf\+\_\+\+Debug}} dw\+\_\+dbg, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} dw\+\_\+context\+\_\+index, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} dw\+\_\+offsetentry\+\_\+index, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+offset\+\_\+value\+\_\+out, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+global\+\_\+offset\+\_\+value\+\_\+out, \doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}dw\+\_\+error)
\begin{DoxyCompactList}\small\item\em Return certain loclists offsets. \end{DoxyCompactList}\item 
DW\+\_\+\+API int \doxymbox{\hyperlink{group__locations_gae8386dee95f51cd7e7e5270faa5a5d1d}{dwarf\+\_\+get\+\_\+loclist\+\_\+head\+\_\+basics}} (\doxymbox{\hyperlink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c}} dw\+\_\+head, \doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}dw\+\_\+lkind, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+lle\+\_\+count, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+loclists\+\_\+version, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+loclists\+\_\+index\+\_\+returned, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+bytes\+\_\+total\+\_\+in\+\_\+rle, \doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}} \texorpdfstring{$\ast$}{*}dw\+\_\+offset\+\_\+size, \doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}} \texorpdfstring{$\ast$}{*}dw\+\_\+address\+\_\+size, \doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}} \texorpdfstring{$\ast$}{*}dw\+\_\+segment\+\_\+selector\+\_\+size, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+overall\+\_\+offset\+\_\+of\+\_\+this\+\_\+context, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+total\+\_\+length\+\_\+of\+\_\+this\+\_\+context, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+offset\+\_\+table\+\_\+offset, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+offset\+\_\+table\+\_\+entrycount, \doxymbox{\hyperlink{group__basicdatatypes_ga32afecc94a71aae2be36aa279f1dded8}{Dwarf\+\_\+\+Bool}} \texorpdfstring{$\ast$}{*}dw\+\_\+loclists\+\_\+base\+\_\+present, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+loclists\+\_\+base, \doxymbox{\hyperlink{group__basicdatatypes_ga32afecc94a71aae2be36aa279f1dded8}{Dwarf\+\_\+\+Bool}} \texorpdfstring{$\ast$}{*}dw\+\_\+loclists\+\_\+base\+\_\+address\+\_\+present, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+loclists\+\_\+base\+\_\+address, \doxymbox{\hyperlink{group__basicdatatypes_ga32afecc94a71aae2be36aa279f1dded8}{Dwarf\+\_\+\+Bool}} \texorpdfstring{$\ast$}{*}dw\+\_\+loclists\+\_\+debug\+\_\+addr\+\_\+base\+\_\+present, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+loclists\+\_\+debug\+\_\+addr\+\_\+base, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+offset\+\_\+this\+\_\+lle\+\_\+area, \doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}dw\+\_\+error)
\begin{DoxyCompactList}\small\item\em Return basic data about a loclists head. \end{DoxyCompactList}\item 
DW\+\_\+\+API int \doxymbox{\hyperlink{group__locations_ga7cbb42b959f8553ba55cad649e0ba777}{dwarf\+\_\+get\+\_\+loclist\+\_\+context\+\_\+basics}} (\doxymbox{\hyperlink{group__allstructs_gac2ba1e1c1b70a3191506b414195ca807}{Dwarf\+\_\+\+Debug}} dw\+\_\+dbg, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} dw\+\_\+index, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+header\+\_\+offset, \doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}dw\+\_\+offset\+\_\+size, \doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}dw\+\_\+extension\+\_\+size, unsigned int \texorpdfstring{$\ast$}{*}dw\+\_\+version, \doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}dw\+\_\+address\+\_\+size, \doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}dw\+\_\+segment\+\_\+selector\+\_\+size, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+offset\+\_\+entry\+\_\+count, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+offset\+\_\+of\+\_\+offset\+\_\+array, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+offset\+\_\+of\+\_\+first\+\_\+locentry, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+offset\+\_\+past\+\_\+last\+\_\+locentry, \doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}dw\+\_\+error)
\begin{DoxyCompactList}\small\item\em Return basic data about a loclists context. \end{DoxyCompactList}\item 
DW\+\_\+\+API int \doxymbox{\hyperlink{group__locations_ga78d3d5478acca1c9cd866cf6b5483e8d}{dwarf\+\_\+get\+\_\+loclist\+\_\+lle}} (\doxymbox{\hyperlink{group__allstructs_gac2ba1e1c1b70a3191506b414195ca807}{Dwarf\+\_\+\+Debug}} dw\+\_\+dbg, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} dw\+\_\+contextnumber, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} dw\+\_\+entry\+\_\+offset, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} dw\+\_\+endoffset, unsigned int \texorpdfstring{$\ast$}{*}dw\+\_\+entrylen, unsigned int \texorpdfstring{$\ast$}{*}dw\+\_\+entry\+\_\+kind, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+entry\+\_\+operand1, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+entry\+\_\+operand2, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+expr\+\_\+ops\+\_\+blocksize, \doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}dw\+\_\+expr\+\_\+ops\+\_\+offset, \doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}\texorpdfstring{$\ast$}{*}dw\+\_\+expr\+\_\+opsdata, \doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}dw\+\_\+error)
\begin{DoxyCompactList}\small\item\em Return basic data about a loclists context entry. \end{DoxyCompactList}\end{DoxyCompactItemize}


\doxysubsection{Detailed Description}


\label{doc-func-members}
\Hypertarget{group__locations_doc-func-members}
\doxysubsection{Function Documentation}
\Hypertarget{group__locations_ga15258867c631414fb4ed048249374e05}\index{Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}!dwarf\_dealloc\_loc\_head\_c@{dwarf\_dealloc\_loc\_head\_c}}
\index{dwarf\_dealloc\_loc\_head\_c@{dwarf\_dealloc\_loc\_head\_c}!Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}}
\doxysubsubsection{\texorpdfstring{dwarf\_dealloc\_loc\_head\_c()}{dwarf\_dealloc\_loc\_head\_c()}}
{\footnotesize\ttfamily \label{group__locations_ga15258867c631414fb4ed048249374e05} 
DW\+\_\+\+API void dwarf\+\_\+dealloc\+\_\+loc\+\_\+head\+\_\+c (\begin{DoxyParamCaption}\item[{\doxymbox{\hyperlink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c}}}]{dw\+\_\+head}{}\end{DoxyParamCaption})}



Dealloc (free) all memory allocated for \doxylink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c}. 


\begin{DoxyParams}{Parameters}
{\em dw\+\_\+head} & A head pointer.\\
\hline
\end{DoxyParams}
The caller should zero the passed-\/in pointer on return as it is stale at that point. \Hypertarget{group__locations_ga736d9d65b47aa08977785f3c0629b064}\index{Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}!dwarf\_get\_location\_op\_value\_c@{dwarf\_get\_location\_op\_value\_c}}
\index{dwarf\_get\_location\_op\_value\_c@{dwarf\_get\_location\_op\_value\_c}!Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}}
\doxysubsubsection{\texorpdfstring{dwarf\_get\_location\_op\_value\_c()}{dwarf\_get\_location\_op\_value\_c()}}
{\footnotesize\ttfamily \label{group__locations_ga736d9d65b47aa08977785f3c0629b064} 
DW\+\_\+\+API int dwarf\+\_\+get\+\_\+location\+\_\+op\+\_\+value\+\_\+c (\begin{DoxyParamCaption}\item[{\doxymbox{\hyperlink{group__allstructs_gabcb72d212aafc296a1fe1bb92689e9b8}{Dwarf\+\_\+\+Locdesc\+\_\+c}}}]{dw\+\_\+locdesc}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}}}]{dw\+\_\+index}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+operator\+\_\+out}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+operand1}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+operand2}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+operand3}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+offset\+\_\+for\+\_\+branch}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+error}{}\end{DoxyParamCaption})}



Get the raw values from a single location operation. 


\begin{DoxyParams}{Parameters}
{\em dw\+\_\+locdesc} & Pass in a valid \doxylink{group__allstructs_gabcb72d212aafc296a1fe1bb92689e9b8}{Dwarf\+\_\+\+Locdesc\+\_\+c}. \\
\hline
{\em dw\+\_\+index} & Pass in the operator index. zero through dw\+\_\+locexpr\+\_\+op\+\_\+count\+\_\+out-\/1. \\
\hline
{\em dw\+\_\+operator\+\_\+out} & On success returns the DW\+\_\+\+OP operator, such as DW\+\_\+\+OP\+\_\+plus . \\
\hline
{\em dw\+\_\+operand1} & On success returns the value of the operand or zero. \\
\hline
{\em dw\+\_\+operand2} & On success returns the value of the operand or zero. \\
\hline
{\em dw\+\_\+operand3} & On success returns the value of the operand or zero. \\
\hline
{\em dw\+\_\+offset\+\_\+for\+\_\+branch} & On success returns The byte offset of the operator within the entire expression. Useful for checking the correctness of operators that branch.. \\
\hline
{\em dw\+\_\+error} & The usual error detail return pointer. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
Returns DW\+\_\+\+DLV\+\_\+\+OK etc. 
\end{DoxyReturn}
\Hypertarget{group__locations_ga889f24f93fe1ff22a64772fd42baf822}\index{Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}!dwarf\_get\_locdesc\_entry\_d@{dwarf\_get\_locdesc\_entry\_d}}
\index{dwarf\_get\_locdesc\_entry\_d@{dwarf\_get\_locdesc\_entry\_d}!Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}}
\doxysubsubsection{\texorpdfstring{dwarf\_get\_locdesc\_entry\_d()}{dwarf\_get\_locdesc\_entry\_d()}}
{\footnotesize\ttfamily \label{group__locations_ga889f24f93fe1ff22a64772fd42baf822} 
DW\+\_\+\+API int dwarf\+\_\+get\+\_\+locdesc\+\_\+entry\+\_\+d (\begin{DoxyParamCaption}\item[{\doxymbox{\hyperlink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c}}}]{dw\+\_\+loclist\+\_\+head}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}}}]{dw\+\_\+index}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+lle\+\_\+value\+\_\+out}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+rawlowpc}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+rawhipc}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga32afecc94a71aae2be36aa279f1dded8}{Dwarf\+\_\+\+Bool}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+debug\+\_\+addr\+\_\+unavailable}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga16ddc0e584ea1a17237ccf1617f31075}{Dwarf\+\_\+\+Addr}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+lowpc\+\_\+cooked}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga16ddc0e584ea1a17237ccf1617f31075}{Dwarf\+\_\+\+Addr}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+hipc\+\_\+cooked}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+locexpr\+\_\+op\+\_\+count\+\_\+out}{, }\item[{\doxymbox{\hyperlink{group__allstructs_gabcb72d212aafc296a1fe1bb92689e9b8}{Dwarf\+\_\+\+Locdesc\+\_\+c}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+locentry\+\_\+out}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+loclist\+\_\+source\+\_\+out}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+expression\+\_\+offset\+\_\+out}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+locdesc\+\_\+offset\+\_\+out}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+error}{}\end{DoxyParamCaption})}



Retrieve the details(\+\_\+d) of a location expression. 

Cooked value means the addresses from the location description after base values applied, so they are actual addresses. debug\+\_\+addr\+\_\+unavailable non-\/zero means the record from a Split Dwarf skeleton unit could not be accessed from the .dwo section or dwp object so the cooked values could not be calculated.


\begin{DoxyParams}{Parameters}
{\em dw\+\_\+loclist\+\_\+head} & A loclist head pointer. \\
\hline
{\em dw\+\_\+index} & Pass in an index value less than dw\+\_\+locentry\+\_\+count . \\
\hline
{\em dw\+\_\+lle\+\_\+value\+\_\+out} & On success returns the DW\+\_\+\+LLE value applicable, such as DW\+\_\+\+LLE\+\_\+start\+\_\+end . \\
\hline
{\em dw\+\_\+rawlowpc} & On success returns the first operand in the expression (if the expression has an operand). \\
\hline
{\em dw\+\_\+rawhipc} & On success returns the second operand in the expression. (if the expression has a second operand). \\
\hline
{\em dw\+\_\+debug\+\_\+addr\+\_\+unavailable} & On success returns FALSE if the data required to calculate dw\+\_\+lowpc\+\_\+cooked or dw\+\_\+hipc\+\_\+cooked was present or TRUE if some required data was missing (for example in split dwarf). \\
\hline
{\em dw\+\_\+lowpc\+\_\+cooked} & On success and if dw\+\_\+debug\+\_\+addr\+\_\+unavailable FALSE returns the true low address. \\
\hline
{\em dw\+\_\+hipc\+\_\+cooked} & On success and if dw\+\_\+debug\+\_\+addr\+\_\+unavailable FALSE returns the true high address. \\
\hline
{\em dw\+\_\+locexpr\+\_\+op\+\_\+count\+\_\+out} & On success returns the count of operations in the expression. \\
\hline
{\em dw\+\_\+locentry\+\_\+out} & On success returns a pointer to a specific location description. \\
\hline
{\em dw\+\_\+loclist\+\_\+source\+\_\+out} & On success returns the applicable DW\+\_\+\+LKIND value. \\
\hline
{\em dw\+\_\+expression\+\_\+offset\+\_\+out} & On success returns the offset of the expression in the applicable section. \\
\hline
{\em dw\+\_\+locdesc\+\_\+offset\+\_\+out} & On return sets the offset to the location description offset (if that is meaningful) or zero for simple location expressions. \\
\hline
{\em dw\+\_\+error} & The usual error detail return pointer. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
Returns DW\+\_\+\+DLV\+\_\+\+OK etc. 
\end{DoxyReturn}
\Hypertarget{group__locations_ga8b3ebddae8d5dc0f617ce87e3eb4133f}\index{Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}!dwarf\_get\_locdesc\_entry\_e@{dwarf\_get\_locdesc\_entry\_e}}
\index{dwarf\_get\_locdesc\_entry\_e@{dwarf\_get\_locdesc\_entry\_e}!Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}}
\doxysubsubsection{\texorpdfstring{dwarf\_get\_locdesc\_entry\_e()}{dwarf\_get\_locdesc\_entry\_e()}}
{\footnotesize\ttfamily \label{group__locations_ga8b3ebddae8d5dc0f617ce87e3eb4133f} 
DW\+\_\+\+API int dwarf\+\_\+get\+\_\+locdesc\+\_\+entry\+\_\+e (\begin{DoxyParamCaption}\item[{\doxymbox{\hyperlink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c}}}]{dw\+\_\+loclist\+\_\+head}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}}}]{dw\+\_\+index}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+lle\+\_\+value\+\_\+out}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+rawlowpc}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+rawhipc}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga32afecc94a71aae2be36aa279f1dded8}{Dwarf\+\_\+\+Bool}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+debug\+\_\+addr\+\_\+unavailable}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga16ddc0e584ea1a17237ccf1617f31075}{Dwarf\+\_\+\+Addr}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+lowpc\+\_\+cooked}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga16ddc0e584ea1a17237ccf1617f31075}{Dwarf\+\_\+\+Addr}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+hipc\+\_\+cooked}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+locexpr\+\_\+op\+\_\+count\+\_\+out}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+lle\+\_\+bytecount}{, }\item[{\doxymbox{\hyperlink{group__allstructs_gabcb72d212aafc296a1fe1bb92689e9b8}{Dwarf\+\_\+\+Locdesc\+\_\+c}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+locentry\+\_\+out}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+loclist\+\_\+source\+\_\+out}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+expression\+\_\+offset\+\_\+out}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+locdesc\+\_\+offset\+\_\+out}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+error}{}\end{DoxyParamCaption})}



Retrieve the details(\+\_\+e) of a location expression. 

Cooked value means the addresses from the location description after base values applied, so they are actual addresses. debug\+\_\+addr\+\_\+unavailable non-\/zero means the record from a Split Dwarf skeleton unit could not be accessed from the .dwo section or dwp object so the cooked values could not be calculated.

This is identical to dwarf\+\_\+get\+\_\+locdesc\+\_\+entry\+\_\+d except that it adds a pointer argument so the caller can know the size, in bytes, of the loclist DW\+\_\+\+LLE operation itself.

It\textquotesingle{}s used by dwarfdump but it is unlikely to be of interest to most callers.. \Hypertarget{group__locations_ga63391b01dedf669137d7b8f004d26040}\index{Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}!dwarf\_get\_loclist\_c@{dwarf\_get\_loclist\_c}}
\index{dwarf\_get\_loclist\_c@{dwarf\_get\_loclist\_c}!Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}}
\doxysubsubsection{\texorpdfstring{dwarf\_get\_loclist\_c()}{dwarf\_get\_loclist\_c()}}
{\footnotesize\ttfamily \label{group__locations_ga63391b01dedf669137d7b8f004d26040} 
DW\+\_\+\+API int dwarf\+\_\+get\+\_\+loclist\+\_\+c (\begin{DoxyParamCaption}\item[{\doxymbox{\hyperlink{group__allstructs_ga3b8f8b4e43653647a2face222040a915}{Dwarf\+\_\+\+Attribute}}}]{dw\+\_\+attr}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+loclist\+\_\+head}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+locentry\+\_\+count}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+error}{}\end{DoxyParamCaption})}



Location Lists and Expressions. 

This works on DWARF2 through DWARF5.

\begin{DoxySeeAlso}{See also}
\doxylink{group__example__loclistcv5}{Location/\+expression access}
\end{DoxySeeAlso}

\begin{DoxyParams}{Parameters}
{\em dw\+\_\+attr} & The attribute must refer to a location expression or a location list, so must be DW\+\_\+\+FORM\+\_\+block, DW\+\_\+\+FORM\+\_\+exprloc, or a loclist reference form.. \\
\hline
{\em dw\+\_\+loclist\+\_\+head} & On success returns a pointer to the created loclist head record. \\
\hline
{\em dw\+\_\+locentry\+\_\+count} & On success returns the count of records. For an expression it will be one. \\
\hline
{\em dw\+\_\+error} & The usual error detail return pointer. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
Returns DW\+\_\+\+DLV\+\_\+\+OK etc. 
\end{DoxyReturn}
\Hypertarget{group__locations_ga7cbb42b959f8553ba55cad649e0ba777}\index{Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}!dwarf\_get\_loclist\_context\_basics@{dwarf\_get\_loclist\_context\_basics}}
\index{dwarf\_get\_loclist\_context\_basics@{dwarf\_get\_loclist\_context\_basics}!Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}}
\doxysubsubsection{\texorpdfstring{dwarf\_get\_loclist\_context\_basics()}{dwarf\_get\_loclist\_context\_basics()}}
{\footnotesize\ttfamily \label{group__locations_ga7cbb42b959f8553ba55cad649e0ba777} 
DW\+\_\+\+API int dwarf\+\_\+get\+\_\+loclist\+\_\+context\+\_\+basics (\begin{DoxyParamCaption}\item[{\doxymbox{\hyperlink{group__allstructs_gac2ba1e1c1b70a3191506b414195ca807}{Dwarf\+\_\+\+Debug}}}]{dw\+\_\+dbg}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}}}]{dw\+\_\+index}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+header\+\_\+offset}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+offset\+\_\+size}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+extension\+\_\+size}{, }\item[{unsigned int \texorpdfstring{$\ast$}{*}}]{dw\+\_\+version}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+address\+\_\+size}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+segment\+\_\+selector\+\_\+size}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+offset\+\_\+entry\+\_\+count}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+offset\+\_\+of\+\_\+offset\+\_\+array}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+offset\+\_\+of\+\_\+first\+\_\+locentry}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+offset\+\_\+past\+\_\+last\+\_\+locentry}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+error}{}\end{DoxyParamCaption})}



Return basic data about a loclists context. 

Some of the same values as from dwarf\+\_\+get\+\_\+loclist\+\_\+head\+\_\+basics but here without any dependence on data derived from a CU context. Useful to print raw loclist data. \Hypertarget{group__locations_gae8386dee95f51cd7e7e5270faa5a5d1d}\index{Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}!dwarf\_get\_loclist\_head\_basics@{dwarf\_get\_loclist\_head\_basics}}
\index{dwarf\_get\_loclist\_head\_basics@{dwarf\_get\_loclist\_head\_basics}!Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}}
\doxysubsubsection{\texorpdfstring{dwarf\_get\_loclist\_head\_basics()}{dwarf\_get\_loclist\_head\_basics()}}
{\footnotesize\ttfamily \label{group__locations_gae8386dee95f51cd7e7e5270faa5a5d1d} 
DW\+\_\+\+API int dwarf\+\_\+get\+\_\+loclist\+\_\+head\+\_\+basics (\begin{DoxyParamCaption}\item[{\doxymbox{\hyperlink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c}}}]{dw\+\_\+head}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+lkind}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+lle\+\_\+count}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+loclists\+\_\+version}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+loclists\+\_\+index\+\_\+returned}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+bytes\+\_\+total\+\_\+in\+\_\+rle}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+offset\+\_\+size}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+address\+\_\+size}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+segment\+\_\+selector\+\_\+size}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+overall\+\_\+offset\+\_\+of\+\_\+this\+\_\+context}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+total\+\_\+length\+\_\+of\+\_\+this\+\_\+context}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+offset\+\_\+table\+\_\+offset}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+offset\+\_\+table\+\_\+entrycount}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga32afecc94a71aae2be36aa279f1dded8}{Dwarf\+\_\+\+Bool}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+loclists\+\_\+base\+\_\+present}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+loclists\+\_\+base}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga32afecc94a71aae2be36aa279f1dded8}{Dwarf\+\_\+\+Bool}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+loclists\+\_\+base\+\_\+address\+\_\+present}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+loclists\+\_\+base\+\_\+address}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga32afecc94a71aae2be36aa279f1dded8}{Dwarf\+\_\+\+Bool}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+loclists\+\_\+debug\+\_\+addr\+\_\+base\+\_\+present}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+loclists\+\_\+debug\+\_\+addr\+\_\+base}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+offset\+\_\+this\+\_\+lle\+\_\+area}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+error}{}\end{DoxyParamCaption})}



Return basic data about a loclists head. 

Used by dwarfdump to print basic data from the data generated to look at a specific loclist context as returned by dwarf\+\_\+loclists\+\_\+index\+\_\+get\+\_\+lle\+\_\+head() or dwarf\+\_\+loclists\+\_\+offset\+\_\+get\+\_\+lle\+\_\+head. Here we know there was a \doxylink{group__allstructs_ga3b8f8b4e43653647a2face222040a915}{Dwarf\+\_\+\+Attribute} so additional things are known as compared to calling dwarf\+\_\+get\+\_\+loclist\+\_\+context\+\_\+basics See DWARF5 Section 7.\+20 Location List Table page 243. \Hypertarget{group__locations_gaab8bf7b5adbf7c5021ac3fb87270a5af}\index{Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}!dwarf\_get\_loclist\_head\_kind@{dwarf\_get\_loclist\_head\_kind}}
\index{dwarf\_get\_loclist\_head\_kind@{dwarf\_get\_loclist\_head\_kind}!Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}}
\doxysubsubsection{\texorpdfstring{dwarf\_get\_loclist\_head\_kind()}{dwarf\_get\_loclist\_head\_kind()}}
{\footnotesize\ttfamily \label{group__locations_gaab8bf7b5adbf7c5021ac3fb87270a5af} 
DW\+\_\+\+API int dwarf\+\_\+get\+\_\+loclist\+\_\+head\+\_\+kind (\begin{DoxyParamCaption}\item[{\doxymbox{\hyperlink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c}}}]{dw\+\_\+loclist\+\_\+head}{, }\item[{unsigned int \texorpdfstring{$\ast$}{*}}]{dw\+\_\+lkind}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+error}{}\end{DoxyParamCaption})}



Know what kind of location data it is. 


\begin{DoxyParams}{Parameters}
{\em dw\+\_\+loclist\+\_\+head} & Pass in a loclist head pointer. \\
\hline
{\em dw\+\_\+lkind} & On success returns the loclist kind through the pointer. For example DW\+\_\+\+LKIND\+\_\+expression. \\
\hline
{\em dw\+\_\+error} & The usual error detail return pointer. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
Returns DW\+\_\+\+DLV\+\_\+\+OK etc. 
\end{DoxyReturn}
\Hypertarget{group__locations_ga78d3d5478acca1c9cd866cf6b5483e8d}\index{Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}!dwarf\_get\_loclist\_lle@{dwarf\_get\_loclist\_lle}}
\index{dwarf\_get\_loclist\_lle@{dwarf\_get\_loclist\_lle}!Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}}
\doxysubsubsection{\texorpdfstring{dwarf\_get\_loclist\_lle()}{dwarf\_get\_loclist\_lle()}}
{\footnotesize\ttfamily \label{group__locations_ga78d3d5478acca1c9cd866cf6b5483e8d} 
DW\+\_\+\+API int dwarf\+\_\+get\+\_\+loclist\+\_\+lle (\begin{DoxyParamCaption}\item[{\doxymbox{\hyperlink{group__allstructs_gac2ba1e1c1b70a3191506b414195ca807}{Dwarf\+\_\+\+Debug}}}]{dw\+\_\+dbg}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}}}]{dw\+\_\+contextnumber}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}}}]{dw\+\_\+entry\+\_\+offset}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}}}]{dw\+\_\+endoffset}{, }\item[{unsigned int \texorpdfstring{$\ast$}{*}}]{dw\+\_\+entrylen}{, }\item[{unsigned int \texorpdfstring{$\ast$}{*}}]{dw\+\_\+entry\+\_\+kind}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+entry\+\_\+operand1}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+entry\+\_\+operand2}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+expr\+\_\+ops\+\_\+blocksize}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+expr\+\_\+ops\+\_\+offset}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga52e439e652a1a30277679f64f83cc0fe}{Dwarf\+\_\+\+Small}} \texorpdfstring{$\ast$}{*}\texorpdfstring{$\ast$}{*}}]{dw\+\_\+expr\+\_\+opsdata}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+error}{}\end{DoxyParamCaption})}



Return basic data about a loclists context entry. 

Useful to print raw loclist data. \Hypertarget{group__locations_ga502c7c9939ad6be527f58940c7e43b63}\index{Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}!dwarf\_get\_loclist\_offset\_index\_value@{dwarf\_get\_loclist\_offset\_index\_value}}
\index{dwarf\_get\_loclist\_offset\_index\_value@{dwarf\_get\_loclist\_offset\_index\_value}!Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}}
\doxysubsubsection{\texorpdfstring{dwarf\_get\_loclist\_offset\_index\_value()}{dwarf\_get\_loclist\_offset\_index\_value()}}
{\footnotesize\ttfamily \label{group__locations_ga502c7c9939ad6be527f58940c7e43b63} 
DW\+\_\+\+API int dwarf\+\_\+get\+\_\+loclist\+\_\+offset\+\_\+index\+\_\+value (\begin{DoxyParamCaption}\item[{\doxymbox{\hyperlink{group__allstructs_gac2ba1e1c1b70a3191506b414195ca807}{Dwarf\+\_\+\+Debug}}}]{dw\+\_\+dbg}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}}}]{dw\+\_\+context\+\_\+index}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}}}]{dw\+\_\+offsetentry\+\_\+index}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+offset\+\_\+value\+\_\+out}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+global\+\_\+offset\+\_\+value\+\_\+out}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+error}{}\end{DoxyParamCaption})}



Return certain loclists offsets. 

Useful with the DWARF5 .debug\+\_\+loclists section.


\begin{DoxyParams}{Parameters}
{\em dw\+\_\+dbg} & The \doxylink{group__allstructs_gac2ba1e1c1b70a3191506b414195ca807}{Dwarf\+\_\+\+Debug} of interest. \\
\hline
{\em dw\+\_\+context\+\_\+index} & Pass in the loclists context index. \\
\hline
{\em dw\+\_\+offsetentry\+\_\+index} & Pass in the offset array index. \\
\hline
{\em dw\+\_\+offset\+\_\+value\+\_\+out} & On success returns the offset value at offset table\+[dw\+\_\+offsetentry\+\_\+index]\+, an offset local to this context. \\
\hline
{\em dw\+\_\+global\+\_\+offset\+\_\+value\+\_\+out} & On success returns the same offset value but with the offset of the table added in to form a section offset. \\
\hline
{\em dw\+\_\+error} & The usual error detail return pointer. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
Returns DW\+\_\+\+DLV\+\_\+\+OK etc. If one of the indexes passed in is out of range it returns DW\+\_\+\+DLV\+\_\+\+NO\+\_\+\+ENTRY. 
\end{DoxyReturn}
\Hypertarget{group__locations_gadb9d0258969de3bccd1a905840ca7256}\index{Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}!dwarf\_load\_loclists@{dwarf\_load\_loclists}}
\index{dwarf\_load\_loclists@{dwarf\_load\_loclists}!Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}}
\doxysubsubsection{\texorpdfstring{dwarf\_load\_loclists()}{dwarf\_load\_loclists()}}
{\footnotesize\ttfamily \label{group__locations_gadb9d0258969de3bccd1a905840ca7256} 
DW\+\_\+\+API int dwarf\+\_\+load\+\_\+loclists (\begin{DoxyParamCaption}\item[{\doxymbox{\hyperlink{group__allstructs_gac2ba1e1c1b70a3191506b414195ca807}{Dwarf\+\_\+\+Debug}}}]{dw\+\_\+dbg}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+loclists\+\_\+count}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+error}{}\end{DoxyParamCaption})}



Load Loclists. 

This loads raw .debug\+\_\+loclists (DWARF5). It is unlikely you have a reason to use this function. If CUs or DIES have been referenced in any way loading is already done. A duplicate loading attempt returns DW\+\_\+\+DLV\+\_\+\+OK immediately, returning dw\+\_\+loclists\+\_\+count filled in and does nothing else.

Doing it more than once is never necessary or harmful. There is no deallocation call made visible, deallocation happens when \doxylink{group__initfunctions_ga14a505c07ee5481401735f280f719454}{dwarf\+\_\+finish()} is called.


\begin{DoxyParams}{Parameters}
{\em dw\+\_\+dbg} & The applicable \doxylink{group__allstructs_gac2ba1e1c1b70a3191506b414195ca807}{Dwarf\+\_\+\+Debug}. \\
\hline
{\em dw\+\_\+loclists\+\_\+count} & On success, returns the number of DWARF5 loclists contexts in the section, whether this is the first or a duplicate load. \\
\hline
{\em dw\+\_\+error} & The usual error detail return pointer. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
Returns DW\+\_\+\+DLV\+\_\+\+OK if it loaded successfully or if it is a duplicate load. If no .debug\+\_\+loclists present returns DW\+\_\+\+DLV\+\_\+\+NO\+\_\+\+ENTRY. 
\end{DoxyReturn}
\Hypertarget{group__locations_ga2061570ef695cfd9aa71e428845fef37}\index{Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}!dwarf\_loclist\_from\_expr\_c@{dwarf\_loclist\_from\_expr\_c}}
\index{dwarf\_loclist\_from\_expr\_c@{dwarf\_loclist\_from\_expr\_c}!Locations of data: DWARF2-\/DWARF5@{Locations of data: DWARF2-\/DWARF5}}
\doxysubsubsection{\texorpdfstring{dwarf\_loclist\_from\_expr\_c()}{dwarf\_loclist\_from\_expr\_c()}}
{\footnotesize\ttfamily \label{group__locations_ga2061570ef695cfd9aa71e428845fef37} 
DW\+\_\+\+API int dwarf\+\_\+loclist\+\_\+from\+\_\+expr\+\_\+c (\begin{DoxyParamCaption}\item[{\doxymbox{\hyperlink{group__allstructs_gac2ba1e1c1b70a3191506b414195ca807}{Dwarf\+\_\+\+Debug}}}]{dw\+\_\+dbg}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga376c1939313af42401fc67bc998fdd2c}{Dwarf\+\_\+\+Ptr}}}]{dw\+\_\+expression\+\_\+in}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}}}]{dw\+\_\+expression\+\_\+length}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}}}]{dw\+\_\+address\+\_\+size}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}}}]{dw\+\_\+offset\+\_\+size}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga4fb2b14ce7a6d27321fa7999b46b82bd}{Dwarf\+\_\+\+Half}}}]{dw\+\_\+dwarf\+\_\+version}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+loc\+\_\+head}{, }\item[{\doxymbox{\hyperlink{group__basicdatatypes_ga5de64bb9627534a24dcbccc327916265}{Dwarf\+\_\+\+Unsigned}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+listlen}{, }\item[{\doxymbox{\hyperlink{group__allstructs_ga8d4fac0e48040b6ca91e06ffda09766a}{Dwarf\+\_\+\+Error}} \texorpdfstring{$\ast$}{*}}]{dw\+\_\+error}{}\end{DoxyParamCaption})}



Generate a \doxylink{group__allstructs_ga77e23e9624ff0b22ed747913f294fd25}{Dwarf\+\_\+\+Loc\+\_\+\+Head\+\_\+c} from an expression block. 

Useful if you have an expression block (from somewhere), do not have a \doxylink{group__allstructs_ga3b8f8b4e43653647a2face222040a915}{Dwarf\+\_\+\+Attribute} available, and wish to deal with the expression.

\begin{DoxySeeAlso}{See also}
\doxylink{group__example__locexprc}{Reading a location expression}
\end{DoxySeeAlso}

\begin{DoxyParams}{Parameters}
{\em dw\+\_\+dbg} & The applicable \doxylink{group__allstructs_gac2ba1e1c1b70a3191506b414195ca807}{Dwarf\+\_\+\+Debug} \\
\hline
{\em dw\+\_\+expression\+\_\+in} & Pass in a pointer to the expression bytes. \\
\hline
{\em dw\+\_\+expression\+\_\+length} & Pass in the length, in bytes, of the expression. \\
\hline
{\em dw\+\_\+address\+\_\+size} & Pass in the applicable address\+\_\+size. \\
\hline
{\em dw\+\_\+offset\+\_\+size} & Pass in the applicable offset size. \\
\hline
{\em dw\+\_\+dwarf\+\_\+version} & Pass in the applicable dwarf version. \\
\hline
{\em dw\+\_\+loc\+\_\+head} & On success returns a pointer to a dwarf location head record for use in getting to the details of the expression. \\
\hline
{\em dw\+\_\+listlen} & On success, sets the listlen to one. \\
\hline
{\em dw\+\_\+error} & The usual error detail return pointer. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
Returns DW\+\_\+\+DLV\+\_\+\+OK etc. 
\end{DoxyReturn}
