iar(1) CLIX iar(1)
NAME
iar - Reports information about executable modules, archives, and object
files
SYNOPSIS
iar [-y] [-c compiler] [-v version] [-t version_comparison_operator] [-w
assembler_version] [-r assembler_comparison_operator] [-d date] [-p
target_processor] [-s date_comparison_operator] [-n report_filename] [-o
optimization_level] [-q optimization_comparison_operator] [filename...]
FLAGS
-y Prints only a summary report. No information on individual files
is produced.
-c compiler
Reports only the files compiled with the specified compiler. The
valid compilers are clipper, gnuc, greenhills, and all (specifies
all files compiled with all available compilers). The default is
all.
-v version
Reports only the files which meet the version specification. Note
that if compiler is not specified, the version specifications are
not honored. The valid versions of compilers are as follows:
Clipper all, the version number specified in the form nn.nn
GNUC all, the version number specified in the form
nn.nn.nnn
GreenHills all, 1.8.4, 1.8.4A, 1.8.4B, and 1.8.4C
The default value for either compiler is all.
-t version_comparison_operator
Sets up search criteria for version. Note that if version is not
specified, the version comparison specifications are not honored.
The valid versions comparison operators are as follows: lt, le, eq,
ge, and gt. The default is eq.
-w assembler_version
Reports only the files built with the specified version of the
assembler. The assembler_version is specified in the form
nn.nn[nn]. The default is all.
-r assembler_comparison_operator
Sets up search criteria for the assembler version. Note that if
assembler_version is not specified, the assembler version
2/94 - Intergraph Corporation 1
iar(1) CLIX iar(1)
comparison specifications are not honored. The valid assembler
versions comparison operators are as follows: lt, le, eq, ge, and
gt. The default is eq.
-d date
Reports only the files which meet the date specification. The date
is specified in the form of mm/dd/yy. The default value is all,
which reports all the files.
-s date_comparison_operator
Sets up search criteria for date. Note that if the date is not
specified, the date comparison specifications are not honored. The
valid date operators are as follows: lt, le, eq, ge, and gt. The
default operator is eq.
-p target_processor
Reports only the files compiled for the specified target processor.
The valid target processors are as follows: C100, C300, C400,
C400safe, and all. The default target processor is all.
-n report_filename
Specifies a name for the report file which iar generates. A
filename must be specified when this flag is used; otherwise, iar
may mistake the object name to be the report filename and return an
error message saying that no object files were specified.
-o optimization_level
Reports only the files compiled at the specified optimization
level. An optimization level is a digit (0 through 9) or all. The
default level is all.
-q optimization_comparison_operator
Sets up search criteria for the optimization level. Note that if
an optimization level is not specified with the -o flag, this
comparison operator is ineffective. The valid comparison operators
are lt, le, eq, ge, and gt. The default operator is eq.
DESCRIPTION
The iar command is an image analysis reporter that reports file
information on a given file based on user-specified criteria.
If iar is invoked with no command line flags, an fmli user interface to
iar is started.
If any command line flags are specified, the command line version of iar
is invoked. The command line iar produces a report about the files
specified. By default, iar examines Clipper executable files, object
files, and/or archive libraries and reports the name, target processor,
compiler, compiler version, assembler version, compilation date, and
compiler flags of each file that makes up the executable file, object
2 Intergraph Corporation - 2/94
iar(1) CLIX iar(1)
file, or archive. By default, the report is printed to the file
image.report in the user's current directory. The user may specify a
different name for the report file by using the -n flag.
The user may specify search criteria so that only files which meet the
specified criteria are reported. The following flags allow the user to
set up the search criteria: -c, -v, -t, -w, -r, -d, -s, and -p. If none
of the search flags is used, all files are reported. Note: If iar cannot
determine whether a file meets the specified criteria, it treats the file
as if it does meet the criteria. Such files are listed in the file-by-file
listing, and included in the computation of the percent of files that
match the criteria.
EXAMPLES
1. To list information (name, target processor, compiler, compiler
version, assembler version, compilation date, and compiler flags)
about all files that compose the archive library mylib.a, the
executable file myexe, and the object file test.o, enter the following
iar command. The report is printed to stdout and to the image.report
file in the current directory.
iar mylib.a myexe test.o
2. To bring up the fmli user interface to iar, enter the command with no
flags.
iar
3. To list information (name, target processor, compiler, compiler
version, assembler version, compilation date, and compiler flags)
about all files that compose the archive library mylib.a, the
executable file myexe, and the object file test.o that were compiled
with the Clipper compiler on September 14, 1991, enter the following
iar command. The report is printed to stdout and to the file named
/usr/username/report/myreport. (In this example, the username is
mary, so the file is named /usr/mary/report/myreport.) Note that
unless the -n flag is used, the report is always placed in the current
directory and named image.report.
iar -c clipper -d 9/14/91 -n /usr/mary/report/myreport mylib.a myexe test.o
FILES
/usr/ip32/ingrconfig This file is maintained by newprod and lists each
product that has been downloaded to the workstation
and some information about each product. The iar
command uses this file to find its home directory,
2/94 - Intergraph Corporation 3
iar(1) CLIX iar(1)
menus, and shell scripts.
NOTES
If iar cannot determine whether a file meets the specified criteria, it
will treat the file as if it does meet the criteria. Such files will be
listed in the file-by-file listing, and included in the computation of the
percent of files that match the criteria.
EXIT VALUES
The iar command returns a value of 0 upon successful completion. If an
error was encountered, a value of 1 is returned.
4 Intergraph Corporation - 2/94