Compare commits

...

5 Commits

Author SHA1 Message Date
David Anderson
89e17f5290 A handful of the corrections to Macos were
wrong. Now fully consistent.
	modified:   src/lib/libdwarf/libdwarf.h
2025-07-07 15:16:34 -07:00
David Anderson
605cd1e71c Up to date.
modified:   ChangeLog
2025-07-07 15:03:32 -07:00
David Anderson
46d7f5cf65 Corrected date of the document.
Mention tentative release 20 July 2024.
	modified:   doc/libdwarf.dox
2025-07-07 15:02:07 -07:00
David Anderson
14782677e9 Unified spelling to Macos.
Corrected spelling errors on a few words.
Corrected wording clarifying that
dwarf_language_version_data()
and dwarfsrclanglname_version() returned
string pointers must never be freed or
dealloc'd by library callers.
	modified:   src/lib/libdwarf/libdwarf.h
2025-07-07 14:58:50 -07:00
David Anderson
d60d790043 explaining the fix to meson.build.
modified:   ChangeLog
2025-07-06 16:39:27 -07:00
3 changed files with 80 additions and 15 deletions

View File

@@ -1,3 +1,67 @@
2025-07-07: David Anderson
commit 46d7f5cf651bf010c5f71e061ae4a62d73e461b0
Corrected date of the document.
Mention tentative release 20 July 2024.
modified: doc/libdwarf.dox
2025-07-07: David Anderson
commit 14782677e994860707b969ade3f47fc798edccb6
Unified spelling to Macos.
Corrected spelling errors on a few words.
Corrected wording clarifying that
dwarf_language_version_data()
and dwarfsrclanglname_version() returned
string pointers must never be freed or
dealloc'd by library callers.
modified: src/lib/libdwarf/libdwarf.h
2025-07-06: David Anderson
commit d60d790043895728716a06c0f79c85486fead270
explaining the fix to meson.build.
modified: ChangeLog
2025-07-07: MrSmör
commit 6a0ace2b192bd0e3b6c9bb465685280c5e85db8d
Make meson generate a proper pkg-config file when absolute paths (#298)
are specified for includedir and libdir etc.
Showing just one example, the other two lines
are equivalent
Prefix and @0@ are in the output so if @0@ is full path
it does not work, as it has mixed full paths onto prefix.
-pkgconf.set('libdir', '${prefix}/@0@'.format(get_option('libdir')))
A full path in @0@ means (via join_paths) that
the prefix gets dropped (that is, path joining
works sensibly).
+pkgconf.set('libdir', join_paths('${prefix}','@0@'.format(get_option('libdir'))))
modified: meson.build
2025-07-05: David Anderson
commit 6c54cee95eadaa5456db03ac617774de1b0399ee
make rebuild so these files now say (n comments)
they are part of 2.1.0
modified: src/bin/dwarfdump/dwarfdump-af-table-ext.h
modified: src/bin/dwarfdump/dwarfdump-af-table-std.h
modified: src/bin/dwarfdump/dwarfdump-ta-ext-table.h
modified: src/bin/dwarfdump/dwarfdump-ta-table.h
modified: src/bin/dwarfdump/dwarfdump-tt-ext-table.h
modified: src/bin/dwarfdump/dwarfdump-tt-table.h
modified: src/lib/libdwarf/dwarf_names.c
2025-07-04: David Anderson
commit 4f073405c2814ae16397935b7a6b9a4dbef90bdc
Up to date.
modified: ChangeLog
2025-07-04: David Anderson
commit 6ecf529a3034c126f4cdf2b46c864f5590048072

View File

@@ -3,7 +3,7 @@
@tableofcontents{HTML:3,LaTeX:3}
@author David Anderson
@copyright This work is licensed under the Creative Commons Attribution 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by/4.0/ or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.
@date 2025-05-31 v2.1.0
@date 2025-07-07 v2.1.0
@section draft Suggestions for improvement are welcome.
@@ -1163,6 +1163,8 @@
<b>Changes 2.0.0 to 2.1.0</b>
Tentative release 20 July 2020
Corrected (and tested) use of DWARF6 attributes
DW_AT_language_name and DW_AT_language_version.
As of July 2025 we are not aware of a released

View File

@@ -106,13 +106,13 @@ extern "C" {
#define DW_PATHSOURCE_unspecified 0
#define DW_PATHSOURCE_basic 1
#define DW_PATHSOURCE_dsym 2 /* MacOS dSYM */
#define DW_PATHSOURCE_dsym 2 /* Macos dSYM */
#define DW_PATHSOURCE_debuglink 3 /* GNU debuglink */
#ifndef DW_FTYPE_UNKNOWN
#define DW_FTYPE_UNKNOWN 0
#define DW_FTYPE_ELF 1 /* Unix/Linux/etc */
#define DW_FTYPE_MACH_O 2 /* MacOS. */
#define DW_FTYPE_MACH_O 2 /* Macos. */
#define DW_FTYPE_PE 3 /* Windows */
#define DW_FTYPE_ARCHIVE 4 /* unix archive */
#define DW_FTYPE_APPLEUNIVERSAL 5
@@ -1568,9 +1568,9 @@ typedef struct Dwarf_Rnglists_Head_s * Dwarf_Rnglists_Head;
The returned string will be null-terminated.
The path actually used is copied to true_path_out.
If true_path_buffer len is zero or true_path_out_buffer
is zero then the Special MacOS processing will not
is zero then the Special Macos processing will not
occur, nor will the GNU_debuglink processing occur.
In case GNU debuglink data was followed or MacOS
In case GNU debuglink data was followed or Macos
dSYM applies the true_path_out
will not match path and the initial byte will be
non-null.
@@ -2965,9 +2965,8 @@ DW_API int dwarf_srclanglname(Dwarf_Die dw_die,
attributes (normally
only found on a CU DIE). For example DW_LNAME_C
would return a pointer to "YYYYMM"
Never free or dealloc the string, it is in static memory.
Never free or dealloc the string returned
through dw_returned_verstring, it is in static memory.
@param dw_error
The usual error detail return pointer.
@return
@@ -3000,8 +2999,8 @@ DW_API int dwarf_srclanglname_version(Dwarf_Die dw_die,
the pointer would by "YYYYMM".
If there is no version scheme defined, return a NULL
through the pointer.
Never dealloc or free() any returned value
as it is a static constant string.
Never dealloc or free() the string returned through
dw_version_scheme as it is a static constant string.
@return
Returns DW_DLV_OK or the dw_lang_name
is unknown, returns DW_DLV_NO_ENTRY.
@@ -3700,7 +3699,7 @@ DW_API int dwarf_discr_entry_s(Dwarf_Dsc_Head dw_dsc,
-# The file number denotes a name in the line table header.
-# If the name is not a full path (i.e. not starting
with / in posix/linux/MacOS) then prepend the appropriate
with / in posix/linux/Macos) then prepend the appropriate
directory string from the line table header.
-# If the name is still not a full path then prepend
the content of the DW_AT_comp_dir attribute
@@ -4516,7 +4515,7 @@ DW_API void dwarf_dealloc_ranges(Dwarf_Debug dw_dbg,
Otherwise the value FALSE will be returned through
dw_known_base.
@param dw_baseaddress
if dw_known_base is retured as TRUE then
if dw_known_base is returned as TRUE then
dw_baseaddress will be set with the correct pc value.
Otherwise zero will be set through dw_baseaddress.
@param dw_at_ranges_offset_present
@@ -8495,7 +8494,7 @@ DW_API int dwarf_get_debugfission_for_key(Dwarf_Debug dw_dbg,
/*! @defgroup gnudebuglink Access GNU .gnu_debuglink, build-id.
@{
When DWARF sections are in a differenct object
When DWARF sections are in a different object
than the executable or a normal shared object.
The special GNU section provides a way to name
the object file with DWARF.
@@ -9054,8 +9053,8 @@ DW_API int dwarf_get_FORM_CLASS_name(enum Dwarf_Form_Class dw_fc,
For non-Elf the name reported will be as if
it were Elf sections. For example, not the names
MacOS puts in its object sections (which
the MacOS reader translates).
Macos puts in its object sections (which
the Macos reader translates).
These calls returning selected object header
{machine architecture,flags)