v8::internal::Builtins Class Reference

#include <builtins.h>

Collaboration diagram for v8::internal::Builtins:

Public Types
enum	Name { builtin_count }
enum	CFunctionId { cfunction_count }
enum	JavaScript { id_count }

Public Member Functions
	~Builtins ()
void	SetUp (Isolate *isolate, bool create_heap_objects)
void	TearDown ()
void	IterateBuiltins (ObjectVisitor *v)
const char *	Lookup (byte *pc)
Code *	builtin (Name name)
Address	builtin_address (Name name)
const char *	name (int index)
Handle< Code >	GetCode (JavaScript id, bool *resolved)
bool	is_initialized () const

Static Public Member Functions
static Address	c_function_address (CFunctionId id)
static const char *	GetName (JavaScript id)
static int	GetArgumentsCount (JavaScript id)
static int	NumberOfJavaScriptBuiltins ()

Private Member Functions
	Builtins ()
	DISALLOW_COPY_AND_ASSIGN (Builtins)

Static Private Member Functions
static void	Generate_Adaptor (MacroAssembler *masm, CFunctionId id, BuiltinExtraArguments extra_args)
static void	Generate_CompileLazy (MacroAssembler *masm)
static void	Generate_InOptimizationQueue (MacroAssembler *masm)
static void	Generate_CompileOptimized (MacroAssembler *masm)
static void	Generate_CompileOptimizedConcurrent (MacroAssembler *masm)
static void	Generate_JSConstructStubGeneric (MacroAssembler *masm)
static void	Generate_JSConstructStubApi (MacroAssembler *masm)
static void	Generate_JSEntryTrampoline (MacroAssembler *masm)
static void	Generate_JSConstructEntryTrampoline (MacroAssembler *masm)
static void	Generate_NotifyDeoptimized (MacroAssembler *masm)
static void	Generate_NotifySoftDeoptimized (MacroAssembler *masm)
static void	Generate_NotifyLazyDeoptimized (MacroAssembler *masm)
static void	Generate_NotifyStubFailure (MacroAssembler *masm)
static void	Generate_NotifyStubFailureSaveDoubles (MacroAssembler *masm)
static void	Generate_ArgumentsAdaptorTrampoline (MacroAssembler *masm)
static void	Generate_FunctionCall (MacroAssembler *masm)
static void	Generate_FunctionApply (MacroAssembler *masm)
static void	Generate_InternalArrayCode (MacroAssembler *masm)
static void	Generate_ArrayCode (MacroAssembler *masm)
static void	Generate_StringConstructCode (MacroAssembler *masm)
static void	Generate_OnStackReplacement (MacroAssembler *masm)
static void	Generate_OsrAfterStackCheck (MacroAssembler *masm)
static void	Generate_InterruptCheck (MacroAssembler *masm)
static void	Generate_StackCheck (MacroAssembler *masm)
static void	Generate_MarkCodeAsExecutedOnce (MacroAssembler *masm)
static void	Generate_MarkCodeAsExecutedTwice (MacroAssembler *masm)
static void	InitBuiltinFunctionTable ()

Private Attributes
Object *	builtins_ [builtin_count]
const char *	names_ [builtin_count]
bool	initialized_

Static Private Attributes
static Address const	c_functions_ [cfunction_count]
static const char *const	javascript_names_ [id_count]
static int const	javascript_argc_ [id_count]

Friends
class	BuiltinFunctionTable
class	Isolate

Detailed Description

Definition at line 201 of file builtins.h.

Member Enumeration Documentation

CFunctionId

enum v8::internal::Builtins::CFunctionId

Enumerator
cfunction_count

Definition at line 229 of file builtins.h.

                   {
#define DEF_ENUM_C(name, ignore) c_##name,
    BUILTIN_LIST_C(DEF_ENUM_C)
#undef DEF_ENUM_C
    cfunction_count
  };

JavaScript

enum v8::internal::Builtins::JavaScript

Enumerator
id_count

