rdwarf 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5025e79195f3e1a040f05e3e0c89c2ff02055a1f
+  data.tar.gz: 46af846fae0a900a921c4617ac0ac4abc9b24be0
+SHA512:
+  metadata.gz: 1230590d3eeb1b0d42944861f9c57d83eb4ed83c217307a3fcd70a417b7a3c6a053f49f8d5a8777183c2bf806a1a632fcec2ccd73f850d6f75ecbad6ac59500d
+  data.tar.gz: 36b2ab2fe6ad184c5da6c7f03eb6a48e3456372671de43c528cfb3e8da2fc8f624c0aafcd14d7d5fbfe2753e7ec2d94a295c4545e9866061cdacdd82d614a61b

data/.gitignore

@@ -0,0 +1,16 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/ext/rdwarf/Makefile
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+*~
+mkmf.log

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.2.2
+before_install: gem install bundler -v 1.10.6

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in rdwarf.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,28 @@
+Copyright (C) 2015 Kubo Takehiro <kubo@jiubao.org>
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+   1. Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+
+   2. Redistributions in binary form must reproduce the above
+      copyright notice, this list of conditions and the following
+      disclaimer in the documentation and/or other materials provided
+      with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHORS ''AS IS'' AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+The views and conclusions contained in the software and documentation
+are those of the authors and should not be interpreted as representing
+official policies, either expressed or implied, of the authors.

data/README.md

