dwarf_alloc.c revision 07dc1947c362e187fb955d283b692f8769dd5def
/*
Copyright (C) 2000-2005 Silicon Graphics, Inc. All Rights Reserved.
Portions Copyright (C) 2007-2010 David Anderson. All Rights Reserved.
This program is free software; you can redistribute it and/or modify it
under the terms of version 2.1 of the GNU Lesser General Public License
as published by the Free Software Foundation.
This program is distributed in the hope that it would be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
Further, this software is distributed without any warranty that it is
free of the rightful claim of any third person regarding infringement
or the like. Any license provided herein, whether implied or
otherwise, applies only to this software file. Patent licenses, if
any, provided herein do not apply to combinations of this program with
other software, or any other product whatsoever.
You should have received a copy of the GNU Lesser General Public
License along with this program; if not, write the Free Software
Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston MA 02110-1301,
USA.
Contact information: Silicon Graphics, Inc., 1500 Crittenden Lane,
Mountain View, CA 94043, or:
http://www.sgi.com
For further information regarding this notice, see:
http://oss.sgi.com/projects/GenInfo/NoticeExplan
*/
/* The address of the Free Software Foundation is
Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
Boston, MA 02110-1301, USA.
SGI has moved from the Crittenden Lane address.
*/
#undef DEBUG
#include "config.h"
#include "dwarf_incl.h"
#include <sys/types.h>
#include <stdlib.h>
#include <stdio.h>
#include "malloc_check.h"
/*
These files are included to get the sizes
of structs to set the ah_bytes_one_struct field
of the Dwarf_Alloc_Hdr_s structs for each
allocation type.
*/
#include "dwarf_line.h"
#include "dwarf_global.h"
#include "dwarf_arange.h"
#include "dwarf_abbrev.h"
#include "dwarf_die_deliv.h"
#include "dwarf_frame.h"
#include "dwarf_loc.h"
#include "dwarf_funcs.h"
#include "dwarf_types.h"
#include "dwarf_vars.h"
#include "dwarf_weaks.h"
static void _dwarf_free_special_error(Dwarf_Ptr space);
#ifdef DWARF_SIMPLE_MALLOC
static void _dwarf_simple_malloc_add_to_list(Dwarf_Debug dbg,
Dwarf_Ptr addr,
unsigned long size,
short alloc_type);
static void _dwarf_simple_malloc_delete_from_list(Dwarf_Debug dbg,
Dwarf_Ptr space,
short alloc_type);
void _dwarf_simple_malloc_botch(int err);
#endif /* DWARF_SIMPLE_MALLOC */
/*
This macro adds the size of a pointer to the size of a
struct that is given to it. It rounds up the size to
be a multiple of the size of a pointer. This is done
so that every struct returned by _dwarf_get_alloc()
can be preceded by a pointer to the chunk it came from.
Before allocating, it checks if the size of struct is less than
the size of a pointer. If yes, it returns the size
of 2 pointers. The returned size should be at least
the size of 2 pointers, since the first points to the
chunk the struct was allocated from, and the second
is used to link the free list.
We want DW_RESERVE to be at least the size of
a long long and at least the size of a pointer because
our struct has a long long and we want that aligned right.
Now Standard C defines long long as 8 bytes, so lets
make that standard. It will become unworkable when
long long or pointer grows beyound 8 bytes.
Unclear what to do with wierd requirements, like
36 bit pointers.
*/
#define DW_RESERVE 8
/* Round size up to the next multiple of DW_RESERVE bytes
*/
#define ROUND_SIZE(inputsize) \
(((inputsize) % (DW_RESERVE)) == 0 ? \
(inputsize): \
((inputsize) + \
(DW_RESERVE) - ((inputsize) % (DW_RESERVE)) ))
#define ROUND_SIZE_WITH_POINTER(i_size) (ROUND_SIZE(i_size) + DW_RESERVE)
/* SMALL_ALLOC is for trivia where allocation is a waste.
Things that should be removed, really. */
#define SMALL_ALLOC 2
/* BASE_ALLOC is where a basic allocation makes sense, but 'not too large'.
No thorough evaluation of this value has been done, though
it was found wasteful of memory to have BASE_ALLOC be as large as
BIG_ALLOC. */
#define BASE_ALLOC 64
/* BIG_ALLOC is where a larger-than-BASE_ALLOC
allocation makes sense, but still 'not too large'.
No thorough evaluation of this value has been done. */
#define BIG_ALLOC 128
/* This translates into de_alloc_hdr index
** the 0,1,1 entries are special: they don't use the
** table values at all.
** Rearranging the DW_DLA values would break binary compatibility
** so that is not an option.
*/
struct ial_s {
int ia_al_num; /* Index into de_alloc_hdr table. */
/* In bytes, one struct instance. This does not account for extra
space needed per block, but that (DW_RESERVE) will be added in
later where it is needed (DW_RESERVE space never added in here).
*/
int ia_struct_size;
/* Number of instances per alloc block. MUST be > 0. */
int ia_base_count;
int (*specialconstructor) (Dwarf_Debug, void *);
void (*specialdestructor) (void *);
};
static const
struct ial_s index_into_allocated[ALLOC_AREA_INDEX_TABLE_MAX] = {
{0, 1, 1, 0, 0}, /* none */
{0, 1, 1, 0, 0}, /* 1 DW_DLA_STRING */
{1, sizeof(Dwarf_Loc), BASE_ALLOC, 0, 0}
, /* 2 DW_DLA_LOC */
{2, sizeof(Dwarf_Locdesc), BASE_ALLOC, 0, 0}
, /* 3 DW_DLA_LOCDESC */
{0, 1, 1, 0, 0}
, /* not used *//* 4 DW_DLA_ELLIST */
{0, 1, 1, 0, 0}
, /* not used *//* 5 DW_DLA_BOUNDS */
{3, sizeof(Dwarf_Block), BASE_ALLOC, 0, 0}
, /* 6 DW_DLA_BLOCK */
{0, 1, 1, 0, 0}
, /* the actual dwarf_debug structure *//* 7 DW_DLA_DEBUG */
{4, sizeof(struct Dwarf_Die_s), BIG_ALLOC, 0, 0}, /* 8 DW_DLA_DIE
*/
{5, sizeof(struct Dwarf_Line_s), BIG_ALLOC, 0, 0}, /* 9
DW_DLA_LINE */
{6, sizeof(struct Dwarf_Attribute_s), BIG_ALLOC * 2, 0, 0},
/* 10 DW_DLA_ATTR */
{0, 1, 1, 0, 0}, /* not used *//* 11 DW_DLA_TYPE */
{0, 1, 1, 0, 0}, /* not used *//* 12 DW_DLA_SUBSCR */
{7, sizeof(struct Dwarf_Global_s), BASE_ALLOC, 0, 0}, /* 13
DW_DLA_GLOBAL
*/
{8, sizeof(struct Dwarf_Error_s), BASE_ALLOC, 0, 0}, /* 14
DW_DLA_ERROR
*/
{0, 1, 1, 0, 0}, /* 15 DW_DLA_LIST */
{0, 1, 1, 0, 0}, /* not used *//* 16 DW_DLA_LINEBUF */
{9, sizeof(struct Dwarf_Arange_s), BASE_ALLOC, 0, 0}, /* 17
DW_DLA_ARANGE
*/
{10, sizeof(struct Dwarf_Abbrev_s), BIG_ALLOC, 0, 0}, /* 18
DW_DLA_ABBREV
*/
{11, sizeof(Dwarf_Frame_Op), BIG_ALLOC, 0, 0}
, /* 19 DW_DLA_FRAME_OP */
{12, sizeof(struct Dwarf_Cie_s), BASE_ALLOC, 0, 0}, /* 20
DW_DLA_CIE */
{13, sizeof(struct Dwarf_Fde_s), BASE_ALLOC, 0, 0}, /* 21 DW_DLA_FDE */
{0, 1, 1, 0, 0}, /* 22 DW_DLA_LOC_BLOCK */
{0, 1, 1, 0, 0}, /* 23 DW_DLA_FRAME_BLOCK */
{14, sizeof(struct Dwarf_Global_s), BASE_ALLOC, 0, 0}, /* 24 DW_DLA_FUNC
UNUSED */
{15, sizeof(struct Dwarf_Global_s), BASE_ALLOC, 0, 0}, /* 25
DW_DLA_TYPENAME
UNUSED */
{16, sizeof(struct Dwarf_Global_s), BASE_ALLOC, 0, 0}, /* 26 DW_DLA_VAR
UNUSED */
{17, sizeof(struct Dwarf_Global_s), BASE_ALLOC, 0, 0}, /* 27 DW_DLA_WEAK
UNUSED */
{0, 1, 1, 0, 0}, /* 28 DW_DLA_ADDR */
{0, 1,1,0,0 }, /* 29 DW_DLA_RANGES */
/* The following DW_DLA data types
are known only inside libdwarf. */
{18, sizeof(struct Dwarf_Abbrev_List_s), BIG_ALLOC, 0, 0},
/* 30 DW_DLA_ABBREV_LIST */
{19, sizeof(struct Dwarf_Chain_s), BIG_ALLOC, 0, 0}, /* 31 DW_DLA_CHAIN */
{20, sizeof(struct Dwarf_CU_Context_s), BASE_ALLOC, 0, 0},
/* 32 DW_DLA_CU_CONTEXT */
{21, sizeof(struct Dwarf_Frame_s), BASE_ALLOC,
_dwarf_frame_constructor,
_dwarf_frame_destructor}, /* 33 DW_DLA_FRAME */
{22, sizeof(struct Dwarf_Global_Context_s), BASE_ALLOC, 0, 0},
/* 34 DW_DLA_GLOBAL_CONTEXT */
{23, sizeof(struct Dwarf_File_Entry_s), BASE_ALLOC, 0, 0}, /* 34 */
/* 35 DW_DLA_FILE_ENTRY */
{24, sizeof(struct Dwarf_Line_Context_s), BASE_ALLOC, 0, 0},
/* 36 DW_DLA_LINE_CONTEXT */
{25, sizeof(struct Dwarf_Loc_Chain_s), BASE_ALLOC, 0, 0}, /* 36 */
/* 37 DW_DLA_LOC_CHAIN */
{26, sizeof(struct Dwarf_Hash_Table_s),BASE_ALLOC, 0, 0}, /* 37 */
/* 38 DW_DLA_HASH_TABLE */
/* The following really use Global struct: used to be unique struct
per type, but now merged (11/99). The opaque types
are visible in the interface. The types for
DW_DLA_FUNC,
DW_DLA_TYPENAME, DW_DLA_VAR, DW_DLA_WEAK also use
the global types.
*/
{27, sizeof(struct Dwarf_Global_Context_s), BASE_ALLOC, 0, 0},
/* 39 DW_DLA_FUNC_CONTEXT */
{28, sizeof(struct Dwarf_Global_Context_s), BASE_ALLOC, 0, 0},
/* 40 DW_DLA_TYPENAME_CONTEXT */
{29, sizeof(struct Dwarf_Global_Context_s), BASE_ALLOC, 0, 0},
/* 41 DW_DLA_VAR_CONTEXT */
{30, sizeof(struct Dwarf_Global_Context_s), BASE_ALLOC, 0, 0},
/* 42 DW_DLA_WEAK_CONTEXT */
{31, sizeof(struct Dwarf_Global_Context_s), BASE_ALLOC, 0, 0},
/* 43 DW_DLA_PUBTYPES_CONTEXT DWARF3 */
{0,1,1,0,0 },
/* 44 DW_DLA_HASH_TABLE_ENTRY */
};
#ifndef DWARF_SIMPLE_MALLOC
/*
This function is given a pointer to the header
structure that is used to allocate 1 struct of
the type given by alloc_type. It first checks
if a struct is available in its free list. If
not, it checks if 1 is available in its blob,
which is a chunk of memory that is reserved for
its use. If not, it malloc's a chunk. The
initial part of it is used to store the end
address of the chunk, and also to keep track
of the number of free structs in that chunk.
This information is used for freeing the chunk
when all the structs in it are free.
Assume all input arguments have been validated.
This function can be used only to allocate 1
struct of the given type.
It returns a pointer to the struct that the
user can use. It returns NULL only when it
is out of free structs, and cannot malloc
any more. The struct returned is zero-ed.
A pointer to the chunk that the struct belongs
to is stored in the bytes preceding the
returned address. Since this pointer it
never overwritten, when a struct is allocated
from the free_list this pointer does not
have to be written. In the 2 other cases,
where the struct is allocated from a new
chunk, or the blob, a pointer to the chunk
is written.
*/
static Dwarf_Ptr
_dwarf_find_memory(Dwarf_Alloc_Hdr alloc_hdr)
{
/* Pointer to the struct allocated. */
Dwarf_Small *ret_mem = 0;
/* Pointer to info about chunks allocated. */
Dwarf_Alloc_Area alloc_area;
/* Size of chunk malloc'ed when no free structs left. */
Dwarf_Signed mem_block_size;
/* Pointer to block malloc'ed. */
Dwarf_Small *mem_block;
/*
Check the alloc_area from which the last allocation was made
(most recent new block). If that is not successful, then search
the list of alloc_area's from alloc_header. */
alloc_area = alloc_hdr->ah_last_alloc_area;
if (alloc_area == NULL || alloc_area->aa_free_structs_in_chunk == 0)
for (alloc_area = alloc_hdr->ah_alloc_area_head;
alloc_area != NULL; alloc_area = alloc_area->aa_next) {
if (alloc_area->aa_free_structs_in_chunk > 0) {
break; /* found a free entry! */
}
}
if (alloc_area != NULL) {
alloc_area->aa_free_structs_in_chunk--;
if (alloc_area->aa_free_list != NULL) {
ret_mem = alloc_area->aa_free_list;
/*
Update the free list. The initial part of the struct is
used to hold a pointer to the next struct on the free
list. In this way, the free list chain is maintained at
0 memory cost. */
alloc_area->aa_free_list =
((Dwarf_Free_List) ret_mem)->fl_next;
} else if (alloc_area->aa_blob_start < alloc_area->aa_blob_end) {
ret_mem = alloc_area->aa_blob_start;
/*
Store pointer to chunk this struct belongs to in the
first few bytes. Return pointer to bytes after this
pointer storage. */
*(Dwarf_Alloc_Area *) ret_mem = alloc_area;
ret_mem += DW_RESERVE;
alloc_area->aa_blob_start += alloc_hdr->ah_bytes_one_struct;
} else {
/* else fall thru , though it should be impossible to fall
thru. And represents a disastrous programming error if
we get here. */
#ifdef DEBUG
fprintf(stderr, "libdwarf Internal error start %x end %x\n",
(int) alloc_area->aa_blob_start,
(int) alloc_area->aa_blob_end);
#endif
}
}
/* New memory has to malloc'ed since there are no free structs. */
if (ret_mem == 0) {
Dwarf_Word rounded_area_hdr_size;
alloc_hdr->ah_chunks_allocated++;
{ /* this nonsense avoids a warning */
/* CONSTCOND would be better */
unsigned long v = sizeof(struct Dwarf_Alloc_Area_s);
rounded_area_hdr_size = ROUND_SIZE(v);
}
/*
Allocate memory to contain the required number of structs
and the Dwarf_Alloc_Area_s to control it. */
mem_block_size = alloc_hdr->ah_bytes_malloc_per_chunk +
rounded_area_hdr_size;
mem_block = malloc(mem_block_size);
if (mem_block == NULL) {
return (NULL);
}
/*
Attach the Dwarf_Alloc_Area_s struct to the list of chunks
malloc'ed for this struct type. Also initialize the fields
of the Dwarf_Alloc_Area_s. */
alloc_area = (Dwarf_Alloc_Area) mem_block;
alloc_area->aa_prev = 0;
if (alloc_hdr->ah_alloc_area_head != NULL) {
alloc_hdr->ah_alloc_area_head->aa_prev = alloc_area;
}
alloc_area->aa_free_list = 0;
alloc_area->aa_next = alloc_hdr->ah_alloc_area_head;
alloc_hdr->ah_alloc_area_head = alloc_area;
alloc_area->aa_alloc_hdr = alloc_hdr;
alloc_area->aa_free_structs_in_chunk =
(Dwarf_Sword) alloc_hdr->ah_structs_per_chunk - 1;
if (alloc_area->aa_free_structs_in_chunk < 1) {
/* If we get here, there is a disastrous programming error
somewhere. */
#ifdef DEBUG
fprintf(stderr,
"libdwarf Internal error: free structs in chunk %d\n",
(int) alloc_area->aa_free_structs_in_chunk);
#endif
return NULL;
}
/*
The struct returned begins immediately after the
Dwarf_Alloc_Area_s struct. */
ret_mem = mem_block + rounded_area_hdr_size;
alloc_area->aa_blob_start =
ret_mem + alloc_hdr->ah_bytes_one_struct;
alloc_area->aa_blob_end = mem_block + mem_block_size;
/*
Store pointer to chunk this struct belongs to in the first
few bytes. Return pointer to bytes after this pointer
storage. */
*(Dwarf_Alloc_Area *) ret_mem = alloc_area;
ret_mem += DW_RESERVE;
}
alloc_hdr->ah_last_alloc_area = alloc_area;
alloc_hdr->ah_struct_user_holds++;
memset(ret_mem, 0, alloc_hdr->ah_bytes_one_struct - DW_RESERVE);
return (ret_mem);
}
#endif /* ndef DWARF_SIMPLE_MALLOC */
/*
This function returns a pointer to a region
of memory. For alloc_types that are not
strings or lists of pointers, only 1 struct
can be requested at a time. This is indicated
by an input count of 1. For strings, count
equals the length of the string it will
contain, i.e it the length of the string
plus 1 for the terminating null. For lists
of pointers, count is equal to the number of
pointers. For DW_DLA_FRAME_BLOCK, DW_DLA_RANGES, and
DW_DLA_LOC_BLOCK allocation types also, count
is the count of the number of structs needed.
This function cannot be used to allocate a
Dwarf_Debug_s struct.
*/
Dwarf_Ptr
_dwarf_get_alloc(Dwarf_Debug dbg,
Dwarf_Small alloc_type, Dwarf_Unsigned count)
{
Dwarf_Alloc_Hdr alloc_hdr;
Dwarf_Ptr ret_mem;
Dwarf_Signed size = 0;
unsigned int index;
unsigned int type = alloc_type;
if (dbg == NULL) {
return (NULL);
}
if (type >= ALLOC_AREA_INDEX_TABLE_MAX) {
/* internal error */
return NULL;
}
index = index_into_allocated[type].ia_al_num;
/* zero also illegal but not tested for */
/* If the Dwarf_Debug is not fully set up, we will get index 0 for
any type and must do something. 'Not fully set up' can only
happen for DW_DLA_ERROR, I (davea) believe, and for that we call
special code here.. */
if (index == 0) {
if (alloc_type == DW_DLA_STRING) {
size = count;
} else if (alloc_type == DW_DLA_LIST) {
size = count * sizeof(Dwarf_Ptr);
} else if (alloc_type == DW_DLA_FRAME_BLOCK) {
size = count * sizeof(Dwarf_Frame_Op);
} else if (alloc_type == DW_DLA_LOC_BLOCK) {
size = count * sizeof(Dwarf_Loc);
} else if (alloc_type == DW_DLA_HASH_TABLE_ENTRY) {
size = count * sizeof(struct Dwarf_Hash_Table_Entry_s);
} else if (alloc_type == DW_DLA_ADDR) {
size = count *
(sizeof(Dwarf_Addr) > sizeof(Dwarf_Off) ?
sizeof(Dwarf_Addr) : sizeof(Dwarf_Off));
} else if (alloc_type == DW_DLA_RANGES) {
size = count * sizeof(Dwarf_Ranges);
} else if (alloc_type == DW_DLA_ERROR) {
void *m = _dwarf_special_no_dbg_error_malloc();
dwarf_malloc_check_alloc_data(m, DW_DLA_ERROR);
return m;
} else {
/* If we get here, there is a disastrous programming error
somewhere. */
#ifdef DEBUG
fprintf(stderr,
"libdwarf Internal error: type %d unexpected\n",
(int) type);
#endif
}
} else {
alloc_hdr = &dbg->de_alloc_hdr[index];
if (alloc_hdr->ah_bytes_one_struct > 0) {
#ifdef DWARF_SIMPLE_MALLOC
size = alloc_hdr->ah_bytes_one_struct;
#else
{
void *m = _dwarf_find_memory(alloc_hdr);
dwarf_malloc_check_alloc_data(m, type);
if (index_into_allocated[type].specialconstructor) {
int res =
index_into_allocated[type].
specialconstructor(dbg, m);
if (res != DW_DLV_OK) {
/* We leak what we allocated in
_dwarf_find_memory when constructor fails. */
return NULL;
}
}
return m;
}
#endif
} else {
/* Special case: should not really happen at all. */
if (type == DW_DLA_ERROR) {
/* dwarf_init failure. Because dbg is incomplete we
won't use it to record the malloc. */
void *m = _dwarf_special_no_dbg_error_malloc();
dwarf_malloc_check_alloc_data(m, DW_DLA_ERROR);
return m;
} else {
/* If we get here, there is a disastrous programming
error somewhere. */
#ifdef DWARF_SIMPLE_MALLOC
_dwarf_simple_malloc_botch(3);
#endif
#ifdef DEBUG
fprintf(stderr,
"libdwarf Internal error: Type %d unexpected\n",
(int) type);
#endif
}
}
}
ret_mem = malloc(size);
#ifdef DWARF_SIMPLE_MALLOC
_dwarf_simple_malloc_add_to_list(dbg, ret_mem, (unsigned long) size,
type);
#endif
if (ret_mem != NULL)
memset(ret_mem, 0, size);
dwarf_malloc_check_alloc_data(ret_mem, type);
if (index_into_allocated[type].specialconstructor) {
int res =
index_into_allocated[type].specialconstructor(dbg, ret_mem);
if (res != DW_DLV_OK) {
/* We leak what we allocated in _dwarf_find_memory when
constructor fails. */
return NULL;
}
}
return (ret_mem);
}
/*
This function is used to deallocate a region of memory
that was obtained by a call to _dwarf_get_alloc. Note
that though dwarf_dealloc() is a public function,
_dwarf_get_alloc() isn't.
For lists, typically arrays of pointers, it is assumed
that the space was allocated by a direct call to malloc,
and so a straight free() is done. This is also the case
for variable length blocks such as DW_DLA_FRAME_BLOCK
and DW_DLA_LOC_BLOCK and DW_DLA_RANGES.
For strings, the pointer might point to a string in
.debug_info or .debug_string. After this is checked,
and if found not to be the case, a free() is done,
again on the assumption that a malloc was used to
obtain the space.
For other types of structs, a pointer to the chunk that
the struct was allocated out of, is present in the bytes
preceding the pointer passed in. For this chunk it is
checked whether all the structs in that chunk are now free.
If so, the entire chunk is free_ed. Otherwise, the space
is added to the free list for that chunk, and the free count
incremented.
This function does not return anything.
*/
void
dwarf_dealloc(Dwarf_Debug dbg,
Dwarf_Ptr space, Dwarf_Unsigned alloc_type)
{
Dwarf_Alloc_Hdr alloc_hdr;
Dwarf_Alloc_Area alloc_area;
unsigned int type = alloc_type;
unsigned int index;
if (space == NULL) {
return;
}
if (type == DW_DLA_ERROR) {
/* Get pointer to Dwarf_Alloc_Area this struct came from. See
dwarf_alloc.h ROUND_SIZE_WITH_POINTER stuff */
alloc_area =
*(Dwarf_Alloc_Area *) ((char *) space - DW_RESERVE);
if (alloc_area == 0) {
/* This is the special case of a failed dwarf_init(). Also
(and more signficantly) there are a variety of other
situations where libdwarf does not *know* what dbg is
involved (because of a libdwarf-caller-error) so
libdwarf uses NULL as the dbg. Those too wind up here. */
_dwarf_free_special_error(space);
dwarf_malloc_check_dealloc_data(space, type);
return;
}
}
if (dbg == NULL) {
/* App error, or an app that failed to succeed in a
dwarf_init() call. */
return;
}
if (type >= ALLOC_AREA_INDEX_TABLE_MAX) {
/* internal or user app error */
return;
}
index = index_into_allocated[type].ia_al_num;
/*
A string pointer may point into .debug_info or .debug_string.
Otherwise, they are directly malloc'ed. */
dwarf_malloc_check_dealloc_data(space, type);
if (index == 0) {
if (type == DW_DLA_STRING) {
if ((Dwarf_Small *) space >= dbg->de_debug_info.dss_data &&
(Dwarf_Small *) space <
dbg->de_debug_info.dss_data + dbg->de_debug_info.dss_size)
return;
if (dbg->de_debug_line.dss_data != NULL &&
(Dwarf_Small *) space >= dbg->de_debug_line.dss_data &&
(Dwarf_Small *) space <
dbg->de_debug_line.dss_data + dbg->de_debug_line.dss_size)
return;
if (dbg->de_debug_pubnames.dss_data != NULL &&
(Dwarf_Small *) space >= dbg->de_debug_pubnames.dss_data &&
(Dwarf_Small *) space <
dbg->de_debug_pubnames.dss_data +
dbg->de_debug_pubnames.dss_size)
return;
if (dbg->de_debug_frame.dss_data != NULL &&
(Dwarf_Small *) space >= dbg->de_debug_frame.dss_data &&
(Dwarf_Small *) space <
dbg->de_debug_frame.dss_data + dbg->de_debug_frame.dss_size)
return;
if (dbg->de_debug_str.dss_data != NULL &&
(Dwarf_Small *) space >= dbg->de_debug_str.dss_data &&
(Dwarf_Small *) space <
dbg->de_debug_str.dss_data + dbg->de_debug_str.dss_size)
return;
if (dbg->de_debug_funcnames.dss_data != NULL &&
(Dwarf_Small *) space >= dbg->de_debug_funcnames.dss_data &&
(Dwarf_Small *) space <
dbg->de_debug_funcnames.dss_data +
dbg->de_debug_funcnames.dss_size)
return;
if (dbg->de_debug_typenames.dss_data != NULL &&
(Dwarf_Small *) space >= dbg->de_debug_typenames.dss_data &&
(Dwarf_Small *) space <
dbg->de_debug_typenames.dss_data +
dbg->de_debug_typenames.dss_size)
return;
if (dbg->de_debug_pubtypes.dss_data != NULL &&
(Dwarf_Small *) space >= dbg->de_debug_pubtypes.dss_data &&
(Dwarf_Small *) space <
dbg->de_debug_pubtypes.dss_data +
dbg->de_debug_pubtypes.dss_size)
return;
if (dbg->de_debug_varnames.dss_data != NULL &&
(Dwarf_Small *) space >= dbg->de_debug_varnames.dss_data &&
(Dwarf_Small *) space <
dbg->de_debug_varnames.dss_data +
dbg->de_debug_varnames.dss_size)
return;
if (dbg->de_debug_weaknames.dss_data != NULL &&
(Dwarf_Small *) space >= dbg->de_debug_weaknames.dss_data &&
(Dwarf_Small *) space <
dbg->de_debug_weaknames.dss_data +
dbg->de_debug_weaknames.dss_size)
return;
#ifdef DWARF_SIMPLE_MALLOC
_dwarf_simple_malloc_delete_from_list(dbg, space, type);
#endif
free(space);
return;
}
if (type == DW_DLA_LIST ||
type == DW_DLA_FRAME_BLOCK ||
type == DW_DLA_LOC_BLOCK || type == DW_DLA_ADDR ||
type == DW_DLA_RANGES ||
type == DW_DLA_HASH_TABLE_ENTRY) {
#ifdef DWARF_SIMPLE_MALLOC
_dwarf_simple_malloc_delete_from_list(dbg, space, type);
#endif
free(space);
return;
}
/* else is an alloc type that is not used */
/* app or internal error */
#ifdef DWARF_SIMPLE_MALLOC
_dwarf_simple_malloc_botch(4);
#endif
return;
}
if (index_into_allocated[type].specialdestructor) {
index_into_allocated[type].specialdestructor(space);
}
#ifdef DWARF_SIMPLE_MALLOC
_dwarf_simple_malloc_delete_from_list(dbg, space, type);
free(space);
#else /* !DWARF_SIMPLE_MALLOC */
alloc_hdr = &dbg->de_alloc_hdr[index];
/* Get pointer to Dwarf_Alloc_Area this struct came from. See
dwarf_alloc.h ROUND_SIZE_WITH_POINTER stuff */
alloc_area = *(Dwarf_Alloc_Area *) ((char *) space - DW_RESERVE);
/* ASSERT: alloc_area != NULL If NULL we could abort, let it
coredump below, or return, pretending all is well. We go on,
letting program crash. Is caller error. */
/*
Check that the alloc_hdr field of the alloc_area we have is
pointing to the right alloc_hdr. This is used to catch use of
incorrect deallocation code by the user. */
if (alloc_area->aa_alloc_hdr != alloc_hdr) {
/* If we get here, the user has called dwarf_dealloc wrongly or
there is some other disastrous error. By leaking mem here we
try to be safe... */
#ifdef DEBUG
fprintf(stderr,
"libdwarf Internal error: type %d hdr mismatch %lx %lx "
"area ptr %lx\n",
(int) type,
(long) alloc_area->aa_alloc_hdr,
(long) alloc_hdr, (long) alloc_area);
#endif
return;
}
alloc_hdr->ah_struct_user_holds--;
alloc_area->aa_free_structs_in_chunk++;
/*
Give chunk back to malloc only when every struct is freed */
if (alloc_area->aa_free_structs_in_chunk ==
alloc_hdr->ah_structs_per_chunk) {
if (alloc_area->aa_prev != NULL) {
alloc_area->aa_prev->aa_next = alloc_area->aa_next;
} else {
alloc_hdr->ah_alloc_area_head = alloc_area->aa_next;
}
if (alloc_area->aa_next != NULL) {
alloc_area->aa_next->aa_prev = alloc_area->aa_prev;
}
alloc_hdr->ah_chunks_allocated--;
if (alloc_area == alloc_hdr->ah_last_alloc_area) {
alloc_hdr->ah_last_alloc_area = NULL;
}
memset(alloc_area, 0, sizeof(*alloc_area));
free(alloc_area);
}
else {
((Dwarf_Free_List) space)->fl_next = alloc_area->aa_free_list;
alloc_area->aa_free_list = space;
}
#endif /* !DWARF_SIMPLE_MALLOC */
}
/*
Allocates space for a Dwarf_Debug_s struct,
since one does not exist.
*/
Dwarf_Debug
_dwarf_get_debug(void
)
{
Dwarf_Debug dbg;
dbg = (Dwarf_Debug) malloc(sizeof(struct Dwarf_Debug_s));
if (dbg == NULL)
return (NULL);
else
memset(dbg, 0, sizeof(struct Dwarf_Debug_s));
return (dbg);
}
/*
Sets up the Dwarf_Debug_s struct for all the
allocation types currently defined.
Allocation types DW_DLA_STRING, DW_DLA_LIST,
DW_DLA_FRAME_BLOCK, DW_DLA_LOC_BLOCK, DW_DLA_RANGES are
malloc'ed directly.
This routine should be called after _dwarf_setup(),
so that information about the sizes of the Dwarf
sections can be used to decide the number of
structs of each type malloc'ed.
Also DW_DLA_ELLIST, DW_DLA_BOUNDS, DW_DLA_TYPE,
DW_DLA_SUBSCR, DW_DLA_LINEBUF allocation types
are currently not used.
The ah_bytes_one_struct and ah_structs_per_chunk fields for
these types have been set to 1 for efficiency
in dwarf_get_alloc().
Ah_alloc_num should be greater than 1 for all
types that are currently being used.
Therefore, for these allocation types the
ah_bytes_one_struct, and ah_structs_per_chunk fields do not
need to be initialized.
Being an internal routine, assume proper dbg.
*/
Dwarf_Debug
_dwarf_setup_debug(Dwarf_Debug dbg)
{
int i;
for (i = 1; i <= MAX_DW_DLA; i++) {
const struct ial_s *ialp = &index_into_allocated[i];
unsigned int hdr_index = ialp->ia_al_num;
Dwarf_Word str_size = ialp->ia_struct_size;
Dwarf_Word str_count = ialp->ia_base_count;
Dwarf_Word rnded_size = ROUND_SIZE_WITH_POINTER(str_size);
Dwarf_Alloc_Hdr alloc_hdr = &dbg->de_alloc_hdr[hdr_index];
alloc_hdr->ah_bytes_one_struct = (Dwarf_Half) rnded_size;
/* ah_structs_per_chunk must be >0 else we are in trouble */
alloc_hdr->ah_structs_per_chunk = str_count;
alloc_hdr->ah_bytes_malloc_per_chunk = rnded_size * str_count;
}
return (dbg);
}
/*
This function prints out the statistics
collected on allocation of memory chunks.
*/
void
dwarf_print_memory_stats(Dwarf_Debug dbg)
{
Dwarf_Alloc_Hdr alloc_hdr;
Dwarf_Shalf i;
/*
Alloc types start at 1, not 0. Hence, the first NULL string, and
also a size of MAX_DW_DLA + 1. */
char *alloc_type_name[MAX_DW_DLA + 1] = {
"",
"DW_DLA_STRING",
"DW_DLA_LOC",
"DW_DLA_LOCDESC",
"DW_DLA_ELLIST",
"DW_DLA_BOUNDS",
"DW_DLA_BLOCK",
"DW_DLA_DEBUG",
"DW_DLA_DIE",
"DW_DLA_LINE",
"DW_DLA_ATTR",
"DW_DLA_TYPE",
"DW_DLA_SUBSCR",
"DW_DLA_GLOBAL",
"DW_DLA_ERROR",
"DW_DLA_LIST",
"DW_DLA_LINEBUF",
"DW_DLA_ARANGE",
"DW_DLA_ABBREV",
"DW_DLA_FRAME_OP",
"DW_DLA_CIE",
"DW_DLA_FDE",
"DW_DLA_LOC_BLOCK",
"DW_DLA_FRAME_BLOCK",
"DW_DLA_FUNC",
"DW_DLA_TYPENAME",
"DW_DLA_VAR",
"DW_DLA_WEAK",
"DW_DLA_ADDR",
"DW_DLA_RANGES",
"DW_DLA_ABBREV_LIST",
"DW_DLA_CHAIN",
"DW_DLA_CU_CONTEXT",
"DW_DLA_FRAME",
"DW_DLA_GLOBAL_CONTEXT",
"DW_DLA_FILE_ENTRY",
"DW_DLA_LINE_CONTEXT",
"DW_DLA_LOC_CHAIN",
"DW_DLA_HASH_TABLE",
"DW_DLA_FUNC_CONTEXT",
"DW_DLA_TYPENAME_CONTEXT",
"DW_DLA_VAR_CONTEXT",
"DW_DLA_WEAK_CONTEXT",
"DW_DLA_PUBTYPES_CONTEXT",
"DW_DLA_HASH_TABLE_ENTRY",
};
if (dbg == NULL)
return;
printf("Size of Dwarf_Debug %4ld bytes\n",
(long) sizeof(*dbg));
printf("Size of Dwarf_Alloc_Hdr_s %4ld bytes\n",
(long) sizeof(struct Dwarf_Alloc_Hdr_s));
printf("size of Dwarf_Alloc_Area_s %4ld bytes\n",
(long) sizeof(struct Dwarf_Alloc_Area_s));
printf(" Alloc Type Curr Structs byt str\n");
printf(" ---------- ---- ------- per per\n");
for (i = 1; i <= MAX_DW_DLA; i++) {
int indx = index_into_allocated[i].ia_al_num;
alloc_hdr = &dbg->de_alloc_hdr[indx];
if (alloc_hdr->ah_bytes_one_struct != 1) {
printf("%2d %-25s %6d %8d %6d %6d\n",
(int) i,
alloc_type_name[i],
(int) alloc_hdr->ah_chunks_allocated,
(int) alloc_hdr->ah_struct_user_holds,
(int) alloc_hdr->ah_bytes_malloc_per_chunk,
(int) alloc_hdr->ah_structs_per_chunk);
}
}
}
#ifndef DWARF_SIMPLE_MALLOC
/*
This recursively frees
the chunks still allocated, and
forward chained through the aa_next
pointer.
*/
static void
_dwarf_recursive_free(Dwarf_Alloc_Area alloc_area)
{
if (alloc_area->aa_next != NULL) {
_dwarf_recursive_free(alloc_area->aa_next);
}
alloc_area->aa_next = 0;
alloc_area->aa_prev = 0;
free(alloc_area);
}
#endif
/* In the 'rela' relocation case we might have malloc'd
space to ensure it is read-write. In that case, free the space. */
static void
rela_free(struct Dwarf_Section_s * sec)
{
if (sec->dss_data_was_malloc) {
free(sec->dss_data);
}
sec->dss_data = 0;
sec->dss_data_was_malloc = 0;
}
/*
Used to free all space allocated for this Dwarf_Debug.
The caller should assume that the Dwarf_Debug pointer
itself is no longer valid upon return from this function.
In case of difficulty, this function simply returns quietly.
*/
int
_dwarf_free_all_of_one_debug(Dwarf_Debug dbg)
{
Dwarf_Alloc_Hdr alloc_hdr;
Dwarf_Shalf i;
Dwarf_CU_Context context = 0;
Dwarf_CU_Context nextcontext = 0;
if (dbg == NULL)
return (DW_DLV_ERROR);
/* To do complete validation that we have no surprising missing or
erroneous deallocs it is advisable to do the dwarf_deallocs here
that are not things the user can otherwise request.
Housecleaning. */
for (context = dbg->de_cu_context_list;
context; context = nextcontext) {
Dwarf_Hash_Table hash_table = context->cc_abbrev_hash_table;
_dwarf_free_abbrev_hash_table_contents(dbg,hash_table);
nextcontext = context->cc_next;
dwarf_dealloc(dbg, hash_table, DW_DLA_HASH_TABLE);
dwarf_dealloc(dbg, context, DW_DLA_CU_CONTEXT);
}
/* Housecleaning done. Now really free all the space. */
#ifdef DWARF_SIMPLE_MALLOC
if (dbg->de_simple_malloc_base) {
struct simple_malloc_record_s *smp = dbg->de_simple_malloc_base;
while (smp) {
int i;
struct simple_malloc_record_s *prev_smp = 0;
for (i = 0; i < smp->sr_used; ++i) {
struct simple_malloc_entry_s *cur;
cur = &smp->sr_entry[i];
if (cur->se_addr != 0) {
free(cur->se_addr);
cur->se_addr = 0;
}
}
prev_smp = smp;
smp = smp->sr_next;
free(prev_smp);
}
dbg->de_simple_malloc_base = 0;
}
#else
for (i = 1; i < ALLOC_AREA_REAL_TABLE_MAX; i++) {
int indx = i;
alloc_hdr = &dbg->de_alloc_hdr[indx];
if (alloc_hdr->ah_alloc_area_head != NULL) {
_dwarf_recursive_free(alloc_hdr->ah_alloc_area_head);
}
}
#endif
rela_free(&dbg->de_debug_info);
rela_free(&dbg->de_debug_abbrev);
rela_free(&dbg->de_debug_line);
rela_free(&dbg->de_debug_loc);
rela_free(&dbg->de_debug_aranges);
rela_free(&dbg->de_debug_macinfo);
rela_free(&dbg->de_debug_pubnames);
rela_free(&dbg->de_debug_str);
rela_free(&dbg->de_debug_frame);
rela_free(&dbg->de_debug_frame_eh_gnu);
rela_free(&dbg->de_debug_pubtypes);
rela_free(&dbg->de_debug_funcnames);
rela_free(&dbg->de_debug_typenames);
rela_free(&dbg->de_debug_varnames);
rela_free(&dbg->de_debug_weaknames);
rela_free(&dbg->de_debug_ranges);
dwarf_harmless_cleanout(&dbg->de_harmless_errors);
memset(dbg, 0, sizeof(*dbg)); /* Prevent accidental use later. */
free(dbg);
return (DW_DLV_OK);
}
/* A special case: we have no dbg, no alloc header etc.
So create something out of thin air that we can recognize
in dwarf_dealloc.
Something with the prefix (prefix space hidden from caller).
Only applies to DW_DLA_ERROR, making up an error record.
*/
struct Dwarf_Error_s *
_dwarf_special_no_dbg_error_malloc(void)
{
/* the union unused things are to guarantee proper alignment */
union u {
Dwarf_Alloc_Area ptr_not_used;
struct Dwarf_Error_s base_not_used;
char data_space[sizeof(struct Dwarf_Error_s) +
(DW_RESERVE * 2)];
};
char *mem;
mem = malloc(sizeof(union u));
if (mem == 0) {
return 0;
}
memset(mem, 0, sizeof(union u));
mem += DW_RESERVE;
return (struct Dwarf_Error_s *) mem;
}
/* The free side of _dwarf_special_no_dbg_error_malloc()
*/
static void
_dwarf_free_special_error(Dwarf_Ptr space)
{
char *mem = (char *) space;
mem -= DW_RESERVE;
free(mem);
}
#ifdef DWARF_SIMPLE_MALLOC
/* here solely for planting a breakpoint. */
/* ARGSUSED */
void
_dwarf_simple_malloc_botch(int err)
{
fprintf(stderr,"simple malloc botch %d\n",err);
}
static void
_dwarf_simple_malloc_add_to_list(Dwarf_Debug dbg,
Dwarf_Ptr addr,
unsigned long size, short alloc_type)
{
struct simple_malloc_record_s *cur;
struct simple_malloc_entry_s *newentry;
if (!dbg->de_simple_malloc_base) {
/* First entry to this routine. */
dbg->de_simple_malloc_base =
malloc(sizeof(struct simple_malloc_record_s));
if (!dbg->de_simple_malloc_base) {
_dwarf_simple_malloc_botch(7);
return; /* no memory, give up */
}
memset(dbg->de_simple_malloc_base,
0, sizeof(struct simple_malloc_record_s));
}
cur = dbg->de_simple_malloc_base;
if (cur->sr_used >= DSM_BLOCK_COUNT) {
/* Better not be > than as that means chaos */
/* Create a new block to link at the head. */
struct simple_malloc_record_s *newblock =
malloc(sizeof(struct simple_malloc_record_s));
if (!newblock) {
_dwarf_simple_malloc_botch(8);
return; /* Can do nothing, out of memory */
}
memset(newblock, 0, sizeof(struct simple_malloc_record_s));
/* Link the new block at the head of the chain, and make it
'current' */
dbg->de_simple_malloc_base = newblock;
newblock->sr_next = cur;
cur = newblock;
}
newentry = &cur->sr_entry[cur->sr_used];
newentry->se_addr = addr;
newentry->se_size = size;
newentry->se_type = alloc_type;
++cur->sr_used;
}
/*
DWARF_SIMPLE_MALLOC: testing the hypothesis that the existing
malloc scheme here (see _dwarf_get_alloc()) is pointless complexity.
DWARF_SIMPLE_MALLOC also makes it easy for a malloc-tracing
tool to verify libdwarf malloc has no botches (though of course
such does not test the complicated standard-libdwarf-alloc code).
To properly answer the question, the simple-malloc allocate
and delete should be something other than a simple list.
Perhaps a heap, or perhaps a red-black tree.
*/
static void
_dwarf_simple_malloc_delete_from_list(Dwarf_Debug dbg,
Dwarf_Ptr space, short alloc_type)
{
if (space == 0) {
_dwarf_simple_malloc_botch(6);
}
if (dbg->de_simple_malloc_base) {
struct simple_malloc_record_s *smp = dbg->de_simple_malloc_base;
while (smp) {
int i;
for (i = 0; i < smp->sr_used; ++i) {
struct simple_malloc_entry_s *cur;
cur = &smp->sr_entry[i];
if (cur->se_addr == space) {
if (cur->se_type != alloc_type) {
_dwarf_simple_malloc_botch(0);
}
cur->se_addr = 0;
return;
}
}
smp = smp->sr_next;
}
}
/* Never found the space. */
_dwarf_simple_malloc_botch(1);
return;
}
#endif