Definition at line 236 of file builtins.h.

                  {
#define DEF_ENUM(name, ignore) name,
    BUILTINS_LIST_JS(DEF_ENUM)
#undef DEF_ENUM
    id_count
  };

Name

enum v8::internal::Builtins::Name

Enumerator
builtin_count

Definition at line 216 of file builtins.h.

            {
#define DEF_ENUM_C(name, ignore) k##name,
#define DEF_ENUM_A(name, kind, state, extra) k##name,
#define DEF_ENUM_H(name, kind) k##name,
    BUILTIN_LIST_C(DEF_ENUM_C)
    BUILTIN_LIST_A(DEF_ENUM_A)
    BUILTIN_LIST_H(DEF_ENUM_H)
    BUILTIN_LIST_DEBUG_A(DEF_ENUM_A)
#undef DEF_ENUM_C
#undef DEF_ENUM_A
    builtin_count
  };

Constructor & Destructor Documentation

~Builtins()

v8::internal::Builtins::~Builtins

(

)

Definition at line 1429 of file builtins.cc.

                    {
}

Builtins()

v8::internal::Builtins::Builtins ( )

private

Definition at line 1423 of file builtins.cc.

                   : initialized_(false) {
  memset(builtins_, 0, sizeof(builtins_[0]) * builtin_count);
  memset(names_, 0, sizeof(names_[0]) * builtin_count);
}

References builtin_count, builtins_, and names_.

Member Function Documentation

builtin()

Code* v8::internal::Builtins::builtin ( Name  name )

inline

Definition at line 254 of file builtins.h.

                           {
    // Code::cast cannot be used here since we access builtins
    // during the marking phase of mark sweep. See IC::Clear.
    return reinterpret_cast<Code*>(builtins_[name]);
  }

References builtins_, and name().

Referenced by v8::internal::BackEdgeTable::AddStackCheck(), v8::internal::StubCache::Clear(), v8::internal::ConstantPoolArray::ClearPtrEntries(), v8::internal::Logger::CodeCreateEvent(), v8::internal::Deoptimizer::DoComputeAccessorStubFrame(), v8::internal::Deoptimizer::DoComputeArgumentsAdaptorFrame(), v8::internal::Deoptimizer::DoComputeCompiledStubFrame(), v8::internal::Deoptimizer::DoComputeConstructStubFrame(), v8::internal::Deoptimizer::DoComputeJSFrame(), v8::internal::DropFrames(), v8::internal::Debug::HandleStepIn(), v8::internal::InstallBuiltin(), v8::internal::InstallFunction(), v8::internal::SharedFunctionInfo::is_compiled(), v8::internal::JSFunction::is_compiled(), v8::internal::JSFunction::IsInOptimizationQueue(), v8::internal::JSFunction::IsMarkedForConcurrentOptimization(), v8::internal::JSFunction::IsMarkedForOptimization(), v8::internal::TypeFeedbackOracle::LoadIsBuiltin(), v8::internal::CpuProfiler::LogBuiltins(), v8::internal::BackEdgeTable::Patch(), v8::internal::Debug::PrepareStep(), v8::internal::CodeFlusher::ProcessJSFunctionCandidates(), v8::internal::CodeFlusher::ProcessSharedFunctionInfoCandidates(), v8::internal::BackEdgeTable::RemoveStackCheck(), v8::internal::LiveEdit::ReplaceFunctionCode(), v8::internal::BackEdgeTable::Revert(), v8::internal::StubCache::Set(), v8::internal::LiveEdit::SetAfterBreakTarget(), v8::internal::TraceTopFrame(), and v8::internal::ArgumentsAdaptorFrame::unchecked_code().

Here is the call graph for this function:

Here is the caller graph for this function:

builtin_address()

Address v8::internal::Builtins::builtin_address ( Name  name )

inline

Definition at line 260 of file builtins.h.

                                     {
    return reinterpret_cast<Address>(&builtins_[name]);
  }

References builtins_, and name().

Here is the call graph for this function:

c_function_address()

static Address v8::internal::Builtins::c_function_address ( CFunctionId  id )

