DWARF_DEALLOC(3) | Library Functions Manual | DWARF_DEALLOC(3) |
dwarf_dealloc
,
dwarf_fde_cie_list_dealloc
,
dwarf_funcs_dealloc
,
dwarf_globals_dealloc
,
dwarf_pubtypes_dealloc
,
dwarf_ranges_dealloc
,
dwarf_srclines_dealloc
,
dwarf_types_dealloc
,
dwarf_vars_dealloc
,
dwarf_weaks_dealloc
—
#include <libdwarf.h>
void
dwarf_dealloc
(Dwarf_Debug dbg,
Dwarf_Ptr ptr, Dwarf_Unsigned
type);
dwarf_fde_cie_list_dealloc
(Dwarf_Debug
dbg, Dwarf_Cie *cie_list,
Dwarf_Signed cie_count, Dwarf_Fde
*fde_list, Dwarf_Signed fde_count);
void
dwarf_funcs_dealloc
(Dwarf_Debug
dbg, Dwarf_Func *funcs,
Dwarf_Signed funccount);
void
dwarf_globals_dealloc
(Dwarf_Debug
dbg, Dwarf_Global *globals,
Dwarf_Signed globalcount);
void
dwarf_pubtypes_dealloc
(Dwarf_Debug
dbg, Dwarf_Type *pubtypes,
Dwarf_Signed pubtypecount);
void
dwarf_ranges_dealloc
(Dwarf_Debug
dbg, Dwarf_Ranges *ranges,
Dwarf_Signed rangecount);
void
dwarf_srclines_dealloc
(Dwarf_Debug
dbg, Dwarf_Line *lines,
Dwarf_Signed linecount);
void
dwarf_types_dealloc
(Dwarf_Debug
dbg, Dwarf_Type *types,
Dwarf_Signed typecount);
void
dwarf_vars_dealloc
(Dwarf_Debug
dbg, Dwarf_Var *vars,
Dwarf_Signed varcount);
void
dwarf_weaks_dealloc
(Dwarf_Debug
dbg, Dwarf_Weak *weaks,
Dwarf_Signed weakcount);
dwarf_dealloc
() is used by applications to
indicate that memory areas returned by DWARF Access Library
(libdwarf, -ldwarf) may be safely disposed off. Due to the way memory
is managed in the current implementation, the use of
dwarf_dealloc
() is only necessary for a small set of
DWARF types.
Argument dbg should reference a valid debugging context allocated using dwarf_init(3).
Argument ptr should point to an object or memory area obtained by a prior call to a DWARF(3) function.
Argument type indicates the type of object being deallocated. The indicated type must match that of the object being passed in argument ptr. Valid values for the type argument are:
DW_DLA_ABBREV
DW_DLA_DIE
DW_DLA_FRAME_BLOCK
Calls to dwarf_dealloc
() with other values
for argument type are no-ops in this
implementation.
The functions
dwarf_fde_cie_list_dealloc
(),
dwarf_funcs_dealloc
(),
dwarf_globals_dealloc
(),
dwarf_pubtypes_dealloc
(),
dwarf_ranges_dealloc
(),
dwarf_srclines_dealloc
(),
dwarf_types_dealloc
(),
dwarf_vars_dealloc
() and
dwarf_weaks_dealloc
() are provided for compatibility
with other implementations of the DWARF(3) API. Due to the way memory is
managed in the current implementation, these functions are effectively
no-ops.
See dwarf(3) for more information about the memory management scheme in this implementation of the DWARF(3) API.
dwarf_dealloc
(),
dwarf_fde_cie_list_dealloc
(),
dwarf_funcs_dealloc
(),
dwarf_globals_dealloc
(),
dwarf_pubtypes_dealloc
(),
dwarf_ranges_dealloc
(),
dwarf_srclines_dealloc
(),
dwarf_types_dealloc
(),
dwarf_vars_dealloc
() and
dwarf_weaks_dealloc
() have no return value.
July 23, 2011 | NetBSD 9.2 |