.Dd $Mdocdate$

.Dt DWARFGEN \&1 "dwarfdump and libdwarf"

.Os

.Sh NAME

.Nm dwarfgen

.Nd generate example DWARF data.

.Sh SYNOPSIS

.Nm

.Op Fl t Ar type

.Op Fl o Ar outpath

.Op Fl c cunum

.Ar pathname

.

.Sh DESCRIPTION

The

.Nm

creates DWARF sections as requested by specific options.

.Pp

Using some information source, create a tree of dwarf

information (speaking of a DIE tree).

Turn the die tree into dwarfdata using libdwarf producer

and write the resulting data in an object file.

It is a bit inconsistent in error handling just to

demonstrate the various possibilities using the producer

library.

.Pp

Main options:

.Bl -tag -compact

.It Fl t Ar type

what sort of input to read.  May be one of:

.Bl -tag -compact

.It Ar def

means predefined (no input is read, the output

is based on some canned setups built into dwarfgen).

.Ar path

is ignored in this case. This is the default, and does not work.

.It Ar obj

means

.Ar path

is the object file to

read (The dwarf sections are duplicated in the output file.)

Requires 

.Ar path .

.It Ar txt

.Ar path

contains plain text

(in a form rather like output by dwarfdump)

that defines the dwarf that is to be output.

Requires 

.Ar path .

.El

.

.It Fl o Ar outpath

specifies the pathname of the output object. If not supplied,

.Pa testout.o

is used as the default output path.

.

.It Fl c Ar cunum

supplies a CU number of the

.Ql obj

.Ar type

input to read .

.\" not "output" ??? jkl

because the dwarf producer wants just one CU.

Default is -1 which won't match anything.

.El

.Pp

Other options:

.Bl -tag -compact

.It Fl h

transform high PC to const. 

.It Fl s

output as text.

.It Fl r

show relocation details.

.It Fl v Ar version

DWARF version 2, 3, 4, or 5. 

.It Fl p Ar size

pointer size, 4 or 8.

.It Fl f Ar offset

offset size, 4 or 8.

.El

.

.\" .Sh ENVIRONMENT

.\" For sections 1, 6, 7, and 8 only.

.\" .Sh FILES

.\" .Sh EXIT	STATUS

.\" For sections 1, 6, and 8 only.

.\" .Sh EXAMPLES

.\" .Sh DIAGNOSTICS

.\" For sections 1, 4, 6, 7, 8, and 9 printf/stderr messages only.

.\" .Sh SEE ALSO

.\" .Xr foobar 1

.\" .Sh STANDARDS

.\" .Sh HISTORY

.\" .Sh AUTHORS

.\" .Sh CAVEATS

.\" .Sh BUGS