Hi, I wanted to push this initial setup of the elfutils webpages on sourceware.org but it looks like I (the elfutils group?) doesn't have permission to push at the moment. Frank, I believe all files need to be writable to the elfutils group, and the directories too. (And they might need the sticky bit set to make sure new directories are also be default writable to the elfutils group.)
$ git push Counting objects: 6, done. Delta compression using up to 2 threads. Compressing objects: 100% (6/6), done. Writing objects: 100% (6/6), 6.72 KiB | 0 bytes/s, done. Total 6 (delta 0), reused 0 (delta 0) error: insufficient permission for adding an object to repository database ./objects fatal: failed to write object error: unpack failed: unpack-objects abnormal exit To ssh://sourceware.org/git/elfutils-htdocs.git ! [remote rejected] master -> master (n/a (unpacker error)) error: failed to push some refs to 'ssh://m...@sourceware.org/git/elfutils-htdocs.git' - This adds an initial home page (index.html) and style sheet (default.css) for the htdocs on https://sourceware.org/elfutils/ Two fedorahosted wikipages have also been added DwarfExtensions and ElflintGNU. The Roadmap was years out of date and hasn't been moved over yet. It needs a full rewrite first. Signed-off-by: Mark Wielaard <m...@klomp.org> --- DwarfExtensions | 135 +++++++++++++++++++++++++++++++++++++++++++++ ElflintGNU | 30 ++++++++++ default.css | 41 ++++++++++++++ index.html | 166 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-- 4 files changed, 366 insertions(+), 6 deletions(-) create mode 100644 DwarfExtensions create mode 100644 ElflintGNU create mode 100644 default.css diff --git a/DwarfExtensions b/DwarfExtensions new file mode 100644 index 0000000..ba5ab41 --- /dev/null +++ b/DwarfExtensions @@ -0,0 +1,135 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd";> +<html xmlns="http://www.w3.org/1999/xhtml";> + +<head> +<link href="default.css" rel="stylesheet" type="text/css"> +<title> DwarfExtensions - elfutils</title> +</head> + +<body> +<div> + +<h2 id="DIETags">DIE Tags</h2> +<table> +<tr><th> DW_TAG </th><th> Value </th><th> Description </th><th> Producer </th><th> elfutils support </th></tr> +<tr><td> DW_TAG_atomic_type </td><td> 0x47 </td><td> <a href="http://dwarfstd.org/ShowIssue.php?issue=131112.1";>DWARF5 C11 _Atomic type qualifier</a> </td><td> GCC5 </td><td> libdw dwarf_peel_type </td></tr> +<tr><td> DW_TAG_MIPS_loop </td><td> 0x4081 </td><td> Never implemented, <a href="http://libdwarf.git.sourceforge.net/git/gitweb.cgi?p=libdwarf/libdwarf;a=blob_plain;f=libdwarf/mips_extensions.pdf;hb=HEAD";>mips_extensions</a> </td><td> Nothing </td><td> Constant only </td></tr> +<tr><td> DW_TAG_format_label </td><td> 0x4101 </td><td> Unknown Fortran related </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_TAG_function_template </td><td> 0x4102 </td><td> Unknown C++ related </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_TAG_class_template </td><td> 0x4103 </td><td> Unknown C++ related </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_TAG_GNU_BINCL </td><td> 0x4104 </td><td> Marks start of new include file </td><td> GCC -feliminate-dwarf2-dups </td><td> Constant only </td></tr> +<tr><td> DW_TAG_GNU_EINCL </td><td> 0x4104 </td><td> Marks end of include file </td><td> GCC -feliminate-dwarf2-dups </td><td> Constant only </td></tr> +<tr><td> DW_TAG_GNU_template_template_param </td><td> 0x4106 </td><td> <a href="http://gcc.gnu.org/wiki/TemplateParmsDwarf";>GNU Template Parms</a> </td><td> G++ </td><td> Constant only </td></tr> +<tr><td> DW_TAG_GNU_template_parameter_pack </td><td> 0x4107 </td><td> <a href="http://gcc.gnu.org/wiki/TemplateParmsDwarf";>GNU Template Parms</a> and <a href="http://wiki.dwarfstd.org/index.php?title=C%2B%2B0x:_Variadic_templates";>DWARF5 proposal</a> </td><td> G++ </td><td> Constant only </td></tr> +<tr><td> DW_TAG_GNU_formal_parameter_pack </td><td> 0x4108 </td><td> <a href="http://gcc.gnu.org/wiki/TemplateParmsDwarf";>GNU Template Parms</a> and <a href="http://wiki.dwarfstd.org/index.php?title=C%2B%2B0x:_Variadic_templates";>DWARF5 proposal</a> </td><td> G++ </td><td> Constant only </td></tr> +<tr><td> DW_TAG_GNU_call_site </td><td> 0x4109 </td><td> GNU call site <a href="http://www.dwarfstd.org/ShowIssue.php?issue=100909.2&type=open";>DWARF5 proposal</a> </td><td> GCC </td><td> Recognized in readelf </td></tr> +<tr><td> DW_TAG_GNU_call_site_parameter </td><td> 0x410a </td><td> GNU call site <a href="http://www.dwarfstd.org/ShowIssue.php?issue=100909.2&type=open";>DWARF5 proposal</a> </td><td> GCC </td><td> Recognized in readelf </td></tr> +</table> + +<h2 id="TAGAttributes">TAG Attributes</h2> +<table> +<tr><th> DW_AT </th><th> Value </th><th> Description </th><th> Producer </th><th> elfutils support </th></tr> +<tr><td> DW_AT_noreturn </td><td> 0x87 </td><td> Identifies a subprogram that does not return to its caller, DWARFv5 </td><td> GCC5 </td><td> Constant only </td></tr> +<tr><td> DW_AT_MIPS_fde </td><td> 0x2001 </td><td> subprogram tag attribute, offset into .debug_frame section, <a href="http://libdwarf.git.sourceforge.net/git/gitweb.cgi?p=libdwarf/libdwarf;a=blob_plain;f=libdwarf/mips_extensions.pdf;hb=HEAD";>mips_extensions</a> </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_AT_MIPS_loop_begin </td><td> 0x2002 </td><td> Never implemented, <a href="http://libdwarf.git.sourceforge.net/git/gitweb.cgi?p=libdwarf/libdwarf;a=blob_plain;f=libdwarf/mips_extensions.pdf;hb=HEAD";>mips_extensions</a> </td><td> Nothing </td><td> Constant only </td></tr> +<tr><td> DW_AT_MIPS_tail_loop_begin </td><td> 0x2003 </td><td> Never implemented, <a href="http://libdwarf.git.sourceforge.net/git/gitweb.cgi?p=libdwarf/libdwarf;a=blob_plain;f=libdwarf/mips_extensions.pdf;hb=HEAD";>mips_extensions</a> </td><td> Nothing </td><td> Constant only </td></tr> +<tr><td> DW_AT_MIPS_epilog_begin </td><td> 0x2004 </td><td> Never implemented, <a href="http://libdwarf.git.sourceforge.net/git/gitweb.cgi?p=libdwarf/libdwarf;a=blob_plain;f=libdwarf/mips_extensions.pdf;hb=HEAD";>mips_extensions</a> </td><td> Nothing </td><td> Constant only </td></tr> +<tr><td> DW_AT_MIPS_loop_unroll_factor </td><td> 0x2005 </td><td> Never implemented, <a href="http://libdwarf.git.sourceforge.net/git/gitweb.cgi?p=libdwarf/libdwarf;a=blob_plain;f=libdwarf/mips_extensions.pdf;hb=HEAD";>mips_extensions</a> </td><td> Nothing </td><td> Constant only </td></tr> +<tr><td> DW_AT_MIPS_software_pipeline_depth </td><td> 0x2006 </td><td> Never implemented, <a href="http://libdwarf.git.sourceforge.net/git/gitweb.cgi?p=libdwarf/libdwarf;a=blob_plain;f=libdwarf/mips_extensions.pdf;hb=HEAD";>mips_extensions</a> </td><td> Nothing </td><td> Constant only </td></tr> +<tr><td> DW_AT_MIPS_linkage_name </td><td> 0x2007 </td><td> Same as DWARF4 DW_AT_linkage_name </td><td> GCC </td><td> Constant only </td></tr> +<tr><td> DW_AT_MIPS_stride </td><td> 0x2008 </td><td> F90 array stride, <a href="http://libdwarf.git.sourceforge.net/git/gitweb.cgi?p=libdwarf/libdwarf;a=blob_plain;f=libdwarf/mips_extensions.pdf;hb=HEAD";>mips_extensions</a> </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_AT_MIPS_abstract_name </td><td> 0x2009 </td><td> name of inlined_subroutine with abstract root in other CU, <a href="http://libdwarf.git.sourceforge.net/git/gitweb.cgi?p=libdwarf/libdwarf;a=blob_plain;f=libdwarf/mips_extensions.pdf;hb=HEAD";>mips_extensions</a> </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_AT_MIPS_clone_origin </td><td> 0x200a </td><td> name of non-specialed version of cloned subroutine, <a href="http://libdwarf.git.sourceforge.net/git/gitweb.cgi?p=libdwarf/libdwarf;a=blob_plain;f=libdwarf/mips_extensions.pdf;hb=HEAD";>mips_extensions</a> </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_AT_MIPS_has_inlines </td><td> 0x200b </td><td> hint for inlined subroutines under subprogram DIE, <a href="http://libdwarf.git.sourceforge.net/git/gitweb.cgi?p=libdwarf/libdwarf;a=blob_plain;f=libdwarf/mips_extensions.pdf;hb=HEAD";>mips_extensions</a> </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_AT_MIPS_stride_byte </td><td> 0x200c </td><td> F90 array stride, <a href="http://libdwarf.git.sourceforge.net/git/gitweb.cgi?p=libdwarf/libdwarf;a=blob_plain;f=libdwarf/mips_extensions.pdf;hb=HEAD";>mips_extensions</a> </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_AT_MIPS_stride_elem </td><td> 0x200d </td><td> F90 array stride, <a href="http://libdwarf.git.sourceforge.net/git/gitweb.cgi?p=libdwarf/libdwarf;a=blob_plain;f=libdwarf/mips_extensions.pdf;hb=HEAD";>mips_extensions</a> </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_AT_MIPS_ptr_dopetype </td><td> 0x200e </td><td> F90 Dope Vector, <a href="http://libdwarf.git.sourceforge.net/git/gitweb.cgi?p=libdwarf/libdwarf;a=blob_plain;f=libdwarf/mips_extensions.pdf;hb=HEAD";>mips_extensions</a> </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_AT_MIPS_allocatable_dopetype </td><td> 0x200f </td><td> F90 Dope Vector, <a href="http://libdwarf.git.sourceforge.net/git/gitweb.cgi?p=libdwarf/libdwarf;a=blob_plain;f=libdwarf/mips_extensions.pdf;hb=HEAD";>mips_extensions</a> </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_AT_MIPS_assumed_shape_dopetype </td><td> 0x2010 </td><td> F90 Dope Vector, <a href="http://libdwarf.git.sourceforge.net/git/gitweb.cgi?p=libdwarf/libdwarf;a=blob_plain;f=libdwarf/mips_extensions.pdf;hb=HEAD";>mips_extensions</a> </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_AT_MIPS_assumed_size </td><td> 0x2011 </td><td> F90 arrays, <a href="http://libdwarf.git.sourceforge.net/git/gitweb.cgi?p=libdwarf/libdwarf;a=blob_plain;f=libdwarf/mips_extensions.pdf;hb=HEAD";>mips_extensions</a> </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_AT_sf_names </td><td> 0x2101 </td><td> DWARF1 only? </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_AT_src_info </td><td> 0x2102 </td><td> DWARF1 only? </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_AT_mac_info </td><td> 0x2103 </td><td> DWARF1 only? </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_AT_src_coords </td><td> 0x2104 </td><td> DWARF1 only? </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_AT_body_begin </td><td> 0x2105 </td><td> DWARF1 only? </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_AT_body_end </td><td> 0x2106 </td><td> DWARF1 only? </td><td> Unknown </td><td> Constant only </td></tr> +<tr><td> DW_AT_GNU_vector </td><td> 0x2107 </td><td> <a href="http://gcc.gnu.org/ml/gcc-patches/2002-04/msg01428.html";>ppc/ppc64 Altivec return value</a> </td><td> GCC </td><td> dwfl_module_return_value_location </td></tr> +<tr><td> DW_AT_GNU_guarded_by </td><td> 0x2108 </td><td> <a href="http://gcc.gnu.org/wiki/ThreadSafetyAnnotationsInDWARF";>GNU ThreadSafetyAnnotations</a> </td><td> Not implemented </td><td> Constant only </td></tr> +<tr><td> DW_AT_GNU_pt_guarded_by </td><td> 0x2109 </td><td> <a href="http://gcc.gnu.org/wiki/ThreadSafetyAnnotationsInDWARF";>GNU ThreadSafetyAnnotations</a> </td><td> Not implemented </td><td> Constant only </td></tr> +<tr><td> DW_AT_GNU_guarded </td><td> 0x210a </td><td> <a href="http://gcc.gnu.org/wiki/ThreadSafetyAnnotationsInDWARF";>GNU ThreadSafetyAnnotations</a> </td><td> Not implemented </td><td> Constant only </td></tr> +<tr><td> DW_AT_GNU_pt_guarded </td><td> 0x210b </td><td> <a href="http://gcc.gnu.org/wiki/ThreadSafetyAnnotationsInDWARF";>GNU ThreadSafetyAnnotations</a> </td><td> Not implemented </td><td> Constant only </td></tr> +<tr><td> DW_AT_GNU_locks_excluded </td><td> 0x210c </td><td> <a href="http://gcc.gnu.org/wiki/ThreadSafetyAnnotationsInDWARF";>GNU ThreadSafetyAnnotations</a> </td><td> Not implemented </td><td> Constant only </td></tr> +<tr><td> DW_AT_GNU_exclusive_locks_required </td><td> 0x210d </td><td> <a href="http://gcc.gnu.org/wiki/ThreadSafetyAnnotationsInDWARF";>GNU ThreadSafetyAnnotations</a> </td><td> Not implemented </td><td> Constant only </td></tr> +<tr><td> DW_AT_GNU_shared_locks_required </td><td> 0x210e </td><td> <a href="http://gcc.gnu.org/wiki/ThreadSafetyAnnotationsInDWARF";>GNU ThreadSafetyAnnotations</a> </td><td> Not implemented </td><td> Constant only </td></tr> +<tr><td> DW_AT_GNU_odr_signature </td><td> 0x210f </td><td> <a href="http://gcc.gnu.org/ml/gcc/2011-04/msg00065.html";>link-time ODR checking</a> part of <a href="http://gcc.gnu.org/wiki/DwarfSeparateTypeInfo";>GNU DwarfSeparateTypeInfo</a> </td><td> GCC </td><td> Constant only </td></tr> +<tr><td> DW_AT_GNU_template_name </td><td> 0x2110 </td><td> <a href="http://gcc.gnu.org/wiki/TemplateParmsDwarf";>GNU Template Parms</a> and <a href="http://wiki.dwarfstd.org/index.php?title=C%2B%2B0x:_Variadic_templates";>DWARF5 proposal</a> </td><td> G++ </td><td> Constant only </td></tr> +<tr><td> DW_AT_GNU_call_site_value </td><td> 0x2111 </td><td> GNU call site <a href="http://www.dwarfstd.org/ShowIssue.php?issue=100909.2&type=open";>DWARF5 proposal</a> </td><td> GCC </td><td> Recognized in readelf </td></tr> +<tr><td> DW_AT_GNU_call_site_data_value </td><td> 0x2112 </td><td> GNU call site <a href="http://www.dwarfstd.org/ShowIssue.php?issue=100909.2&type=open";>DWARF5 proposal</a> </td><td> GCC </td><td> Recognized in readelf </td></tr> +<tr><td> DW_AT_GNU_call_site_target </td><td> 0x2113 </td><td> GNU call site <a href="http://www.dwarfstd.org/ShowIssue.php?issue=100909.2&type=open";>DWARF5 proposal</a> </td><td> GCC </td><td> Recognized in readelf </td></tr> +<tr><td> DW_AT_GNU_call_site_target_clobbered </td><td> 0x2114 </td><td> GNU call site <a href="http://www.dwarfstd.org/ShowIssue.php?issue=100909.2&type=open";>DWARF5 proposal</a> </td><td> GCC </td><td> Recognized in readelf </td></tr> +<tr><td> DW_AT_GNU_tail_call </td><td> 0x2115 </td><td> GNU call site <a href="http://www.dwarfstd.org/ShowIssue.php?issue=100909.2&type=open";>DWARF5 proposal</a> </td><td> GCC </td><td> Recognized in readelf </td></tr> +<tr><td> DW_AT_GNU_all_tail_call_sites </td><td> 0x2116 </td><td> GNU call site <a href="http://www.dwarfstd.org/ShowIssue.php?issue=100909.2&type=open";>DWARF5 proposal</a> </td><td> GCC </td><td> Recognized in readelf </td></tr> +<tr><td> DW_AT_GNU_all_call_sites </td><td> 0x2117 </td><td> GNU call site <a href="http://www.dwarfstd.org/ShowIssue.php?issue=100909.2&type=open";>DWARF5 proposal</a> </td><td> GCC </td><td> Recognized in readelf </td></tr> +<tr><td> DW_AT_GNU_all_source_call_sites </td><td> 0x2118 </td><td> GNU call site <a href="http://www.dwarfstd.org/ShowIssue.php?issue=100909.2&type=open";>DWARF5 proposal</a> </td><td> GCC </td><td> Recognized in readelf </td></tr> +<tr><td> DW_AT_GNU_macros </td><td> 0x2119 </td><td> GNU .debug_macro <a href="http://www.dwarfstd.org/ShowIssue.php?issue=110722.1";>DWARF5 proposal</a> </td><td> GCC </td><td> Recognized in readelf </td></tr> +<tr><td> DW_AT_GNU_deleted </td><td> 0x211a </td><td> Attribute added for C++11 deleted special member functions (= delete;) </td><td> G++ </td><td> Constant only </td></tr> +<tr><td> DW_AT_GNU_dwo_name </td><td> 0x2130 </td><td> <a href="http://gcc.gnu.org/wiki/DebugFission";>GNU Fission</a> <a href="http://www.dwarfstd.org/ShowIssue.php?issue=120514.1&type=closed";>DWARF5 proposal</a> </td><td> Unknown </td><td> No support </td></tr> +<tr><td> DW_AT_GNU_dwo_id </td><td> 0x2131 </td><td> <a href="http://gcc.gnu.org/wiki/DebugFission";>GNU Fission</a> <a href="http://www.dwarfstd.org/ShowIssue.php?issue=120514.1&type=closed";>DWARF5 proposal</a> </td><td> Unknown </td><td> No support </td></tr> +<tr><td> DW_AT_GNU_ranges_base </td><td> 0x2132 </td><td> <a href="http://gcc.gnu.org/wiki/DebugFission";>GNU Fission</a> <a href="http://www.dwarfstd.org/ShowIssue.php?issue=120514.1&type=closed";>DWARF5 proposal</a> </td><td> Unknown </td><td> No support </td></tr> +<tr><td> DW_AT_GNU_addr_base </td><td> 0x2133 </td><td> <a href="http://gcc.gnu.org/wiki/DebugFission";>GNU Fission</a> <a href="http://www.dwarfstd.org/ShowIssue.php?issue=120514.1&type=closed";>DWARF5 proposal</a> </td><td> Unknown </td><td> No support </td></tr> +<tr><td> DW_AT_GNU_pubnames </td><td> 0x2134 </td><td> <a href="http://gcc.gnu.org/wiki/DebugFission";>GNU Fission</a> <a href="http://www.dwarfstd.org/ShowIssue.php?issue=120514.1&type=closed";>DWARF5 proposal</a> </td><td> GCC </td><td> No support </td></tr> +<tr><td> DW_AT_GNU_pubtypes </td><td> 0x2135 </td><td> <a href="http://gcc.gnu.org/wiki/DebugFission";>GNU Fission</a> <a href="http://www.dwarfstd.org/ShowIssue.php?issue=120514.1&type=closed";>DWARF5 proposal</a> </td><td> GCC </td><td> No support </td></tr> +</table> + +<h2 id="AttributeForms">Attribute Forms</h2> +<table> +<tr><th> DW_FORM </th><th> Value </th><th> Description </th><th> Producer </th><th> elfutils support </th></tr> +<tr><td> DW_FORM_GNU_addr_index </td><td> 0x1f01 </td><td> <a href="http://gcc.gnu.org/wiki/DebugFission";>GNU Fission</a> <a href="http://www.dwarfstd.org/ShowIssue.php?issue=120514.1&type=closed";>DWARF5 proposal</a> </td><td> Unknown </td><td> No support </td></tr> +<tr><td> DW_FORM_GNU_str_index </td><td> 0x1f02 </td><td> <a href="http://gcc.gnu.org/wiki/DebugFission";>GNU Fission</a> <a href="http://www.dwarfstd.org/ShowIssue.php?issue=120514.1&type=closed";>DWARF5 proposal</a> </td><td> Unknown </td><td> No support </td></tr> +<tr><td> DW_FORM_GNU_ref_alt </td><td> 0x1f20 </td><td> DWZ multifile <a href="http://www.dwarfstd.org/ShowIssue.php?issue=120604.1";>DWARF5 proposal</a> </td><td> DWZ </td><td> libdw if configured with --enable-dwz </td></tr> +<tr><td> DW_FORM_GNU_strp_alt </td><td> 0x1f21 </td><td> DWZ multifile <a href="http://www.dwarfstd.org/ShowIssue.php?issue=120604.1";>DWARF5 proposal</a> </td><td> DWZ </td><td> libdw if configured with --enable-dwz </td></tr> +</table> + +<h2 id="ExpressionOpcodes">Expression Opcodes</h2> +<table> +<tr><th> DW_OP </th><th> Value </th><th> Description </th><th> Producer </th><th> elfutils support </th></tr> +<tr><td> DW_OP_GNU_push_tls_address </td><td> 0xe0 </td><td> Translates offset to address in TLS area (NOT equivalent to DWARF4 DW_OP_form_tls_address which translates addresses directly) </td><td> GCC </td><td> Constant only </td></tr> +<tr><td> DW_OP_GNU_uninit </td><td> 0xf0 </td><td> <a href="http://gcc.gnu.org/ml/gcc-patches/2007-05/msg00068.html";>Track uninitialized variables</a> </td><td> GCC -fvar-tracking-uninit </td><td> Constant only </td></tr> +<tr><td> DW_OP_GNU_encoded_addr </td><td> 0xf1 </td><td> <a href="http://gcc.gnu.org/ml/gcc-patches/2008-09/msg01713.html";>absolute address in .eh_frame section</a>, <a href="http://sourceware.org/binutils/docs-2.22/as/CFI-directives.html";>GAS CFI</a> </td><td> GCC?/GAS? </td><td> Constant only </td></tr> +<tr><td> DW_OP_GNU_implicit_pointer </td><td> 0xf2 </td><td> GNU implicit pointer <a href="http://www.dwarfstd.org/ShowIssue.php?issue=100831.1-1&type=closed";>original DWARF5 proposal</a> <a href="http://www.dwarfstd.org/ShowIssue.php?issue=100831.1&type=closed";>new DWARF5 version</a> </td><td> GCC </td><td> libdw dwarf_getlocation_implicit_pointer </td></tr> +<tr><td> DW_OP_GNU_entry_value </td><td> 0xf3 </td><td> GNU entry value <a href="http://www.dwarfstd.org/ShowIssue.php?issue=100909.1";>DWARF5 proposal</a> </td><td> GCC </td><td> readelf </td></tr> +<tr><td> DW_OP_GNU_const_type </td><td> 0xf4 </td><td> Typed DWARF stack <a href="http://www.dwarfstd.org/doc/040408.1.html";>DWARF draft proposal</a> </td><td> GCC </td><td> readelf </td></tr> +<tr><td> DW_OP_GNU_regval_type </td><td> 0xf5 </td><td> Typed DWARF stack <a href="http://www.dwarfstd.org/doc/040408.1.html";>DWARF draft proposal</a> </td><td> GCC </td><td> readelf </td></tr> +<tr><td> DW_OP_GNU_deref_type </td><td> 0xf6 </td><td> Typed DWARF stack <a href="http://www.dwarfstd.org/doc/040408.1.html";>DWARF draft proposal</a> </td><td> GCC </td><td> readelf </td></tr> +<tr><td> DW_OP_GNU_convert </td><td> 0xf7 </td><td> Typed DWARF stack <a href="http://www.dwarfstd.org/doc/040408.1.html";>DWARF draft proposal</a> </td><td> GCC </td><td> readelf </td></tr> +<tr><td> DW_OP_GNU_reinterpret </td><td> 0xf9 </td><td> Typed DWARF stack <a href="http://www.dwarfstd.org/doc/040408.1.html";>DWARF draft proposal</a>, <a href="https://lists.fedorahosted.org/pipermail/elfutils-devel/2012-October/002676.html";>background info</a> </td><td> GCC </td><td> readelf </td></tr> +<tr><td> DW_OP_GNU_parameter_ref </td><td> 0xfa </td><td> <a href="http://gcc.gnu.org/ml/gcc-patches/2011-06/msg00649.html";>References optimized out parameter</a> </td><td> GCC </td><td> readelf </td></tr> +<tr><td> DW_OP_GNU_addr_index </td><td> 0xfb </td><td> <a href="http://gcc.gnu.org/wiki/DebugFission";>GNU Fission</a> <a href="http://www.dwarfstd.org/ShowIssue.php?issue=120514.1&type=closed";>DWARF5 proposal</a> </td><td> Unknown </td><td> No support </td></tr> +<tr><td> DW_OP_GNU_const_index </td><td> 0xfc </td><td> <a href="http://gcc.gnu.org/wiki/DebugFission";>GNU Fission</a> <a href="http://www.dwarfstd.org/ShowIssue.php?issue=120514.1&type=closed";>DWARF5 proposal</a> </td><td> Unknown </td><td> No support </td></tr> +</table> + +<h2 id="Languagecodes">Language codes</h2> +<table> +<tr><th> DW_LANG </th><th> Value </th><th> Description </th><th> Producer </th><th> elfutils support </th></tr> +<tr><td> DW_LANG_Go </td><td> 0x16 </td><td> Go <a href="http://dwarfstd.org/ShowIssue.php?issue=101014.1&type=closed";>DWARF5 proposal</a> </td><td> GCC </td><td> readelf </td></tr> +<tr><td> DW_LANG_C_plus_plus_11 </td><td> 0x1a </td><td> C++11 DWARFv5 </td><td> GCC </td><td> readelf, libdw </td></tr> +<tr><td> DW_LANG_C11 </td><td> 0x1d </td><td> C11 DWARFv5 </td><td> GCC </td><td> readelf, libdw </td></tr> +<tr><td> DW_LANG_C_plus_plus_14 </td><td> 0x21 </td><td> C++14 DWARFv5 </td><td> GCC </td><td> readelf, libdw </td></tr> +<tr><td> DW_LANG_Haskell </td><td> 0x18 </td><td> <a href="http://www.dwarfstd.org/ShowIssue.php?issue=120218.1";>Haskell DWARFv5</a> </td><td> ghc </td><td> readelf </td></tr> +<tr><td> DW_LANG_Fortran03 </td><td> 0x22 </td><td> <a href="http://dwarfstd.org/ShowIssue.php?issue=141121.1";>Fortran 2003 DWARFv5</a> </td><td> GCC5 </td><td> readelf, libdw </td></tr> +<tr><td> DW_LANG_Fortran08 </td><td> 0x23 </td><td> <a href="http://dwarfstd.org/ShowIssue.php?issue=141121.1";>Fortran 2008 DWARFv5</a> </td><td> GCC5 </td><td> readelf, libdw </td></tr> +<tr><td> DW_LANG_Mips_Assembler </td><td> 0x8001 </td><td> Generic Assembler (Note spelling _Mips_, not _MIPS_) </td><td> GAS </td><td> readelf </td></tr> +</table> + +<h2 id="CallFrameAddressinstructions">Call Frame Address instructions</h2> +<table> +<tr><th> DW_CFA </th><th> Value </th><th> Description </th><th> Producer </th><th> elfutils support</th></tr> +<tr><td> DW_CFA_MIPS_advance_loc8 </td><td> 0x1d </td><td> 8 byte DW_CFA_advance_loc </td><td> GCC? </td><td> libdw dwarf_cfi_addrframe</td></tr> +<tr><td> DW_CFA_GNU_window_save </td><td> 0x2d </td><td> magic shorthand used only by SPARC </td><td> GCC </td><td> libdw dwarf_cfi_addrframe</td></tr> +<tr><td> DW_CFA_GNU_args_size </td><td> 0x2e </td><td> uleb128 argument indicating function stack size </td><td> GCC? </td><td> parsed but ignored</td></tr> +<tr><td> DW_CFA_GNU_negative_offset_extended </td><td> 0x2f </td><td> GNU extension obsoleted by DWARF3 DW_CFA_offset_extended_sf </td><td> very old < 2002 GCC </td><td> libdw dwarf_cfi_addrframe</td></tr> +</table> + +</div> +</body> +</html> diff --git a/ElflintGNU b/ElflintGNU new file mode 100644 index 0000000..c11a416 --- /dev/null +++ b/ElflintGNU @@ -0,0 +1,30 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd";> +<html xmlns="http://www.w3.org/1999/xhtml";> + +<head> +<link rel="stylesheet" href="default.css" type="text/css"/> +<title>ElflintGNU - elfutils</title> +</head> + +<body> +<p> +eu-elflint has a flag '--gnu-ld' described as "Binary has been created with GNU ld and is therefore known to be broken in certain ways". Note that by GNU ld the original GNU binutils ld is meant, not the newer GNU binutils gold linker. +</p> + +<p> +The following linty things are accepted under '--gnu-ld': +</p> + +<ul> +<li>When GNU ld decides to remove empty sections it leaves symbols referencing them behind. These are symbols in .symtab or .dynsym and for the named symbols have zero size. <a href="http://sourceware.org/PR13621";>http://sourceware.org/PR13621</a></li> +<li>_GLOBAL_OFFSET_TABLE_ symbol size does not match section size.</li> +<li>_DYNAMIC symbol size does not match dynamic segment size.</li> +<li>STB_LOCAL local symbol with version.</li> +<li>thread-local data sections address not zero.</li> +<li>relocation offset out of bounds.</li> +<li>.debug_str section should have just SHF_MERGE | SHF_STRINGS flags set.</li> +<li>A NOBITS section in the middle of a PT_LOAD segment is allowed if the underlying file contents is all zeros.</li> +</ul> + +</body> +</html> diff --git a/default.css b/default.css new file mode 100644 index 0000000..1316f21 --- /dev/null +++ b/default.css @@ -0,0 +1,41 @@ +H1 { + font-size: 3em; + margin-top: 0.3em; + margin-bottom: 0.2em; + font-weight: bold; + color: rgb( 0, 102, 0 ); + text-align: center; +} + +BODY, TD, CITE, A, P, UL, DL, DIV { + font-family: sans; + font-size: 12pt; + color: rgb( 0, 0, 0 ); +} + +DT { font-family: mono; font-size: 9pt; } +DD { font-family: sans; font-size: 9pt; + margin-left: 12pt; padding-bottom: 3pt; } + +A:link, A:visited, A:active { font-weight: bold; text-decoration: none; } +A:link { color: rgb( 0, 102, 0 ); } +A:visited { color: rgb( 0, 128, 0 ); } +A:active { color: rgb( 0, 179, 0 ); } + +DIV.abstract { + overflow: hidden; + border-width: 0; + text-align: justify; +} + +DIV.content { + padding-top: 8px; + padding-left: 132px; + padding-right: 132px; + overflow: hidden; + border-width: 0; + text-align: left; +} + +DIV.list { font-family: mono; font-size: 9pt; + margin-left: 12pt; padding-bottom: 3pt; } diff --git a/index.html b/index.html index ac4c282..a60c6be 100644 --- a/index.html +++ b/index.html @@ -1,6 +1,160 @@ -<html> - <head><title>elfutils</title></head> - <body><h1>elfutils on sourceware</h1> - <b>coming soon</b> - </body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" + "http://www.w3.org/TR/REC-html40/loose.dtd";> +<META NAME="description" + CONTENT="elfutils, libraries and tools for ELF files and DWARF data."> +<META NAME="keywords" + CONTENT="elfutils ELF DWARF libelf libdw libasm stack backtrace"> +<HTML> + <HEAD> + <LINK HREF="default.css" REL="stylesheet" TYPE="text/css"> + <TITLE>The elfutils project</TITLE> + </HEAD> + <BODY> + <H1>ELFUTILS</H1> + <DIV CLASS="content"> + + <P> + <CENTER> + <TABLE BORDER=0 WIDTH="85%" BGCOLOR="#C8C0C8" CELLPADDING=15 CELLSPACING=5> + <TR><TD> + <DIV CLASS="abstract"> + <A HREF="http://elfutils.org/";>elfutils</A> is a collection of + utilities and libraries to read, create and modify ELF binary files, + find and handle DWARF debug data, symbols, thread state and + stacktraces for processes and core files. + </DIV> + </TD></TR> + </TABLE> + </CENTER> + </P> + + <P> + The current <A HREF="https://sourceware.org/git/?p=elfutils.git;a=summary";>elfutils source code</A> can be checked out with: + <DIV><TT>git clone git://sourceware.org/git/elfutils.git</TT></DIV> + </P> + + <P> + Please reports bugs at <A HREF="https://sourceware.org/bugzilla/";>https://sourceware.org/bugzilla/</A> + </P> + + <P> + Project discussion on <A HREF="mailto:elfutils-de...@sourceware.org";>elfutils-de...@sourceware.org</A> (<A HREF="https://sourceware.org/ml/elfutils-devel/";>archives</A>) or visit us on <TT>irc.freenode.net</TT> channel <TT>#elfutils</TT>. + + <P> + To subscribe to the elfutils development list send email to + <A HREF="mailto:elfutils-devel-subscr...@sourceware.org";>elfutils-devel-subscr...@sourceware.org</A>. + Or enter your e-mail address in the box below and hit the button: + <FORM METHOD="get" ACTION="https://sourceware.org/cgi-bin/subscribe-sourceware";> + <INPUT TYPE="hidden" NAME="listname" VALUE="elfutils-devel"> + <INPUT TYPE="text" NAME="username" SIZE="30"> + <INPUT TYPE="Submit" NAME="submit" VALUE="Sign me up!"> + </FORM> + </P> + + <P> + See the <A HREF="https://sourceware.org/git/?p=elfutils.git;a=blob_plain;f=CONTRIBUTING;hb=HEAD";>CONTRIBUTING</A> file for how to propose patches to the code. + </P> + + <P>Releases: + <A HREF="ftp://sourceware.org/pub/elfutils/";>ftp://sourceware.org/pub/elfutils/</A> or <A HREF="https://sourceware.org/elfutils/ftp/";>https://sourceware.org/elfutils/ftp/</A> + </P> + + <P> + Included libraries: + </P> + + <DL> + <DT>libelf</DT> + <DD><TT>elf32</TT>, <TT>elf64</TT> and <TT>gelf</TT> functions to read, + modify and create ELF files.</DD> + + <DT>libdw</DT> + <DD><TT>dwarf</TT>, <TT>dwfl</TT> and <TT>dwelf</TT> functions to read + DWARF, find separate debuginfo, symbols and inspect process state. + </DD> + + <DT>libasm</DT> + <DD><TT>asm</TT> and <TT>disasm</TT> functions to assemble and + disassamble instructions (partial support for i686 and BPF + instructions only).</DD> + + </DL> + + <P> + Included utilities: + </P> + + <DL> + <DT>eu-addr2line</DT> + <DD>Locate source files and line information for addresses.</DD> + + <DT>eu-ar</DT> + <DD>Create, modify, and extract from archives.</DD> + + <DT>eu-elfcmp</DT> + <DD>Compare relevant parts of two ELF files for equality.</DD> + + <DT>eu-elfcompress</DT> + <DD>Compress or decompress sections in an ELF file.</DD> + + <DT>eu-elflint</DT> + <DD>Pedantic checking of ELF files compliance with gABI/psABI spec.</DD> + + <DT>eu-findtextrel</DT> + <DD>Locate source of text relocations in ELF files.</DD> + + <DT>eu-make-debug-archive</DT> + <DD>Script to make an offline archive for debugging of ELF binaries and linux kernel modules</DD> + + <DT>eu-nm</DT> + <DD>List symbols from ELF files.</DD> + + <DT>eu-objdump</DT> + <DD>Show information from ELF files.</DD> + + <DT>eu-ranlib</DT> + <DD>Generate an index to speed access to archives.</DD> + + <DT>eu-readelf</DT> + <DD>Print information from ELF file in human-readable form.</DD> + + <DT>eu-size</DT> + <DD>List section sizes of ELF files.</DD> + + <DT>eu-stack</DT> + <DD>Print a stack for each thread in a process or core file.</DD> + + <DT>eu-strings</DT> + <DD>Print the strings of printable characters in files.</DD> + + <DT>eu-strip</DT> + <DD>Discard symbols and debug data from object files.</DD> + + <DT>eu-unstrip</DT> + <DD>Combine stripped files with separate symbols and debug information.</DD> + </DL> + + <P>Included backends for machine specific ELF handling:</P> + <DIV CLASS="list">aarch64 alpha arm bpf i386 ia64 m68k ppc ppc64 + s390 s390x sh sparc sparc64 tilegx x32 x86_64</DIV> + </P> + + <P>Design notes and extensions supported:</P> + + <UL> + <LI>Some design decisions and <A HREF="https://sourceware.org/git/?p=elfutils.git;a=blob_plain;f=NOTES;hb=HEAD";>NOTES</A>.</LI> + <LI>List of <A HREF="DwarfExtensions">DwarfExtensions</A> recognized.</LI> + <LI>List of <A HREF="ElflintGNU">ElflintGNU</a> issues recognized.</LI> + </UL> + + <CENTER> + <HR WIDTH="90%"></CENTER> + <P> + Questions? + Send them to <A HREF="mailto:elfutils-de...@sourceware.org";>elfutils-de...@sourceware.org</A> + or visit us on <TT>irc.freenode.net</TT> channel <TT>#elfutils</TT>. + </P> + + </DIV> + </BODY> +</HTML> -- 2.9.3 _______________________________________________ elfutils-devel mailing list -- elfutils-devel@lists.fedorahosted.org To unsubscribe send an email to elfutils-devel-le...@lists.fedorahosted.org
