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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
|
(**************************************************************************)
(* *)
(* OCaml *)
(* *)
(* Damien Doligez, projet Para, INRIA Rocquencourt *)
(* Jacques-Henri Jourdan, projet Gallium, INRIA Paris *)
(* *)
(* Copyright 1996-2016 Institut National de Recherche en Informatique *)
(* et en Automatique. *)
(* *)
(* All rights reserved. This file is distributed under the terms of *)
(* the GNU Lesser General Public License version 2.1, with the *)
(* special exception on linking described in the file LICENSE. *)
(* *)
(**************************************************************************)
type stat = {
minor_words : float;
promoted_words : float;
major_words : float;
minor_collections : int;
major_collections : int;
heap_words : int;
heap_chunks : int;
live_words : int;
live_blocks : int;
free_words : int;
free_blocks : int;
largest_free : int;
fragments : int;
compactions : int;
top_heap_words : int;
stack_size : int;
forced_major_collections: int;
}
type control = {
minor_heap_size : int;
major_heap_increment : int;
space_overhead : int;
verbose : int;
max_overhead : int;
stack_limit : int;
allocation_policy : int;
window_size : int;
custom_major_ratio : int;
custom_minor_ratio : int;
custom_minor_max_size : int;
}
external stat : unit -> stat = "caml_gc_stat"
external quick_stat : unit -> stat = "caml_gc_quick_stat"
external counters : unit -> (float * float * float) = "caml_gc_counters"
external minor_words : unit -> (float [@unboxed])
= "caml_gc_minor_words" "caml_gc_minor_words_unboxed"
external get : unit -> control = "caml_gc_get"
external set : control -> unit = "caml_gc_set"
external minor : unit -> unit = "caml_gc_minor"
external major_slice : int -> int = "caml_gc_major_slice"
external major : unit -> unit = "caml_gc_major"
external full_major : unit -> unit = "caml_gc_full_major"
external compact : unit -> unit = "caml_gc_compaction"
external get_minor_free : unit -> int = "caml_get_minor_free"
let eventlog_pause () = ()
let eventlog_resume () = ()
open Printf
let print_stat c =
let st = stat () in
fprintf c "minor_collections: %d\n" st.minor_collections;
fprintf c "major_collections: %d\n" st.major_collections;
fprintf c "compactions: %d\n" st.compactions;
fprintf c "forced_major_collections: %d\n" st.forced_major_collections;
fprintf c "\n";
let l1 = String.length (sprintf "%.0f" st.minor_words) in
fprintf c "minor_words: %*.0f\n" l1 st.minor_words;
fprintf c "promoted_words: %*.0f\n" l1 st.promoted_words;
fprintf c "major_words: %*.0f\n" l1 st.major_words;
fprintf c "\n";
let l2 = String.length (sprintf "%d" st.top_heap_words) in
fprintf c "top_heap_words: %*d\n" l2 st.top_heap_words;
fprintf c "heap_words: %*d\n" l2 st.heap_words;
fprintf c "live_words: %*d\n" l2 st.live_words;
fprintf c "free_words: %*d\n" l2 st.free_words;
fprintf c "largest_free: %*d\n" l2 st.largest_free;
fprintf c "fragments: %*d\n" l2 st.fragments;
fprintf c "\n";
fprintf c "live_blocks: %d\n" st.live_blocks;
fprintf c "free_blocks: %d\n" st.free_blocks;
fprintf c "heap_chunks: %d\n" st.heap_chunks
let allocated_bytes () =
let (mi, pro, ma) = counters () in
(mi +. ma -. pro) *. float_of_int (Sys.word_size / 8)
external finalise : ('a -> unit) -> 'a -> unit = "caml_final_register"
external finalise_last : (unit -> unit) -> 'a -> unit =
"caml_final_register_called_without_value"
external finalise_release : unit -> unit = "caml_final_release"
type alarm = bool Atomic.t
type alarm_rec = {active : alarm; f : unit -> unit}
let rec call_alarm arec =
if Atomic.get arec.active then begin
let finally () = finalise call_alarm arec in
Fun.protect ~finally arec.f
end
let delete_alarm a = Atomic.set a false
(* never inline, to prevent [arec] from being allocated statically *)
let[@inline never] create_alarm f =
let alarm = Atomic.make true in
Domain.at_exit (fun () -> delete_alarm alarm);
let arec = { active = alarm; f = f } in
finalise call_alarm arec;
alarm
module Memprof =
struct
type t
type allocation_source = Normal | Marshal | Custom | Map_file
let string_of_allocation_source = function
| Normal -> "Normal"
| Marshal -> "Marshal"
| Custom -> "Custom"
| Map_file -> "Map_file"
type allocation =
{ n_samples : int;
size : int;
source : allocation_source;
callstack : Printexc.raw_backtrace }
type ('minor, 'major) tracker = {
alloc_minor: allocation -> 'minor option;
alloc_major: allocation -> 'major option;
promote: 'minor -> 'major option;
dealloc_minor: 'minor -> unit;
dealloc_major: 'major -> unit;
}
let null_tracker = {
alloc_minor = (fun _ -> None);
alloc_major = (fun _ -> None);
promote = (fun _ -> None);
dealloc_minor = (fun _ -> ());
dealloc_major = (fun _ -> ());
}
external c_start :
float -> int -> ('minor, 'major) tracker -> t
= "caml_memprof_start"
let start
~sampling_rate
?(callstack_size = max_int)
tracker =
c_start sampling_rate callstack_size tracker
external stop : unit -> unit = "caml_memprof_stop"
external discard : t -> unit = "caml_memprof_discard"
end
type suspended_collection_work = int
(* Note: we do not currently expose this type outside the module,
because it could plausibly change in the future. In particular,
currently the runtime only track major allocations during ramp-up
work, but there are other sources of GC pressure, such as custom
block allocation, that could be tracked as well and should probably
be tracked separately. This suggests that the type of suspended work
could become a record of integers instead of one integer.
On the other hand, it would be nice to let users, say, smooth out
suspended work by splitting it in N smaller parts to be ramped down
separately. This would be possible by exposing the type as int, or
possibly by defining a division/splitting function for the abstract
type.
*)
external ramp_up : (unit -> 'a) -> 'a * suspended_collection_work
= "caml_ml_gc_ramp_up"
external ramp_down : suspended_collection_work -> unit
= "caml_ml_gc_ramp_down"
|
