v8::CpuProfiler Class Reference

Interface for controlling CPU profiling. More...

#include <v8-profiler.h>

Collaboration diagram for v8::CpuProfiler:

Public Member Functions
void	SetSamplingInterval (int us)
	Changes default CPU profiler sampling interval to the specified number of microseconds. More...
void	StartProfiling (Handle< String > title, bool record_samples=false)
	Starts collecting CPU profile. More...
	V8_DEPRECATED ("Use StartProfiling", void StartCpuProfiling(Handle< String > title, bool record_samples=false))
	Deprecated. More...
CpuProfile *	StopProfiling (Handle< String > title)
	Stops collecting CPU profile with a given title and returns it. More...
	V8_DEPRECATED ("Use StopProfiling", const CpuProfile *StopCpuProfiling(Handle< String > title))
	Deprecated. More...
void	SetIdle (bool is_idle)
	Tells the profiler whether the embedder is idle. More...

Private Member Functions
	CpuProfiler ()
	~CpuProfiler ()
	CpuProfiler (const CpuProfiler &)
CpuProfiler &	operator= (const CpuProfiler &)

Detailed Description

Interface for controlling CPU profiling.

Instance of the profiler can be retrieved using v8::Isolate::GetCpuProfiler.

Definition at line 129 of file v8-profiler.h.

Constructor & Destructor Documentation

CpuProfiler() [1/2]

v8::CpuProfiler::CpuProfiler ( )

private

~CpuProfiler()

v8::CpuProfiler::~CpuProfiler ( )

private

CpuProfiler() [2/2]

v8::CpuProfiler::CpuProfiler ( const CpuProfiler &  )

private

Member Function Documentation

operator=()

CpuProfiler& v8::CpuProfiler::operator= ( const CpuProfiler &  )

private

SetIdle()

void v8::CpuProfiler::SetIdle

(

bool

is_idle

)

Tells the profiler whether the embedder is idle.

Definition at line 7200 of file api.cc.

                                      {
  i::Isolate* isolate = reinterpret_cast<i::CpuProfiler*>(this)->isolate();
  i::StateTag state = isolate->current_vm_state();
  DCHECK(state == i::EXTERNAL || state == i::IDLE);
  if (isolate->js_entry_sp() != NULL) return;
  if (is_idle) {
    isolate->set_current_vm_state(i::IDLE);
  } else if (state == i::IDLE) {
    isolate->set_current_vm_state(i::EXTERNAL);
  }
}

References DCHECK, v8::internal::EXTERNAL, v8::internal::IDLE, v8::internal::Isolate::js_entry_sp(), and NULL.

Here is the call graph for this function:

SetSamplingInterval()

void v8::CpuProfiler::SetSamplingInterval

(

int

us

)

Changes default CPU profiler sampling interval to the specified number of microseconds.

Default interval is 1000us. This method must be called when there are no profiles being recorded.

Definition at line 7170 of file api.cc.

                                            {
  DCHECK(us >= 0);
  return reinterpret_cast<i::CpuProfiler*>(this)->set_sampling_interval(
      base::TimeDelta::FromMicroseconds(us));
}

References DCHECK.

StartProfiling()

void v8::CpuProfiler::StartProfiling	(	Handle< String >	title,
		bool	record_samples = false
	)

Starts collecting CPU profile.

Title may be an empty string. It is allowed to have several profiles being collected at once. Attempts to start collecting several profiles with the same title are silently ignored. While collecting a profile, functions from all security contexts are included in it. The token-based filtering is only performed when querying for a profile.

|record_samples| parameter controls whether individual samples should be recorded in addition to the aggregated tree.

Definition at line 7177 of file api.cc.

                                                                          {
  reinterpret_cast<i::CpuProfiler*>(this)->StartProfiling(
      *Utils::OpenHandle(*title), record_samples);
}

References v8::Utils::OpenHandle().

Here is the call graph for this function:

StopProfiling()

CpuProfile * v8::CpuProfiler::StopProfiling

(

Handle< String >

title

)

Stops collecting CPU profile with a given title and returns it.

If the title given is empty, finishes the last profile started.

Definition at line 7188 of file api.cc.

                                                           {
  return reinterpret_cast<CpuProfile*>(
      reinterpret_cast<i::CpuProfiler*>(this)->StopProfiling(
          *Utils::OpenHandle(*title)));
}

References v8::Utils::OpenHandle().

Here is the call graph for this function:

V8_DEPRECATED() [1/2]

v8::CpuProfiler::V8_DEPRECATED	(	"Use StartProfiling"	,
		void	StartCpuProfilingHandle< String > title, bool record_samples=false
	)

Deprecated.

Use StartProfiling instead.

V8_DEPRECATED() [2/2]

v8::CpuProfiler::V8_DEPRECATED	(	"Use StopProfiling"	,
		const CpuProfile *	StopCpuProfilingHandle< String > title
	)

Deprecated.

Use StopProfiling instead.

---

The documentation for this class was generated from the following files:

• /mnt/V8SourceCode/include/v8-profiler.h
• /mnt/V8SourceCode/src/api.cc