File: fault.mli

package info (click to toggle)
herdtools7 7.58-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 19,732 kB
  • sloc: ml: 128,583; ansic: 3,827; makefile: 670; python: 407; sh: 212; awk: 14
file content (82 lines) | stat: -rw-r--r-- 3,082 bytes parent folder | download
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
(****************************************************************************)
(*                           the diy toolsuite                              *)
(*                                                                          *)
(* Jade Alglave, University College London, UK.                             *)
(* Luc Maranget, INRIA Paris-Rocquencourt, France.                          *)
(*                                                                          *)
(* Copyright 2019-present Institut National de Recherche en Informatique et *)
(* en Automatique, ARM Ltd and the authors. All rights reserved.            *)
(*                                                                          *)
(* This software is governed by the CeCILL-B license under French law and   *)
(* abiding by the rules of distribution of free software. You can use,      *)
(* modify and/ or redistribute the software under the terms of the CeCILL-B *)
(* license as circulated by CEA, CNRS and INRIA at the following URL        *)
(* "http://www.cecill.info". We also give a copy in LICENSE.txt.            *)
(****************************************************************************)

(** External view of faults, which are part of final state *)


module type I = sig
  type arch_global
  val pp_global : arch_global -> string
  val global_compare : arch_global -> arch_global -> int
(* Identifiers in faults are considered identical *)
  val same_id_fault : arch_global -> arch_global -> bool

  type fault_type
  val pp_fault_type : fault_type -> string
  val fault_type_compare : fault_type -> fault_type -> int
end

type ('loc, 'ftype) atom =
  (Proc.t * Label.t option) * 'loc option * 'ftype option

val pp_fatom : ('loc -> string) -> ('ftype -> string) -> ('loc,'ftype) atom -> string

val atom_compare : ('loc -> 'loc -> int) -> ('ftype -> 'ftype -> int) ->
                   ('loc,'ftype) atom -> ('loc,'ftype) atom -> int

val map_value : ('v -> 'w) -> ('v,'ftype) atom -> ('w,'ftype) atom

module type S = sig

  type loc_global
  type fault_type

  type fault =
    (Proc.t * Label.Set.t) * loc_global option
    * fault_type option * string option

  val pp_fault : fault -> string

  module FaultSet : MySet.S with type elt = fault

  type fatom = (loc_global,fault_type) atom

  val pp_fatom : fatom -> string
  val check_one_fatom : fault -> fatom -> bool
  val check_fatom : FaultSet.t -> fatom -> bool

  module FaultAtomSet : MySet.S with type elt = fatom

end

module Make : functor (A:I) -> S with type loc_global := A.arch_global and type fault_type := A.fault_type

(** Reaction to faults common to litmus and herd when the test doesn't specify a fault handler *)
module Handling : sig
  type t =
    | Handled      (** After a fault retry the faulting instruction *)
    | Fatal        (** After a fault exit the execution *)
    | Skip         (** After a fault skip the faulting instruction *)


  val default : t
  val tags : string list
  val parse : string -> t option
  val pp : t -> string

  val is_fatal : t -> bool
  val is_skip : t -> bool
end