gnatcheck (1)

gnatcheck [OPTION]... filename [-cargs gcc_switches] [-rules rule_switches]

gnatcheck [OPTION]... -files=filename [-cargs gcc_switches] [-rules rule_switches]

gnatcheck checks the conformance of Ada source text with rules and produces a report file for later analysis as well as on standard output.

In the first form, gnatcheck examines the specified Ada source files (wildcards are allowed).

In the second form, gnatcheck examines the Ada source files listed in the specified file.

gnatcheck is an ASIS application developed on top of the ASIS implementation for GNAT. As such, it reads tree files (*.adt) produced by the compiler to accomplish its goals, and invokes gnatgcc for this.

-a

Process RTL units.

-cargs gcc_switches

Pass gcc_switches to GCC when producing the tree files.

-d

Debug mode.

-dd

Progress indicator mode, for use in the GNAT Programming Studio.

-h

Print the list of built-in rules.

-l

Full source location chains in report file.

-q

Quiet mode: do not report detections on standard output.

-rules rule_switches

rule_switches can be any combination of the following:

-from=file

Read rule options from file

+ALL

Turn all rules on.

-ALL

Turn all rules off.

+Rrule_id[:param[,param...]]

Turn the specified rule on, passing it optional parameters.

-Rrule_id

Turn the specified rule off.

+Rrule_id[:param[,param...]]

Turn off some of the checks for the specified rule.

rule_id is any of the rules listed with the -h option.

-s

Short form of the report file.

-sn

Include only section n (n in 1 .. 3) in the report file.

-v

Verbose mode.

gnat(1), asistant(1), gnat2xml(1), gnatelim(1), gnatmetric(1), gnatpp(1), gnatstub(1), gnattest(1)

Documentation about the ASIS tools may be found in /usr/share/doc/asis-doc/ if the asis-doc package is installed. The reference documentation about ASIS is excluded due to license problems, but may be found in various formats at http://libre.adacore.com/developers/documentation.