summaryrefslogtreecommitdiff
path: root/library/states.mli
blob: 7e6535d92652f5761b656f44ae1e13d4d3a46fb1 (plain)
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
(************************************************************************)
(*  v      *   The Coq Proof Assistant  /  The Coq Development Team     *)
(* <O___,, *   INRIA - CNRS - LIX - LRI - PPS - Copyright 1999-2012     *)
(*   \VV/  **************************************************************)
(*    //   *      This file is distributed under the terms of the       *)
(*         *       GNU Lesser General Public License Version 2.1        *)
(************************************************************************)

(** {6 States of the system} *)

(** In that module, we provide functions to get
  and set the state of the whole system. Internally, it is done by
  freezing the states of both [Lib] and [Summary]. We provide functions
  to write and restore state to and from a given file. *)

val intern_state : string -> unit
val extern_state : string -> unit

type state
val freeze : unit -> state
val unfreeze : state -> unit

(** {6 Rollback } *)

(** [with_heavy_rollback f x] applies [f] to [x] and restores the
  state of the whole system as it was before the evaluation if an exception
  is raised. *)
val with_heavy_rollback : ('a -> 'b) -> (exn -> exn) -> 'a -> 'b

(** [with_state_protection f x] applies [f] to [x] and restores the
  state of the whole system as it was before the evaluation of f *)

val with_state_protection : ('a -> 'b) -> 'a -> 'b