libv8 3.16.14.19.1-armv7l-linux → 5.3.332.38.5-armv7l-linux
Sign up to get free protection for your applications and to get access to all the features.
- 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/arm.release/libv8_base.a +0 -0
- data/vendor/v8/out/arm.release/libv8_libbase.a +0 -0
- data/vendor/v8/out/arm.release/libv8_libplatform.a +0 -0
- data/vendor/v8/out/arm.release/libv8_libsampler.a +0 -0
- data/vendor/v8/out/arm.release/libv8_nosnapshot.a +0 -0
- data/vendor/v8/out/arm.release/libv8_snapshot.a +0 -0
- data/vendor/v8/out/arm.release/obj.target/src/libv8_base.a +0 -0
- data/vendor/v8/out/arm.release/obj.target/src/libv8_libbase.a +0 -0
- data/vendor/v8/out/arm.release/obj.target/src/libv8_libplatform.a +0 -0
- data/vendor/v8/out/arm.release/obj.target/src/libv8_libsampler.a +0 -0
- data/vendor/v8/out/arm.release/obj.target/src/libv8_nosnapshot.a +0 -0
- data/vendor/v8/out/arm.release/obj.target/src/libv8_snapshot.a +0 -0
- metadata +23 -25
- data/vendor/v8/include/v8-preparser.h +0 -118
- data/vendor/v8/include/v8stdint.h +0 -54
- data/vendor/v8/out/arm.release/obj.target/tools/gyp/libpreparser_lib.a +0 -0
- data/vendor/v8/out/arm.release/obj.target/tools/gyp/libv8_base.a +0 -0
- data/vendor/v8/out/arm.release/obj.target/tools/gyp/libv8_nosnapshot.a +0 -0
- data/vendor/v8/out/arm.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_
|