@@ -0,0 +1,39 @@
+# Rdwarf
+
+Rdwarf is a ruby module to read DWARF debugging information using [libdwarf](http://www.prevanders.net/dwarf.html).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'rdwarf'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install rdwarf
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake false` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/kubo/rdwarf.
+
+## License
+
+The gem is available as open source under the terms of the [LGPL 2.1](https://opensource.org/licenses/LGPL-2.1) as a whole.
+
+Files under ext/rdwarf/libdwarf, which were copied from [libdwarf](http://www.prevanders.net/dwarf.html), are licensed under the LGPL2.1. Others are licensed under the 2-clause BSD license.

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+require "rake/extensiontask"
+
+task :build => :compile
+
+Rake::ExtensionTask.new("rdwarf") do |ext|
+  ext.lib_dir = "lib/rdwarf"
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "rdwarf"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/ext/rdwarf/depend

@@ -0,0 +1,5 @@
+rdwarf_names.c: $(srcdir)/rdwarf_names_gen.rb $(srcdir)/libdwarf/dwarf.h
+	$(ruby) $(srcdir)/rdwarf_names_gen.rb $(srcdir)/libdwarf/dwarf.h > rdwarf_names.c
+
+libdwarf/libdwarf.a:
+	cd libdwarf && make

data/ext/rdwarf/extconf.rb

@@ -0,0 +1,29 @@
+require "mkmf"
+
+if !have_header('libelf.h') || !have_library('elf', 'elf_begin')
+  puts "ERROR: libelf is not found."
+  exit 1
+end
+
+libdwarf_dir = "#{File.absolute_path(File.dirname(__FILE__))}/libdwarf"
+
+Dir.exist?('libdwarf') or Dir.mkdir('libdwarf')
+
+Dir.chdir('libdwarf') do
+  env = {
+    'CC' => RbConfig::CONFIG['CC'],
+    'CPP' => RbConfig::CONFIG['CPP'],
+    'CFLAGS' => RbConfig::CONFIG['CFLAGS'],
+  }
+  cmd = "#{libdwarf_dir}/configure"
+  message("Executing #{cmd}:\n")
+  if !system(env, cmd)
+    exit 1
+  end
+end
+
+$objs = ['rdwarf.o', 'rdwarf_names.o', 'libdwarf/libdwarf.a']
+
+$CFLAGS += " -Ilibdwarf"
+
+create_makefile("rdwarf/rdwarf")

data/ext/rdwarf/libdwarf/CHANGES

@@ -0,0 +1,102 @@
+
+
+-------------------------------------------------------------
+April 14, 2000  davea@sgi.com
+Corrected minor bugs in production of 32bit dwarf with
+64 bit pointers.  Fixed omissions in legal
+DIE children of a DIE.  Make small changes in
+description of regster output in frame information
+access.
+
+-------------------------------------------------------------
+Mar 7, 2000 davea@sgi.com
+Corrected line table reading so it will handle
+reading an object with a diffent number of standard
+op codes than at libdwarf compile time.
+This was possible all along, but libdwarf did
+not do it right.
+
+-------------------------------------------------------------
+Dec 8, 1999  davea@sgi.com
+Changed nearly all files.
+Adding the capability to read and produce
+the new, accepted by committee, but not
+released-publically 64bit extension proposal
+dwarf data.
+This allows dwarf compilation units
+with 64bit section offsets and 32bit
+sections offsets to be mixed. 
+So that offsets can grow very large with
+64-bit pointer applications (though 64bit pointers
+and 64bit offsets are not the same notion).
+
+In addition, removed all the contents (or nearly all)
+of the dwarf_funcs.c dwarf_weaks.c dwarf_vars.c,
+and dwarf_types.c, as the data format is identical
+to dwarf globals (pubnames) and there is no need
+to duplicate all that code.
+
+All these sections whose contents were gutted are things that
+are formatted exactly like pubnames, and all are sgi
+extensions.  Now the implementation uses pubnames code
+(dwarf_global.c) to do the work for all the pubnames-like
+sections.
+
+The (minor, IMO) difference is that in case of an incorrect
+dwarf file (leading to libdwarf being unable to process
+something in one of the sgi-specific pubnames-like sections)
+the dwarf error string may reference pubnames when weaks,
+static functions, static variables, or global typenames are
+actually the problem.  This is fixable, however the price would
+appear to be that even globals would need to call a helper
+function (to pass in the correct error return).  Right now the
+dwarf_weaks.c calls the dwarf_global.c function, for example,
+with no extra arguments indicating the true section involved.
+(Other approaches keeping the original error codes exist.
+Producing the code uniquely via macros seems unappealing.
+Inline functions would be ok though.  This version does not
+inline the functions we are talking about, such as
+dwarf_global_name_offsets() when called from
+dwarf_type_name_offsets().)
+
+Since these extra sections are SGI only and only really used by
+SGI's workshop product, and the performance hit is small, the
+extra function calls in reading each seem acceptable.
+
+
+-------------------------------------------------------------
+Sep 29,1999 davea@sgi.com
+Changed many files, so that it is easy to switch
+from 32bit-offset-only (like cygnus
+and dwarf2 v 2.0.0)  to sgi/mips 64 bit dwarf.
+See NEWS for more info on 32bit-offset.
+
+
+-------------------------------------------------------------
+Since Oct 95 and before May, 1996
+
+Added the function dwarf_get_cie_of_fde() which makes it possible
+to remember a single fde/cie set out of a block usefully.
+
+Enhanced doc of dwarf_bitoffset()
+
+Added new function dwarf_global_formref() so all reference
+forms can be retrieved.
+
+Fixed bug in retrieving array bounds: was failing to sign extend
+formsdata.
+
+Added function dwarf_get_fde_info_for_all_regs(), which makes
+retrieval of the complete set of registers (as needed by
+debuggers and exception handlers) effectively N times faster
+than getting them one a time where N is the number of registers.
+
+Added support for exception table handling (really just support
+for a reference to an exception table for c++ exceptions).
+
+Fixed a bug where useless extra space (several megabytes)
+were malloc'ed for the abbreviations table by the libdwarf
+consumer code.
+
+davea@sgi.com
+-------------------------------------------------------------

data/ext/rdwarf/libdwarf/CODINGSTYLE

@@ -0,0 +1,71 @@
+This document is a brief description of the main
+coding style conventions in libdwarf.   Many of them
+will be obvious from the code, but over time some
+accidental diffences crept in.
+
+Code should be indented in multiples of 4 spaces, and
+tabs should not be used to indent the source code.
+Use the dicheck program to check indenting.
+
+dwarf.h and libdwarf.h must have all arguments commented
+out as these are public headers.  Because a  prototype like
+int dwarf_example_prototype(Dwarf_Debug foo);
+would be made unusable by  a legitimate
+preprocessor definition
+such as  #define foo +
+
+The struct naming convention is 'struct  Camel_Caps_s' for the
+struct and   'Camel_Caps' for any typedef for the struct.
+Admittedly having both camel caps
+and an underbar is an unusual convention, but it is
+the way the coding was begun in the early 1990's and
+we should remain consistent now.
+
+All user-referenceable data and functions 
+and user_visible types should begin with DW_ or
+dwarf_.  Non-static libdwarf global data and functions
+should begin with _dwarf (a somewhat questionable
+approach, but workable).
+
+Function names should be all lower case with underbars
+for readability.
+
+There should never be static data in any function.
+Nor should there ever be static data outside of libdwarf
+functions.  libdwarf can be called from multiple threads
+(but only from one thread per Dwarf_Debug) and multiple
+Dwarf_Debug objects can be open at one time.
+Instead place such data per-dbg into the Dwarf_Debug structure
+in dwarf_opaque.h. Similarly for the producer code.
+
+Function-local variables should be lower-case with
+underbars for readability.   It's ok for a small loop
+with counters to use single letter names like i or k or m.
+
+structure members should have a struct-specific
+2-character prefix to the name (followed by
+an underbar). That makes it much
+easier to grep for uses of members.
+
+Try to keep lines under 80 characters in length.
+
+Ensure every if() has {} to enclose the actions.
+
+There is a slight preference for if<single space>(
+over  if(. Similarly with for (, while (, and switch (.
+Not obsessing about these space-issues...
+
+Use libdwarf.h types for all the data objects you define,
+though sometimes an 'unsigned' or 'int' or 'size_t' is
+ok in restricted circumstances.  Dwarf_Unsigned Dwarf_Signed
+are the preferred integer types for general use.
+
+No .c file should ever have an 'extern *' to access some external.
+Instead, such external references should be defined in a header file
+and every .c with a reference to the external should #include
+the relevant header.  Being obsessive about this ensures that when
+the definition changes it will match the function declaration.
+There are a couple violations of this as of 2012, and those
+should be fixed!
+
+------------

data/ext/rdwarf/libdwarf/COPYING

@@ -0,0 +1,28 @@
+
+
+The files:
+	libdwarf.h
+	dwarf.h
+	and all the .h and .c files in this implementation of
+	libdwarf are copyrighted according to the file
+	LIBDWARFCOPYRIGHT (which mentions the LGPL version 2.1).   
+        Each file mentions the LGPL.
+        The full text of the LGPL 2.1 is provided in LGPL.txt
+
+The libdwarf documentation:
+	libdwarf2.1.mm
+	is based on material submitted to the UI PLSIG as proposed
+	interfaces for dwarf, but completely rewritten.  
+        Copyright ownership is therefore SGI (but see the document for details)  
+        and it seems clear that the intent was there was to be free
+	copying with no fees.
+
+        libdwarf2p.1.mm
+        is documentation of a set of interfaces 
+        (not part of the UI PLSIG proposals)
+        and the document was written from scratch at SGI.
+        Copyright ownership is therefore SGI (but see the document for details)  
+        and it seems clear that the intent was there was to be free
+	copying with no fees.
+
+17 March 2014:Updated to remove reference to dwarf.v2.mm.

data/ext/rdwarf/libdwarf/ChangeLog

@@ -0,0 +1,619 @@
+2015-11-15 David Anderson
+     * Makefile.in,configure.in: These now support building in separate clean directory.
+     * configure: Regenerated.
+2015-11-11 David Anderson
+     * dwarf_opaque.h: Delete two useless blank lines.
+2015-11-09 David Anderson
+     * libdwarf.h.in: Removed unimplemented function 
+       declarationfrom the file.
+     * libdwarf2.1.mm: Updated with new interface functions
+       for DWARF5 and split dwarf. Version2.33
+     * libdwarf2.1.mm: Regenerated.
+2015-11-08 David Anderson
+     * dwarf_alloc.c: Fixed indents, trailing whitespace.  
+     * dwarf_loc2.c: Fixed indents, trailing whitespace.  
+     * dwarf_form.c: Made too-long line into 2 lines.
+     * dwarf_loc.h: Removed duplicate Dwarf_Loc_c_s etc declarations.
+     * dwarf_util.c(_dwarf_error_mv_s_to_t),dwarf_util.h: New 
+       function to eliminate duplicative code.: 
+     * dwarf_query.c): Fix bug in dwarf_get_offset_size().
+       Use new _dwarf_error_mv_s_to_t() to get error on correct dbg.
+       Fixed indents, trailing whitespace.
+     * dwarf_ranges.c: Use new _dwarf_error_mv_s_to_t() 
+       to get error on correct dbg.
+       Fixed indents, trailing whitespace.
+2015-11-07 David Anderson
+     * dwarf_alloc.c: Added new checks so  user mixing up
+       tied dbg with regular dbg won't lead to crashes
+       when calling dwarf_dealloc or dwarf_finish().
+       Zeroed out some fields to recognize space deallocated.
+     * dwarf_die_deliv.c: Added support of split dwarf
+       DW_AT_[GNU_]ranges_base
+     * dwarf_form.c: Load string from tieddbg when appropriate.
+     * dwarf_harmless.c: On free() zero out a field to show that was done.
+     * dwarf_loc.c: Correct the handling of split dwarf loclist.
+     * dwarf_opaque.h: Add cc_ranges_base_present for split dwarf.
+       Add _dwarf_get_ranges_base_attr_from_tied() for split dwarf.
+     * dwarf_query.c: Get and remember skeleton compilaton unit 
+       DW_AT_[GNU_]ranges_base from tied objects for split dwarf.
+     * dwarf_ranges.c: If a tied object present, look for ranges
+       there, not in split dwarf object.
+     * dwarf_util.c: Housekeeping zeros out fields to ensure not
+       used after dealloc.
+2015-11-01 David Anderson
+     * configure.in: Added -O0 to --enable-wall.
+       So if a coredump while debugging gdb will work well.
+     * configure: Regenerated.
+2015-11-01 David Anderson
+     * Makefile.in: Split out dwarf_loc2 to put the DWARF5
+       expression code all in one place.
+     * dwarf_alloc.c,dwarf_alloc.h: Three new opaque 
+       structs for DWARF5 expression interfaces.
+     * dwarf_error.c: New error codes for DWARF5 expression interfaces.
+     * dwarf_frame.c: Altered internal interfaces to support
+       DWARF5 expression reading.
+     * dwarf_loc.c: Refactored to support DWARF5 and moved
+       some code into dwarf_loc2.c to segregate the new
+       interfaces for clarity.  
+     * dwarf_loc.h: Definitions of new library-internal structs
+       (opaque to callers).
+     * dwarf_loc2.c: Contains the new DWARF5 location expression
+       interface code. It is not separately compiled, it is
+       #included by dwarf_loc.c.
+     * dwarf_opaque.h: Commentary change.
+     * dwarf_query.c: dwarf_get_offset_size() new.  
+       Refactored to avoid duplicating code.
+     * libdwarf.h.in: DWARF5 location expression interfaces
+       refined and commentary improved.q
+2015-10-28  David Anderson
+     * dwarf_loc2.c: New file with the new code for DWARF5
+       location expressions put here. Not separate compile,
+       this is brought into dwarf_loc.c via a #include there
+2015-10-26  David Anderson
+     * Makefile.in: Handle the configure --enable-wall option.
+     * configure.in: Add --enable-wall so we can easily get
+       gcc's -Wall option for the build.
+     * configure: Regenerated.
+     * dwarf_error.c: Amplify the text for DW_DLE_LOCLIST_INTERFACE_ERROR.
+     * dwarf_loc.c(_dwarf_read_loc_expr_op): Correct a sanity test
+       recently introduced.  Ensure the location fields all set.
+       #if 0 some code that will be fixed with the new location
+       interface set.
+     * dwarf_loc.h: Revised the prototypes and commentary for the new
+       location list interfaces.
+2015-10-25  David Anderson
+     * checkexamples.c: Add commentary to example9.
+     * dwarf_alloc.c: Add DW_DLA_LOC_BLOCK_C and DW_CLA_LOCDESC_C
+       allocation descriptions to array.
+     * dwarf_alloc.h: Increase ALLOC_AREA_INDEX_TABLE_MAX to match.
+     * dwarf_base_types.h: Increase MAX_DW_DLA to match.
+     * dwarf_die_deliv.c: Switch some returns from pointer to
+       the standard int DW_DLV_OK etc and return pointer through
+       an argument.  Identify which CUs are dwo by checking name
+       for a .dwo ending. Fix whitespace endings.
+     * dwarf_error.c: Add DW_DLE 309 to 311 errors to descriptions array.
+     * dwarf_form.c: Remove trailing whitespace. Reformat one line
+       so it is not so long.
+     * dwarf_line.c: Add {} on if for clarity. 
+       Fix whitespace endings.
+     * dwarf_line_table_reader.c: Fix whitespace endings.
+     * dwarf_loc.c: Refactor loc. expr. reader into a 
+       routine that reads one expression, _darf_read_loc_expr_op()..
+       Add DWARF5 operators.
+       Add preliminary dwo expression support (which will change
+       but this is a start).  Old expression interface now
+       explicitly supports only DWARF 2,3,4. No DWARF5.
+       Add preliminary loclist_c support (it will change).
+       Add commentary about the old loclist interface.
+     * dwarf_loc.h: First cut of new interfaces (functional, not
+       public structs).
+     * dwarf_opaque.h: Add cc_is_dwo flag to cu context struct.
+     * libdwarf.h.in: Rework some loclist commentary.
+       Add first try at new loclist interfaces for DWARF2,3,4,5.
+       New error codes for new loclist/dwo code.
+     * libdwarf2.1.mm: Rev 2.32. New wording on old loclist 
+       interfaces.
+2015-10-15  David Anderson
+     * dwarf_util.c,dwarf_query.c: Added DW_FORM_strp_sup as
+       same idea as DW_FORM_GNU_strp_alt.
+2015-10-15  David Anderson
+     * checkexamples.c: Fixed data type in the example code.
+     * dwarf.h: Updated comment about DW_FORM_GNU_strp_alt 
+     * dwarf_elf_access.c: Fixed trailing whitespace and
+       removed debug printf that got left in.
+     * dwarf_error.c: Add new TIED file errors.
+       DW_DLE_NO_TIED_FILE_AVAILABLE, DW_DLE_NO_TIED_STRING_AVAILABLE.
+     * dwarf_form.c: Added support for DW_FORM_GNU_strp_alt.
+     * dwarf_init_finish.c: #if 0 routine all_sig8bits_zero(). 
+     * dwarf_line.c: Now always notice windows-like c: etc
+       as start of a full path. Ensure directories with \ are
+       turned to / in line tables. (for full such transforms
+       configure with --enable-windowspath ) Remove some debug #ifdef
+       lines.
+       Alter the linecontext interface to pass back table count,
+       not linecount.
+     * dwarf_line.h: Add commentary and lc_table_count field.
+     * dwarf_line_table_reader_common.c: Fix indent/trailing whitespace.
+       Now sets lc_table_count;
+     * dwarf_opaque.h: Add _dwarf_get_string_from_tied() interface.
+     * dwarf_print_lines.c: Remove trailing whitespace and some debug printf..
+     * libdwarf.h.in: New error codes. Fix trailing whitespace. Expand
+       commentary.
+2015-10-13  David Anderson
+     * dwarf_line.c: Refactored so we have only one
+       piece of code creating file paths from line table data.
+       deleted obsolete code that was #if 0.
+     * libdwarf.h.in: Fleshed out linecontext
+       versions of two-level table readng.
+       Revised  a new interface (dwarf_srclines_b) to
+       make it possible to do a read of just the line header.
+     * libdwarf2.1.mm: Documented new functions.
+       Fixed the example code so it is actually correct
+2015-10-06  David Anderson
+     * Makefile.in: Removed source files from the build that
+       are only useful to IRIX and only in the context of building
+       an IRIX runtime system.
+     * dwarf_alloc.c: Added constructor/destructor code to
+       Dwarf_Line_Context allocator.
+     * dwarf_elf_access.c: Added additional #defines so we
+       have the IA64 defines we need to compile certain 
+       test cases on freebsd.
+     * dwarf_error.c: Two new error codes for Dwarf_Line_Context
+       checking.
+     * dwarf_line_table_reader_common.c: New file. We can compile
+       the line reading with and without detailed print lines
+       for dwarfdump.  Now only one body of line reading code
+       to maintain.
+     * dwarf_line.c: Moved code out to dwarf_line_table_reader_common.c
+       Refactored to support skeleton line tables (DWARF5) 
+       Eliminated an internal struct, it is no longer needed.
+       a little better.
+       Supports experimental two-level line tables too.
+     * dwarf_print_lines.c: Uses dwarf_line_table_reader_common.c
+       to do much of its work now.
+     * libdwarf.h.in: New interfaces for nicer access to 
+       line table headers.
+     * libdwarf2.1.mm: Partial documentation of the new
+       libdwarf line table interfaces. 
+2015-10-01  David Anderson
+     * dwarf_global.h: Now the last __sgi related macro (else, endif)
+       have /* __sgi */.
+2015-09-30  David Anderson
+     * dwarf_global.c,dwarf_line.c,dwarf_line.h,dwarf_line2.c,
+       dwarf_line_table_reader_common.c,dwarf_sort_line.c,libdwarf.h.in:
+       The SGI IRIX only fields in dwarf_line.h ifdef __sgi now.
+       And all code referencing them that way too. Balancing
+       #endif has /* __sgi */ now for searchability.
+       Functions only usable on SGI IRIX only compiled in if __sgi 
+       macro defined.
+     * libdwarf2.1.mm: Added a comment related to experimental
+       two-level line tables.
+
+2015-09-29  David Anderson
+     * dwarf_die_deliv.c,dwarf_line.c,dwarf_print_lines.c: Now looks for
+       and adds the extra offset from debug_fission: DW_SECT_LINE.
+2015-09-29  David Anderson
+     *  dwarf_line.c,dwarf_line.h,dwarf_line_table_reader_common.c,
+        dwarf_print_lines.c: Moved the prefix reading subroutine
+        into common so the prefix-printing can have 
+        print code added (with ifdef so production does not
+        have it). 
+2015-09-29  David Anderson
+     * dwarf_line.c,dwarf_line_table_reader_common.c,dwarf_print_lines.c,
+       dwarf_line.h,dwarf_line2.c,libdwarf.h.in:
+       Moved some code from dwarf_line_table_reader_common.c to dwarf_line.c.
+       Fixed indent and trailing whitespace. Fixed the 'section offset'
+       code by using the proper value from dss_ptr..
+2015-09-28  David Anderson
+     * dwarf_line_table_reader_common.c: New file is the line table reader
+       extracted from dwarf_line.c. Now compiled into dwarf_line.c
+       and dwarf_print_lines.c with correct two-level line table
+       calculations. No more coding the table twice.
+     * dwarf_line.c,dwarf_print_lines.c: Now #include
+       dwarf_line_table_reader_common.c
+     * Makefile.in: Reflects new source depedencies.
+     * dwarf_line2.c: An internal function interface changed,
+       so accomodated it here.
+     * libdwarf.h.in, dwarf_error.c: New error code, DW_DLE_BAD_LINE_TABLE_OPERATION.
+Changes not staged for commit:
+  (use "git add <file>..." to update what will be committed)
+  (use "git checkout -- <file>..." to discard changes in working directory)
+
+	modified:   Makefile.in
+	modified:   dwarf_error.c
+	modified:   dwarf_line.c
+	modified:   dwarf_line2.c
+	modified:   dwarf_line_table_reader_common.c
+	modified:   dwarf_print_lines.c
+	modified:   libdwarf.h.in
+
+2015-09-28  David Anderson
+    * dwarf_line.c,dwarf_line.h,dwarf_print_lines.c: made li_ and lr_
+      line register structs agree on spelling of suffix of each name.
+      Now dwarf_srclines (and two-level) use the
+      line register struct instead of a list of local variables.
+2015-09-26  David Anderson
+     * dwarf_elf_access.c: Removed some trailing spaces.
+     * dwarf_line.c: Update the li_is_actuals_table (new field)
+       where a new line is emitted. For later safe dealloc.
+       Fixed indents and removed trailing spaces.
+       Fixed the dwarf_srclines_dealloc to work properly on
+       all the line table variations.
+     * dwarf_line.h: Removed trailing spaces.
+       Added li_is_actuals_table so the dealloc can work properly.
+     * dwarf_print_lines.c: Fixed the Logicals and Actuals table
+       formatting, Now prints the subprograms table too.
+     * libdwarf.h.in: Added dwarf_get_LNCT_name() to function list.
+2015-09-25  David Anderson
+     * dwarf_print_lines.c: A first cut at detailed line tables.
+       Not yet computing state register values for all two-level
+       line tables here.
+2015-09-25  David Anderson
+     * dwarf_line.h: added a comment.
+     * dwarf_print_lines.c: Now finds actuals and logicals
+       tables and prints them. Incomplete but perhaps useful.
+2015-09-24  David Anderson
+     * dwarf_line.c: Renamed a local var for clarity. Added commentary
+       for clarity.  Fixed a memory leak for skeleton lined tables.
+       Added required free() calls on error to avoid memory leaks.
+       Moved an 'overrun' check into a loop to check on every
+       loop iteration.
+     * dwarf_line.h: Added commentary.
+2015-09-23  David Anderson
+     * dwarf_abbref.c,dwarf_die_deliv.c,dwarf_init_finish.c,dwarf_query.c: Removed 
+       unused local variables.
+     * dwarf_line.c: Corrected bugs in the two-level line table
+       support and improved error checking.
+       Revamped the line table header reading code for clarity.
+       See dw-linetableheader.txt .
+     * dw-linetableheader.txt: The line table headers are a bit
+       complicated (mostly by the experimental two-level 
+       line table support) so this file shows the header fields
+       in order by version.
+     * dwarf_form.c: Fixed nested comment, removed unused local variables..
+     * dwarf_loc.c: Cast return from _dwarf_get_alloc() to remove
+       a compile warning.
+     * dwarf_tied.c: Removed unused local variable.
+     * dwarf_xu_index.c: Removed unused local variables.
+2015-09-22  David Anderson
+     * libdwarf/dwarf.h,dwarf_elf_access.c,dwarf_form.c,dwarf_line.h:
+       Fixed indentation errors.
+     * dwarf_line.c: Fixed indentation and corrected an error
+       introduced a couple days ago.
+2015-09-19  David Anderson
+     * dwarf.h: Adding commentary. a DW_LNS for two-level line tables
+       looks wrong..
+     * dwarf_die_deliv.c: Adding commentary.
+     * dwarf_line.c: An internal function now has a leading _
+       and a context argument.. Added
+       local names of popular pointers.
+     * dwarf_print_lines.c,dwarf_sort_line.c: An internal 
+       function now has a leading _ and a context argument..
+     * dwarf_opaque.h: Added cc_segment_selector_size to contex structure.
+     * libdwarf.h.in:  Added commentary on two-level line table functions etc.
+2015-09-17  David Anderson
+     * dwarf.h, dwarf_alloc.c,dwarf_base_types.h,dwarf_init_finish.c,
+       dwarf_line.c,dwarf_line.h,dwarf_line2.c,dwarf_util.c,libdwarf.h.in:
+       Adding support for experimental 2-level line table.
+2015-09-15  David Anderson
+     *  dwarf_form.c(_dwarf_extract_string_offset_via_str_offsets):
+        Modified comment to reflect the current DWARF5 draft (we need not
+        guess about correctness).
+2015-09-15  David Anderson
+     * dwarf_query.c, dwarf_form.c: We were failing 
+       check for off-end-of debug_str_offsets section correctly
+       and had a dwarf_dealloc where it was not wanted.
+2015-09-15  David Anderson
+     * dwarf_query.c(_dwarf_extract_address_from_debug_addr): At line 540
+       we were deleting a dwarf_error that might not be there.
+       Now conditional on DW_DLV_ERROR. This and around line 605
+       are the very rare situation we can turn one error code off
+       and possibly or definitely substitute another error. 
+       Normally we just return the original error as the 
+       'lowest level error.'
+2015-09-15  David Anderson
+     * dwarf_elf_access.c: Added conditional
+       R_MIPS_64  and  R_MIPS_TLS_TPREL64 defines
+       as the headers I have for freebsd 32bit VM
+       do not define those and we need them for 
+       testinga couple object files.
+2015-09-15  Carlos Alberto Enciso
+     * dwarf_elf_access.c: For Windows version, 
+       some compilers generate
+       EM_PPC64 elf type, but the generated code is 32 bits.
+       Set the correct
+       value for 'dbg->de_pointer_size'.
+     * dwarf_init_finish.c: For Windows version, 
+       remove the incorrect hard
+       code value for 'dbg->de_pointer_size'.
+     * dwgetopt.h: Add the guard 'extern "C"'.
+2015-09-15  David Anderson and Carlos Alberto Enciso
+     * dwarf_form.c (dwarf_formsig8_const): Was failing to
+       return its return code.
+     * dwarf_xu_index.c (_dwarf_search_fission_for_offset): Was 
+       failing to return its return code.
+2015-09-14  David Anderson
+     * dwarf_form.c,dwarf_global.c,dwarf_line.c,dwarf_macro.c,dwarf_util.c:
+       Fixed indents and removed trailing whitespace.
+2015-09-14  David Anderson
+     * libdwarf2.1.mm: Revision 2.30. Fixed awkward
+       line in UTF-8 section.
+     * libdwarf2.1.pdf: Regenerated
+2015-09-14  David Anderson
+     * libdwarf2.1.mm: Revision 2.29. Added text
+       to Items Changed section. Added a top level
+       UTF-8 strings section.
+     * libdwarf2.1.pdf: Regenerated
+2015-09-14  David Anderson
+     * libdwarf2.1.mm: Revision 2.28. Now describes
+       dwarf_set_tied_dbg().
+     * libdwarf2.1.pdf: Regenerated
+2015-09-13  David Anderson
+     * libdwarf.h.in,dwarf_error.c: New error code for 
+       improved string checking.
+     * dwarf_form.c,dwarf_string.c:Now call the string checker
+       on all strings and do a more thorough check.
+     * dwarf_util.c, dwarf_util.h: Revised the interfaces to the 
+       string checker to make it more useful and accurate.
+2015-09-12  David Anderson
+     * dwarf_die_deliv.c,dwarf_form.c,dwarf_opaque.h,
+       dwarf_original_elf_init.c,dwarf_query.c,dwarf_tied.c:
+       Now we can find addresses in the base from the dwp.
+2015-09-11  David Anderson
+     * Makefile.in: clean now removes test executable ./dwarftied
+     * dwarf.h: Adding DW_AT_GNU_macros attribute, 0x2119.
+2015-09-11  David Anderson
+     * dwarf.h: Adding DW_AT_GNU_discriminator attribute, 0x2136.
+2015-09-11  David Anderson
+     * Makefile.in,dwarf_alloc.c,dwarf_die_deliv.c,dwarf_error.c,dwarf_form.c,
+       dwarf_opaque.h,dwarf_original_elf_init.c,dwarf_query.ckdwarf_tied.c,
+       libdwarf.h.in: Added dwarf_tied.c and -x tied= options. So libdwarf
+       can follow DW_FORM_addrx to get the address from another object.
+2015-09-05  David Anderson
+     * dwarf.h: Fixed indentation of two lines with the 0x
+       values incorrectly indented.
+2015-07-12  David Anderson
+     * dwarf_init_finish.c: Added commentary about .rela
+     * dwgetopt.c,dwgetopt.h,dwgetopttest.c: Use dwoptind dwoptarg etc, 
+       not optind, optarg, optopt opeerror etc.
+     * gennames.h: use dwoptarg dwoptind, not optarg, optind.
+2015-05-08  David Anderson
+     * dwarf_die_deliv.c, dwarf_frame2.c, dwarf_frame2.c,
+       dwarf_frame.c: The debugging-only #if 0 now have comments
+       so grep for 'if 0' is not alarming.
+     * dwgetopt.c,pro_forms.c,pro_section.c: Removed unused code
+       bracketed with '#if 0'.
+2015-05-01  David Anderson
+     * dwarf.h: Added  DW_DEFAULTED* and DW_IDX* DWARF5 macros.
+     * dwarf_abbrev.c: Expanded comments about the interface
+       used by dwarfdump -a.
+       It is NOT guaranteed to work on all objects.
+       It continues to work usefully on a plain .o .
+     * dwarf_alloc.h: Added code to clean when there
+       are fission package file sections .debug_cu_index or
+       .debug_tu_index.
+     * dwarf_die_deliv.c: Significant changes to internals to support
+       DWARF5 debug fission dwp package objects.
+       Added dwarf_die_from_hash_signature() which lets one
+       find DWP DIE information from a hash signature.
+     * dwarf_error.c: Fifteen new DW_DLE* error messages added related
+       to new DWARF5 sections and to debug fission package files.
+     * dwarf_form.c:  New commentary about offsets rrelated to
+       DWP package files.  New interface dwarf_formsig8_const()
+       to read the DW_FORM_data8  a DW_AT_dwo_id uses.
+     * dwarf_global.c: Added commentary about an old interface
+       and DWARF5 (the old interface does not support DWARF5,
+       newer (but not new) interfaces do).
+     * dwarf_incl.h: Add dwarf_xu_index.h include.
+     * dwarf_init_finish.c: Removed a couple dwo-section
+       readers (they were not real) Added new DWARF5
+       section readers and the appropriate .dwo section readers.
+     * dwarf_line.c,dwarf_loc.c: Added support for getting the correct  line
+     * dwarf_macro.c: Added comment that .debug_macinfo 
+       section not supported in DWP
+       Package File (and .debug_macinfo is not in DWARF5).
+       section offset in a DWP package file.
+     * dwarf_opaque.h: Many New fields for the new sections
+       and DWP Package File support.
+       Various new functions (libdwarf internal) for the
+       new sections.
+     * dwarf_query.c: Added support for DWP Package File offsets.
+     * dwarf_tsearch.h: Added ifndef DWARF_TSEARCH so #include
+       more than once does not lead to difficulty.
+     * dwarf_util.c:  Added support for DWP Package File data.
+     * dwarf_xu_index.c: Added support for DWP Package File data
+       so it can all be read properly.
+     * dwarf_xu_index.h: Added ifndef DWARF_XU_INDEX_H so #include
+       more than once does not lead to difficulty.
+     * libdwarf.h.in: Added dwarf_get_IDX_name() and 
+       dwarf_get_IDX_name(). Added fifteen new DW_DLE error codes.
+       New function dwarf_die_from_hash_signature().
+     * libdwarf2.1.mm: Rev 2.27. Documented interfaces 
+       dwarf_next_cu_header_d(),dwarf_die_from_hash_signature(),
+       dwarf_get_debugfission_for_die(),dwarf_get_debugfission_for_key().
+     * libdwarf2.1.pdf: Regenerated.
+2015-04-23  David Anderson
+     * dwarf.h: Delete spurious blank lines.
+     * dwarf_base_types.h:  New defines. DW_CIE_VERSION* DW_CU_VERSION**
+       DW_ARANGES_VERSION* DW_LINE_VERSION* DW_LOC_VERSION*
+       DW_LINE_STR_VERSION5, DW_MACRO_VERSION5,
+       DW_LINE_LOC, DW_NAMES_VERSION5, DW_PUBNAMES_VERSION*,
+       DW_PUBTYPES_VERSION*, DW_STR_OFFSETS_VERSION5,
+       DW_SUP_VERSION*, DW_CU_INDEX_VERSION5,
+       DW_TU_INDEX_VERSION5, making version comparisons
+       more precise and including DWARF5.
+     * dwarf_arange.c: CURRENT_VERSION_STAMP -> DW_ARANGES_VERSION2 
+     * dwarf_die_deliv.c,dwarf_global.c,dwarf_line.c, : Use the new 
+       DW_*_VERSION* version names.
+     * dwarf_init_finish.c: Added to 3 comments.
+     * dwarf_loc.c: Use the new DW_*_VERSION* version names.
+       Use a local variable to simpify some comparisons
+       for readability.
+     * dwarf_opaque.h: Update the comments about version numbers.
+       Added new comments foreshadowing changes for DebugFission
+       and DWP. REMOVE CURRENT_VERSION_STAMP* macros as they
+       are no longer used.
+2015-03-10  David Anderson
+     * dwgetopt.c: Was mishandling options
+       missing their required argument.
+2015-03-09  David Anderson
+    * dwgetopt.c: Fixed a bug in handling options.
+      See dwarfdump build for testing code 
+      and test runs for dwgetopt.c
+2015-02-22  David Anderson
+    * dwgetopt.h, dwgetopt.c: Copied from dwarfdump so
+      libdwarf can compile without dwarfdump source present.
+    * Makefile.in: Builds dwgetopt.o
+    * gennames.c: Now uses dwgetopt.o
+2015-02-12  David Anderson
+    * dwarf_original_elf_init.c(dwarf_elf_init_file_ownership):
+      When dwarf_elf_object_access_init() returns DW_DLV_ERROR
+      the Dwarf_Error was not getting set. Now it is set.
+2015-02-04  David Anderson
+    * dwarf.h: Added new TAGs etc from DWARF5. Since DWARF5 is
+      not a completed standard these new things could change.
+    * dwarf_die_deliv.c: Refactored calculation of end_of CU
+      to ensure uniformity.  Added checks to catch attempts
+      to read past end and coredump (can happen when the DWARF is 
+      erroneous). Notice when bogus attribute wraps memory
+      so the next DIE would be at an earlier address in memory
+      than the current die (DW_DLE_NEXT_DIE_LOW_ERROR).
+    * dwarf_error.c: DW_DLE_NEXT_DIE_LOW_ERROR error code added.
+    * dwarf_form.c: Added check to ensure we do not run off the
+      end of the string section (.debug_str).
+    * dwarf_opaque.h: Declare new internal
+      function  _dwarf_calculate_section_end_ptr().
+    * dwarf_query.c(dwarf_attrlist): 
+      A little bit of refactoring/reordering done to catch
+      errors.
+      Created new function _dwarf_calculate_section_end_ptr().
+    * dwarf_xu_index.c: Removed trailing space, one line..
+    * libdwarf.h.in: Added define of DW_DLE_NEXT_DIE_LOW_ERROR.
+2015-01-31  David Anderson
+    * Makefile.in,common.c,common.h,dwarf_abbrev.c,dwarf_abbrev.h,
+      dwarf_addr_finder.c,dwarf_alloc.c,dwarf_alloc.h,dwarf_arange.c,
+      dwarf_arange.h,dwarf_base_types.h,dwarf_die_deliv.c,dwarf_die_deliv.h,
+      dwarf_elf_access.c,dwarf_elf_access.h,dwarf_error.h,dwarf_form.c,
+      dwarf_frame.c,dwarf_frame.h,dwarf_frame2.c,dwarf_frame3.c,dwarf_funcs.c,
+      dwarf_funcs.h,dwarf_gdbindex.c,dwarf_global.c,dwarf_global.h,
+      dwarf_incl.h,dwarf_leb.c,dwarf_line.c,dwarf_line.h,dwarf_line2.c,
+      dwarf_loc.c,dwarf_loc.h,dwarf_macro.c,dwarf_macro.h,
+      dwarf_opaque.h,dwarf_original_elf_init.c,dwarf_print_lines.c,
+      dwarf_pubtypes.c,dwarf_query.c,dwarf_ranges.c,dwarf_reloc_arm.h:
+      Removed obsolete postal address and oss.sgi.com address
+      from copyright.
+
+2015-01-30  David Anderson
+     * dwarf_init_finish.c: Now uses Dwarf_Sig8 for .debug_cu_index.
+     * dwarf_opaque.h: Use Dwarf_Sig8 for the dfp_hash field.
+     * libdwarf.h.in: dwarf_get_xu_hash_entry() uses Dwarf_Sig8 now.
+2015-01-30  David Anderson
+     * dwarf.h: Adding some DWARF5 defines. 
+       Use with caution: DWARF5 is not yet final.
+     * gennames.c: Local array needed to be bigger
+       due to a longer attribute list.
+2015-01-28  David Anderson
+     * libdwarf2.1.mm: Fixed .H 2 to .H 3 on
+       dwarf_get_TAG_name etc.
+       Removed duplication of 3 lines of 
+       Global Namespace operations.
+       Added doc of dwarf_dwarf_get_debug_str_index()
+       and fixed a level 2 header (starting the quoted
+       string with a period caused trouble in the
+       output).
+     * libdwarf2.1.pdf. Regenerated. Version 2.25.
+2015-01-25  David Anderson
+     * dwarf_form.c(dwarf_convert_to_global_offset): Removed
+       yesterday's change. The cu_context offset value
+       already has debugfission offset built in.
+2015-01-24  David Anderson
+     * dwarf_form.c: dwarf_convert_to_global_offset() was not
+       accounting for debugfission data (dwp).
+     * dwarf_die_deliv.c(dwarf_offdie_b): Was not adding
+       cc_extension_size into cu header offset (cc_extension_size
+       is rarely non-zero, but its omission was a bug here).
+     * dwarf_util.h: Improved a line of commentary.
+2015-01-21  David Anderson
+     * Makefile.in: Now with separate dwarf_names.h and dwarf_names.c
+       rules so parallel make works properly.
+     * dwarf.h: Improved the comment on DW_SECT_TYPES as that
+       is not actually part of DWARF5 but is reserved.
+     * dwarf_die_deliv.c: Added dwarf_get_debugfission_for_die().
+       Now dwarfdump and other clients can access
+       and print fission data for a specific CU easily.
+     * dwarf_init_finish.c(load_debugfission_tables): Deleted 
+       unused local variable.
+     * dwarf_opaque.h: Now uses libdwarf.h DW_FISSION_SECT_COUNT
+       for clarity (libdwarf-only name).
+     * libdwarf.h.in: Add DW_DLE_FISSION_VERSION_ERROR as part
+       of error checking. Add prototype for 
+       dwarf_get_debugfission_for_die() and declare its struct argument.
+2015-01-18  David Anderson
+     * dwarf_abbrev.c: Added comment, debugfission not supported
+       in the non-cu-specific interface.
+     * dwarf_alloc.c, dwarf_base_types.h: Add DW_DLA_FISSION_PERCU support.
+     * dwarf_die_deliv.c: Added _dwarf_get_fission_addition_die()
+       and  _dwarf_get_fission_addition() for debugfission support.
+     * dwarf_error.c: Add DW_DLE_FISSION_INDEX_WRONG error string.
+     * dwarf_form.c: Add debugfission support for str_offsets.
+     * dwarf_init_finish.c: Load debugfission tables if such exist
+       in an object.
+     * dwarf_line.c: Add debugfission support for .debug_line.dwo
+     * dwarf_loc.c: Add debugfission support for .debug_loc.dwo
+     * dwarf_macro.c: Add comment that debugfission not supported
+       in the non-CU-specific interface.
+     * dwarf_opaque.h: Add structures for debugfission:
+       Dwarf_Fission_Offsets_s,Dwarf_Fission_Per_CU_s,
+       Dwarf_Fission_Section_Offset_s.
+       declare the new functions in dwarf_die_deliv.c
+     * dwarf_util.c: Remove a few lines of traling whitespace.
+     * dwarf_uxu_index.c: Correct bogus formatting.
+     * libdwarf.h.in: Add DW_DLE_FISSION_INDEX_WRONG .
+2015-01-12  David Anderson
+     * dwarf_init_finish.c(_dwarf_setup): Move freeresult
+       declaration before statements.
+     * dwarf_util.c: Add comments about va_end().
+2015-01-11  David Anderson
+     * dwarf_init_finish.c(_dwarf_setup): For all returns 
+       in _dwarf_setup() free the sections malloc space.
+2015-01-08  David Anderson
+     * cmplrs/dwarf_addr_finder.h: Fix a comment and remove a trailing
+       whitespace.
+     * dwarf.h: Blank line added accidentally.
+     * dwarf_alloc.c: Removed trailing whitespace.
+     * dwarf_init_finish.c: Remove trailing whitespace. Fix indent.
+     * dwarf_leb.c: Remove trailing whitespace. Fix indent.
+     * dwarf_line.h: Fix macro backslash location, lining things up.
+     * dwarf_util.c: Remove trailing whitespace.
+2015-01-06  David Anderson
+     * 	dwarf_alloc.c, dwarf_base_types.h, dwarf_elf_access.c,
+        dwarf_error.c,dwarf_error.h,dwarf_form.c,dwarf_init_finish.c,
+        dwarf_leb.c,dwarf_query.c,pro_section.c: Fixed indents and
+        removed trailing whitespace.
+2015-01-06  David Anderson
+     * dwarf_frame.c( _dwarf_get_fde_info_for_a_pc_row): Cast
+       the pointer returned from _dwarf_get_alloc(), somehow
+       this cast was omitted.
+     * dwarf_alloc.c(dwarf_dealloc): Ensure a NULL
+       'space' pointer input is not touched before checking
+       if it is set.
+     * dwarf_init_finish.c(_dwarf_setup): For badly formed Elf
+       ensure we do not use stale pointers.
+2015-01-05  David Anderson
+     * dwarf_original_elf_init.c(dwarf_finish): If the Dwarf_Debug is
+       not initialized do not use it.
+2015-01-03  David Anderson
+     * libdwarf2p.1.mm: Somehow dwarf_transform_to_disk_form()
+       was not documented. Now it is.
+     * libdwarf2p.1.pdf: Regenerated, version 1.38.
+2015-01-03  David Anderson
+     * dwarf_allo.c: Comment the allocation table base
+       more carefully.
+     * dwarf_base_types.h: Making DW_DLA defines more
+       readable, more consistent with other instances.
+     * libdwarf.h.in: Adding producer error codes.
+       The producer library has some places error values
+       are misidentified. Main effect: documentation.
+     * dwarf_error.c:  Add the strings for the new error codes.
+2015-01-01  David Anderson
+     *	A new year begins.