package frama-c

  1. Overview
  2. Docs
package frama-c
Legend:
Page
Library
Module
Module type
Parameter
Class
Class type
Source

Source file aorai_option.ml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
(**************************************************************************)
(*                                                                        *)
(*  This file is part of Aorai plug-in of Frama-C.                        *)
(*                                                                        *)
(*  Copyright (C) 2007-2024                                               *)
(*    CEA (Commissariat à l'énergie atomique et aux énergies              *)
(*         alternatives)                                                  *)
(*    INRIA (Institut National de Recherche en Informatique et en         *)
(*           Automatique)                                                 *)
(*    INSA  (Institut National des Sciences Appliquees)                   *)
(*                                                                        *)
(*  you can redistribute it and/or modify it under the terms of the GNU   *)
(*  Lesser General Public License as published by the Free Software       *)
(*  Foundation, version 2.1.                                              *)
(*                                                                        *)
(*  It is distributed in the hope that it will be useful,                 *)
(*  but WITHOUT ANY WARRANTY; without even the implied warranty of        *)
(*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *)
(*  GNU Lesser General Public License for more details.                   *)
(*                                                                        *)
(*  See the GNU Lesser General Public License version 2.1                 *)
(*  for more details (enclosed in the file licenses/LGPLv2.1).            *)
(*                                                                        *)
(**************************************************************************)

include Plugin.Register
    (struct
      let name = "aorai"
      let shortname = "aorai"
      let help = "verification of behavioral properties (experimental)"
    end)

module Ya =
  Filepath
    (struct
      let option_name = "-aorai-automata"
      let arg_name = "f"
      let file_kind = "Ya"
      let existence = Fc_Filepath.Must_exist
      let help = "considers the property described by the ya automata \
                  (in Ya language) from file <f>."
    end)

module Dot =
  False(struct
    let option_name = "-aorai-dot"
    let help = "generates a dot file of the Buchi automata"
  end)

module DotSeparatedLabels =
  False(struct
    let option_name = "-aorai-dot-sep-labels"
    let help = "tells dot to not output guards directly over the edges"
  end)

module AbstractInterpretation =
  False(struct
    let option_name = "-aorai-simple-AI"
    let help = "use simple abstract interpretation"
  end)

module AbstractInterpretationOff  =
  False(struct
    let option_name = "-aorai-AI-off"
    let help = "does not use abstract interpretation"
  end)

let () = Parameter_customize.set_negative_option_name "-aorai-spec-off"
module Axiomatization =
  True(struct
    let option_name = "-aorai-spec-on"
    let help = "if set, does not axiomatize automata"
  end)

module GenerateAnnotations =
  True
    (struct
      let option_name = "-aorai-generate-annotations"
      let help = "generate computed ACSL annotations for the program"
    end)

module GenerateDeterministicLemmas =
  True
    (struct
      let option_name = "-aorai-generate-deterministic-lemmas"
      let help = "generate lemmas to be proven in order to prove that an \
                  automaton is indeed deterministic"
    end)

module ConsiderAcceptance =
  False(struct
    let option_name = "-aorai-acceptance"
    let help = "if set, considers acceptation states"
  end)

let () = Parameter_customize.set_negative_option_name "-aorai-raw-auto"
module AutomataSimplification=
  True
    (struct
      let option_name = "-aorai-simplified-auto"
      let help = "If set, does not simplify automata"
    end)

module AddingOperationNameAndStatusInSpecification =
  False
    (struct
      let option_name = "-aorai-add-oper"
      let help = "Adding current operation name (and statut) in pre/post \
                  conditions"
    end)

module Deterministic=
  State_builder.Ref
    (Datatype.Bool)
    (struct
      let name = "Aorai_option.Deterministic"
      let dependencies = []
      let default () = false
    end)

module SmokeTests=
  False
    (struct
      let option_name = "-aorai-smoke-tests"
      let help = "Add assertion in the generated functions to ensure \
                  that the automaton is always in at least one state"
    end)

module InstrumentationHistory =
  Int
    (struct
      let option_name = "-aorai-instrumentation-history"
      let arg_name = "N"
      let help = "the instrumentation will keep an history of the N last states"
      let default = 0
    end)


let is_on () = not (Ya.is_default())

let advance_abstract_interpretation () =
  not (AbstractInterpretationOff.get ()) && not (AbstractInterpretation.get ())

let emitter =
  Emitter.create
    "Aorai"
    [ Emitter.Code_annot; Emitter.Funspec; Emitter.Global_annot ]
    ~correctness:
      [ Ya.parameter; Axiomatization.parameter;
        ConsiderAcceptance.parameter;
        AutomataSimplification.parameter ]
    ~tuning:
      [ AbstractInterpretation.parameter;
        AddingOperationNameAndStatusInSpecification.parameter;
        InstrumentationHistory.parameter;
        GenerateAnnotations.parameter ]


(*
  Local Variables:
  compile-command: "make -C ../../.."
  End:
*)
OCaml

Innovation. Community. Security.

GitHub Discord Twitter Peertube RSS
About
Changelog Releases Industrial Users Academic Users Why OCaml
Ecosystem
Packages Community Events OCaml Planet Jobs
Resources
Install OCaml Get Started Platform Tools Language Manual Standard Library API Books Exercises Papers OCaml Playground Logo
Policies
Carbon Footprint Governance Privacy Code of Conduct