.\"--- @(#)template.sh 1.14 90/12/06 SMI; 
'\" tep
.\" %\&Z%%\&M% %\&I% %\&E% SMI; from _source_
.TH ER_MAPGEN 1 "16 June 1998"
.SH NAME
er_mapgen \- generates a mapfile using an experiment that has been generated by
the          
.B
Sampling Collector
in the 
.B
Sun WorkShop Debugging window.
.SH SYNOPSIS
.B er_mapgen 
.B \-l 
.I experiment
.sp .5 
.B er_mapgen
[
\f4\-c\f2 "seg1,seg2" .\|.\|.\f1
]
[
\f4\-s\f2 "sample_selection"\f1
]
[
.B \-o 
.I mapfile
]
.I experiment
.SH AVAILABILITY
.LP
Available with ANSI C and Sun FORTRAN, C++, and Assembler.
.SH DESCRIPTION
.IX "_1st_index_term_" "_2nd_index_term_" "_format_of_1st_" "_format_of_2nd_"
.LP
.B
er_mapgen 
is a utility that generates a mapfile from an experiment that
has been generated by using the 
.B
Sampling Collector
in the
.B
Sun WorkShop Debugging window.
This mapfile can be used with the static linker
.B
ld
to relink the application in order to create an executable with a
smaller working set size.  
.SH OPTIONS
.TP 17
.B \-c 
Choose segment coverage; only the named segments will be used when
generating the mapfile.
.TP
.B \-o 
Create the mapfile named in this option.
.TP
.B \-s
Choose sample selection; only these samples will be used when generating
the mapfile.  The default selection is all samples selected.  Sample
selection can be a single sample, a range of samples, or single samples
and a range of samples (for example:  7, or 7-17, or 5-13,21,27,31-35).
.TP
.B \-l
Give a list of the segments that can be used with the 
.B
-c
option.
.SH "SEE ALSO"
.BR dbx(1), 
.BR debugger(1), 
.BR analyzer(1),
.BR ld(1),
.BR er_print(1),
.BR er_export(1)