inlinestatic

Definition at line 264 of file builtins.h.

                                                    {
    return c_functions_[id];
  }

References c_functions_.

DISALLOW_COPY_AND_ASSIGN()

v8::internal::Builtins::DISALLOW_COPY_AND_ASSIGN ( Builtins  )

private

Generate_Adaptor()

static void v8::internal::Builtins::Generate_Adaptor ( MacroAssembler *  masm, CFunctionId  id, BuiltinExtraArguments  extra_args  )

staticprivate

Generate_ArgumentsAdaptorTrampoline()

static void v8::internal::Builtins::Generate_ArgumentsAdaptorTrampoline ( MacroAssembler *  masm )

staticprivate

Generate_ArrayCode()

static void v8::internal::Builtins::Generate_ArrayCode ( MacroAssembler *  masm )

staticprivate

Generate_CompileLazy()

static void v8::internal::Builtins::Generate_CompileLazy ( MacroAssembler *  masm )

staticprivate

Generate_CompileOptimized()

static void v8::internal::Builtins::Generate_CompileOptimized ( MacroAssembler *  masm )

staticprivate

Generate_CompileOptimizedConcurrent()

static void v8::internal::Builtins::Generate_CompileOptimizedConcurrent ( MacroAssembler *  masm )

staticprivate

Generate_FunctionApply()

static void v8::internal::Builtins::Generate_FunctionApply ( MacroAssembler *  masm )

staticprivate

Generate_FunctionCall()

static void v8::internal::Builtins::Generate_FunctionCall ( MacroAssembler *  masm )

staticprivate

Generate_InOptimizationQueue()

static void v8::internal::Builtins::Generate_InOptimizationQueue ( MacroAssembler *  masm )

staticprivate

Generate_InternalArrayCode()

static void v8::internal::Builtins::Generate_InternalArrayCode ( MacroAssembler *  masm )

staticprivate

Generate_InterruptCheck()

void v8::internal::Builtins::Generate_InterruptCheck ( MacroAssembler *  masm )

staticprivate

Definition at line 1618 of file builtins.cc.

                                                           {
  masm->TailCallRuntime(Runtime::kInterrupt, 0, 1);
}

References v8::internal::MacroAssembler::TailCallRuntime().

Here is the call graph for this function:

Generate_JSConstructEntryTrampoline()

static void v8::internal::Builtins::Generate_JSConstructEntryTrampoline ( MacroAssembler *  masm )

staticprivate

Generate_JSConstructStubApi()

static void v8::internal::Builtins::Generate_JSConstructStubApi ( MacroAssembler *  masm )

staticprivate

Generate_JSConstructStubGeneric()

static void v8::internal::Builtins::Generate_JSConstructStubGeneric ( MacroAssembler *  masm )

staticprivate

Generate_JSEntryTrampoline()

static void v8::internal::Builtins::Generate_JSEntryTrampoline ( MacroAssembler *  masm )

staticprivate

Generate_MarkCodeAsExecutedOnce()

static void v8::internal::Builtins::Generate_MarkCodeAsExecutedOnce ( MacroAssembler *  masm )

staticprivate

Generate_MarkCodeAsExecutedTwice()

static void v8::internal::Builtins::Generate_MarkCodeAsExecutedTwice ( MacroAssembler *  masm )

staticprivate

Generate_NotifyDeoptimized()

static void v8::internal::Builtins::Generate_NotifyDeoptimized ( MacroAssembler *  masm )

staticprivate

Generate_NotifyLazyDeoptimized()

static void v8::internal::Builtins::Generate_NotifyLazyDeoptimized ( MacroAssembler *  masm )

staticprivate

Generate_NotifySoftDeoptimized()

static void v8::internal::Builtins::Generate_NotifySoftDeoptimized ( MacroAssembler *  masm )

staticprivate

Generate_NotifyStubFailure()

static void v8::internal::Builtins::Generate_NotifyStubFailure ( MacroAssembler *  masm )

staticprivate

