spark(1)

NAME
spark - examines SPARK programs and generates verification conditions

SYNOPSIS
spark
[OPTIONS] [ FILE_LIST or @METAFILE ]

DESCRIPTION
The Examiner for SPARK, spark, analyses the given source files for errors and violations of the SPARK subset and (optionally) generates verification conditions and dead path conjectures necessary for proof of absence of run-time exceptions and partial correctness.

This manual page only summarises the spark command-line flags, please refer to the full Examiner manual for further information.

OPTIONS
These options do not quite follow the usual GNU command line syntax. All options start with a single dash instead of the usual two and they can also be abbreviated, as long as the abbreviation is unique. For example \FC-help\F[] can be abbreviated to \FC-he\F[] but not \FC-h\F[] as this clashes with \FC-html\F[].

\FC-source_extension=\F[]file_type
    Specifies source file extension (Default 'ada')

\FC-noindex_file\F[], \FC-index_file=\F[]file_spec
    Specifies the index file. By default no index file is used.

\FC-nowarning_file\F[], \FC-warning_file=\F[]file_spec
    Specifies the warning control file. By default no warning control file is used.

\FC-noconfig_file\F[], \FC-config_file=\F[]file_spec
    Specifies the Examiner configuration file. By default no configuration file is used.

\FC-noswitch\F[]
    Ignore the \FCspark.sw\F[] file, if it exists.

\FC-nolistings\F[], \FC-listing_extension=\F[]file_type
    By default all listing files have the 'lst' extension. These options can be used to disable listing file generation or to change the default extension.

\FC-noreport_file\F[], \FC-report_file=\F[]file_spec
    By default the report will be named 'SPARK.REP'. These options can be used to change the default name or to disable report generation.

\FC-html\F[], \FC-html=\F[]dir_spec
    Generate HTML listings and report file.

\FC-output_directory=\F[]dir_spec
    Generate report, listing and proof files in the specified directory.

\FC-plain_output\F[]
    No dates, line or error numbers will appear in the output files.

\FC-language=\F[]L
    This can be one of 83, 95 (the default) or 2005.

\FC-profile=\F[]P
    Choose between the sequential (the default) or ravenscar language profile.

\FC-noduration\F[]
    Do not predefine \FCStandard.Duration\F[].

\FC-syntax_check\F[]
    Perform syntax check only. No semantic checks.

\FC-flow_analysis=\F[]TYPE
    Choose between \FCinformation\F[] or \FCdata\F[].

\FC-policy=\F[]TYPE
    Select \FCsecurity\F[] or \FCsafety\F[] policy for flow analysis.

\FC-vcg\F[]
    Generate VCs.

\FC-dpc\F[]
    Generate DPCs.

\FC-rules=\F[]CHOICE
    Select policy for generation of composite constant proof rules. Can be one of none (the default), lazy, keen or all.

\FC-annotation_character=\F[]CHAR
    Select alternative annotation character. The default is '#'.

\FC-noecho\F[]
    Suppress screen output.

\FC-nosli\F[]
    Don't generate SLI files.

\FC-sparklib\F[]
    Use the standard SPARK library.

\FC-nostatistics\F[], \FC-statistics\F[]
    Append Examiner table usage statistics to the report file. By default we don't do this.

\FC-fdl_identifiers=\F[]OPTION
    Control treatment of FDL identifiers when found in SPARK source. Can be one of 'reject' (the default) or 'accept' or <string>.

\FC-version\F[]
    Print Examiner banner and statistics and then exit.

\FC-help\F[]
    Print command line summary and options.

\FC-original_flow_errors\F[]
    Print information flow errors in original, less compact, format.

\FC-error_explanations=\F[]SETTING
    Print explanations after error messages. Settings can be off (the default), first_occurrence or every_occurrence.

\FC-justification_option=\F[]TYPE
    Select policy for justification of errors. Values can be full (the default), brief or ignore.

\FC-casing\F[], \FC-casing=\F[]CHOICE
    Check casing for identifier references and check casing of package \FCStandard\F[] identifiers. It is also possible to specify i or s to check for only one of these.

SEE ALSO
sparksimp(1), spadesimp(1), zombiescope(1), victor(1), pogs(1)

sparkformat(1), sparkmake(1)

AUTHOR
This manual page was written by Florian Schanda <\FCflorian.schanda@altran-praxis.com\F[]> for the Debian GNU/Linux system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts.