blob: 96239d145686c4c7b6d1134c7b8c3add07e401ab (
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
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
|
(************************************************************************)
(* v * The Coq Proof Assistant / The Coq Development Team *)
(* <O___,, * INRIA - CNRS - LIX - LRI - PPS - Copyright 1999-2014 *)
(* \VV/ **************************************************************)
(* // * This file is distributed under the terms of the *)
(* * GNU Lesser General Public License Version 2.1 *)
(************************************************************************)
module type Task = sig
type task
(* Marshallable *)
type request
type response
val name : string (* UID of the task kind, for -toploop *)
val extra_env : unit -> string array
(* run by the master, on a thread *)
val request_of_task : [ `Fresh | `Old ] -> task -> request option
val use_response : task -> response -> [ `Stay | `StayReset ]
val on_marshal_error : string -> task -> unit
val on_slave_death : task option -> [ `Exit of int | `Stay ]
val on_task_cancellation_or_expiration : task option -> unit
val forward_feedback : Stateid.t -> Feedback.feedback_content -> unit
(* run by the worker *)
val perform : request -> response
(* debugging *)
val name_of_task : task -> string
val name_of_request : request -> string
end
type cancel_switch = bool ref
module MakeQueue(T : Task) : sig
(* Number of workers, 0 = lazy local *)
val init : int -> unit
val destroy : unit -> unit
val with_n_workers :
int -> (join:(unit -> unit) -> cancel_all:(unit -> unit) -> 'a) -> 'a
val n_workers : unit -> int
val enqueue_task : T.task -> cancel_switch -> unit
(* blocking function that waits for the task queue to be empty *)
val join : unit -> unit
val cancel_all : unit -> unit
val cancel_worker : string -> unit
val set_order : (T.task -> T.task -> int) -> unit
(* Take a snapshot (non destructive but waits until all workers are
* enqueued) *)
val snapshot : unit -> T.task list
(* Clears the queue, only if the worker prool is empty *)
val clear : unit -> unit
end
module MakeWorker(T : Task) : sig
val main_loop : unit -> unit
val init_stdout : unit -> unit
end
|