libv8 3.16.14.19.1-amd64-freebsd-11 → 5.3.332.38.3-amd64-freebsd-11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +5 -5
- data/ext/libv8/arch.rb +10 -33
- data/ext/libv8/location.rb +16 -8
- data/ext/libv8/paths.rb +3 -3
- data/lib/libv8/version.rb +1 -1
- data/vendor/v8/include/libplatform/libplatform.h +38 -0
- data/vendor/v8/include/v8-debug.h +84 -191
- data/vendor/v8/include/v8-experimental.h +54 -0
- data/vendor/v8/include/v8-platform.h +171 -0
- data/vendor/v8/include/v8-profiler.h +395 -188
- data/vendor/v8/include/v8-testing.h +5 -62
- data/vendor/v8/include/v8-util.h +654 -0
- data/vendor/v8/include/v8-version.h +20 -0
- data/vendor/v8/include/v8.h +6925 -2960
- data/vendor/v8/include/v8config.h +432 -0
- data/vendor/v8/out/x64.release/libv8_base.a +0 -0
- data/vendor/v8/out/x64.release/libv8_libbase.a +0 -0
- data/vendor/v8/out/x64.release/libv8_libplatform.a +0 -0
- data/vendor/v8/out/x64.release/libv8_libsampler.a +0 -0
- data/vendor/v8/out/x64.release/libv8_nosnapshot.a +0 -0
- data/vendor/v8/out/x64.release/libv8_snapshot.a +0 -0
- data/vendor/v8/out/x64.release/obj.target/src/libv8_base.a +0 -0
- data/vendor/v8/out/x64.release/obj.target/src/libv8_libbase.a +0 -0
- data/vendor/v8/out/x64.release/obj.target/src/libv8_libplatform.a +0 -0
- data/vendor/v8/out/x64.release/obj.target/src/libv8_libsampler.a +0 -0
- data/vendor/v8/out/x64.release/obj.target/src/libv8_nosnapshot.a +0 -0
- data/vendor/v8/out/x64.release/obj.target/src/libv8_snapshot.a +0 -0
- metadata +25 -27
- data/vendor/v8/include/v8-preparser.h +0 -118
- data/vendor/v8/include/v8stdint.h +0 -54
- data/vendor/v8/out/x64.release/obj.target/tools/gyp/libpreparser_lib.a +0 -0
- data/vendor/v8/out/x64.release/obj.target/tools/gyp/libv8_base.a +0 -0
- data/vendor/v8/out/x64.release/obj.target/tools/gyp/libv8_nosnapshot.a +0 -0
- data/vendor/v8/out/x64.release/obj.target/tools/gyp/libv8_snapshot.a +0 -0
@@ -1,82 +1,72 @@
|
|
1
1
|
// Copyright 2010 the V8 project authors. All rights reserved.
|
2
|
-
//
|
3
|
-
//
|
4
|
-
// met:
|
5
|
-
//
|
6
|
-
// * Redistributions of source code must retain the above copyright
|
7
|
-
// notice, this list of conditions and the following disclaimer.
|
8
|
-
// * Redistributions in binary form must reproduce the above
|
9
|
-
// copyright notice, this list of conditions and the following
|
10
|
-
// disclaimer in the documentation and/or other materials provided
|
11
|
-
// with the distribution.
|
12
|
-
// * Neither the name of Google Inc. nor the names of its
|
13
|
-
// contributors may be used to endorse or promote products derived
|
14
|
-
// from this software without specific prior written permission.
|
15
|
-
//
|
16
|
-
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
17
|
-
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
18
|
-
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
19
|
-
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
20
|
-
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
21
|
-
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
22
|
-
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
23
|
-
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
24
|
-
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
25
|
-
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
26
|
-
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
2
|
+
// Use of this source code is governed by a BSD-style license that can be
|
3
|
+
// found in the LICENSE file.
|
27
4
|
|
28
5
|
#ifndef V8_V8_PROFILER_H_
|
29
6
|
#define V8_V8_PROFILER_H_
|
30
7
|
|
31
|
-
#include
|
8
|
+
#include <vector>
|
9
|
+
#include "v8.h" // NOLINT(build/include)
|
32
10
|
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
#error both BUILDING_V8_SHARED and USING_V8_SHARED are set - please check the\
|
38
|
-
build configuration to ensure that at most one of these is set
|
39
|
-
#endif
|
11
|
+
/**
|
12
|
+
* Profiler support for the V8 JavaScript engine.
|
13
|
+
*/
|
14
|
+
namespace v8 {
|
40
15
|
|
41
|
-
|
42
|
-
|
43
|
-
#elif USING_V8_SHARED
|
44
|
-
#define V8EXPORT __declspec(dllimport)
|
45
|
-
#else
|
46
|
-
#define V8EXPORT
|
47
|
-
#endif
|
16
|
+
class HeapGraphNode;
|
17
|
+
struct HeapStatsUpdate;
|
48
18
|
|
49
|
-
|
19
|
+
typedef uint32_t SnapshotObjectId;
|
50
20
|
|
51
|
-
// Setup for Linux shared library export. See v8.h in this directory for
|
52
|
-
// information on how to build/use V8 as shared library.
|
53
|
-
#if defined(__GNUC__) && ((__GNUC__ >= 4) || \
|
54
|
-
(__GNUC__ == 3 && __GNUC_MINOR__ >= 3)) && defined(V8_SHARED)
|
55
|
-
#define V8EXPORT __attribute__ ((visibility("default")))
|
56
|
-
#else
|
57
|
-
#define V8EXPORT
|
58
|
-
#endif
|
59
21
|
|
60
|
-
|
22
|
+
struct CpuProfileDeoptFrame {
|
23
|
+
int script_id;
|
24
|
+
size_t position;
|
25
|
+
};
|
61
26
|
|
27
|
+
} // namespace v8
|
28
|
+
|
29
|
+
#ifdef V8_OS_WIN
|
30
|
+
template class V8_EXPORT std::vector<v8::CpuProfileDeoptFrame>;
|
31
|
+
#endif
|
62
32
|
|
63
|
-
/**
|
64
|
-
* Profiler support for the V8 JavaScript engine.
|
65
|
-
*/
|
66
33
|
namespace v8 {
|
67
34
|
|
68
|
-
|
35
|
+
struct V8_EXPORT CpuProfileDeoptInfo {
|
36
|
+
/** A pointer to a static string owned by v8. */
|
37
|
+
const char* deopt_reason;
|
38
|
+
std::vector<CpuProfileDeoptFrame> stack;
|
39
|
+
};
|
40
|
+
|
41
|
+
} // namespace v8
|
42
|
+
|
43
|
+
#ifdef V8_OS_WIN
|
44
|
+
template class V8_EXPORT std::vector<v8::CpuProfileDeoptInfo>;
|
45
|
+
#endif
|
46
|
+
|
47
|
+
namespace v8 {
|
69
48
|
|
70
49
|
/**
|
71
50
|
* CpuProfileNode represents a node in a call graph.
|
72
51
|
*/
|
73
|
-
class
|
52
|
+
class V8_EXPORT CpuProfileNode {
|
74
53
|
public:
|
54
|
+
struct LineTick {
|
55
|
+
/** The 1-based number of the source line where the function originates. */
|
56
|
+
int line;
|
57
|
+
|
58
|
+
/** The count of samples associated with the source line. */
|
59
|
+
unsigned int hit_count;
|
60
|
+
};
|
61
|
+
|
75
62
|
/** Returns function name (empty string for anonymous functions.) */
|
76
|
-
|
63
|
+
Local<String> GetFunctionName() const;
|
64
|
+
|
65
|
+
/** Returns id of the script where function is located. */
|
66
|
+
int GetScriptId() const;
|
77
67
|
|
78
68
|
/** Returns resource name for script from where the function originates. */
|
79
|
-
|
69
|
+
Local<String> GetScriptResourceName() const;
|
80
70
|
|
81
71
|
/**
|
82
72
|
* Returns the number, 1-based, of the line where the function originates.
|
@@ -85,96 +75,117 @@ class V8EXPORT CpuProfileNode {
|
|
85
75
|
int GetLineNumber() const;
|
86
76
|
|
87
77
|
/**
|
88
|
-
* Returns
|
89
|
-
*
|
78
|
+
* Returns 1-based number of the column where the function originates.
|
79
|
+
* kNoColumnNumberInfo if no column number information is available.
|
90
80
|
*/
|
91
|
-
|
81
|
+
int GetColumnNumber() const;
|
92
82
|
|
93
83
|
/**
|
94
|
-
* Returns
|
95
|
-
* estimated by samples count.
|
84
|
+
* Returns the number of the function's source lines that collect the samples.
|
96
85
|
*/
|
97
|
-
|
86
|
+
unsigned int GetHitLineCount() const;
|
98
87
|
|
99
|
-
/** Returns the
|
100
|
-
|
88
|
+
/** Returns the set of source lines that collect the samples.
|
89
|
+
* The caller allocates buffer and responsible for releasing it.
|
90
|
+
* True if all available entries are copied, otherwise false.
|
91
|
+
* The function copies nothing if buffer is not large enough.
|
92
|
+
*/
|
93
|
+
bool GetLineTicks(LineTick* entries, unsigned int length) const;
|
101
94
|
|
102
|
-
/** Returns
|
103
|
-
|
95
|
+
/** Returns bailout reason for the function
|
96
|
+
* if the optimization was disabled for it.
|
97
|
+
*/
|
98
|
+
const char* GetBailoutReason() const;
|
99
|
+
|
100
|
+
/**
|
101
|
+
* Returns the count of samples where the function was currently executing.
|
102
|
+
*/
|
103
|
+
unsigned GetHitCount() const;
|
104
104
|
|
105
105
|
/** Returns function entry UID. */
|
106
106
|
unsigned GetCallUid() const;
|
107
107
|
|
108
|
+
/** Returns id of the node. The id is unique within the tree */
|
109
|
+
unsigned GetNodeId() const;
|
110
|
+
|
108
111
|
/** Returns child nodes count of the node. */
|
109
112
|
int GetChildrenCount() const;
|
110
113
|
|
111
114
|
/** Retrieves a child node by index. */
|
112
115
|
const CpuProfileNode* GetChild(int index) const;
|
113
116
|
|
117
|
+
/** Retrieves deopt infos for the node. */
|
118
|
+
const std::vector<CpuProfileDeoptInfo>& GetDeoptInfos() const;
|
119
|
+
|
114
120
|
static const int kNoLineNumberInfo = Message::kNoLineNumberInfo;
|
121
|
+
static const int kNoColumnNumberInfo = Message::kNoColumnInfo;
|
115
122
|
};
|
116
123
|
|
117
124
|
|
118
125
|
/**
|
119
|
-
* CpuProfile contains a CPU profile in a form of
|
120
|
-
*
|
121
|
-
* - bottom-up call graph (in backward direction).
|
126
|
+
* CpuProfile contains a CPU profile in a form of top-down call tree
|
127
|
+
* (from main() down to functions that do all the work).
|
122
128
|
*/
|
123
|
-
class
|
129
|
+
class V8_EXPORT CpuProfile {
|
124
130
|
public:
|
125
|
-
/** Returns CPU profile UID (assigned by the profiler.) */
|
126
|
-
unsigned GetUid() const;
|
127
|
-
|
128
131
|
/** Returns CPU profile title. */
|
129
|
-
|
130
|
-
|
131
|
-
/** Returns the root node of the bottom up call tree. */
|
132
|
-
const CpuProfileNode* GetBottomUpRoot() const;
|
132
|
+
Local<String> GetTitle() const;
|
133
133
|
|
134
134
|
/** Returns the root node of the top down call tree. */
|
135
135
|
const CpuProfileNode* GetTopDownRoot() const;
|
136
136
|
|
137
|
+
/**
|
138
|
+
* Returns number of samples recorded. The samples are not recorded unless
|
139
|
+
* |record_samples| parameter of CpuProfiler::StartCpuProfiling is true.
|
140
|
+
*/
|
141
|
+
int GetSamplesCount() const;
|
142
|
+
|
143
|
+
/**
|
144
|
+
* Returns profile node corresponding to the top frame the sample at
|
145
|
+
* the given index.
|
146
|
+
*/
|
147
|
+
const CpuProfileNode* GetSample(int index) const;
|
148
|
+
|
149
|
+
/**
|
150
|
+
* Returns the timestamp of the sample. The timestamp is the number of
|
151
|
+
* microseconds since some unspecified starting point.
|
152
|
+
* The point is equal to the starting point used by GetStartTime.
|
153
|
+
*/
|
154
|
+
int64_t GetSampleTimestamp(int index) const;
|
155
|
+
|
156
|
+
/**
|
157
|
+
* Returns time when the profile recording was started (in microseconds)
|
158
|
+
* since some unspecified starting point.
|
159
|
+
*/
|
160
|
+
int64_t GetStartTime() const;
|
161
|
+
|
162
|
+
/**
|
163
|
+
* Returns time when the profile recording was stopped (in microseconds)
|
164
|
+
* since some unspecified starting point.
|
165
|
+
* The point is equal to the starting point used by GetStartTime.
|
166
|
+
*/
|
167
|
+
int64_t GetEndTime() const;
|
168
|
+
|
137
169
|
/**
|
138
170
|
* Deletes the profile and removes it from CpuProfiler's list.
|
139
171
|
* All pointers to nodes previously returned become invalid.
|
140
|
-
* Profiles with the same uid but obtained using different
|
141
|
-
* security token are not deleted, but become inaccessible
|
142
|
-
* using FindProfile method. It is embedder's responsibility
|
143
|
-
* to call Delete on these profiles.
|
144
172
|
*/
|
145
173
|
void Delete();
|
146
174
|
};
|
147
175
|
|
148
176
|
|
149
177
|
/**
|
150
|
-
* Interface for controlling CPU profiling.
|
178
|
+
* Interface for controlling CPU profiling. Instance of the
|
179
|
+
* profiler can be retrieved using v8::Isolate::GetCpuProfiler.
|
151
180
|
*/
|
152
|
-
class
|
181
|
+
class V8_EXPORT CpuProfiler {
|
153
182
|
public:
|
154
183
|
/**
|
155
|
-
*
|
156
|
-
*
|
157
|
-
*
|
158
|
-
* single CPU profile. To avoid exposing function names belonging to
|
159
|
-
* other contexts, filtering by security token is performed while
|
160
|
-
* obtaining profiling results.
|
184
|
+
* Changes default CPU profiler sampling interval to the specified number
|
185
|
+
* of microseconds. Default interval is 1000us. This method must be called
|
186
|
+
* when there are no profiles being recorded.
|
161
187
|
*/
|
162
|
-
|
163
|
-
/**
|
164
|
-
* Returns the number of profiles collected (doesn't include
|
165
|
-
* profiles that are being collected at the moment of call.)
|
166
|
-
*/
|
167
|
-
static int GetProfilesCount();
|
168
|
-
|
169
|
-
/** Returns a profile by index. */
|
170
|
-
static const CpuProfile* GetProfile(
|
171
|
-
int index,
|
172
|
-
Handle<Value> security_token = Handle<Value>());
|
173
|
-
|
174
|
-
/** Returns a profile by uid. */
|
175
|
-
static const CpuProfile* FindProfile(
|
176
|
-
unsigned uid,
|
177
|
-
Handle<Value> security_token = Handle<Value>());
|
188
|
+
void SetSamplingInterval(int us);
|
178
189
|
|
179
190
|
/**
|
180
191
|
* Starts collecting CPU profile. Title may be an empty string. It
|
@@ -183,34 +194,43 @@ class V8EXPORT CpuProfiler {
|
|
183
194
|
* title are silently ignored. While collecting a profile, functions
|
184
195
|
* from all security contexts are included in it. The token-based
|
185
196
|
* filtering is only performed when querying for a profile.
|
197
|
+
*
|
198
|
+
* |record_samples| parameter controls whether individual samples should
|
199
|
+
* be recorded in addition to the aggregated tree.
|
186
200
|
*/
|
187
|
-
|
201
|
+
void StartProfiling(Local<String> title, bool record_samples = false);
|
188
202
|
|
189
203
|
/**
|
190
204
|
* Stops collecting CPU profile with a given title and returns it.
|
191
205
|
* If the title given is empty, finishes the last profile started.
|
192
206
|
*/
|
193
|
-
|
194
|
-
Handle<String> title,
|
195
|
-
Handle<Value> security_token = Handle<Value>());
|
207
|
+
CpuProfile* StopProfiling(Local<String> title);
|
196
208
|
|
197
209
|
/**
|
198
|
-
*
|
199
|
-
*
|
200
|
-
*
|
210
|
+
* Force collection of a sample. Must be called on the VM thread.
|
211
|
+
* Recording the forced sample does not contribute to the aggregated
|
212
|
+
* profile statistics.
|
201
213
|
*/
|
202
|
-
|
203
|
-
};
|
214
|
+
void CollectSample();
|
204
215
|
|
216
|
+
/**
|
217
|
+
* Tells the profiler whether the embedder is idle.
|
218
|
+
*/
|
219
|
+
void SetIdle(bool is_idle);
|
205
220
|
|
206
|
-
|
221
|
+
private:
|
222
|
+
CpuProfiler();
|
223
|
+
~CpuProfiler();
|
224
|
+
CpuProfiler(const CpuProfiler&);
|
225
|
+
CpuProfiler& operator=(const CpuProfiler&);
|
226
|
+
};
|
207
227
|
|
208
228
|
|
209
229
|
/**
|
210
230
|
* HeapSnapshotEdge represents a directed connection between heap
|
211
231
|
* graph nodes: from retainers to retained nodes.
|
212
232
|
*/
|
213
|
-
class
|
233
|
+
class V8_EXPORT HeapGraphEdge {
|
214
234
|
public:
|
215
235
|
enum Type {
|
216
236
|
kContextVariable = 0, // A variable from a function context.
|
@@ -233,7 +253,7 @@ class V8EXPORT HeapGraphEdge {
|
|
233
253
|
* Returns edge name. This can be a variable name, an element index, or
|
234
254
|
* a property name.
|
235
255
|
*/
|
236
|
-
|
256
|
+
Local<Value> GetName() const;
|
237
257
|
|
238
258
|
/** Returns origin node. */
|
239
259
|
const HeapGraphNode* GetFromNode() const;
|
@@ -246,20 +266,24 @@ class V8EXPORT HeapGraphEdge {
|
|
246
266
|
/**
|
247
267
|
* HeapGraphNode represents a node in a heap graph.
|
248
268
|
*/
|
249
|
-
class
|
269
|
+
class V8_EXPORT HeapGraphNode {
|
250
270
|
public:
|
251
271
|
enum Type {
|
252
|
-
kHidden = 0,
|
253
|
-
kArray = 1,
|
254
|
-
kString = 2,
|
255
|
-
kObject = 3,
|
256
|
-
kCode = 4,
|
257
|
-
kClosure = 5,
|
258
|
-
kRegExp = 6,
|
259
|
-
kHeapNumber = 7,
|
260
|
-
kNative = 8,
|
261
|
-
kSynthetic = 9
|
262
|
-
|
272
|
+
kHidden = 0, // Hidden node, may be filtered when shown to user.
|
273
|
+
kArray = 1, // An array of elements.
|
274
|
+
kString = 2, // A string.
|
275
|
+
kObject = 3, // A JS object (except for arrays and strings).
|
276
|
+
kCode = 4, // Compiled code.
|
277
|
+
kClosure = 5, // Function closure.
|
278
|
+
kRegExp = 6, // RegExp.
|
279
|
+
kHeapNumber = 7, // Number stored in the heap.
|
280
|
+
kNative = 8, // Native object (not from V8 heap).
|
281
|
+
kSynthetic = 9, // Synthetic object, usualy used for grouping
|
282
|
+
// snapshot items together.
|
283
|
+
kConsString = 10, // Concatenated string. A pair of pointers to strings.
|
284
|
+
kSlicedString = 11, // Sliced string. A fragment of another string.
|
285
|
+
kSymbol = 12, // A Symbol (ES6).
|
286
|
+
kSimdValue = 13 // A SIMD value stored in the heap (Proposed ES7).
|
263
287
|
};
|
264
288
|
|
265
289
|
/** Returns node type (see HeapGraphNode::Type). */
|
@@ -270,7 +294,7 @@ class V8EXPORT HeapGraphNode {
|
|
270
294
|
* of the constructor (for objects), the name of the function (for
|
271
295
|
* closures), string value, or an empty string (for compiled code).
|
272
296
|
*/
|
273
|
-
|
297
|
+
Local<String> GetName() const;
|
274
298
|
|
275
299
|
/**
|
276
300
|
* Returns node id. For the same heap object, the id remains the same
|
@@ -279,43 +303,56 @@ class V8EXPORT HeapGraphNode {
|
|
279
303
|
SnapshotObjectId GetId() const;
|
280
304
|
|
281
305
|
/** Returns node's own size, in bytes. */
|
282
|
-
|
306
|
+
size_t GetShallowSize() const;
|
283
307
|
|
284
308
|
/** Returns child nodes count of the node. */
|
285
309
|
int GetChildrenCount() const;
|
286
310
|
|
287
311
|
/** Retrieves a child by index. */
|
288
312
|
const HeapGraphEdge* GetChild(int index) const;
|
313
|
+
};
|
314
|
+
|
289
315
|
|
316
|
+
/**
|
317
|
+
* An interface for exporting data from V8, using "push" model.
|
318
|
+
*/
|
319
|
+
class V8_EXPORT OutputStream { // NOLINT
|
320
|
+
public:
|
321
|
+
enum WriteResult {
|
322
|
+
kContinue = 0,
|
323
|
+
kAbort = 1
|
324
|
+
};
|
325
|
+
virtual ~OutputStream() {}
|
326
|
+
/** Notify about the end of stream. */
|
327
|
+
virtual void EndOfStream() = 0;
|
328
|
+
/** Get preferred output chunk size. Called only once. */
|
329
|
+
virtual int GetChunkSize() { return 1024; }
|
330
|
+
/**
|
331
|
+
* Writes the next chunk of snapshot data into the stream. Writing
|
332
|
+
* can be stopped by returning kAbort as function result. EndOfStream
|
333
|
+
* will not be called in case writing was aborted.
|
334
|
+
*/
|
335
|
+
virtual WriteResult WriteAsciiChunk(char* data, int size) = 0;
|
290
336
|
/**
|
291
|
-
*
|
292
|
-
*
|
337
|
+
* Writes the next chunk of heap stats data into the stream. Writing
|
338
|
+
* can be stopped by returning kAbort as function result. EndOfStream
|
339
|
+
* will not be called in case writing was aborted.
|
293
340
|
*/
|
294
|
-
|
341
|
+
virtual WriteResult WriteHeapStatsChunk(HeapStatsUpdate* data, int count) {
|
342
|
+
return kAbort;
|
343
|
+
}
|
295
344
|
};
|
296
345
|
|
297
346
|
|
298
347
|
/**
|
299
348
|
* HeapSnapshots record the state of the JS heap at some moment.
|
300
349
|
*/
|
301
|
-
class
|
350
|
+
class V8_EXPORT HeapSnapshot {
|
302
351
|
public:
|
303
|
-
enum Type {
|
304
|
-
kFull = 0 // Heap snapshot with all instances and references.
|
305
|
-
};
|
306
352
|
enum SerializationFormat {
|
307
353
|
kJSON = 0 // See format description near 'Serialize' method.
|
308
354
|
};
|
309
355
|
|
310
|
-
/** Returns heap snapshot type. */
|
311
|
-
Type GetType() const;
|
312
|
-
|
313
|
-
/** Returns heap snapshot UID (assigned by the profiler.) */
|
314
|
-
unsigned GetUid() const;
|
315
|
-
|
316
|
-
/** Returns heap snapshot title. */
|
317
|
-
Handle<String> GetTitle() const;
|
318
|
-
|
319
356
|
/** Returns the root node of the heap graph. */
|
320
357
|
const HeapGraphNode* GetRoot() const;
|
321
358
|
|
@@ -364,40 +401,158 @@ class V8EXPORT HeapSnapshot {
|
|
364
401
|
* Nodes reference strings, other nodes, and edges by their indexes
|
365
402
|
* in corresponding arrays.
|
366
403
|
*/
|
367
|
-
void Serialize(OutputStream* stream,
|
404
|
+
void Serialize(OutputStream* stream,
|
405
|
+
SerializationFormat format = kJSON) const;
|
368
406
|
};
|
369
407
|
|
370
408
|
|
371
|
-
|
409
|
+
/**
|
410
|
+
* An interface for reporting progress and controlling long-running
|
411
|
+
* activities.
|
412
|
+
*/
|
413
|
+
class V8_EXPORT ActivityControl { // NOLINT
|
414
|
+
public:
|
415
|
+
enum ControlOption {
|
416
|
+
kContinue = 0,
|
417
|
+
kAbort = 1
|
418
|
+
};
|
419
|
+
virtual ~ActivityControl() {}
|
420
|
+
/**
|
421
|
+
* Notify about current progress. The activity can be stopped by
|
422
|
+
* returning kAbort as the callback result.
|
423
|
+
*/
|
424
|
+
virtual ControlOption ReportProgressValue(int done, int total) = 0;
|
425
|
+
};
|
426
|
+
|
372
427
|
|
373
428
|
/**
|
374
|
-
*
|
429
|
+
* AllocationProfile is a sampled profile of allocations done by the program.
|
430
|
+
* This is structured as a call-graph.
|
375
431
|
*/
|
376
|
-
class
|
432
|
+
class V8_EXPORT AllocationProfile {
|
377
433
|
public:
|
434
|
+
struct Allocation {
|
435
|
+
/**
|
436
|
+
* Size of the sampled allocation object.
|
437
|
+
*/
|
438
|
+
size_t size;
|
439
|
+
|
440
|
+
/**
|
441
|
+
* The number of objects of such size that were sampled.
|
442
|
+
*/
|
443
|
+
unsigned int count;
|
444
|
+
};
|
445
|
+
|
446
|
+
/**
|
447
|
+
* Represents a node in the call-graph.
|
448
|
+
*/
|
449
|
+
struct Node {
|
450
|
+
/**
|
451
|
+
* Name of the function. May be empty for anonymous functions or if the
|
452
|
+
* script corresponding to this function has been unloaded.
|
453
|
+
*/
|
454
|
+
Local<String> name;
|
455
|
+
|
456
|
+
/**
|
457
|
+
* Name of the script containing the function. May be empty if the script
|
458
|
+
* name is not available, or if the script has been unloaded.
|
459
|
+
*/
|
460
|
+
Local<String> script_name;
|
461
|
+
|
462
|
+
/**
|
463
|
+
* id of the script where the function is located. May be equal to
|
464
|
+
* v8::UnboundScript::kNoScriptId in cases where the script doesn't exist.
|
465
|
+
*/
|
466
|
+
int script_id;
|
467
|
+
|
468
|
+
/**
|
469
|
+
* Start position of the function in the script.
|
470
|
+
*/
|
471
|
+
int start_position;
|
472
|
+
|
473
|
+
/**
|
474
|
+
* 1-indexed line number where the function starts. May be
|
475
|
+
* kNoLineNumberInfo if no line number information is available.
|
476
|
+
*/
|
477
|
+
int line_number;
|
478
|
+
|
479
|
+
/**
|
480
|
+
* 1-indexed column number where the function starts. May be
|
481
|
+
* kNoColumnNumberInfo if no line number information is available.
|
482
|
+
*/
|
483
|
+
int column_number;
|
484
|
+
|
485
|
+
/**
|
486
|
+
* List of callees called from this node for which we have sampled
|
487
|
+
* allocations. The lifetime of the children is scoped to the containing
|
488
|
+
* AllocationProfile.
|
489
|
+
*/
|
490
|
+
std::vector<Node*> children;
|
491
|
+
|
492
|
+
/**
|
493
|
+
* List of self allocations done by this node in the call-graph.
|
494
|
+
*/
|
495
|
+
std::vector<Allocation> allocations;
|
496
|
+
};
|
497
|
+
|
498
|
+
/**
|
499
|
+
* Returns the root node of the call-graph. The root node corresponds to an
|
500
|
+
* empty JS call-stack. The lifetime of the returned Node* is scoped to the
|
501
|
+
* containing AllocationProfile.
|
502
|
+
*/
|
503
|
+
virtual Node* GetRootNode() = 0;
|
504
|
+
|
505
|
+
virtual ~AllocationProfile() {}
|
506
|
+
|
507
|
+
static const int kNoLineNumberInfo = Message::kNoLineNumberInfo;
|
508
|
+
static const int kNoColumnNumberInfo = Message::kNoColumnInfo;
|
509
|
+
};
|
510
|
+
|
511
|
+
|
512
|
+
/**
|
513
|
+
* Interface for controlling heap profiling. Instance of the
|
514
|
+
* profiler can be retrieved using v8::Isolate::GetHeapProfiler.
|
515
|
+
*/
|
516
|
+
class V8_EXPORT HeapProfiler {
|
517
|
+
public:
|
518
|
+
enum SamplingFlags {
|
519
|
+
kSamplingNoFlags = 0,
|
520
|
+
kSamplingForceGC = 1 << 0,
|
521
|
+
};
|
522
|
+
|
378
523
|
/**
|
379
524
|
* Callback function invoked for obtaining RetainedObjectInfo for
|
380
525
|
* the given JavaScript wrapper object. It is prohibited to enter V8
|
381
526
|
* while the callback is running: only getters on the handle and
|
382
527
|
* GetPointerFromInternalField on the objects are allowed.
|
383
528
|
*/
|
384
|
-
typedef RetainedObjectInfo* (*WrapperInfoCallback)
|
385
|
-
|
529
|
+
typedef RetainedObjectInfo* (*WrapperInfoCallback)(uint16_t class_id,
|
530
|
+
Local<Value> wrapper);
|
386
531
|
|
387
532
|
/** Returns the number of snapshots taken. */
|
388
|
-
|
533
|
+
int GetSnapshotCount();
|
389
534
|
|
390
535
|
/** Returns a snapshot by index. */
|
391
|
-
|
392
|
-
|
393
|
-
/** Returns a profile by uid. */
|
394
|
-
static const HeapSnapshot* FindSnapshot(unsigned uid);
|
536
|
+
const HeapSnapshot* GetHeapSnapshot(int index);
|
395
537
|
|
396
538
|
/**
|
397
539
|
* Returns SnapshotObjectId for a heap object referenced by |value| if
|
398
540
|
* it has been seen by the heap profiler, kUnknownObjectId otherwise.
|
399
541
|
*/
|
400
|
-
|
542
|
+
SnapshotObjectId GetObjectId(Local<Value> value);
|
543
|
+
|
544
|
+
/**
|
545
|
+
* Returns heap object with given SnapshotObjectId if the object is alive,
|
546
|
+
* otherwise empty handle is returned.
|
547
|
+
*/
|
548
|
+
Local<Value> FindObjectById(SnapshotObjectId id);
|
549
|
+
|
550
|
+
/**
|
551
|
+
* Clears internal map from SnapshotObjectId to heap object. The new objects
|
552
|
+
* will not be added into it unless a heap snapshot is taken or heap object
|
553
|
+
* tracking is kicked off.
|
554
|
+
*/
|
555
|
+
void ClearObjectIds();
|
401
556
|
|
402
557
|
/**
|
403
558
|
* A constant for invalid SnapshotObjectId. GetSnapshotObjectId will return
|
@@ -410,23 +565,21 @@ class V8EXPORT HeapProfiler {
|
|
410
565
|
* Callback interface for retrieving user friendly names of global objects.
|
411
566
|
*/
|
412
567
|
class ObjectNameResolver {
|
413
|
-
|
568
|
+
public:
|
414
569
|
/**
|
415
570
|
* Returns name to be used in the heap snapshot for given node. Returned
|
416
571
|
* string must stay alive until snapshot collection is completed.
|
417
572
|
*/
|
418
|
-
virtual const char* GetName(
|
419
|
-
|
573
|
+
virtual const char* GetName(Local<Object> object) = 0;
|
574
|
+
|
575
|
+
protected:
|
420
576
|
virtual ~ObjectNameResolver() {}
|
421
577
|
};
|
422
578
|
|
423
579
|
/**
|
424
|
-
* Takes a heap snapshot and returns it.
|
425
|
-
* See HeapSnapshot::Type for types description.
|
580
|
+
* Takes a heap snapshot and returns it.
|
426
581
|
*/
|
427
|
-
|
428
|
-
Handle<String> title,
|
429
|
-
HeapSnapshot::Type type = HeapSnapshot::kFull,
|
582
|
+
const HeapSnapshot* TakeHeapSnapshot(
|
430
583
|
ActivityControl* control = NULL,
|
431
584
|
ObjectNameResolver* global_object_name_resolver = NULL);
|
432
585
|
|
@@ -434,8 +587,12 @@ class V8EXPORT HeapProfiler {
|
|
434
587
|
* Starts tracking of heap objects population statistics. After calling
|
435
588
|
* this method, all heap objects relocations done by the garbage collector
|
436
589
|
* are being registered.
|
590
|
+
*
|
591
|
+
* |track_allocations| parameter controls whether stack trace of each
|
592
|
+
* allocation in the heap will be recorded and reported as part of
|
593
|
+
* HeapSnapshot.
|
437
594
|
*/
|
438
|
-
|
595
|
+
void StartTrackingHeapObjects(bool track_allocations = false);
|
439
596
|
|
440
597
|
/**
|
441
598
|
* Adds a new time interval entry to the aggregated statistics array. The
|
@@ -444,28 +601,74 @@ class V8EXPORT HeapProfiler {
|
|
444
601
|
* reports updates for all previous time intervals via the OutputStream
|
445
602
|
* object. Updates on each time interval are provided as a stream of the
|
446
603
|
* HeapStatsUpdate structure instances.
|
447
|
-
*
|
604
|
+
* If |timestamp_us| is supplied, timestamp of the new entry will be written
|
605
|
+
* into it. The return value of the function is the last seen heap object Id.
|
448
606
|
*
|
449
|
-
*
|
607
|
+
* StartTrackingHeapObjects must be called before the first call to this
|
450
608
|
* method.
|
451
609
|
*/
|
452
|
-
|
610
|
+
SnapshotObjectId GetHeapStats(OutputStream* stream,
|
611
|
+
int64_t* timestamp_us = NULL);
|
453
612
|
|
454
613
|
/**
|
455
614
|
* Stops tracking of heap objects population statistics, cleans up all
|
456
615
|
* collected data. StartHeapObjectsTracking must be called again prior to
|
457
|
-
* calling
|
616
|
+
* calling GetHeapStats next time.
|
617
|
+
*/
|
618
|
+
void StopTrackingHeapObjects();
|
619
|
+
|
620
|
+
/**
|
621
|
+
* Starts gathering a sampling heap profile. A sampling heap profile is
|
622
|
+
* similar to tcmalloc's heap profiler and Go's mprof. It samples object
|
623
|
+
* allocations and builds an online 'sampling' heap profile. At any point in
|
624
|
+
* time, this profile is expected to be a representative sample of objects
|
625
|
+
* currently live in the system. Each sampled allocation includes the stack
|
626
|
+
* trace at the time of allocation, which makes this really useful for memory
|
627
|
+
* leak detection.
|
628
|
+
*
|
629
|
+
* This mechanism is intended to be cheap enough that it can be used in
|
630
|
+
* production with minimal performance overhead.
|
631
|
+
*
|
632
|
+
* Allocations are sampled using a randomized Poisson process. On average, one
|
633
|
+
* allocation will be sampled every |sample_interval| bytes allocated. The
|
634
|
+
* |stack_depth| parameter controls the maximum number of stack frames to be
|
635
|
+
* captured on each allocation.
|
636
|
+
*
|
637
|
+
* NOTE: This is a proof-of-concept at this point. Right now we only sample
|
638
|
+
* newspace allocations. Support for paged space allocation (e.g. pre-tenured
|
639
|
+
* objects, large objects, code objects, etc.) and native allocations
|
640
|
+
* doesn't exist yet, but is anticipated in the future.
|
641
|
+
*
|
642
|
+
* Objects allocated before the sampling is started will not be included in
|
643
|
+
* the profile.
|
644
|
+
*
|
645
|
+
* Returns false if a sampling heap profiler is already running.
|
646
|
+
*/
|
647
|
+
bool StartSamplingHeapProfiler(uint64_t sample_interval = 512 * 1024,
|
648
|
+
int stack_depth = 16,
|
649
|
+
SamplingFlags flags = kSamplingNoFlags);
|
650
|
+
|
651
|
+
/**
|
652
|
+
* Stops the sampling heap profile and discards the current profile.
|
653
|
+
*/
|
654
|
+
void StopSamplingHeapProfiler();
|
655
|
+
|
656
|
+
/**
|
657
|
+
* Returns the sampled profile of allocations allocated (and still live) since
|
658
|
+
* StartSamplingHeapProfiler was called. The ownership of the pointer is
|
659
|
+
* transfered to the caller. Returns nullptr if sampling heap profiler is not
|
660
|
+
* active.
|
458
661
|
*/
|
459
|
-
|
662
|
+
AllocationProfile* GetAllocationProfile();
|
460
663
|
|
461
664
|
/**
|
462
665
|
* Deletes all snapshots taken. All previously returned pointers to
|
463
666
|
* snapshots and their contents become invalid after this call.
|
464
667
|
*/
|
465
|
-
|
668
|
+
void DeleteAllHeapSnapshots();
|
466
669
|
|
467
670
|
/** Binds a callback to embedder's class ID. */
|
468
|
-
|
671
|
+
void SetWrapperClassInfoProvider(
|
469
672
|
uint16_t class_id,
|
470
673
|
WrapperInfoCallback callback);
|
471
674
|
|
@@ -476,13 +679,20 @@ class V8EXPORT HeapProfiler {
|
|
476
679
|
*/
|
477
680
|
static const uint16_t kPersistentHandleNoClassId = 0;
|
478
681
|
|
479
|
-
/** Returns the number of currently existing persistent handles. */
|
480
|
-
static int GetPersistentHandleCount();
|
481
|
-
|
482
682
|
/** Returns memory used for profiler internal data and snapshots. */
|
483
|
-
|
484
|
-
|
683
|
+
size_t GetProfilerMemorySize();
|
684
|
+
|
685
|
+
/**
|
686
|
+
* Sets a RetainedObjectInfo for an object group (see V8::SetObjectGroupId).
|
687
|
+
*/
|
688
|
+
void SetRetainedObjectInfo(UniqueId id, RetainedObjectInfo* info);
|
485
689
|
|
690
|
+
private:
|
691
|
+
HeapProfiler();
|
692
|
+
~HeapProfiler();
|
693
|
+
HeapProfiler(const HeapProfiler&);
|
694
|
+
HeapProfiler& operator=(const HeapProfiler&);
|
695
|
+
};
|
486
696
|
|
487
697
|
/**
|
488
698
|
* Interface for providing information about embedder's objects
|
@@ -498,17 +708,17 @@ class V8EXPORT HeapProfiler {
|
|
498
708
|
* were not previously reported via AddObjectGroup.
|
499
709
|
*
|
500
710
|
* Thus, if an embedder wants to provide information about native
|
501
|
-
* objects for heap snapshots,
|
711
|
+
* objects for heap snapshots, it can do it in a GC prologue
|
502
712
|
* handler, and / or by assigning wrapper class ids in the following way:
|
503
713
|
*
|
504
|
-
* 1. Bind a callback to class id by calling
|
714
|
+
* 1. Bind a callback to class id by calling SetWrapperClassInfoProvider.
|
505
715
|
* 2. Call SetWrapperClassId on certain persistent handles.
|
506
716
|
*
|
507
717
|
* V8 takes ownership of RetainedObjectInfo instances passed to it and
|
508
718
|
* keeps them alive only during snapshot collection. Afterwards, they
|
509
719
|
* are freed by calling the Dispose class function.
|
510
720
|
*/
|
511
|
-
class
|
721
|
+
class V8_EXPORT RetainedObjectInfo { // NOLINT
|
512
722
|
public:
|
513
723
|
/** Called by V8 when it no longer needs an instance. */
|
514
724
|
virtual void Dispose() = 0;
|
@@ -560,7 +770,7 @@ class V8EXPORT RetainedObjectInfo { // NOLINT
|
|
560
770
|
|
561
771
|
/**
|
562
772
|
* A struct for exporting HeapStats data from V8, using "push" model.
|
563
|
-
* See HeapProfiler::
|
773
|
+
* See HeapProfiler::GetHeapStats.
|
564
774
|
*/
|
565
775
|
struct HeapStatsUpdate {
|
566
776
|
HeapStatsUpdate(uint32_t index, uint32_t count, uint32_t size)
|
@@ -574,7 +784,4 @@ struct HeapStatsUpdate {
|
|
574
784
|
} // namespace v8
|
575
785
|
|
576
786
|
|
577
|
-
#undef V8EXPORT
|
578
|
-
|
579
|
-
|
580
787
|
#endif // V8_V8_PROFILER_H_
|