4.2 Switches for gnatbind
The following switches are available with gnatbind; details will
be presented in subsequent sections.
- -aO
- Specify directory to be searched for ALI files.
- -aI
- Specify directory to be searched for source file.
- -A
- Generate binder program in Ada (default)
- -b
- Generate brief messages to stderr even if verbose mode set.
- -c
- Check only, no generation of binder output file.
- -C
- Generate binder program in C
- -e
- Output complete list of elaboration-order dependencies.
- -E
- Store tracebacks in exception occurrences when the target supports it.
This is the default with the zero cost exception mechanism.
See also the packages
GNAT.Traceback and
GNAT.Traceback.Symbolic for more information.
Note that on x86 ports, you must not use -fomit-frame-pointer
gcc option.
- -F
- Force the checks of elaboration flags. gnatbind does not normally
generate checks of elaboration flags for the main executable, except when
a Stand-Alone Library is used. However, there are cases when this cannot be
detected by gnatbind. An example is importing an interface of a Stand-Alone
Library through a pragma Import and only specifying through a linker switch
this Stand-Alone Library. This switch is used to guarantee that elaboration
flag checks are generated.
- -h
- Output usage (help) information
- -I
- Specify directory to be searched for source and ALI files.
- -I-
- Do not look for sources in the current directory where
gnatbind was
invoked, and do not look for ALI files in the directory containing the
ALI file named in the gnatbind command line.
- -l
- Output chosen elaboration order.
- -Lxxx
- Bind the units for library building. In this case the adainit and
adafinal procedures (see Binding with Non-Ada Main Programs)
are renamed to xxxinit and
xxxfinal.
Implies -n.
(See GNAT and Libraries, for more details.)
- -Mxyz
- Rename generated main program from main to xyz
- -mn
- Limit number of detected errors to n, where n is
in the range 1..999_999. The default value if no switch is
given is 9999. Binding is terminated if the limit is exceeded.
Furthermore, under Windows, the sources pointed to by the libraries path
set in the registry are not searched for.
- -n
- No main program.
- -nostdinc
- Do not look for sources in the system default directory.
- -nostdlib
- Do not look for library files in the system default directory.
- --RTS=rts-path
- Specifies the default location of the runtime library. Same meaning as the
equivalent gnatmake flag (see Switches for gnatmake).
- -o file
- Name the output file file (default is b~xxx.adb).
Note that if this option is used, then linking must be done manually,
gnatlink cannot be used.
- -O
- Output object list.
- -p
- Pessimistic (worst-case) elaboration order
- -s
- Require all source files to be present.
- -Sxxx
- Specifies the value to be used when detecting uninitialized scalar
objects with pragma Initialize_Scalars.
The xxx string specified with the switch may be either
- “in” requesting an invalid value where possible
- “lo” for the lowest possible value
possible, and the low
- “hi” for the highest possible value
- “xx” for a value consisting of repeated bytes with the
value 16#xx# (i.e. xx is a string of two hexadecimal digits).
In addition, you can specify -Sev to indicate that the value is
to be set at run time. In this case, the program will look for an environment
variable of the form GNAT_INIT_SCALARS=xx, where xx is one
of in/lo/hi/xx with the same meanings as above.
If no environment variable is found, or if it does not have a valid value,
then the default is in (invalid values).
- -static
- Link against a static GNAT run time.
- -shared
- Link against a shared GNAT run time when available.
- -t
- Tolerate time stamp and other consistency errors
- -Tn
- Set the time slice value to n milliseconds. If the system supports
the specification of a specific time slice value, then the indicated value
is used. If the system does not support specific time slice values, but
does support some general notion of round-robin scheduling, then any
non-zero value will activate round-robin scheduling.
A value of zero is treated specially. It turns off time
slicing, and in addition, indicates to the tasking run time that the
semantics should match as closely as possible the Annex D
requirements of the Ada RM, and in particular sets the default
scheduling policy to FIFO_Within_Priorities.
- -v
- Verbose mode. Write error messages, header, summary output to
stdout.
- -wx
- Warning mode (x=s/e for suppress/treat as error)
- -x
- Exclude source files (check object consistency only).
- -z
- No main subprogram.
You may obtain this listing of switches by running gnatbind with
no arguments.