1996-11-29 08:55:09 -08:00
|
|
|
(***********************************************************************)
|
|
|
|
|
(* *)
|
2011-07-27 07:17:02 -07:00
|
|
|
(* OCaml *)
|
1996-11-29 08:55:09 -08:00
|
|
|
(* *)
|
|
|
|
|
(* Jerome Vouillon, projet Cristal, INRIA Rocquencourt *)
|
2011-07-27 07:17:02 -07:00
|
|
|
(* OCaml port by John Malecki and Xavier Leroy *)
|
1996-11-29 08:55:09 -08:00
|
|
|
(* *)
|
|
|
|
|
(* Copyright 1996 Institut National de Recherche en Informatique et *)
|
1999-11-17 10:59:06 -08:00
|
|
|
(* en Automatique. All rights reserved. This file is distributed *)
|
|
|
|
|
(* under the terms of the Q Public License version 1.0. *)
|
1996-11-29 08:55:09 -08:00
|
|
|
(* *)
|
|
|
|
|
(***********************************************************************)
|
|
|
|
|
|
|
|
|
|
(****************************** Frames *********************************)
|
|
|
|
|
|
|
|
|
|
open Instruct
|
|
|
|
|
open Primitives
|
|
|
|
|
|
|
|
|
|
(* Current frame number *)
|
|
|
|
|
val current_frame : int ref
|
|
|
|
|
|
|
|
|
|
(* Event at selected position. *)
|
|
|
|
|
val selected_event : debug_event option ref
|
|
|
|
|
|
2010-01-20 08:26:46 -08:00
|
|
|
(* Selected position in source (module, line, column). *)
|
1996-11-29 08:55:09 -08:00
|
|
|
(* Raise `Not_found' if not on an event. *)
|
2010-01-20 08:26:46 -08:00
|
|
|
val selected_point : unit -> string * int * int
|
1996-11-29 08:55:09 -08:00
|
|
|
|
|
|
|
|
val selected_event_is_before : unit -> bool
|
|
|
|
|
|
|
|
|
|
(* Select a frame. *)
|
|
|
|
|
(* Raise `Not_found' if no such frame. *)
|
|
|
|
|
(* --- Assume the currents events have already been updated. *)
|
|
|
|
|
val select_frame : int -> unit
|
|
|
|
|
|
|
|
|
|
(* Select a frame. *)
|
|
|
|
|
(* Same as `select_frame' but raise no exception if the frame is not found. *)
|
|
|
|
|
(* --- Assume the currents events have already been updated. *)
|
|
|
|
|
val try_select_frame : int -> unit
|
|
|
|
|
|
|
|
|
|
(* Return to default frame (frame 0). *)
|
|
|
|
|
val reset_frame : unit -> unit
|
|
|
|
|
|
|
|
|
|
(* Perform a stack backtrace.
|
|
|
|
|
Call the given function with the events for each stack frame,
|
|
|
|
|
or None if we've encountered a stack frame with no debugging info
|
|
|
|
|
attached. Stop when the function returns false, or frame with no
|
|
|
|
|
debugging info reached, or top of stack reached. *)
|
|
|
|
|
val do_backtrace : (debug_event option -> bool) -> unit
|
|
|
|
|
|
|
|
|
|
(* Return the number of frames in the stack, or (-1) if it can't be
|
|
|
|
|
determined because some frames have no debugging info. *)
|
|
|
|
|
val stack_depth : unit -> int
|
