NAME
gnatelim - eliminate dead code from Ada programs
SYNOPSIS
gnatelim [OPTION]... name
DESCRIPTION
When you are working with a program which shares some set of Ada
packages with other programs, it may happen, that your program uses
only a part of subprogram defined in these packages, whereas the code
created for unused subprograms increases the size of the executable
your program.
gnatelim is a utility tracking unused subprograms in an Ada program.
Its output consists of a list of Eliminate pragmas marking all the
subprograms that are declared, but never called in a given program.
Eliminate is a GNAT-specific pragma. By ecompiling your program with
these pragmas, you may decrease the size of its executable, because the
compiler will not create the code for unused subprograms.
gnatelim is an ASIS application developed on top of the ASIS
implementation for GNAT. It needs a set of tree files representing a
program to analyze and the bind file for its main subprogram to be
created in the current directory. For the current version, it is a the
user’s responsibility to maintain the consistency of the set of tree
files processed by gnatelim, if the user also changes the sources of
the Ada program to be processed.
To produce a list of Eliminate pragmas, gnatelim has to do an extensive
analysis and it may take some time. For example, to process itself,
gnatelim takes 4 minutes of CPU time on a Pentium 200.
OPTIONS
-v verbose mode: gnatelim version information is printed (in the
form of Ada comments) in stdout; the names of the files being
processed are printed to standard-error.
-vf Same as -v, but in addition various debugging information and
information reflecting some details of the analysis done by
gnatelim are printed to standard-error.
-a Process RTL components: by default, gnatelim does not analyze
the units which are the components of the GNAT Run-Time Library
(RTL), and it does not generate Eliminate pragmas for
subprograms declared in the RTL. If ’-a’ option is set, RTL
components are also analyzed (except some units, which contains
subprograms implicitly called by the compiler).
-m Check missed units: if this option is set, gnatelim checks that
all the units which (according to the bind file) has to be
analyzed by gnatelim are really represented by the set of tree
files processed by gnatelim (depending on whether or not ’-a’
option is set). By default (that is, if ’-m’ option is not set),
gnatelim analyzes a set of units represented by a given set of
tree files "as is" (excluding library packages which require
bodies, but for which bodies are not available).
AUTHOR
ASIS-for-GNAT was originally developed by the ASIS-for-GNAT team at
the Software Engineering Laboratory of the Swiss Federal
Institute of Technology (LGL-EPFL) in Lausanne, Switzerland, in
cooperation with the Scientific Research Computer Center of Moscow
State University (SRCC MSU), Russia, with funding partially provided
by grants from the Swiss National Science Foundation and the Swiss
Academy of Engineering Sciences. ASIS-for-GNAT is now maintained by
Ada Core Technologies Inc (http://www.gnat.com).
This manual page was written by Ludovic Brenta <ludovic@ludovic-
brenta.org> for the Debian project.
COPYRIGHT
Copyright (c) 1995-1997, Free Software Foundation, Inc.
SEE ALSO
asistant(1), gnat(1), gnatcheck(1), gnatmetric(1), gnatpp(1),
gnatstub(1)
The full documentation for gnatelim in /usr/share/doc/asis-
programs/README.gnatelim
info asis_ug ASIS-for-GNAT User’s Guide
info asis_rm ASIS-for-GNAT Reference Manual