Ac(1) CLIX Ac(1)
NAME
Ac - Runs the Ada compiler
SYNOPSIS
Ac [flag ... ] file ...
FLAGS
-M identifier Makes the compilation unit identifier the main subprogram.
The main subprogram must be a procedure body with no
parameters defined. The name main is used by default.
-v Produces verbose error messages. In particular, the
compiler will attempt to isolate faults within expressions
detected during overload resolution.
-w Suppresses all warning messages from the Ada compiler.
-c Does not link the resulting .o files together.
-S Saves the assembly code output of the compiler in a file
with suffix .s or .S. No object files will be produced.
-o outfile Specifies the name of the executable file to be produced.
By default, a.out is used.
-O Invokes the C object code improver on the compiler output.
-L Loads only functions that are actually called (directly or
indirectly). This can considerably decrease the size of
the executable module at the expense of a longer assembly
and load time. This optimization does not apply to
functions entirely local to a unit. This flag is
incompatible with the -g flag. When this flag is given,
the -Re flag is automatically switched on. Otherwise, few
savings accrue. All units that make up an executable file
must be compiled with the same setting of this flag. The
standard Ada library provided is compiled with this flag.
-G Loads a global garbage collector to replace the usual
garbage collection scheme. The latter does not reclaim
heap space for access types defined within a library
package.
-p Arranges for the compiler to produce code that counts the
number of times each routine is called. If link editing
occurs, this flag replaces the standard startup routine
with one that automatically calls monitor() at the start
and arranges to write out a mon.out file at normal
2/94 - Intergraph Corporation 1
Ac(1) CLIX Ac(1)
termination of the object program. An execution profile
can then be generated using prof.
-g Generates extra symbol table information for a symbolic
debugger. The user can set breakpoints, but displaying
the values of variables does not always give the expected
results. It can cause the debugger to crash.
-V Displays the version number of the compiler.
-I directory Searches for library files in the named directory, in the
directory of the source file, and in the standard Ada
library. Any number of -I flags may be given.
Directories are searched in the following order:
directory of the source file, directories specified by -I
flags (in the order given), and then /usr/lib/Ada.
-lx Specifies a library name of the form /lib/libx.a, where x
is a string. If the library does not exist, the ld
command tries /usr/lib/libx.a. A library is searched when
its name is encountered, so the placement of a -l flag is
significant.
-Rstring Suppresses the following run time checks according to the
characters in the given string. (See the York ACE Ada
Compiler Environment Basic User's Guide for more
information.)
a Access check.
d Discriminant check.
i Index check.
l Length check.
r Range check.
z Division check.
o Overflow check.
e Elaboration check.
s Storage check.
x All of the above checks are suppressed.
All other flags are passed to the loader.
DESCRIPTION
2 Intergraph Corporation - 2/94
Ac(1) CLIX Ac(1)
The Ac command invokes the York (Release 4) Ada compiler. Arguments with
names ending in .H and .A are interpreted as Ada source files. These
source files are compiled. Each source file is suffixed with .O becomes
an object file suffixed .H. Each source file suffixed with .o becomes an
object file suffixed with .A. In the same way, arguments with names that
end in .s are assembled and a .o file is produced.
Files with names that end in .c are interpreted as C source files. They
are compiled and placed in a .o file to be linked if required. In
addition, .o and .a files may be passed as files to be linked along with
the generated .o files.
Note that any Ada programs with foreign language bodies must have the
corresponding .c or .o file explicitly mentioned on the command line.
These and any other filename arguments are passed to ld and are linked
together to form an executable a.out file.
In addition to creating an object file, a compilation updates a library
file, ADA-LIBRARY, for each compilation unit in the source file. The
library file is created if it does not already exist. The library file
contains the locations of the units in the program library and is read by
subsequent compilations to enforce the separate compilation rules of the
language.
EXAMPLES
This example creates the executable file elgan with a main subprogram that
has the identifier elgan. The input source file is elgan.A.
Ac -M elgan -o elgan elgan.A
FILES
libada.a Runtime support library for basic features.
libtask.a Runtime support library for tasking feature.
libadastand.a Basic I/O and memory management library.
/bin/ld Link editor (standard AT&T).
/bin/as Assembler.
/lib/crt0.o Runtime startup code.
/usr/lib/Ada/ald Ada-specific link editor.
/usr/lib/Ada/asplit Ada-specific assembler.
/usr/lib/Ada/elab_clipper Entry label generation program.
2/94 - Intergraph Corporation 3
Ac(1) CLIX Ac(1)
/usr/lib/Ada/ac_clipper Ada CLIPPER compiler.
EXIT VALUES
The Ac command exits with a value of 0 if successful, or unsuccessful when
it cannot open a specified source file. If unsuccessful for any other
reason, the command exits with a value of 1.
RELATED INFORMATION
Commands: adep(1), alt(1), ld(1), ab(1), prof(1), as(1)
Functions: monitor(3)
York ACE Ada Compiler Environment Basic User's Guide
Ada Compiler Reference Guide
4 Intergraph Corporation - 2/94