You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

79 lines
2.6 KiB

(*
* Copyright (c) 2009 - 2013 Monoidics ltd.
* Copyright (c) 2013 - present Facebook, Inc.
* All rights reserved.
*
* This source code is licensed under the BSD style license found in the
* LICENSE file in the root directory of this source tree. An additional grant
* of patent rights can be found in the PATENTS file in the same directory.
*)
(** Symbolic Operations and Failures: the units in which analysis work is measured *)
open! IStd
(** Internal state of the module *)
type t
val check_wallclock_alarm : unit -> unit
(** if the wallclock alarm has expired, raise a timeout exception *)
val get_remaining_wallclock_time : unit -> float
(** Return the time remaining before the wallclock alarm expires *)
val get_timeout_seconds : unit -> float option
(** Timeout in seconds for each function *)
val get_total : unit -> int
(** Return the total number of symop's since the beginning *)
val pay : unit -> unit
(** Count one symop *)
val reset_total : unit -> unit
(** Reset the total number of symop's *)
val restore_state : t -> unit
(** Restore the old state. *)
val save_state : keep_symop_total:bool -> t
(** Return the old state, and revert the current state to the initial one.
If keep_symop_total is true, share the total counter. *)
val set_alarm : unit -> unit
(** Reset the counter and activate the alarm *)
val set_wallclock_alarm : float -> unit
(** Set the wallclock alarm checked at every pay() *)
val set_wallclock_timeout_handler : (unit -> unit) -> unit
(** set the handler for the wallclock timeout *)
val unset_alarm : unit -> unit
(** De-activate the alarm *)
val unset_wallclock_alarm : unit -> unit
(** Unset the wallclock alarm checked at every pay() *)
type failure_kind =
| FKtimeout (** max time exceeded *)
| FKsymops_timeout of int (** max symop's exceeded *)
| FKrecursion_timeout of int (** max recursion level exceeded *)
| FKcrash of string (** uncaught exception or failed assertion *)
(** Timeout exception *)
exception Analysis_failure_exe of failure_kind
val exn_not_failure : exn -> bool
(** check that the exception is not a timeout exception *)
val try_finally : f:(unit -> 'a) -> finally:(unit -> unit) -> 'a
(** [try_finally ~f ~finally] executes [f] and then [finally] even if [f] raises an exception.
Assuming that [finally ()] terminates quickly [Analysis_failure_exe] exceptions are handled correctly.
In particular, an exception raised by [f ()] is delayed until [finally ()] finishes, so [finally ()] should
return reasonably quickly. *)
val pp_failure_kind : Format.formatter -> failure_kind -> unit
val failure_kind_to_string : failure_kind -> string