Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Sync libdwarf's manual pages with upstream.

This commit is contained in:
jkoshy 2020-11-26 22:51:35 +00:00
parent ef39d52e3c
commit 604b08429e
126 changed files with 900 additions and 897 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

54
external/bsd/elftoolchain/dist/libdwarf/dwarf.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Joseph Koshy. All rights reserved.
.\"
@ -23,11 +23,11 @@
.\" out of the use of this software, even if advised of the possibility of
.\" such damage.
.\"
.\" Id: dwarf.3 3295 2016-01-08 22:08:10Z jkoshy
.\" Id: dwarf.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd December 21, 2014
.Os
.Dt DWARF 3
.Os
.Sh NAME
.Nm dwarf
.Nd access debugging information in object files
@ -36,7 +36,6 @@
.Sh SYNOPSIS
.In libdwarf.h
.Sh DESCRIPTION
.Pp
The
.Lb libdwarf
provides functions that allow an application to read and write debugging
@ -131,7 +130,6 @@ A descriptor representing a static variable.
A descriptor representing a weak name.
.El
.Ss Error Handling
.Pp
Library functions that encounter an error will return with a value
other than
.Dv DW_DLV_OK .
@ -175,7 +173,7 @@ below.
.Pp
.Bl -tag -compact -width "CCCC"
.It Abbreviations
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_get_abbrev
Retrieve abbreviation information at a given offset.
.It Fn dwarf_get_abbrev_children_flag
@ -189,7 +187,7 @@ descriptor.
Retrieve the tag for an abbreviation entry.
.El
.It Addresses
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_get_address_size
Return the number of bytes needed to represent an address.
.It Fn dwarf_get_arange
@ -208,7 +206,7 @@ Retrieve information about non-contiguous address ranges for
a debugging information entry.
.El
.It Attributes
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_arrayorder
Retrieve the value of a
.Dv DW_AT_ordering
@ -281,7 +279,7 @@ Retrieve the attribute code for an attribute.
Retrieve the form of an attribute.
.El
.It Call Information Entries and Frame Descriptor Entries
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_get_cie_index
Retrieve the index for a CIE descriptor.
.It Fn dwarf_get_cie_info
@ -310,7 +308,7 @@ Retrieve an FDE descriptor.
Retrieve range information from an FDE descriptor.
.El
.It Compilation Units
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Xo
.Fn dwarf_get_cu_die_offset_given_cu_header_offset ,
.Fn dwarf_get_cu_die_offset_given_cu_header_offset_b
@ -325,7 +323,7 @@ compilation or type unit.
Step through compilation units in a debug context.
.El
.It Debugging Information Entries
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_child
Returns the child of a debugging information entry.
.It Fn dwarf_die_abbrev_code
@ -355,7 +353,7 @@ entry.
Retrieve the tag for a debugging information entry.
.El
.It Functions
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_func_cu_offset
Retrieves the offset for the compilation unit for a function.
.It Fn dwarf_func_die_offset
@ -369,7 +367,7 @@ Retrieve both the name and offsets for a function.
Retrieve information about static functions.
.El
.It Globals
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_get_globals
Retrieve a list of globals.
.It Fn dwarf_global_cu_offset
@ -398,7 +396,7 @@ and
allow an application to specify alternate low-level file access
routines.
.It Line Numbers
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_lineaddr
Retrieve the program address for a source line.
.It Fn dwarf_linebeginstatement
@ -422,7 +420,7 @@ Retrieve source files for a compilation unit.
Return line number information for a compilation unit.
.El
.It Location Lists
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_get_loclist_entry
Retrieve a location list entry.
.It Fn dwarf_loclist , Fn dwarf_loclist_n
@ -435,7 +433,7 @@ Retrieve location expressions.
Translate a location expression into a location descriptor.
.El
.It Error Handling
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_errmsg
Retrieve a human-readable error message.
.It Fn dwarf_errno
@ -446,7 +444,7 @@ Set the argument passed to a callback error handler.
Set the callback handler to be called in case of an error.
.El
.It Frame Handling
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_expand_frame_instructions
Translate frame instruction bytes.
.It Fn dwarf_set_frame_cfa_value
@ -466,7 +464,7 @@ Set the register number representing the
rule.
.El
.It Macros
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_find_macro_value_start
Return the macro value part of a macro string.
.It Fn dwarf_get_macro_details
@ -525,7 +523,7 @@ for DWARF constants:
and
.Fn dwarf_get_VIS_name .
.It Types
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_get_pubtypes , Fn dwarf_get_types
Retrieve descriptors for user-defined types.
.It Fn dwarf_next_types_section
@ -542,7 +540,7 @@ Retrieve the name of a type.
Retrieve the name and offsets for a type.
.El
.It Variables
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_get_vars
Retrieve descriptors for static variables.
.It Fn dwarf_var_cu_offset
@ -555,7 +553,7 @@ Retrieve the name of a variable.
Retrieve the name and offsets for a variable.
.El
.It Weak Symbols
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_get_weaks
Retrieve information about weak symbols.
.It Fn dwarf_weak_cu_offset
@ -568,7 +566,7 @@ Retrieve the name of a weak symbol.
Retrieve the name and offsets for a weak symbol.
.El
.It Miscellaneous
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_get_elf
Retrieve the ELF descriptor for a debug context, see
.Xr elf 3 .
@ -607,7 +605,7 @@ information entry:
and
.Fn dwarf_add_AT_unsigned_const .
.It Debugging Information Entry Management
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_add_die_to_debug
Set the root debugging information entry for a DWARF producer instance.
.It Fn dwarf_die_link
@ -625,7 +623,7 @@ are used to initialize a producer instance.
When done, applications release resources using the function
.Fn dwarf_producer_finish .
.It Relocations and Sections
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_get_relocation_info
Retrieve a relocation array from a producer instance.
.It Fn dwarf_get_relocation_info_count
@ -638,7 +636,7 @@ Reset internal state for a producer instance.
Prepare byte streams for writing out.
.El
.It Macros
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_def_macro
Add a macro definition.
.It Fn dwarf_end_macro_file , Fn dwarf_start_macro_file
@ -649,7 +647,7 @@ Note the removal of a macro definition.
Enables storing macro information as specified in the DWARF standard.
.El
.It Symbols, Expressions, Addresses and Offsets
.Bl -tag -compact
.Bl -tag -compact -width indent
.It Fn dwarf_add_arange , Fn dwarf_add_arange_b
Add address range information.
.It Fn dwarf_add_directory_decl
@ -743,7 +741,9 @@ The DWARF(3) API originated at Silicon Graphics Inc.
.Pp
A BSD-licensed implementation of a subset of the API was written by
.An John Birrell Aq Mt jb@FreeBSD.org
for the FreeBSD project.
for the
.Fx
project.
The implementation was subsequently revised and completed by
.An Kai Wang Aq Mt kaiwang27@users.sourceforge.net .
.Pp

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_comp_dir.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_AT_comp_dir.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_AT_comp_dir.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_AT_comp_dir.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_AT_comp_dir.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 4, 2011
.Os
.Dt DWARF_ADD_AT_COMP_DIR 3
.Os
.Sh NAME
.Nm dwarf_add_AT_comp_dir
.Nd create and attach a DW_AT_comp_dir attribute

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_const_value_string.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_AT_const_value_string.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_AT_const_value_string.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_AT_const_value_string.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_AT_const_value_string.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 4, 2011
.Os
.Dt DWARF_ADD_AT_CONST_VALUE_STRING 3
.Os
.Sh NAME
.Nm dwarf_add_AT_const_value_signedint ,
.Nm dwarf_add_AT_const_value_string ,

