mirror of
https://github.com/Zenithsiz/ftmemsim-valgrind.git
synced 2026-02-03 10:05:29 +00:00
665280aeaf
This patch changes the interface and behaviour of VG_(demangle) and VG_(maybe_Z_demangle). Instead of copying the demangled name into a fixed sized buffer that is passed in from the caller (HChar *buf, Int n_buf), the demangling functions will now return a pointer to the full-length demangled name (HChar **result). It is the caller's responsiblilty to make a copy if needed. This change in function parameters ripples upward - first: to get_sym_name - then to the convenience wrappers - VG_(get_fnname) - VG_(get_fnname_w_offset) - VG_(get_fnname_if_entry) - VG_(get_fnname_raw) - VG_(get_fnname_no_cxx_demangle) - VG_(get_datasym_and_offset) The changes in foComplete then forces the arguments of - VG_(get_objname) to be changed as well There are some issues regarding the ownership and persistence of character strings to consider. In general, the returned character string is owned by "somebody else" which means the caller must not free it. Also, the caller must not modify the returned string as it possibly points to read only memory. Additionally, the returned string is not necessarily persistent. Here are the scenarios: - the returned string is a demangled function name in which case the memory holding the string will be freed when the demangler is called again. - the returned string hangs off of a DebugInfo structure in which case it will be freed when the DebugInfo is discarded - the returned string hangs off of a segment in the address space manager in which case it may be overwritten when the segment is merged with another segment So the rule of thunb here is: if in doubt strdup the string. git-svn-id: svn://svn.valgrind.org/valgrind/trunk@14664
77 lines
3.0 KiB
C
77 lines
3.0 KiB
C
|
|
/*--------------------------------------------------------------------*/
|
|
/*--- Misc simple stuff lacking a better home. priv_misc.h ---*/
|
|
/*--------------------------------------------------------------------*/
|
|
|
|
/*
|
|
This file is part of Valgrind, a dynamic binary instrumentation
|
|
framework.
|
|
|
|
Copyright (C) 2008-2013 OpenWorks LLP
|
|
info@open-works.co.uk
|
|
|
|
This program is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU General Public License as
|
|
published by the Free Software Foundation; either version 2 of the
|
|
License, or (at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program; if not, write to the Free Software
|
|
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
|
|
02111-1307, USA.
|
|
|
|
The GNU General Public License is contained in the file COPYING.
|
|
|
|
Neither the names of the U.S. Department of Energy nor the
|
|
University of California nor the names of its contributors may be
|
|
used to endorse or promote products derived from this software
|
|
without prior written permission.
|
|
*/
|
|
|
|
#ifndef __PRIV_MISC_H
|
|
#define __PRIV_MISC_H
|
|
|
|
#include "pub_core_basics.h" // SizeT
|
|
|
|
/* Allocate(zeroed), free, strdup, memdup, shrink, all in VG_AR_DINFO.
|
|
The allocation functions never return NULL. */
|
|
void* ML_(dinfo_zalloc)( const HChar* cc, SizeT szB );
|
|
void ML_(dinfo_free)( void* v );
|
|
HChar* ML_(dinfo_strdup)( const HChar* cc, const HChar* str );
|
|
void* ML_(dinfo_memdup)( const HChar* cc, const void* str, SizeT nStr );
|
|
void* ML_(dinfo_realloc) ( const HChar* cc, void* ptr, SizeT new_size );
|
|
void ML_(dinfo_shrink_block)( void* ptr, SizeT szB );
|
|
|
|
/* Extract (possibly unaligned) data of various sizes from a buffer. */
|
|
Short ML_(read_Short)( const UChar* data );
|
|
Int ML_(read_Int)( const UChar* data );
|
|
Long ML_(read_Long)( const UChar* data );
|
|
UShort ML_(read_UShort)( const UChar* data );
|
|
UWord ML_(read_UWord)( const UChar* data );
|
|
UInt ML_(read_UInt)( const UChar* data );
|
|
ULong ML_(read_ULong)( const UChar* data );
|
|
UChar ML_(read_UChar)( const UChar* data );
|
|
Addr ML_(read_Addr)( const UChar* data );
|
|
|
|
UChar* ML_(write_UShort)( UChar* ptr, UShort val );
|
|
UChar* ML_(write_UInt)( UChar* ptr, UInt val );
|
|
UChar* ML_(write_ULong)( UChar* ptr, ULong val );
|
|
UChar* ML_(write_UChar)( UChar* ptr, UChar val );
|
|
UChar* ML_(write_Addr)( UChar* ptr, Addr val );
|
|
|
|
/* A handy type, a la Haskell's Maybe type. Yes, I know, C sucks.
|
|
Been there. Done that. Seen the movie. Got the T-shirt. Etc. */
|
|
typedef struct { ULong ul; Bool b; } MaybeULong;
|
|
|
|
|
|
#endif /* ndef __PRIV_MISC_H */
|
|
|
|
/*--------------------------------------------------------------------*/
|
|
/*--- end priv_misc.h ---*/
|
|
/*--------------------------------------------------------------------*/
|