src/Pure/ML-Systems/ml_debugger_polyml-5.6.ML
author wenzelm
Thu, 17 Dec 2015 17:32:01 +0100
changeset 61862 e2a9e46ac0fb
parent 61794 4c232a2ddeab
child 61886 5a9a85c4cfb3
permissions -rw-r--r--
support pretty break indent, like underlying ML systems;
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
61794
4c232a2ddeab discontinued intermediate polyml-5.5.3, assuming the coming release will be polyml-5.6;
wenzelm
parents: 60954
diff changeset
     1
(*  Title:      Pure/ML-Systems/ml_debugger_polyml-5.6.ML
60729
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
     2
    Author:     Makarius
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
     3
61794
4c232a2ddeab discontinued intermediate polyml-5.5.3, assuming the coming release will be polyml-5.6;
wenzelm
parents: 60954
diff changeset
     4
ML debugger interface -- for Poly/ML 5.6, or later.
60729
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
     5
*)
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
     6
60852
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
     7
signature ML_DEBUGGER =
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
     8
sig
60954
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
     9
  type exn_id
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    10
  val exn_id: exn -> exn_id
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    11
  val print_exn_id: exn_id -> string
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    12
  val eq_exn_id: exn_id * exn_id -> bool
60852
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    13
  type location
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    14
  val on_entry: (string * location -> unit) option -> unit
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    15
  val on_exit: (string * location -> unit) option -> unit
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    16
  val on_exit_exception: (string * location -> exn -> unit) option -> unit
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    17
  val on_breakpoint: (location * bool Unsynchronized.ref -> unit) option -> unit
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    18
  type state
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    19
  val state: Thread.thread -> state list
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    20
  val debug_function: state -> string
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    21
  val debug_function_arg: state -> ML_Name_Space.valueVal
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    22
  val debug_function_result: state -> ML_Name_Space.valueVal
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    23
  val debug_location: state -> location
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    24
  val debug_name_space: state -> ML_Name_Space.T
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    25
end;
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    26
60729
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    27
structure ML_Debugger: ML_DEBUGGER =
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    28
struct
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    29
60954
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    30
(* exceptions *)
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    31
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    32
abstype exn_id = Exn_Id of string * int Unsynchronized.ref
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    33
with
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    34
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    35
fun exn_id exn =
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    36
  Exn_Id (General.exnName exn, RunCall.run_call2 RuntimeCalls.POLY_SYS_load_word (exn, 0));
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    37
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    38
fun print_exn_id (Exn_Id (name, _)) = name;
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    39
fun eq_exn_id (Exn_Id (_, id1), Exn_Id (_, id2)) = PolyML.pointerEq (id1, id2);
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    40
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    41
end;
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    42
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    43
val _ =
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    44
  PolyML.addPrettyPrinter (fn _ => fn _ => fn exn_id =>
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    45
    let val s = print_exn_id exn_id
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    46
    in ml_pretty (ML_Pretty.String (s, size s)) end);
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    47
eeee8349e9eb abstract exn_id based on getExnId in polyml/basis/FinalPolyML.sml (NB: the mutable machine word cannot be inspected in ML, e.g. toplevel pp dumps core);
wenzelm
parents: 60853
diff changeset
    48
60729
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    49
(* hooks *)
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    50
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    51
type location = PolyML.location;
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    52
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    53
val on_entry = PolyML.DebuggerInterface.setOnEntry;
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    54
val on_exit = PolyML.DebuggerInterface.setOnExit;
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    55
val on_exit_exception = PolyML.DebuggerInterface.setOnExitException;
60744
4eba53a0ac3d report possible breakpoint positions;
wenzelm
parents: 60730
diff changeset
    56
val on_breakpoint = PolyML.DebuggerInterface.setOnBreakPoint;
60729
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    57
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    58
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    59
(* debugger operations *)
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    60
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    61
type state = PolyML.DebuggerInterface.debugState;
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    62
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    63
val state = PolyML.DebuggerInterface.debugState;
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    64
val debug_function = PolyML.DebuggerInterface.debugFunction;
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    65
val debug_function_arg = PolyML.DebuggerInterface.debugFunctionArg;
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    66
val debug_function_result = PolyML.DebuggerInterface.debugFunctionResult;
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    67
val debug_location = PolyML.DebuggerInterface.debugLocation;
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    68
val debug_name_space = PolyML.DebuggerInterface.debugNameSpace;
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    69
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    70
end;