8
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_dataref.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_AT_dataref.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_AT_dataref.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_AT_dataref.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_AT_dataref.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd September 4, 2011
.Os
.Dt DWARF_ADD_AT_DATAREF 3
.Os
.Sh NAME
.Nm dwarf_add_AT_dataref
.Nd create an attribute descriptor for a relocatable address
@ -115,8 +115,8 @@ function.
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_add_AT_reference 3 ,
.Xr dwarf_add_AT_ref_address 3 ,
.Xr dwarf_add_AT_reference 3 ,
.Xr dwarf_add_AT_signed_const 3 ,
.Xr dwarf_add_AT_unsigned_const 3 ,
.Xr dwarf_new_die 3 ,

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_flag.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_AT_flag.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_AT_flag.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_AT_flag.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_AT_flag.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 4, 2011
.Os
.Dt DWARF_ADD_AT_FLAG 3
.Os
.Sh NAME
.Nm dwarf_add_AT_flag
.Nd create and attach a flag attribute

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_location_expr.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_AT_location_expr.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_AT_location_expr.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_AT_location_expr.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_AT_location_expr.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 5, 2011
.Os
.Dt DWARF_ADD_AT_LOCATION_EXPR 3
.Os
.Sh NAME
.Nm dwarf_add_AT_location_expr
.Nd create an attribute descriptor for a location expression

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_name.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_AT_name.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_AT_name.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_AT_name.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_AT_name.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 4, 2011
.Os
.Dt DWARF_ADD_AT_NAME 3
.Os
.Sh NAME
.Nm dwarf_add_AT_name
.Nd create and attach a DW_AT_name attribute

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_producer.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_AT_producer.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_AT_producer.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_AT_producer.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_AT_producer.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 4, 2011
.Os
.Dt DWARF_ADD_AT_PRODUCER 3
.Os
.Sh NAME
.Nm dwarf_add_AT_producer
.Nd create and attach a DW_AT_producer attribute

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_ref_address.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_AT_ref_address.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_AT_ref_address.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_AT_ref_address.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_AT_ref_address.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 7, 2011
.Os
.Dt DWARF_ADD_AT_REF_ADDRESS 3
.Os
.Sh NAME
.Nm dwarf_add_AT_ref_address
.Nd create a reference class attribute descriptor

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_reference.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_AT_reference.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_AT_reference.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_AT_reference.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_AT_reference.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 4, 2011
.Os
.Dt DWARF_ADD_AT_REFERENCE 3
.Os
.Sh NAME
.Nm dwarf_add_AT_reference
.Nd create and attach an attribute that references another DIE

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_signed_const.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_AT_signed_const.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_AT_signed_const.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_AT_signed_const.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_AT_signed_const.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 4, 2011
.Os
.Dt DWARF_ADD_AT_SIGNED_CONST 3
.Os
.Sh NAME
.Nm dwarf_add_AT_signed_const ,
.Nm dwarf_add_AT_unsigned_const

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_string.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_AT_string.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_AT_string.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_AT_string.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_AT_string.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 4, 2011
.Os
.Dt DWARF_ADD_AT_STRING 3
.Os
.Sh NAME
.Nm dwarf_add_AT_string
.Nd create and attach a string class attribute

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_targ_address.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_AT_targ_address.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_AT_targ_address.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_AT_targ_address.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_AT_targ_address.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 4, 2011
.Os
.Dt DWARF_ADD_AT_TARG_ADDRESS 3
.Os
.Sh NAME
.Nm dwarf_add_AT_targ_address ,
.Nm dwarf_add_AT_targ_address_b

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_arange.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_arange.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_arange.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_arange.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_arange.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 18, 2011
.Os
.Dt DWARF_ADD_ARANGE 3
.Os
.Sh NAME
.Nm dwarf_add_arange ,
.Nm dwarf_add_arange_b

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_die_to_debug.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_die_to_debug.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_die_to_debug.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_die_to_debug.3 2938 2013-04-27 05:09:17Z jkoshy
.\" Id: dwarf_add_die_to_debug.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd August 21, 2011
.Os
.Dt DWARF_ADD_DIE_TO_DEBUG 3
.Os
.Sh NAME
.Nm dwarf_add_die_to_debug
.Nd set the root debugging information entry

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_directory_decl.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_directory_decl.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_directory_decl.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_directory_decl.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_directory_decl.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 17, 2011
.Os
.Dt DWARF_ADD_DIRECTORY_DECL 3
.Os
.Sh NAME
.Nm dwarf_add_directory_decl
.Nd add a directory name to a producer instance

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_expr_addr.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_expr_addr.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_expr_addr.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_expr_addr.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_expr_addr.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 9, 2011
.Os
.Dt DWARF_ADD_EXPR_ADDR 3
.Os
.Sh NAME
.Nm dwarf_add_expr_addr ,
.Nm dwarf_add_expr_addr_b

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_expr_gen.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_expr_gen.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_expr_gen.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_expr_gen.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_expr_gen.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 9, 2011
.Os
.Dt DWARF_ADD_EXPR_GEN 3
.Os
.Sh NAME
.Nm dwarf_add_expr_gen
.Nd add an operator to a location expression descriptor

8
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_fde_inst.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_fde_inst.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_fde_inst.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_fde_inst.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_fde_inst.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd September 26, 2011
.Os
.Dt DWARF_ADD_FDE_INST 3
.Os
.Sh NAME
.Nm dwarf_add_fde_inst
.Nd add a call frame instruction to a DWARF frame descriptor
@ -103,9 +103,9 @@ function.
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_add_frame_cie 3 ,
.Xr dwarf_add_frame_fde 3 ,
.Xr dwarf_add_frame_fde_b 3 ,
.Xr dwarf_add_frame_cie 3 ,
.Xr dwarf_fde_cfa_offset 3 ,
.Xr dwarf_new_fde 3
.Rs

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_file_decl.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_file_decl.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_file_decl.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_file_decl.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_file_decl.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 17, 2011
.Os
.Dt DWARF_ADD_FILE_DECL 3
.Os
.Sh NAME
.Nm dwarf_add_file_decl
.Nd add a source file entry to a producer instance

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_frame_cie.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_frame_cie.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_frame_cie.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_frame_cie.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_frame_cie.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 26, 2011
.Os
.Dt DWARF_ADD_FRAME_CIE 3
.Os
.Sh NAME
.Nm dwarf_add_frame_cie
.Nd add a call frame common information entry to a DWARF producer instance

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_frame_fde.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_frame_fde.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_frame_fde.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_frame_fde.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_frame_fde.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 26, 2011
.Os
.Dt DWARF_ADD_FRAME_FDE 3
.Os
.Sh NAME
.Nm dwarf_add_frame_fde
.Nd add a call frame descriptor to a DWARF producer instance

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_funcname.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_funcname.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_funcname.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_funcname.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_funcname.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 24, 2011
.Os
.Dt DWARF_ADD_FUNCNAME 3
.Os
.Sh NAME
.Nm dwarf_add_funcname
.Nd add information about a static function to a DWARF producer instance

42
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_line_entry.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_line_entry.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_line_entry.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_line_entry.3 3182 2015-04-10 16:08:10Z emaste
.\" Id: dwarf_add_line_entry.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd June 30, 2013
.Os
.Dt DWARF_ADD_LINE_ENTRY 3
.Os
.Sh NAME
.Nm dwarf_add_line_entry
.Nd add a line number information entry to a producer instance
@ -111,24 +111,7 @@ returns
.Dv DW_DLV_NOCOUNT
and sets the argument
.Ar err .
.Sh ERRORS
Function
.Fn dwarf_add_line_entry
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_ARGUMENT"
.It Bq Er DW_DLE_ARGUMENT
Argument
.Ar dbg
was NULL.
.It Bq Er DW_DLE_ARGUMENT
The function
.Xr dwarf_lne_set_address 3
was not called before calling this function.
.It Bq Er DW_DLE_MEMORY
An out of memory condition was encountered during the execution of the
function.
.El
.Sh EXAMPLE
.Sh EXAMPLES
To add line number information to the producer instance, use:
.Bd -literal -offset indent
Dwarf_P_Debug dbg;
@ -156,6 +139,23 @@ if (dwarf_add_line_entry(dbg, filendx, 10, 258, 0, 1, 1, &de) !=
errx(EXIT_FAILURE, "dwarf_add_line_entry failed: %s",
dwarf_errmsg(-1));
.Ed
.Sh ERRORS
Function
.Fn dwarf_add_line_entry
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_ARGUMENT"
.It Bq Er DW_DLE_ARGUMENT
Argument
.Ar dbg
was NULL.
.It Bq Er DW_DLE_ARGUMENT
The function
.Xr dwarf_lne_set_address 3
was not called before calling this function.
.It Bq Er DW_DLE_MEMORY
An out of memory condition was encountered during the execution of the
function.
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_add_directory_decl 3 ,

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_pubname.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_pubname.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_pubname.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_pubname.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_pubname.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 24, 2011
.Os
.Dt DWARF_ADD_PUBNAME 3
.Os
.Sh NAME
.Nm dwarf_add_pubname
.Nd add information about a global object to a DWARF producer instance

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_typename.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_typename.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_typename.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_typename.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_typename.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 24, 2011
.Os
.Dt DWARF_ADD_TYPENAME 3
.Os
.Sh NAME
.Nm dwarf_add_typename
.Nd add information about a user-defined type to a DWARF producer instance

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_varname.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_varname.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_varname.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_varname.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_varname.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 24, 2011
.Os
.Dt DWARF_ADD_VARNAME 3
.Os
.Sh NAME
.Nm dwarf_add_varname
.Nd add information about a static variable to a DWARF producer instance

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_add_weakname.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_add_weakname.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_add_weakname.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_add_weakname.3 2072 2011-10-27 03:26:49Z jkoshy
.\" Id: dwarf_add_weakname.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 24, 2011
.Os
.Dt DWARF_ADD_WEAKNAME 3
.Os
.Sh NAME
.Nm dwarf_add_weakname
.Nd add information about a weak object to a DWARF producer instance

9
external/bsd/elftoolchain/dist/libdwarf/dwarf_attr.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_attr.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_attr.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_attr.3 3093 2014-09-02 22:09:40Z kaiwang27
.\" Id: dwarf_attr.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd April 8, 2010
.Os
.Dt DWARF_ATTR 3
.Os
.Sh NAME
.Nm dwarf_attr
.Nd retrieve an attribute descriptor associated with a DWARF debugging information entry
@ -82,7 +82,8 @@ of an error.
Function
.Fn dwarf_attr
returns
.Dv DW_DLV_OK on success.
.Dv DW_DLV_OK
on success.
.Pp
If the debugging information entry descriptor denoted by argument
.Ar die

9
external/bsd/elftoolchain/dist/libdwarf/dwarf_attrlist.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_attrlist.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_attrlist.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_attrlist.3 2122 2011-11-09 15:35:14Z jkoshy
.\" Id: dwarf_attrlist.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd November 9, 2011
.Os
.Dt DWARF_ATTRLIST 3
.Os
.Sh NAME
.Nm dwarf_attrlist
.Nd retrieve DWARF attribute descriptors
@ -84,7 +84,8 @@ function.
Function
.Fn dwarf_attrlist
returns
.Dv DW_DLV_OK on success.
.Dv DW_DLV_OK
on success.
.Pp
If the debugging information entry descriptor denoted by argument
.Ar die

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_attroffset.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_attroffset.3,v 1.2 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_attroffset.3,v 1.3 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2014 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_attroffset.3 3115 2014-12-20 18:26:46Z jkoshy
.\" Id: dwarf_attroffset.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd December 20, 2014
.Os
.Dt DWARF_ATTROFFSET 3
.Os
.Sh NAME
.Nm dwarf_attroffset
.Nd retrieve the section-relative offset of an attribute descriptor

17
external/bsd/elftoolchain/dist/libdwarf/dwarf_attrval_signed.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_attrval_signed.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_attrval_signed.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_attrval_signed.3 2980 2014-01-21 20:15:54Z kaiwang27
.\" Id: dwarf_attrval_signed.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd January 18, 2014
.Os
.Dd December 26, 2016
.Dt DWARF_ATTRVAL_SIGNED 3
.Os
.Sh NAME
.Nm dwarf_attrval_flag ,
.Nm dwarf_attrval_signed ,
@ -170,17 +170,22 @@ or
.Pp
If the attribute named by argument
.Ar attr
is not present in the debugging information entry referenced by
argument
is
.Dv DW_AT_type
and is not present in the debugging information entry referenced by argument
.Ar die ,
and if a
.Dv DW_AT_abstract_origin
or
.Dv DW_AT_specification
attribute is present in the debugging information entry,
function
.Fn dwarf_attrval_unsigned
will search for the named attribute in the debugging information entry
referenced by the
.Dv DW_AT_abstract_origin
or
.Dv DW_AT_specification
attribute.
.Sh RETURN VALUES
On success, these functions returns

50
external/bsd/elftoolchain/dist/libdwarf/dwarf_child.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_child.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_child.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010,2014 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_child.3 3127 2014-12-21 19:09:19Z jkoshy
.\" Id: dwarf_child.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd December 21, 2014
.Os
.Dt DWARF_CHILD 3
.Os
.Sh NAME
.Nm dwarf_child ,
.Nm dwarf_offdie ,
@ -217,27 +217,6 @@ there was no debugging information entry at the offset specified by
argument
.Ar offset .
.El
.Sh ERRORS
These functions may fail with the following errors:
.Bl -tag -width ".Bq Er DW_DLE_DIE_NO_CU_CONTEXT"
.It Bq Er DW_DLE_ARGUMENT
Arguments
.Ar dbg ,
.Ar die
or
.Ar ret_die
were NULL.
.It Bq Er DW_DLE_DIE_NO_CU_CONTEXT
Argument
.Ar dbg
was not associated with a compilation unit.
.It Bq Er DW_DLE_NO_ENTRY
The descriptor denoted by argument
.Ar die
had no child or sibling, or there was no DWARF debugging information
entry at the offset specified by argument
.Va offset .
.El
.Sh EXAMPLES
To retrieve the first DWARF Debugging Information Entry descriptor for
the first compilation unit associated with a
@ -273,8 +252,29 @@ do {
dwarf_errmsg(de));
} while (die0 != NULL);
.Ed
.Sh ERRORS
These functions may fail with the following errors:
.Bl -tag -width ".Bq Er DW_DLE_DIE_NO_CU_CONTEXT"
.It Bq Er DW_DLE_ARGUMENT
Arguments
.Ar dbg ,
.Ar die
or
.Ar ret_die
were NULL.
.It Bq Er DW_DLE_DIE_NO_CU_CONTEXT
Argument
.Ar dbg
was not associated with a compilation unit.
.It Bq Er DW_DLE_NO_ENTRY
The descriptor denoted by argument
.Ar die
had no child or sibling, or there was no DWARF debugging information
entry at the offset specified by argument
.Va offset .
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_errmsg 3 ,
.Xr dwarf_get_die_infotypes_flag.3 ,
.Xr dwarf_get_die_infotypes_flag 3 ,
.Xr dwarf_next_cu_header 3

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_dealloc.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_dealloc.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_dealloc.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2009-2011 Joseph Koshy. All rights reserved.
.\"
@ -23,11 +23,11 @@
.\" out of the use of this software, even if advised of the possibility of
.\" such damage.
.\"
.\" Id: dwarf_dealloc.3 2073 2011-10-27 03:30:47Z jkoshy
.\" Id: dwarf_dealloc.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd July 23, 2011
.Os
.Dt DWARF_DEALLOC 3
.Os
.Sh NAME
.Nm dwarf_dealloc ,
.Nm dwarf_fde_cie_list_dealloc ,

