4.9 Summary of Binder Switches

The following are the switches available with gnatbind:

-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. This option is currently supported on the following targets: all x86 ports, Solaris, Windows, HP-UX, AIX, PowerPC VxWorks and Alpha VxWorks. 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.

-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

Binds the units for library building. In this case the adainit and adafinal procedures (See see Binding with Non-Ada Main Programs) are renamed to xxxinit and xxxfinal. Implies -n. See see GNAT and Libraries for more details.

-Mxyz

Rename generated main program from main to xyz

-mn

Limit number of detected errors to n (1-999).

-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.

-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 microseconds. A value of zero means no time slicing and also indicates to the tasking run time to match as close as possible to the annex D requirements of the RM.

-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 by running the program gnatbind with no arguments.