blob: 1554e0a1ec35d42a69d5853c16afd64a6977a533 (
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
(************************************************************************)
(* 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 *)
(************************************************************************)
(* This module implements spawning/killing managed processes with a
* synchronous or asynchronous comunication channel that works with
* threads or with a glib like main loop model.
*
* This module requires no threads and no main loop model. It takes care
* of using the fastest communication channel given the underlying OS and
* the requested kind of communication.
*
* The spawned process must use the Spawned module to init its communication
* channels.
*)
(* This is the control panel for managed processes *)
module type Control = sig
type handle
val kill : handle -> unit
val stats : handle -> Gc.stat
val wait : handle -> Unix.process_status
val unixpid : handle -> int
(* What is used in debug messages *)
val uid : handle -> string
(* Installs a callback, called every [sec] seconds. If the returned value
* is true the process is killed *)
val kill_if : handle -> sec:int -> (unit -> bool) -> unit
end
(* Abstraction to work with both threads and main loop models *)
module type Timer = sig
val add_timeout : sec:int -> (unit -> bool) -> unit
end
module type MainLoopModel = sig
type async_chan
type condition
type watch_id
val add_watch : callback:(condition list -> bool) -> async_chan -> watch_id
val remove_watch : watch_id -> unit
val read_all : async_chan -> string
val async_chan_of_file : Unix.file_descr -> async_chan
val async_chan_of_socket : Unix.file_descr -> async_chan
include Timer
end
(* spawn a process and read its output asynchronously *)
module Async(ML : MainLoopModel) : sig
type process
(* If the returned value is false the callback is never called again and
* the process is killed *)
type callback = ML.condition list -> read_all:(unit -> string) -> bool
val spawn :
?prefer_sock:bool -> ?env:string array -> string -> string array ->
callback -> process * out_channel
include Control with type handle = process
end
(* spawn a process and read its output synchronously *)
module Sync(T : Timer) : sig
type process
val spawn :
?prefer_sock:bool -> ?env:string array -> string -> string array ->
process * in_channel * out_channel
include Control with type handle = process
end
(* This is exported to separate the Spawned module, that for simplicity assumes
* Threads so it is in a separate file *)
type req = ReqDie | ReqStats | Hello of int * int
val proto_version : int
type resp = RespStats of Gc.stat
|
