|
DataMuseum.dkPresents historical artifacts from the history of: Rational R1000/400 |
This is an automatic "excavation" of a thematic subset of
See our Wiki for more about Rational R1000/400 Excavated with: AutoArchaeologist - Free & Open Source Software. |
top - download
Length: 8610 (0x21a2)
Types: TextFile
Notes: R1k Text-file segment
└─⟦8527c1e9b⟧ Bits:30000544 8mm tape, Rational 1000, Arrival backup of disks in PAM's R1000
└─ ⟦cfc2e13cd⟧ »Space Info Vol 2«
└─⟦f731edcd5⟧
└─⟦this⟧
ada VADS Reference ada
ada
Ada compiler
Syntax
ada [options] [source_file]... [linker_options]
[object_file.o]...
Options
-# identifier type value (define) Define an identifier of a
specified type and value. See Chapter , VADS ADA
PREPROCESSOR REFERENCE.
-a file_name (archive) Treat file_name as an object
archive file create dby ar. Since some archive files end
with .a, -a is used to distinguish archive files from Ada
source files.
-d (dependencies) Analyze for dependencies only. Do not do
semantic analysis or code generation. Update the library,
marking any defined units as uncompiled. The -d option is
used by a.mak
e to establish dependencies among new files.
Printed 12/26/89 VADS 1
ada VADS Reference ada
-e (error) Process compilation error messages using a.erro
r and send it to standard output. Only the source lines
containing errors are listed. Only one -e or -E option
should be used.
-E
-E file
-E directory (error output) Without a file or directory
argument, ada processes error messages using a.error and
directs a brief output to standard output; the raw error
messages are left in ada_source.err. If a file pathname is
given, the raw error messages are placed in that file. If a
directory argument is supplied, the raw error output is
placed in dir/source.
err. The file of raw error messages can be used as input to
a.error
-el (error listing) Intersperse error messages among source
lines and direct to standard output.
-El
Printed 12/26/89 VADS 2
ada VADS Reference ada
-El file
-El directory (error listing) Same as the -E opti
on, except that source listing with errors is produced.
-ev (error vi(1)) Process syntax error messages using
a.error, embed them in the source file, and call the
environment editor ERROR_EDITOR. (If ERROR_EDITOR is
defined, the environment variable ERROR_PATTERN should also
be defined. ERROR_PATTERN is an editor search command that
locates the first occurrence of `###' in the error file.) If
no editor is specified, vi(1) is invoked.
-K (keep) Keep the intermediate language (IL) file
produced by the compiler front end. The IL file will be
placed int he .objects
directory, with the file name Ada_source.i
-L library_name (library) Operate in VADS library
library_name (the current working directory is the default).
-lfile_abbreviation (library search) This is an option
passed to the UNIX linker, ld(1) telling it to search the
specified library file. (No space between the -l and the
file abbreviation.)
Printed 12/26/89 VADS 3
ada VADS Reference ada
For a description of the file abbreviations, see also
Operating system documentation, ld(1).
-M unit_name (main) Produce an executable program by
linking the named unit as the main program. unit_name must
already be compiled. It must be either a parameterless
procedure or a parameterless function returning an integer.
The executable program will be named a.out unless overridden
with the -o option.
-M source_file (main) Produce an executable program by
compiling and linking source_file. The main unit of the
program is assumed to be the root name of the .a file (for
foo.a the unit is foo). Only one .a file may be preceded by
-M. The executable program will be named a.out unless
overridden with the -o option.
-o executable_file (output) This option is to be used in
conjunction with the -M option. executable_file is the name
of the executable rather than the default a.out.
-O[0-9] (optimize) Invoke the code optimizer (OPTIM3). An
optional digit (there is no space before the digit) provides
the level of optimization. The default is -O4.
-O full optimization
Printed 12/26/89 VADS 4
ada VADS Reference ada
-O0 prevents optimization
-O1 no hoisting
-O2 no hoisting but more passes
-O3 no hoisting but even more passes
-O4 hoisting from loops
-O5 hoisting from loops but more passes
-O6 hoisting from loops with maximum passes
-O7 hoisting from loops and branches
Printed 12/26/89 VADS 5
ada VADS Reference ada
-O8 hoisting from loops and branches, more passes
-O9 hoisting from loops and branches, maximum passes
Hoisting from branches (and cases alternatives) can be slow
and does not always provide significant performance gains so
it can be suppressed.
For more information about optimization, see COMPILING ADA
PROGRAMS, Compiler Optimizations on page
. See also pragma OPTIMIZE_CODE(OFF) on page
-P Invoke the Ada Preprocessor. See Chapter , VADS ADA
PREPROCESSOR REFERENCE.
-R VADS_library (recompile instantiation) Force analysis
of all generic instantiations, causing reinstantiation of
any that are out of date.
-S (suppress) Apply pragma SUPPRESS to the entire
compilation for all suppressible checks. (See also pragm
a SUPPRESS(ALL_CHECKS) on page
Printed 12/26/89 VADS 6
ada VADS Reference ada
-sh (show) Display the name of the tool executable but do
not execute it.
-T (timing) Print timing information for the compilation.
-v (verbose) Print compiler version number, date and time
of compilation, name of file compiled, command input line,
total compilation time, and error summary line. Storage
usage information about the object file is provided. With
OPTIM3 the output format of compression (the size of
optimized instructions) is as a percentage of input
(unoptimized instructions).
-w (warnings) Suppress warning diagnostics.
Description
The command ada executes the Ada compiler and compiles the
named Ada source file, ending with the .a suffix. The file
must reside in a VADS library directory. The ada.lib file in
this directory is modified after each Ada unit is compiled.
By default, ada produces only object and net files. If the
-M option is used, the compiler automatically invokes a.ld
and builds a complete program with the named library unit as
the main program.
Printed 12/26/89 VADS 7
ada VADS Reference ada
Non-Ada object files (.o files produced by a compiler for
another language) may be given as arguments to ada. These
files will be passed on to the linker and will be linked
with the specified Ada object files.
Command line options may be specified in any order, but the
order of compilation and the order of the files to be passed
to the linker can be significant.
Several VADS compilers may be simultaneously available on a
single system. Because the ada command in any
VADS_location/bin on a system will execute the correct
compiler components based upon visible library directives,
the option -sh is provided to print the name of the
components actually executed.
Program listings with a disassembly of machine code
instructions are generated by a.db or a.das.
See also a.das on page ; a.db on page ; a.error on page ;
a.ld on page ; a.mklib on page ; and Operating System
reference documentation for the ld(1) utility.
Diagnostics
The diagnostics produced by the VADS compiler are intended
to be self-explanato
ry. Most refer to the RM. Each RM reference includes a
section number and optionally, a paragraph number enclosed
Printed 12/26/89 VADS 8
ada VADS Reference ada
in parentheses.
Printed 12/26/89 VADS 9