8
external/bsd/elftoolchain/dist/libdwarf/dwarf_def_macro.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_def_macro.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_def_macro.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_def_macro.3 3182 2015-04-10 16:08:10Z emaste
.\" Id: dwarf_def_macro.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd November 9, 2011
.Os
.Dt DWARF_DEF_MACRO 3
.Os
.Sh NAME
.Nm dwarf_def_macro
.Nd add a macro definition to a DWARF producer instance
@ -93,7 +93,7 @@ returns
.Dv DW_DLV_ERROR
and sets the argument
.Ar err .
.Sh EXAMPLE
.Sh EXAMPLES
To record the fact that a macro named
.Dv _STDIO_H_
was defined at line 20 of the current macro file, use:

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_die_abbrev_code.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_die_abbrev_code.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_die_abbrev_code.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_die_abbrev_code.3 2073 2011-10-27 03:30:47Z jkoshy
.\" Id: dwarf_die_abbrev_code.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd April 14, 2010
.Os
.Dt DWARF_DIE_ABBREV_CODE 3
.Os
.Sh NAME
.Nm dwarf_die_abbrev_code
.Nd retrieve the abbreviation code for a DWARF debugging information entry

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_die_link.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_die_link.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_die_link.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_die_link.3 2073 2011-10-27 03:30:47Z jkoshy
.\" Id: dwarf_die_link.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 4, 2011
.Os
.Dt DWARF_DIE_LINK 3
.Os
.Sh NAME
.Nm dwarf_die_link
.Nd link a debugging information entry

13
external/bsd/elftoolchain/dist/libdwarf/dwarf_diename.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_diename.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_diename.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_diename.3 2073 2011-10-27 03:30:47Z jkoshy
.\" Id: dwarf_diename.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd March 31, 2010
.Os
.Dt DWARF_DIENAME 3
.Os
.Sh NAME
.Nm dwarf_diename
.Nd retrieve the name associated with a debugging information entry
@ -53,7 +53,8 @@ pointed to by argument
Function
.Fn dwarf_diename
returns
.Dv DW_DLV_OK on success.
.Dv DW_DLV_OK
on success.
.Pp
If the debugging information entry descriptor denoted by argument
.Ar die
@ -87,6 +88,6 @@ attribute.
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_tag 3 ,
.Xr dwarf_die_abbrev_code 3 ,
.Xr dwarf_dieoffset 3 ,
.Xr dwarf_die_abbrev_code 3
.Xr dwarf_tag 3

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_dieoffset.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_dieoffset.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_dieoffset.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010,2014 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_dieoffset.3 3129 2014-12-21 20:06:26Z jkoshy
.\" Id: dwarf_dieoffset.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd December 21, 2014
.Os
.Dt DWARF_DIEOFFSET 3
.Os
.Sh NAME
.Nm dwarf_die_CU_offset ,
.Nm dwarf_die_CU_offset_range ,

7
external/bsd/elftoolchain/dist/libdwarf/dwarf_end_macro_file.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_end_macro_file.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_end_macro_file.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_end_macro_file.3 2073 2011-10-27 03:30:47Z jkoshy
.\" Id: dwarf_end_macro_file.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd September 25, 2011
.Os
.Dt DWARF_END_MACRO_FILE 3
.Os
.Sh NAME
.Nm dwarf_end_macro_file
.Nd mark the end of the current source file inclusion
@ -40,7 +40,6 @@
.Fo dwarf_end_macro_file
.Fa "Dwarf_P_Debug dbg"
.Fa "Dwarf_Error *err"
.Fa
.Fc
.Sh DESCRIPTION
Function

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_errmsg.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_errmsg.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_errmsg.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2009 Joseph Koshy. All rights reserved.
.\"
@ -23,11 +23,11 @@
.\" out of the use of this software, even if advised of the possibility of
.\" such damage.
.\"
.\" Id: dwarf_errmsg.3 2073 2011-10-27 03:30:47Z jkoshy
.\" Id: dwarf_errmsg.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd December 12, 2009
.Os
.Dt DWARF_ERRMSG 3
.Os
.Sh NAME
.Nm dwarf_errmsg
.Nd retrieve a human-readable string corresponding to a

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_errno.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_errno.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_errno.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2009,2010 Joseph Koshy. All rights reserved.
.\"
@ -23,11 +23,11 @@
.\" out of the use of this software, even if advised of the possibility of
.\" such damage.
.\"
.\" Id: dwarf_errno.3 2073 2011-10-27 03:30:47Z jkoshy
.\" Id: dwarf_errno.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd March 25, 2010
.Os
.Dt DWARF_ERRNO 3
.Os
.Sh NAME
.Nm dwarf_errno
.Nd retrieve the error number corresponding to a

