adactl(1) Ada rules controller

SYNOPSIS

adactl [options] unit[+|-unit]|[@]file ... [-- ASIS_options]
adactl -h [rule id... | all | commands | license | list | options | rules | version]

DESCRIPTION

AdaControl is an Ada rules controller. It is used to control that Ada software meets the requirements of a number of parameterizable rules. It is not intended to supplement checks made by the compiler, but rather to search for particular violations of good-practice rules, or to check that some rules are obeyed project-wide.

Commercial support is available for AdaControl, see file /usr/share/doc/adacontrol/support.txt. If you plan to use AdaControl for industrial projects, or if you want it to be customized or extended to match your own needs, please contact Adalog at [email protected].

SPECIAL MODES

-C
Check rules syntax only. Accepts -d, -f, -l, -v, -x.
-D
Generate dependencies. Accepts -o, -p, -r, -s, -w, -x.
-h
Prints a general help message.
-h rule
Describe rule.
-h all
Describe all rules.
-h commands|license|options|version
Describe all commands, the licence (GPL), the options or the version number.
-h list
List the rules in a format suitable for use inside the GNAT Programming Studio.
-h rules
List the rules in a normal format.
-I
Interactive mode. Accepts all options.

OPTIONS

-d
Enable debug mode.
-e
Treat warnings (Search) as errors (Check)
-E
Print only errors (Check).
-f file
Use file for the specification of rules
-F GNAT | GNAT_SHORT | CSV | CSV_SHORT | CSVX | CSVX_SHORT | NONE
Choose output format.
-i
Ignore local deactivations.
-l
rule...
Process with the specified rules; see below.
-o file
Send output to the specified file.
-p file
Specify an emacs ada-mode project file (.adp)
-r
Recursive
-s
Only process Ada unit specifications
-S level
Produce statistics; level is an integer in the range 0 .. 4.
-t trace_file
Send a trace to the specified file.
-T
Report execution time of rules.
-u
Treat all parameters as Ada units
-v
Enable verbose mode.
-w
Overwrite output file (works with -o)
-x
Exit when internal error

RULES

The following rules are available for the -l option:
   Abnormal_Function_Return        Allocators
   Array_Declarations              Barrier_Expressions
   Case_Statement                  Characters
   Declarations                    Default_Parameter
   Directly_Accessed_Globals       Duplicate_Initialization_Calls
   Entities                        Entity_Inside_Exception
   Exception_Propagation           Expressions
   Global_References               Header_Comments
   Improper_Initialization         Instantiations
   Insufficient_Parameters         Local_Hiding
   Max_Blank_Lines                 Max_Call_Depth
   Max_Line_Length                 Max_Nesting
   Max_Size                        Max_Statement_Nesting
   Movable_Accept_Statements       Multiple_Assignments
   Naming_Convention               Non_Static
   Not_Elaboration_Calls           Not_Selected_Name
   No_Operator_Usage               Object_Declarations
   Other_Dependencies              Parameter_Aliasing
   Parameter_Declarations          Potentially_Blocking_Operations
   Pragmas                         Reduceable_Scope
   Representation_Clauses          Return_Type
   Side_Effect_Parameters          Silent_Exceptions
   Simplifiable_Expressions        Simplifiable_Statements
   Special_Comments                Statements
   Style                           Terminating_Tasks
   Type_Initial_Values             Uncheckable
   Units                           Unnecessary_Use_Clause
   Unsafe_Paired_Calls             Unsafe_Unchecked_Conversion
   Usage                           Use_Clauses
   With_Clauses

AUTHOR

AdaControl was developed by Adalog <URL: http://www.adalog.fr > under contract with Eurocontrol <URL: http://www.eurocontrol.int >. The copyright is jointly owned by Adalog and Eurocontrol.

This manual page was written by Ludovic Brenta <[email protected]> and is licensed under terms of the GNU General Public License.