Generate_NotifyStubFailureSaveDoubles()

static void v8::internal::Builtins::Generate_NotifyStubFailureSaveDoubles ( MacroAssembler *  masm )

staticprivate

Generate_OnStackReplacement()

static void v8::internal::Builtins::Generate_OnStackReplacement ( MacroAssembler *  masm )

staticprivate

Generate_OsrAfterStackCheck()

static void v8::internal::Builtins::Generate_OsrAfterStackCheck ( MacroAssembler *  masm )

staticprivate

Generate_StackCheck()

void v8::internal::Builtins::Generate_StackCheck ( MacroAssembler *  masm )

staticprivate

Definition at line 1623 of file builtins.cc.

                                                       {
  masm->TailCallRuntime(Runtime::kStackGuard, 0, 1);
}

References v8::internal::MacroAssembler::TailCallRuntime().

Here is the call graph for this function:

Generate_StringConstructCode()

static void v8::internal::Builtins::Generate_StringConstructCode ( MacroAssembler *  masm )

staticprivate

GetArgumentsCount()

static int v8::internal::Builtins::GetArgumentsCount ( JavaScript  id )

inlinestatic

Definition at line 274 of file builtins.h.

{ return javascript_argc_[id]; }

References javascript_argc_.

GetCode()

Handle<Code> v8::internal::Builtins::GetCode	(	JavaScript	id,
		bool *	resolved
	)

GetName()

static const char* v8::internal::Builtins::GetName ( JavaScript  id )

inlinestatic

Definition at line 268 of file builtins.h.

{ return javascript_names_[id]; }

References javascript_names_.

InitBuiltinFunctionTable()

void v8::internal::Builtins::InitBuiltinFunctionTable ( )

staticprivate