62
external/bsd/elftoolchain/dist/libdwarf/dwarf_expand_frame_instructions.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_expand_frame_instructions.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_expand_frame_instructions.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_expand_frame_instructions.3 3181 2015-04-10 13:22:51Z emaste
.\" Id: dwarf_expand_frame_instructions.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd November 9, 2011
.Os
.Dt DWARF_EXPAND_FRAME_INSTRUCTIONS 3
.Os
.Sh NAME
.Nm dwarf_expand_frame_instructions
.Nd expand frame instructions
@ -106,32 +106,7 @@ In case of an error, it returns
.Dv DW_DLV_ERROR
and sets the argument
.Ar err .
.Sh ERRORS
Function
.Fn dwarf_expand_frame_instructions
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_ARGUMENT"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar cie ,
.Ar instructions ,
.Ar ret_ops
or
.Ar ret_opcnt
was NULL.
.It Bq Er DW_DLE_ARGUMENT
Argument
.Ar len
was 0.
.It Bq Er DW_DLE_MEMORY
An out of memory condition was encountered during the execution of
this function.
.It Bq Er DW_DLE_FRAME_INSTR_EXEC_ERROR
An unknown instruction was found in the instruction bytes provided
in argument
.Ar instructions .
.El
.Sh EXAMPLE
.Sh EXAMPLES
To retrieve and expand the frame instructions for a given FDE
descriptor, use:
.Bd -literal -offset indent
@ -166,12 +141,37 @@ for (i = 0; i < opcnt; i++) {
/* Free the memory area when no longer needed. */
dwarf_dealloc(dbg, ops, DW_DLA_FRAME_BLOCK);
.Ed
.Sh ERRORS
Function
.Fn dwarf_expand_frame_instructions
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_ARGUMENT"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar cie ,
.Ar instructions ,
.Ar ret_ops
or
.Ar ret_opcnt
was NULL.
.It Bq Er DW_DLE_ARGUMENT
Argument
.Ar len
was 0.
.It Bq Er DW_DLE_MEMORY
An out of memory condition was encountered during the execution of
this function.
.It Bq Er DW_DLE_FRAME_INSTR_EXEC_ERROR
An unknown instruction was found in the instruction bytes provided
in argument
.Ar instructions .
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_frame_instructions_dealloc 3 ,
.Xr dwarf_get_cie_info 3 ,
.Xr dwarf_get_cie_index 3 ,
.Xr dwarf_get_cie_of_fde ,
.Xr dwarf_get_cie_info 3 ,
.Xr dwarf_get_cie_of_fde 3 ,
.Xr dwarf_get_fde_at_pc 3 ,
.Xr dwarf_get_fde_info_for_all_regs 3 ,
.Xr dwarf_get_fde_info_for_all_regs3 3 ,

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_expr_current_offset.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_expr_current_offset.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_expr_current_offset.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_expr_current_offset.3 2073 2011-10-27 03:30:47Z jkoshy
.\" Id: dwarf_expr_current_offset.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 13, 2011
.Os
.Dt DWARF_EXPR_CURRENT_OFFSET 3
.Os
.Sh NAME
.Nm dwarf_expr_current_offset
.Nd retrieve the number of bytes in a location expression stream

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_expr_into_block.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_expr_into_block.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_expr_into_block.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_expr_into_block.3 2073 2011-10-27 03:30:47Z jkoshy
.\" Id: dwarf_expr_into_block.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 13, 2011
.Os
.Dt DWARF_EXPR_INTO_BLOCK 3
.Os
.Sh NAME
.Nm dwarf_expr_into_block
.Nd retrieve the byte stream for a location expression

8
external/bsd/elftoolchain/dist/libdwarf/dwarf_fde_cfa_offset.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_fde_cfa_offset.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_fde_cfa_offset.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_fde_cfa_offset.3 2073 2011-10-27 03:30:47Z jkoshy
.\" Id: dwarf_fde_cfa_offset.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd September 26, 2011
.Os
.Dt DWARF_FDE_CFA_OFFSET 3
.Os
.Sh NAME
.Nm dwarf_fde_cfa_offset
.Nd add a DW_CFA_offset frame instruction to a DWARF frame descriptor
@ -95,7 +95,7 @@ function.
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_add_fde_inst 3 ,
.Xr dwarf_add_frame_cie 3 ,
.Xr dwarf_add_frame_fde 3 ,
.Xr dwarf_add_frame_fde_b 3 ,
.Xr dwarf_add_frame_cie 3 ,
.Xr dwarf_new_fde 3

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_find_macro_value_start.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_find_macro_value_start.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_find_macro_value_start.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_find_macro_value_start.3 2073 2011-10-27 03:30:47Z jkoshy
.\" Id: dwarf_find_macro_value_start.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd March 26, 2011
.Os
.Dt DWARF_FIND_MACRO_VALUE_START 3
.Os
.Sh NAME
.Nm dwarf_find_macro_value_start
.Nd return the address of the first byte of a macro value

10
external/bsd/elftoolchain/dist/libdwarf/dwarf_finish.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_finish.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_finish.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2009,2011 Joseph Koshy. All rights reserved.
.\"
@ -23,11 +23,11 @@
.\" out of the use of this software, even if advised of the possibility of
.\" such damage.
.\"
.\" Id: dwarf_finish.3 2122 2011-11-09 15:35:14Z jkoshy
.\" Id: dwarf_finish.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd November 9, 2011
.Os
.Dt DWARF_FINISH 3
.Os
.Sh NAME
.Nm dwarf_finish ,
.Nm dwarf_object_finish
@ -135,8 +135,8 @@ if (dwarf_finish(dbg, &de) != DW_DLV_OK)
(void) elf_end(e);
.Ed
.Sh SEE ALSO
.Xr elf_end 3 ,
.Xr dwarf_elf_init 3 ,
.Xr dwarf_get_elf 3 ,
.Xr dwarf_init 3 ,
.Xr dwarf_object_init 3
.Xr dwarf_object_init 3 ,
.Xr elf_end 3

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_formaddr.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_formaddr.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_formaddr.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010 Joseph Koshy
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_formaddr.3 2073 2011-10-27 03:30:47Z jkoshy
.\" Id: dwarf_formaddr.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd July 23, 2010
.Os
.Dt DWARF_FORMADDR 3
.Os
.Sh NAME
.Nm dwarf_formaddr
.Nd return the value of an ADDRESS class attribute

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_formblock.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_formblock.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_formblock.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010 Joseph Koshy
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_formblock.3 3182 2015-04-10 16:08:10Z emaste
.\" Id: dwarf_formblock.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd July 23, 2010
.Os
.Dt DWARF_FORMBLOCK 3
.Os
.Sh NAME
.Nm dwarf_formblock
.Nd return the value of a BLOCK attribute

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_formexprloc.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_formexprloc.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_formexprloc.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010 Joseph Koshy
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_formexprloc.3 2073 2011-10-27 03:30:47Z jkoshy
.\" Id: dwarf_formexprloc.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd July 25, 2010
.Os
.Dt DWARF_FORMEXPRLOC 3
.Os
.Sh NAME
.Nm dwarf_formexprloc
.Nd return information about a location expression

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_formflag.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_formflag.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_formflag.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010 Joseph Koshy
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_formflag.3 3181 2015-04-10 13:22:51Z emaste
.\" Id: dwarf_formflag.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd June 21, 2010
.Os
.Dt DWARF_FORMFLAG 3
.Os
.Sh NAME
.Nm dwarf_formflag
.Nd return the value of a BOOLEAN class attribute

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_formref.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_formref.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_formref.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010 Joseph Koshy
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_formref.3 3181 2015-04-10 13:22:51Z emaste
.\" Id: dwarf_formref.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd June 21, 2010
.Os
.Dt DWARF_FORMREF 3
.Os
.Sh NAME
.Nm dwarf_formref ,
.Nm dwarf_global_formref

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_formsig8.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_formsig8.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_formsig8.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010 Joseph Koshy
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_formsig8.3 3181 2015-04-10 13:22:51Z emaste
.\" Id: dwarf_formsig8.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd July 24, 2010
.Os
.Dt DWARF_FORMSIG8 3
.Os
.Sh NAME
.Nm dwarf_formsig8
.Nd return the 64-bit type signature for a DWARF type

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_formstring.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_formstring.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_formstring.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010 Joseph Koshy
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_formstring.3 2073 2011-10-27 03:30:47Z jkoshy
.\" Id: dwarf_formstring.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd July 24, 2010
.Os
.Dt DWARF_FORMSTRING 3
.Os
.Sh NAME
.Nm dwarf_formstring
.Nd return the value of a STRING class attribute

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_formudata.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_formudata.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_formudata.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010 Joseph Koshy
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_formudata.3 3181 2015-04-10 13:22:51Z emaste
.\" Id: dwarf_formudata.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd June 21, 2010
.Os
.Dt DWARF_FORMUDATA 3
.Os
.Sh NAME
.Nm dwarf_formudata ,
.Nm dwarf_formsdata

9
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_AT_name.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_AT_name.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_AT_name.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_AT_name.3 3142 2015-01-29 23:11:14Z jkoshy
.\" Id: dwarf_get_AT_name.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd April 22, 2011
.Os
.Dt DWARF_GET_AT_NAME 3
.Os
.Sh NAME
.Nm dwarf_get_ACCESS_name ,
.Nm dwarf_get_AT_name ,
@ -252,7 +252,8 @@ constants.
.El
.Sh RETURN VALUES
These functions return
.Dv DW_DLV_OK on success.
.Dv DW_DLV_OK
on success.
If the DWARF constant denoted by argument
.Ar val
is not recognized, these function return

48
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_abbrev.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_abbrev.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_abbrev.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_abbrev.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_abbrev.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd March 27, 2011
.Os
.Dt DWARF_GET_ABBREV 3
.Os
.Sh NAME
.Nm dwarf_get_abbrev
.Nd retrieve abbreviation information
@ -125,24 +125,7 @@ In case of an error, it returns
.Dv DW_DLV_ERROR
and sets the argument
.Ar err .
.Sh ERRORS
Function
.Fn dwarf_get_abbrev
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_NO_ENTRY"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar dbg ,
.Ar ret_abbrev ,
.Ar length
or
.Ar attr_count
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
There is no abbreviation information at offset
.Ar offset .
.El
.Sh EXAMPLE
.Sh EXAMPLES
To loop through all the abbreviation information associated with
a DWARF debug context, use:
.Bd -literal -offset indent
@ -172,10 +155,27 @@ while ((ret = dwarf_next_cu_header(dbg, NULL, NULL, &aboff,
if (ret == DW_DLV_ERROR)
warnx("dwarf_next_cu_header: %s", dwarf_errmsg(de));
.Ed
.Sh ERRORS
Function
.Fn dwarf_get_abbrev
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_NO_ENTRY"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar dbg ,
.Ar ret_abbrev ,
.Ar length
or
.Ar attr_count
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
There is no abbreviation information at offset
.Ar offset .
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_dealloc 3 ,
.Xr dwarf_get_abbrev_tag 3 ,
.Xr dwarf_get_abbrev_code 3 ,
.Xr dwarf_get_abbrev_children_flag 3 ,
.Xr dwarf_get_abbrev_entry 3
.Xr dwarf_get_abbrev_code 3 ,
.Xr dwarf_get_abbrev_entry 3 ,
.Xr dwarf_get_abbrev_tag 3

11
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_abbrev_children_flag.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_abbrev_children_flag.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_abbrev_children_flag.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_abbrev_children_flag.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_abbrev_children_flag.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd March 14, 2011
.Os
.Dt DWARF_GET_ABBREV_CHILDREN_FLAG 3
.Os
.Sh NAME
.Nm dwarf_get_abbrev_children_flag
.Nd return a flag indicating the presence of children
@ -71,7 +71,6 @@ If argument
.Ar err
is not NULL, it will be used to store error information in case of an
error.
.Pp
.Sh RETURN VALUES
Function
.Fn dwarf_get_abbrev_children_flag
@ -98,5 +97,5 @@ was NULL.
.Xr dwarf 3 ,
.Xr dwarf_get_abbrev 3 ,
.Xr dwarf_get_abbrev_code 3 ,
.Xr dwarf_get_abbrev_tag 3 ,
.Xr dwarf_get_abbrev_entry 3
.Xr dwarf_get_abbrev_entry 3 ,
.Xr dwarf_get_abbrev_tag 3

10
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_abbrev_code.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_abbrev_code.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_abbrev_code.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_abbrev_code.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_abbrev_code.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd March 13, 2011
.Os
.Dt DWARF_GET_ABBREV_CODE 3
.Os
.Sh NAME
.Nm dwarf_get_abbrev_code
.Nd retrieve the abbreviation code for an abbreviation
@ -83,6 +83,6 @@ was NULL.
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_get_abbrev 3 ,
.Xr dwarf_get_abbrev_tag 3 ,
.Xr dwarf_get_abbrev_children_flag 3 ,
.Xr dwarf_get_abbrev_entry 3
.Xr dwarf_get_abbrev_entry 3 ,
.Xr dwarf_get_abbrev_tag 3

44
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_abbrev_entry.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_abbrev_entry.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_abbrev_entry.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_abbrev_entry.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_abbrev_entry.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd April 02, 2011
.Os
.Dt DWARF_GET_ABBREV_ENTRY 3
.Os
.Sh NAME
.Nm dwarf_get_abbrev_entry
.Nd retrieve attribute information from an abbreviation descriptor
@ -98,25 +98,7 @@ In case of an error, it returns
.Dv DW_DLV_ERROR
and sets the argument
.Ar err .
.Sh ERRORS
Function
.Fn dwarf_get_abbrev_entry
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_NO_ENTRY"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar abbrev ,
.Ar code ,
.Ar form
or
.Ar offset
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
The attribute index specified by argument
.Ar ndx
was out of range.
.El
.Sh EXAMPLE
.Sh EXAMPLES
To loop through all the attribute entries contained in the
abbreviation section, use:
.Bd -literal -offset indent
@ -156,6 +138,24 @@ while ((ret = dwarf_next_cu_header(dbg, NULL, NULL, &aboff,
if (ret == DW_DLV_ERROR)
warnx("dwarf_next_cu_header: %s", dwarf_errmsg(de));
.Ed
.Sh ERRORS
Function
.Fn dwarf_get_abbrev_entry
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_NO_ENTRY"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar abbrev ,
.Ar code ,
.Ar form
or
.Ar offset
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
The attribute index specified by argument
.Ar ndx
was out of range.
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_get_abbrev 3

8
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_abbrev_tag.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_abbrev_tag.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_abbrev_tag.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_abbrev_tag.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_abbrev_tag.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd March 13, 2011
.Os
.Dt DWARF_GET_ABBREV_TAG 3
.Os
.Sh NAME
.Nm dwarf_get_abbrev_tag
.Nd retrieve the tag for an abbreviation
@ -83,6 +83,6 @@ was NULL.
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_get_abbrev 3 ,
.Xr dwarf_get_abbrev_code 3 ,
.Xr dwarf_get_abbrev_children_flag 3 ,
.Xr dwarf_get_abbrev_code 3 ,
.Xr dwarf_get_abbrev_entry 3

10
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_address_size.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_address_size.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_address_size.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_address_size.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_address_size.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd April 14, 2010
.Os
.Dt DWARF_GET_ADDRESS_SIZE 3
.Os
.Sh NAME
.Nm dwarf_get_address_size
.Nd return the number of bytes needed to represent an address
@ -80,5 +80,5 @@ was NULL.
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_init 3 ,
.Xr dwarf_finish 3
.Xr dwarf_finish 3 ,
.Xr dwarf_init 3

8
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_arange.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_arange.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_arange.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_arange.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_arange.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd April 16, 2011
.Os
.Dt DWARF_GET_ARANGE 3
.Os
.Sh NAME
.Nm dwarf_get_arange
.Nd retrieve the address range descriptor for an address
@ -117,7 +117,7 @@ was not found.
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_get_aranges 3 ,
.Xr dwarf_get_arange_cu_header_offset 3 ,
.Xr dwarf_get_arange_info 3 ,
.Xr dwarf_get_aranges 3 ,
.Xr dwarf_get_cu_die_offset 3

38
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_arange_info.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_arange_info.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_arange_info.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_arange_info.3 3142 2015-01-29 23:11:14Z jkoshy
.\" Id: dwarf_get_arange_info.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd April 16, 2011
.Os
.Dt DWARF_GET_ARANGE_INFO 3
.Os
.Sh NAME
.Nm dwarf_get_arange_info
.Nd extract address range information from a descriptor
@ -91,21 +91,7 @@ In case of an error, it returns
.Dv DW_DLV_ERROR
and sets the argument
.Ar err .
.Sh ERRORS
Function
.Fn dwarf_get_arange_info
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_ARGUMENT"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar ar ,
.Ar start ,
.Ar length
or
.Ar cu_die_offset
was NULL.
.El
.Sh EXAMPLE
.Sh EXAMPLES
To loop through all the address lookup table entries, use:
.Bd -literal -offset indent
Dwarf_Debug dbg;
@ -129,9 +115,23 @@ for (i = 0; i < cnt; i++) {
/* Do something with the returned information. */
}
.Ed
.Sh ERRORS
Function
.Fn dwarf_get_arange_info
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_ARGUMENT"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar ar ,
.Ar start ,
.Ar length
or
.Ar cu_die_offset
was NULL.
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_get_arange 3 ,
.Xr dwarf_get_aranges 3 ,
.Xr dwarf_get_arange_cu_header_offset 3 ,
.Xr dwarf_get_aranges 3 ,
.Xr dwarf_get_cu_die_offset 3

46
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_aranges.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_aranges.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_aranges.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_aranges.3 2122 2011-11-09 15:35:14Z jkoshy
.\" Id: dwarf_get_aranges.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd November 9, 2011
.Os
.Dt DWARF_GET_ARANGES 3
.Os
.Sh NAME
.Nm dwarf_get_aranges
.Nd retrieve program address space mappings
@ -98,26 +98,7 @@ In case of an error, it returns
.Dv DW_DLV_ERROR
and sets the argument
.Ar err .
.Sh ERRORS
Function
.Fn dwarf_get_aranges
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_NO_ENTRY"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar dbg ,
.Ar ar_list
or
.Ar ar_cnt
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
The debugging context
.Ar dbg
did not contain a
.Dq ".debug_aranges"
string section.
.El
.Sh EXAMPLE
.Sh EXAMPLES
To loop through all the address lookup table entries, use:
.Bd -literal -offset indent
Dwarf_Debug dbg;
@ -142,6 +123,25 @@ for (i = 0; i < cnt; i++) {
/* Do something with the returned information. */
}
.Ed
.Sh ERRORS
Function
.Fn dwarf_get_aranges
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_NO_ENTRY"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar dbg ,
.Ar ar_list
or
.Ar ar_cnt
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
The debugging context
.Ar dbg
did not contain a
.Dq ".debug_aranges"
string section.
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_get_arange 3 ,

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_cie_index.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_cie_index.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_cie_index.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_cie_index.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_cie_index.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd May 22, 2011
.Os
.Dt DWARF_GET_CIE_INDEX 3
.Os
.Sh NAME
.Nm dwarf_get_cie_index
.Nd retrieve the index of a CIE descriptor

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_cie_info.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_cie_info.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_cie_info.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_cie_info.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_cie_info.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd May 29, 2011
.Os
.Dt DWARF_GET_CIE_INFO 3
.Os
.Sh NAME
.Nm dwarf_get_cie_info
.Nd retrieve information associated with a CIE descriptor

8
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_cie_of_fde.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_cie_of_fde.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_cie_of_fde.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_cie_of_fde.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_cie_of_fde.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd May 22, 2011
.Os
.Dt DWARF_GET_CIE_OF_FDE 3
.Os
.Sh NAME
.Nm dwarf_get_cie_of_fde
.Nd retrieve CIE descriptor
@ -84,7 +84,7 @@ was NULL.
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_get_cie_info 3 ,
.Xr dwarf_get_cie_index 3 ,
.Xr dwarf_get_cie_info 3 ,
.Xr dwarf_get_fde_at_pc 3 ,
.Xr dwarf_get_fde_n 3

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_cu_die_offset.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_cu_die_offset.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_cu_die_offset.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_cu_die_offset.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_cu_die_offset.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd April 10, 2011
.Os
.Dt DWARF_GET_CU_DIE_OFFSET 3
.Os
.Sh NAME
.Nm dwarf_get_arange_cu_header_offset ,
.Nm dwarf_get_cu_die_offset

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_die_infotypes_flag.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_die_infotypes_flag.3,v 1.2 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_die_infotypes_flag.3,v 1.3 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2014 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_die_infotypes_flag.3 3118 2014-12-20 20:30:06Z jkoshy
.\" Id: dwarf_get_die_infotypes_flag.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd December 20, 2014
.Os
.Dt DWARF_GET_DIE_INFOTYPES_FLAG 3
.Os
.Sh NAME
.Nm dwarf_get_die_infotypes_flag
.Nd indicate the originating DWARF section for a DIE

8
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_elf.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_elf.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_elf.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2009 Joseph Koshy. All rights reserved.
.\"
@ -23,11 +23,11 @@
.\" out of the use of this software, even if advised of the possibility of
.\" such damage.
.\"
.\" Id: dwarf_get_elf.3 2122 2011-11-09 15:35:14Z jkoshy
.\" Id: dwarf_get_elf.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd November 9, 2011
.Os
.Dt DWARF_GET_ELF 3
.Os
.Sh NAME
.Nm dwarf_get_elf
.Nd retrieve the
@ -100,6 +100,6 @@ if (dwarf_get_elf(dbg, &elf, &de) != DW_DLV_OK)
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_errmsg 3 ,
.Xr dwarf_init 3 ,
.Xr dwarf_finish 3 ,
.Xr dwarf_init 3 ,
.Xr elf 3

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_at_pc.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_fde_at_pc.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_fde_at_pc.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_fde_at_pc.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_fde_at_pc.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd May 22, 2011
.Os
.Dt DWARF_GET_FDE_AT_PC 3
.Os
.Sh NAME
.Nm dwarf_get_fde_at_pc
.Nd retrieve the FDE descriptor for an address

8
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_info_for_all_regs.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_fde_info_for_all_regs.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_fde_info_for_all_regs.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_fde_info_for_all_regs.3 3182 2015-04-10 16:08:10Z emaste
.\" Id: dwarf_get_fde_info_for_all_regs.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd June 4, 2011
.Os
.Dt DWARF_GET_FDE_INFO_FOR_ALL_REGS 3
.Os
.Sh NAME
.Nm dwarf_get_fde_info_for_all_regs
.Nd retrieve register rule row
@ -152,7 +152,7 @@ did not fall in the range covered by argument
.Xr dwarf_get_fde_info_for_reg3 3 ,
.Xr dwarf_get_fde_n 3 ,
.Xr dwarf_set_frame_cfa_value 3 ,
.Xr dwarf_set_frame_rule_table_size 3 ,
.Xr dwarf_set_frame_rule_initial_value 3 ,
.Xr dwarf_set_frame_rule_table_size 3 ,
.Xr dwarf_set_frame_same_value 3 ,
.Xr dwarf_set_frame_undefined_value 3

8
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_info_for_all_regs3.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_fde_info_for_all_regs3.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_fde_info_for_all_regs3.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_fde_info_for_all_regs3.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_fde_info_for_all_regs3.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd June 26, 2011
.Os
.Dt DWARF_GET_FDE_INFO_FOR_ALL_REGS3 3
.Os
.Sh NAME
.Nm dwarf_get_fde_info_for_all_regs3
.Nd retrieve register rule row
@ -179,7 +179,7 @@ did not fall in the range covered by argument
.Xr dwarf_get_fde_info_for_reg3 3 ,
.Xr dwarf_get_fde_n 3 ,
.Xr dwarf_set_frame_cfa_value 3 ,
.Xr dwarf_set_frame_rule_table_size 3 ,
.Xr dwarf_set_frame_rule_initial_value 3 ,
.Xr dwarf_set_frame_rule_table_size 3 ,
.Xr dwarf_set_frame_same_value 3 ,
.Xr dwarf_set_frame_undefined_value 3

8
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_info_for_cfa_reg3.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_fde_info_for_cfa_reg3.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_fde_info_for_cfa_reg3.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_fde_info_for_cfa_reg3.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_fde_info_for_cfa_reg3.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd June 12, 2011
.Os
.Dt DWARF_GET_FDE_INFO_FOR_CFA_REGS3 3
.Os
.Sh NAME
.Nm dwarf_get_fde_info_for_cfa_regs3
.Nd retrieve a CFA register rule
@ -167,7 +167,7 @@ did not fall in the range covered by argument
.Xr dwarf_get_fde_info_for_reg3 3 ,
.Xr dwarf_get_fde_n 3 ,
.Xr dwarf_set_frame_cfa_value 3 ,
.Xr dwarf_set_frame_rule_table_size 3 ,
.Xr dwarf_set_frame_rule_initial_value 3 ,
.Xr dwarf_set_frame_rule_table_size 3 ,
.Xr dwarf_set_frame_same_value 3 ,
.Xr dwarf_set_frame_undefined_value 3

8
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_info_for_reg.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_fde_info_for_reg.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_fde_info_for_reg.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_fde_info_for_reg.3 3181 2015-04-10 13:22:51Z emaste
.\" Id: dwarf_get_fde_info_for_reg.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd June 4, 2011
.Os
.Dt DWARF_GET_FDE_INFO_FOR_REG 3
.Os
.Sh NAME
.Nm dwarf_get_fde_info_for_reg
.Nd retrieve register rule
@ -152,7 +152,7 @@ did not fall in the range covered by argument
.Xr dwarf_get_fde_info_for_reg3 3 ,
.Xr dwarf_get_fde_n 3 ,
.Xr dwarf_set_frame_cfa_value 3 ,
.Xr dwarf_set_frame_rule_table_size 3 ,
.Xr dwarf_set_frame_rule_initial_value 3 ,
.Xr dwarf_set_frame_rule_table_size 3 ,
.Xr dwarf_set_frame_same_value 3 ,
.Xr dwarf_set_frame_undefined_value 3

62
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_info_for_reg3.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_fde_info_for_reg3.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_fde_info_for_reg3.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_fde_info_for_reg3.3 2122 2011-11-09 15:35:14Z jkoshy
.\" Id: dwarf_get_fde_info_for_reg3.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd November 9, 2011
.Os
.Dt DWARF_GET_FDE_INFO_FOR_REG3 3
.Os
.Sh NAME
.Nm dwarf_get_fde_info_for_reg3
.Nd retrieve register rule
@ -142,33 +142,7 @@ In case of an error, it returns
.Dv DW_DLV_ERROR
and sets the argument
.Ar err .
.Sh ERRORS
Function
.Fn dwarf_get_fde_info_for_reg3
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_FRAME_TABLE_COL_BAD"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar block_ptr ,
.Ar fde ,
.Ar offset_or_block_len ,
.Ar offset_relevant ,
.Ar register_num ,
.Ar row_pc ,
or
.Ar type
was NULL.
.It Bq Er DW_DLE_FRAME_TABLE_COL_BAD
The column number provided in argument
.Ar table_column
was too large.
.It Bq Er DW_DLE_PC_NOT_IN_FDE_RANGE
The program counter value provided in argument
.Ar pc
did not fall in the range covered by argument
.Ar fde .
.El
.Sh EXAMPLE
.Sh EXAMPLES
To retrieve the register rules at column 3 from a rule table
associated with a FDE descriptor:
.Bd -literal -offset indent
@ -201,6 +175,32 @@ for (pc = low_pc; pc < low_pc + func_len; pc++) {
/* ... use the retrieved register rule ... */
}
.Ed
.Sh ERRORS
Function
.Fn dwarf_get_fde_info_for_reg3
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_FRAME_TABLE_COL_BAD"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar block_ptr ,
.Ar fde ,
.Ar offset_or_block_len ,
.Ar offset_relevant ,
.Ar register_num ,
.Ar row_pc ,
or
.Ar type
was NULL.
.It Bq Er DW_DLE_FRAME_TABLE_COL_BAD
The column number provided in argument
.Ar table_column
was too large.
.It Bq Er DW_DLE_PC_NOT_IN_FDE_RANGE
The program counter value provided in argument
.Ar pc
did not fall in the range covered by argument
.Ar fde .
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_get_fde_at_pc 3 ,
@ -210,7 +210,7 @@ for (pc = low_pc; pc < low_pc + func_len; pc++) {
.Xr dwarf_get_fde_info_for_reg 3 ,
.Xr dwarf_get_fde_n 3 ,
.Xr dwarf_set_frame_cfa_value 3 ,
.Xr dwarf_set_frame_rule_table_size 3 ,
.Xr dwarf_set_frame_rule_initial_value 3 ,
.Xr dwarf_set_frame_rule_table_size 3 ,
.Xr dwarf_set_frame_same_value 3 ,
.Xr dwarf_set_frame_undefined_value 3

10
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_instr_bytes.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_fde_instr_bytes.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_fde_instr_bytes.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_fde_instr_bytes.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_fde_instr_bytes.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd May 23, 2011
.Os
.Dt DWARF_GET_FDE_INSTR_BYTES 3
.Os
.Sh NAME
.Nm dwarf_get_fde_instr_bytes
.Nd retrieve instructions from FDE descritpor
@ -100,9 +100,9 @@ was NULL.
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_expand_frame_instructions 3 ,
.Xr dwarf_get_cie_info 3 ,
.Xr dwarf_get_cie_index 3 ,
.Xr dwarf_get_cie_of_fde ,
.Xr dwarf_get_cie_info 3 ,
.Xr dwarf_get_cie_of_fde 3 ,
.Xr dwarf_get_fde_at_pc 3 ,
.Xr dwarf_get_fde_info_for_all_regs 3 ,
.Xr dwarf_get_fde_info_for_all_regs3 3 ,

44
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_list.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_fde_list.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_fde_list.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_fde_list.3 2122 2011-11-09 15:35:14Z jkoshy
.\" Id: dwarf_get_fde_list.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd November 9, 2011
.Os
.Dt DWARF_GET_FDE_LIST 3
.Os
.Sh NAME
.Nm dwarf_get_fde_list
.Nd retrieve frame information
@ -134,23 +134,7 @@ In case of an error, they return
.Dv DW_DLV_ERROR
and set the argument
.Ar err .
.Sh ERRORS
These functions may fail with the following errors:
.Bl -tag -width ".Bq Er DW_DLE_ARGUMENT"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Va dbg ,
.Va cie_list ,
.Va cie_count ,
.Va fde_list
or
.Va fde_count
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
There is no frame information associated with the giving DWARF debug
context.
.El
.Sh EXAMPLE
.Sh EXAMPLES
To obtain frame information from the
.Dq ".debug_frame"
section, use:
@ -204,17 +188,33 @@ for (i = 0; i < fde_count; i++) {
dwarf_fde_cie_list_dealloc(dbg, cie_list, cie_count, fde_list,
fde_count);
.Ed
.Sh ERRORS
These functions may fail with the following errors:
.Bl -tag -width ".Bq Er DW_DLE_ARGUMENT"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Va dbg ,
.Va cie_list ,
.Va cie_count ,
.Va fde_list
or
.Va fde_count
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
There is no frame information associated with the giving DWARF debug
context.
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_fde_cie_list_dealloc 3 ,
.Xr dwarf_get_cie_index 3 ,
.Xr dwarf_get_cie_of_fde 3 ,
.Xr dwarf_get_fde_at_pc 3 ,
.Xr dwarf_get_fde_instr_bytes 3 ,
.Xr dwarf_get_fde_n 3 ,
.Xr dwarf_get_fde_range 3 ,
.Xr dwarf_fde_cie_list_dealloc 3 ,
.Xr dwarf_set_frame_cfa_value 3 ,
.Xr dwarf_set_frame_rule_table_size 3 ,
.Xr dwarf_set_frame_rule_initial_value 3 ,
.Xr dwarf_set_frame_rule_table_size 3 ,
.Xr dwarf_set_frame_same_value 3 ,
.Xr dwarf_set_frame_undefined_value 3

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_n.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_fde_n.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_fde_n.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_fde_n.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_fde_n.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd May 14, 2011
.Os
.Dt DWARF_GET_FDE_N 3
.Os
.Sh NAME
.Nm dwarf_get_fde_n
.Nd retrieve FDE descriptor

10
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_range.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_fde_range.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_fde_range.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_fde_range.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_fde_range.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd May 22, 2011
.Os
.Dt DWARF_GET_FDE_RANGE 3
.Os
.Sh NAME
.Nm dwarf_get_fde_range
.Nd retrieve range information from an FDE descriptor
@ -136,9 +136,9 @@ was NULL.
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_get_cie_info 3 ,
.Xr dwarf_get_cie_index 3 ,
.Xr dwarf_get_cie_of_fde ,
.Xr dwarf_get_cie_info 3 ,
.Xr dwarf_get_cie_of_fde 3 ,
.Xr dwarf_get_fde_at_pc 3 ,
.Xr dwarf_get_fde_info_for_all_regs 3 ,
.Xr dwarf_get_fde_info_for_all_regs3 3 ,

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_form_class.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_form_class.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_form_class.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_form_class.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_form_class.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd June 26, 2011
.Os
.Dt DWARF_GET_FORM_CLASS 3
.Os
.Sh NAME
.Nm dwarf_get_form_class
.Nd retrieve the form class of an attribute

10
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_funcs.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_funcs.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_funcs.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_funcs.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_funcs.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd April 10, 2011
.Os
.Dt DWARF_GET_FUNCS 3
.Os
.Sh NAME
.Nm dwarf_get_funcs ,
.Nm dwarf_func_cu_offset ,
@ -213,5 +213,5 @@ did not contain information about static functions.
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_get_cu_die_offset_given_cu_header_offset 3 ,
.Xr dwarf_funcs_dealloc 3
.Xr dwarf_funcs_dealloc 3 ,
.Xr dwarf_get_cu_die_offset_given_cu_header_offset 3

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_globals.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_globals.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_globals.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_globals.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_globals.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd April 2, 2011
.Os
.Dt DWARF_GET_GLOBALS 3
.Os
.Sh NAME
.Nm dwarf_get_globals ,
.Nm dwarf_global_cu_offset ,

50
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_loclist_entry.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_loclist_entry.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_loclist_entry.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_loclist_entry.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_loclist_entry.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd July 6, 2011
.Os
.Dt DWARF_GET_LOCLIST_ENTRY 3
.Os
.Sh NAME
.Nm dwarf_get_loclist_entry
.Nd retrieve DWARF location list entry
@ -110,26 +110,7 @@ In case of an error, it returns
.Dv DW_DLV_ERROR
and sets the argument
.Ar err .
.Sh ERRORS
Function
.Fn dwarf_get_loclist_entry
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_NO_ENTRY"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar dbg ,
.Ar hipc ,
.Ar lopc ,
.Ar data ,
.Ar entry_len
or
.Ar next_entry
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
There is no location list at the specified offset
.Ar offset .
.El
.Sh EXAMPLE
.Sh EXAMPLES
To iterate through all the location list entries in the
.Dq ".debug_loc"
section, use:
@ -150,9 +131,28 @@ while ((ret = dwarf_get_loclist_entry(dbg, off, &hipc, &lopc, &data,
if (ret == DW_DLV_ERROR)
warnx("dwarf_get_loclist_entry failed: %s", dwarf_errmsg(de));
.Ed
.Sh ERRORS
Function
.Fn dwarf_get_loclist_entry
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_NO_ENTRY"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar dbg ,
.Ar hipc ,
.Ar lopc ,
.Ar data ,
.Ar entry_len
or
.Ar next_entry
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
There is no location list at the specified offset
.Ar offset .
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_loclist 3 ,
.Xr dwarf_loclist_n 3 ,
.Xr dwarf_loclist_from_expr 3 ,
.Xr dwarf_loclist_from_expr_a 3
.Xr dwarf_loclist_from_expr_a 3 ,
.Xr dwarf_loclist_n 3

40
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_macro_details.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_macro_details.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_macro_details.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_macro_details.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_macro_details.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd March 20, 2011
.Os
.Dt DWARF_GET_MACRO_DETAILS 3
.Os
.Sh NAME
.Nm dwarf_get_macro_details
.Nd retrieve macro information
@ -152,23 +152,7 @@ In case of an error, it returns
.Dv DW_DLV_ERROR
and sets the argument
.Ar err .
.Sh ERRORS
Function
.Fn dwarf_get_macro_details
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_NO_ENTRY"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar dbg ,
.Ar entry_cnt
or
.Ar details
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
There is no more macro information at the specified offset
.Ar offset .
.El
.Sh EXAMPLE
.Sh EXAMPLES
To loop through all the macro information entries associated with
a DWARF debug context:
.Bd -literal -offset indent
@ -187,6 +171,22 @@ while (dwarf_get_macro_details(dbg, offset, 0,
offset = md[cnt - 1].dmd_offset + 1;
}
.Ed
.Sh ERRORS
Function
.Fn dwarf_get_macro_details
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_NO_ENTRY"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar dbg ,
.Ar entry_cnt
or
.Ar details
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
There is no more macro information at the specified offset
.Ar offset .
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_dealloc 3 ,

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_pubtypes.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_pubtypes.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_pubtypes.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_pubtypes.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_pubtypes.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd April 4, 2011
.Os
.Dt DWARF_GET_PUBTYPES 3
.Os
.Sh NAME
.Nm dwarf_get_pubtypes ,
.Nm dwarf_pubtype_cu_offset ,

70
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_ranges.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_ranges.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_ranges.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_ranges.3 3182 2015-04-10 16:08:10Z emaste
.\" Id: dwarf_get_ranges.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd November 9, 2011
.Os
.Dt DWARF_GET_RANGES 3
.Os
.Sh NAME
.Nm dwarf_get_ranges
.Nd retrieve non-contiguous address ranges
@ -161,23 +161,6 @@ The application should not attempt to directly free this pointer.
Portable code should instead use
.Fn dwarf_ranges_dealloc
to indicate that the memory may be freed.
.Sh COMPATIBILITY
Function
.Fn dwarf_get_ranges_a
is identical to
.Fn dwarf_get_ranges ,
except that it requires one additional argument
.Ar die
denoting the debugging information entry associated with
the address range list.
In this implementation of the
.Lb libdwarf ,
the argument
.Ar die
is ignored, and function
.Fn dwarf_get_ranges_a
is only provided for compatibility with other implementations of the
DWARF(3) API.
.Sh RETURN VALUES
These functions
return
@ -191,21 +174,7 @@ In case of an error, they return
.Dv DW_DLV_ERROR
and set the argument
.Ar err .
.Sh ERRORS
These function can fail with:
.Bl -tag -width ".Bq Er DW_DLE_NO_ENTRY"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar dbg ,
.Ar ranges
or
.Ar cnt
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
There is no address range list at the specified offset
.Ar offset .
.El
.Sh EXAMPLE
.Sh EXAMPLES
To retrieve the address range list associated with a debugging
information entry, use:
.Bd -literal -offset indent
@ -255,6 +224,37 @@ for (i = 0; (Dwarf_Unsigned) i < attr_count; i++) {
}
}
.Ed
.Sh COMPATIBILITY
Function
.Fn dwarf_get_ranges_a
is identical to
.Fn dwarf_get_ranges ,
except that it requires one additional argument
.Ar die
denoting the debugging information entry associated with
the address range list.
In this implementation of the
.Lb libdwarf ,
the argument
.Ar die
is ignored, and function
.Fn dwarf_get_ranges_a
is only provided for compatibility with other implementations of the
DWARF(3) API.
.Sh ERRORS
These function can fail with:
.Bl -tag -width ".Bq Er DW_DLE_NO_ENTRY"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar dbg ,
.Ar ranges
or
.Ar cnt
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
There is no address range list at the specified offset
.Ar offset .
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_ranges_dealloc 3

60
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_relocation_info.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_relocation_info.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_relocation_info.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_relocation_info.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_relocation_info.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd September 3, 2011
.Os
.Dt DWARF_GET_RELOCATION_INFO 3
.Os
.Sh NAME
.Nm dwarf_get_relocation_info
.Nd retrieve generated relocation arrays
@ -149,32 +149,6 @@ returns
.Dv DW_DLV_ERROR
and sets the argument
.Ar err .
.Sh ERRORS
Function
.Fn dwarf_get_relocation_info
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_NO_ENTRY"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar dbg ,
.Ar elf_section_index ,
.Ar elf_section_link ,
.Ar reloc_entry_count
or
.Ar reloc_buf
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
There were no more ELF relocation arrays to retrieve.
.It Bq Er DW_DLE_NO_ENTRY
The flag
.Dv DW_DLC_SYMBOLIC_RELOCATIONS
was not set on the producer instance.
.It Bq Er DW_DLE_NO_ENTRY
Function
.Xr dwarf_transform_to_disk_form 3
was not called prior to calling function
.Fn dwarf_get_relocation_info .
.El
.Sh EXAMPLES
To generate relocation entries and retrieve them, use:
.Bd -literal -offset indent
@ -220,11 +194,37 @@ for (i = 0; (Dwarf_Unsigned) i < reloc_cnt; i++) {
dwarf_producer_finish(dbg, &de);
.Ed
.Sh ERRORS
Function
.Fn dwarf_get_relocation_info
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_NO_ENTRY"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar dbg ,
.Ar elf_section_index ,
.Ar elf_section_link ,
.Ar reloc_entry_count
or
.Ar reloc_buf
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
There were no more ELF relocation arrays to retrieve.
.It Bq Er DW_DLE_NO_ENTRY
The flag
.Dv DW_DLC_SYMBOLIC_RELOCATIONS
was not set on the producer instance.
.It Bq Er DW_DLE_NO_ENTRY
Function
.Xr dwarf_transform_to_disk_form 3
was not called prior to calling function
.Fn dwarf_get_relocation_info .
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_get_relocation_info_count 3 ,
.Xr dwarf_reset_section_bytes 3 ,
.Xr dwarf_producer_finish 3 ,
.Xr dwarf_producer_init 3 ,
.Xr dwarf_producer_init_b 3 ,
.Xr dwarf_reset_section_bytes 3 ,
.Xr dwarf_transform_to_disk_form 3

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_relocation_info_count.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_relocation_info_count.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_relocation_info_count.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_relocation_info_count.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_relocation_info_count.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd September 3, 2011
.Os
.Dt DWARF_GET_RELOCATION_INFO_COUNT 3
.Os
.Sh NAME
.Nm dwarf_get_relocation_info_count
.Nd return the number of relocation arrays

42
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_section_bytes.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_section_bytes.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_section_bytes.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_section_bytes.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_section_bytes.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd August 26, 2011
.Os
.Dt DWARF_GET_SECTION_BYTES 3
.Os
.Sh NAME
.Nm dwarf_get_section_bytes
.Nd retrieve ELF section byte streams
@ -98,23 +98,6 @@ In case of an error, function
.Fn dwarf_get_section_bytes
will return NULL and set the argument
.Ar err .
.Sh ERRORS
Function
.Fn dwarf_get_section_bytes
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_NO_ENTRY"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar dbg ,
.Ar elf_section_index ,
or
.Ar length
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
There were no more ELF sections to retrieve, or the function was
called before a call to
.Xr dwarf_transform_to_disk_form 3 .
.El
.Sh EXAMPLES
To generate and retrieve ELF section byte streams, use:
.Bd -literal -offset indent
@ -150,10 +133,27 @@ for (i = 0; i < count; i++) {
/* Release resources. */
dwarf_producer_finish(dbg, &de);
.Ed
.Sh ERRORS
Function
.Fn dwarf_get_section_bytes
can fail with:
.Bl -tag -width ".Bq Er DW_DLE_NO_ENTRY"
.It Bq Er DW_DLE_ARGUMENT
One of the arguments
.Ar dbg ,
.Ar elf_section_index ,
or
.Ar length
was NULL.
.It Bq Er DW_DLE_NO_ENTRY
There were no more ELF sections to retrieve, or the function was
called before a call to
.Xr dwarf_transform_to_disk_form 3 .
.El
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_reset_section_bytes 3 ,
.Xr dwarf_producer_finish 3 ,
.Xr dwarf_producer_init 3 ,
.Xr dwarf_producer_init_b 3 ,
.Xr dwarf_reset_section_bytes 3 ,
.Xr dwarf_transform_to_disk_form 3

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_section_max_offsets.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_section_max_offsets.3,v 1.2 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_section_max_offsets.3,v 1.3 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2014 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_section_max_offsets.3 3141 2015-01-29 23:11:10Z jkoshy
.\" Id: dwarf_get_section_max_offsets.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd December 21, 2014
.Dt DWARF_GET_SECTION_MAX_OFFSETS 3
.Os
.Dt DWARF_GET_SECTION_MAX_OFFSETS
.Sh NAME
.Nm dwarf_get_section_max_offsets ,
.Nm dwarf_get_section_max_offsets_b

46
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_str.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_str.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_str.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_str.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_str.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd April 3, 2011
.Os
.Dt DWARF_GET_STR 3
.Os
.Sh NAME
.Nm dwarf_get_str
.Nd retrieve a string from the DWARF string section
@ -97,6 +97,26 @@ In case of an error, it returns
.Dv DW_DLV_ERROR
and sets the argument
.Ar err .
.Sh EXAMPLES
To retrieve all the strings in the DWARF string section, use:
.Bd -literal -offset indent
Dwarf_Debug dbg;
Dwarf_Off offset;
Dwarf_Signed len;
Dwarf_Error de;
char *str;
int ret
offset = 0;
while ((ret = dwarf_get_str(dbg, offset, &str, &len, &de)) ==
DW_DLV_OK) {
/* .. Use the retrieved string. .. */
offset += len + 1; /* Account for the terminating NUL. */
}
if (ret == DW_DLV_ERROR)
warnx("dwarf_get_str: %s", dwarf_errmsg(de));
.Ed
.Sh ERRORS
Function
.Fn dwarf_get_str
@ -126,26 +146,6 @@ was at the very end of the
.Dq ".debug_str"
section.
.El
.Sh EXAMPLE
To retrieve all the strings in the DWARF string section, use:
.Bd -literal -offset indent
Dwarf_Debug dbg;
Dwarf_Off offset;
Dwarf_Signed len;
Dwarf_Error de;
char *str;
int ret
offset = 0;
while ((ret = dwarf_get_str(dbg, offset, &str, &len, &de)) ==
DW_DLV_OK) {
/* .. Use the retrieved string. .. */
offset += len + 1; /* Account for the terminating NUL. */
}
if (ret == DW_DLV_ERROR)
warnx("dwarf_get_str: %s", dwarf_errmsg(de));
.Ed
.Sh SEE ALSO
.Xr dwarf 3 ,
.Xr dwarf_init 3

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_types.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_types.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_types.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_types.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_types.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd April 10, 2011
.Os
.Dt DWARF_GET_TYPES 3
.Os
.Sh NAME
.Nm dwarf_get_types ,
.Nm dwarf_type_cu_offset ,

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_vars.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_vars.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_vars.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_vars.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_vars.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd April 2, 2011
.Os
.Dt DWARF_GET_VARS 3
.Os
.Sh NAME
.Nm dwarf_get_vars ,
.Nm dwarf_var_cu_offset ,

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_get_weaks.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_get_weaks.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_get_weaks.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2011 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_get_weaks.3 2071 2011-10-27 03:20:00Z jkoshy
.\" Id: dwarf_get_weaks.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd April 10, 2011
.Os
.Dt DWARF_GET_WEAKS 3
.Os
.Sh NAME
.Nm dwarf_get_weaks ,
.Nm dwarf_weak_cu_offset ,

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_hasattr.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_hasattr.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_hasattr.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_hasattr.3 3181 2015-04-10 13:22:51Z emaste
.\" Id: dwarf_hasattr.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd April 17, 2010
.Os
.Dt DWARF_HASATTR 3
.Os
.Sh NAME
.Nm dwarf_hasattr
.Nd check for the presence of an attribute

6
external/bsd/elftoolchain/dist/libdwarf/dwarf_hasform.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_hasform.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_hasform.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010 Joseph Koshy. All rights reserved.
.\"
@ -23,11 +23,11 @@
.\" out of the use of this software, even if advised of the possibility of
.\" such damage.
.\"
.\" Id: dwarf_hasform.3 2073 2011-10-27 03:30:47Z jkoshy
.\" Id: dwarf_hasform.3 3640 2018-10-14 14:09:13Z jkoshy
.\"
.Dd May 22, 2010
.Os
.Dt DWARF_HASFORM 3
.Os
.Sh NAME
.Nm dwarf_hasform ,
.Nm dwarf_whatform ,

13
external/bsd/elftoolchain/dist/libdwarf/dwarf_highpc.3 vendored
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dwarf_highpc.3,v 1.3 2016/02/20 02:43:41 christos Exp $
.\" $NetBSD: dwarf_highpc.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
.\"
.\" Copyright (c) 2010,2014 Kai Wang
.\" All rights reserved.
@ -24,11 +24,11 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Id: dwarf_highpc.3 3092 2014-09-02 22:09:30Z kaiwang27
.\" Id: dwarf_highpc.3 3644 2018-10-15 19:55:01Z jkoshy
.\"
.Dd July 22, 2014
.Os
.Dt DWARF_HIGHPC 3
.Os
.Sh NAME
.Nm dwarf_arrayorder ,
.Nm dwarf_bitoffset ,
@ -157,7 +157,8 @@ or
if the caller is not interested in the respective value.
.Sh RETURN VALUES
These functions return
.Dv DW_DLV_OK on success.
.Dv DW_DLV_OK
on success.
.Pp
If the debugging information entry descriptor denoted by argument
.Ar die
@ -191,5 +192,5 @@ had no requested attribute.
.Xr dwarf 3 ,
.Xr dwarf_attr 3 ,
.Xr dwarf_attrlist 3 ,
.Xr dwarf_hasattr 3 ,
.Xr dwarf_get_form_class 3
.Xr dwarf_get_form_class 3 ,
.Xr dwarf_hasattr 3

Some files were not shown because too many files have changed in this diff Show More