Definition at line 1482 of file builtins.cc.

                                        {
  BuiltinDesc* functions = builtin_function_table.functions_;
  functions[builtin_count].generator = NULL;
  functions[builtin_count].c_code = NULL;
  functions[builtin_count].s_name = NULL;
  functions[builtin_count].name = builtin_count;
  functions[builtin_count].flags = static_cast<Code::Flags>(0);
  functions[builtin_count].extra_args = NO_EXTRA_ARGUMENTS;
 
#define DEF_FUNCTION_PTR_C(aname, aextra_args)                         \
    functions->generator = FUNCTION_ADDR(Generate_Adaptor);            \
    functions->c_code = FUNCTION_ADDR(Builtin_##aname);                \
    functions->s_name = #aname;                                        \
    functions->name = c_##aname;                                       \
    functions->flags = Code::ComputeFlags(Code::BUILTIN);              \
    functions->extra_args = aextra_args;                               \
    ++functions;
 
#define DEF_FUNCTION_PTR_A(aname, kind, state, extra)                       \
    functions->generator = FUNCTION_ADDR(Generate_##aname);                 \
    functions->c_code = NULL;                                               \
    functions->s_name = #aname;                                             \
    functions->name = k##aname;                                             \
    functions->flags = Code::ComputeFlags(Code::kind,                       \
                                          state,                            \
                                          extra);                           \
    functions->extra_args = NO_EXTRA_ARGUMENTS;                             \
    ++functions;
 
#define DEF_FUNCTION_PTR_H(aname, kind)                                     \
    functions->generator = FUNCTION_ADDR(Generate_##aname);                 \
    functions->c_code = NULL;                                               \
    functions->s_name = #aname;                                             \
    functions->name = k##aname;                                             \
    functions->flags = Code::ComputeHandlerFlags(Code::kind);               \
    functions->extra_args = NO_EXTRA_ARGUMENTS;                             \
    ++functions;
 
  BUILTIN_LIST_C(DEF_FUNCTION_PTR_C)
  BUILTIN_LIST_A(DEF_FUNCTION_PTR_A)
  BUILTIN_LIST_H(DEF_FUNCTION_PTR_H)
  BUILTIN_LIST_DEBUG_A(DEF_FUNCTION_PTR_A)
 
#undef DEF_FUNCTION_PTR_C
#undef DEF_FUNCTION_PTR_A
}

References builtin_count, v8::internal::builtin_function_table, BUILTIN_LIST_A, BUILTIN_LIST_C, BUILTIN_LIST_DEBUG_A, BUILTIN_LIST_H, v8::internal::BuiltinDesc::c_code, DEF_FUNCTION_PTR_A, DEF_FUNCTION_PTR_C, DEF_FUNCTION_PTR_H, v8::internal::BuiltinDesc::extra_args, v8::internal::BuiltinDesc::flags, v8::internal::BuiltinFunctionTable::functions_, v8::internal::BuiltinDesc::generator, v8::internal::BuiltinDesc::name, v8::internal::NO_EXTRA_ARGUMENTS, NULL, and v8::internal::BuiltinDesc::s_name.

Referenced by v8::internal::BuiltinFunctionTable::functions().

Here is the caller graph for this function:

is_initialized()

bool v8::internal::Builtins::is_initialized ( ) const

inline

Definition at line 278 of file builtins.h.

{ return initialized_; }

References initialized_.

Referenced by v8::internal::CpuProfiler::LogBuiltins().

Here is the caller graph for this function:

IterateBuiltins()

void v8::internal::Builtins::IterateBuiltins

(

ObjectVisitor *

v

)

Definition at line 1599 of file builtins.cc.

                                               {
  v->VisitPointers(&builtins_[0], &builtins_[0] + builtin_count);
}

References builtin_count, and builtins_.

Referenced by v8::internal::Heap::IterateStrongRoots().

Here is the caller graph for this function:

Lookup()

const char * v8::internal::Builtins::Lookup

(

byte *

pc

)

Definition at line 1604 of file builtins.cc.

                                     {
  // may be called during initialization (disassembler!)
  if (initialized_) {
    for (int i = 0; i < builtin_count; i++) {
      Code* entry = Code::cast(builtins_[i]);
      if (entry->contains(pc)) {
        return names_[i];
      }
    }
  }
  return NULL;
}

References builtin_count, builtins_, v8::internal::Code::contains(), initialized_, names_, NULL, and v8::internal::pc.

Here is the call graph for this function:

name()

const char* v8::internal::Builtins::name ( int  index )

inline

Definition at line 269 of file builtins.h.

                              {
    DCHECK(index >= 0);
    DCHECK(index < builtin_count);
    return names_[index];
  }

References builtin_count, DCHECK, and names_.

Referenced by builtin(), builtin_address(), v8::internal::RootsReferencesExtractor::FillReferences(), and SetUp().

Here is the caller graph for this function:

NumberOfJavaScriptBuiltins()

static int v8::internal::Builtins::NumberOfJavaScriptBuiltins ( )

inlinestatic

Definition at line 276 of file builtins.h.

{ return id_count; }

References id_count.

SetUp()

void v8::internal::Builtins::SetUp	(	Isolate *	isolate,
		bool	create_heap_objects
	)

Definition at line 1530 of file builtins.cc.

                                                               {
  DCHECK(!initialized_);
 
  // Create a scope for the handles in the builtins.
  HandleScope scope(isolate);
 
  const BuiltinDesc* functions = builtin_function_table.functions();
 
  // For now we generate builtin adaptor code into a stack-allocated
  // buffer, before copying it into individual code objects. Be careful
  // with alignment, some platforms don't like unaligned code.
#ifdef DEBUG
  // We can generate a lot of debug code on Arm64.
  const size_t buffer_size = 32*KB;
#else
  const size_t buffer_size = 8*KB;
#endif
  union { int force_alignment; byte buffer[buffer_size]; } u;
 
  // Traverse the list of builtins and generate an adaptor in a
  // separate code object for each one.
  for (int i = 0; i < builtin_count; i++) {
    if (create_heap_objects) {
      MacroAssembler masm(isolate, u.buffer, sizeof u.buffer);
      // Generate the code/adaptor.
      typedef void (*Generator)(MacroAssembler*, int, BuiltinExtraArguments);
      Generator g = FUNCTION_CAST<Generator>(functions[i].generator);
      // We pass all arguments to the generator, but it may not use all of
      // them.  This works because the first arguments are on top of the
      // stack.
      DCHECK(!masm.has_frame());
      g(&masm, functions[i].name, functions[i].extra_args);
      // Move the code into the object heap.
      CodeDesc desc;
      masm.GetCode(&desc);
      Code::Flags flags = functions[i].flags;
      Handle<Code> code =
          isolate->factory()->NewCode(desc, flags, masm.CodeObject());
      // Log the event and add the code to the builtins array.
      PROFILE(isolate,
              CodeCreateEvent(Logger::BUILTIN_TAG, *code, functions[i].s_name));
      builtins_[i] = *code;
      if (code->kind() == Code::BUILTIN) code->set_builtin_index(i);
#ifdef ENABLE_DISASSEMBLER
      if (FLAG_print_builtin_code) {
        CodeTracer::Scope trace_scope(isolate->GetCodeTracer());
        OFStream os(trace_scope.file());
        os << "Builtin: " << functions[i].s_name << "\n";
        code->Disassemble(functions[i].s_name, os);
        os << "\n";
      }
#endif
    } else {
      // Deserializing. The values will be filled in during IterateBuiltins.
      builtins_[i] = NULL;
    }
    names_[i] = functions[i].s_name;
  }
 
  // Mark as initialized.
  initialized_ = true;
}

References BUILTIN, builtin_count, v8::internal::builtin_function_table, builtins_, v8::internal::MacroAssembler::CodeObject(), DCHECK, v8::internal::Isolate::factory(), v8::internal::BuiltinDesc::flags, v8::internal::anonymous_namespace{flags.cc}::flags, v8::internal::BuiltinFunctionTable::functions(), v8::internal::Assembler::GetCode(), v8::internal::Isolate::GetCodeTracer(), v8::internal::MacroAssembler::has_frame(), initialized_, v8::internal::KB, name(), names_, NULL, PROFILE, and v8::internal::BuiltinDesc::s_name.

Referenced by v8::internal::Isolate::Init().

Here is the call graph for this function:

Here is the caller graph for this function:

TearDown()

void v8::internal::Builtins::TearDown

(

)

Definition at line 1594 of file builtins.cc.

                        {
  initialized_ = false;
}

References initialized_.

Referenced by v8::internal::Isolate::Deinit().

Here is the caller graph for this function:

Friends And Related Function Documentation

BuiltinFunctionTable

friend class BuiltinFunctionTable

friend

Definition at line 339 of file builtins.h.

Isolate

friend class Isolate

friend

Definition at line 340 of file builtins.h.

Member Data Documentation

builtins_

Object* v8::internal::Builtins::builtins_[builtin_count]

private

Definition at line 289 of file builtins.h.

Referenced by builtin(), builtin_address(), Builtins(), IterateBuiltins(), Lookup(), and SetUp().

c_functions_

Address const v8::internal::Builtins::c_functions_

staticprivate

Initial value:

= {
 
}

Definition at line 284 of file builtins.h.

Referenced by c_function_address().

initialized_

bool v8::internal::Builtins::initialized_

private

Definition at line 337 of file builtins.h.

Referenced by is_initialized(), Lookup(), SetUp(), and TearDown().

javascript_argc_

int const v8::internal::Builtins::javascript_argc_

staticprivate

Initial value:

= {
 
}

Definition at line 292 of file builtins.h.

Referenced by GetArgumentsCount().

javascript_names_

const char *const v8::internal::Builtins::javascript_names_

staticprivate

Initial value:

= {
 
}

Definition at line 291 of file builtins.h.

Referenced by GetName().

names_

const char* v8::internal::Builtins::names_[builtin_count]

private

Definition at line 290 of file builtins.h.

Referenced by Builtins(), Lookup(), name(), and SetUp().

---

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

• /mnt/V8SourceCode/src/builtins.h
• /mnt/V8SourceCode/src/builtins.cc