dart::bin::DartUtils Class Reference

#include <dartutils.h>

Public Types
enum	MagicNumber {   kAppJITMagicNumber , kKernelMagicNumber , kKernelListMagicNumber , kGzipMagicNumber ,   kAotELFMagicNumber , kAotMachO32MagicNumber , kAotMachO64MagicNumber , kAotMachO64Arm64MagicNumber ,   kAotCoffARM32MagicNumber , kAotCoffARM64MagicNumber , kAotCoffRISCV32MagicNumber , kAotCoffRISCV64MagicNumber ,   kUnknownMagicNumber }

Static Public Member Functions
static int64_t	GetIntegerValue (Dart_Handle value_obj)
static int64_t	GetInt64ValueCheckRange (Dart_Handle value_obj, int64_t lower, int64_t upper)
static intptr_t	GetIntptrValue (Dart_Handle value_obj)
static bool	GetInt64Value (Dart_Handle value_obj, int64_t *value)
static const char *	GetStringValue (Dart_Handle str_obj)
static bool	GetBooleanValue (Dart_Handle bool_obj)
static bool	GetNativeBooleanArgument (Dart_NativeArguments args, intptr_t index)
static int64_t	GetNativeIntegerArgument (Dart_NativeArguments args, intptr_t index)
static intptr_t	GetNativeIntptrArgument (Dart_NativeArguments args, intptr_t index)
static const char *	GetNativeStringArgument (Dart_NativeArguments args, intptr_t index)
static const char *	GetNativeTypedDataArgument (Dart_NativeArguments args, intptr_t index)
static Dart_Handle	SetIntegerField (Dart_Handle handle, const char *name, int64_t val)
static Dart_Handle	SetStringField (Dart_Handle handle, const char *name, const char *val)
static bool	IsDartSchemeURL (const char *url_name)
static bool	IsDartIOLibURL (const char *url_name)
static bool	IsDartCLILibURL (const char *url_name)
static bool	IsDartHttpLibURL (const char *url_name)
static bool	IsDartBuiltinLibURL (const char *url_name)
static bool	IsHttpSchemeURL (const char *url_name)
static const char *	RemoveScheme (const char *url)
static char *	DirName (const char *url)
static void *	MapExecutable (const char *name, intptr_t *file_len)
static void *	OpenFile (const char *name, bool write)
static void *	OpenFileUri (const char *uri, bool write)
static void	ReadFile (uint8_t **data, intptr_t *file_len, void *stream)
static void	WriteFile (const void *buffer, intptr_t num_bytes, void *stream)
static void	CloseFile (void *stream)
static bool	EntropySource (uint8_t *buffer, intptr_t length)
static Dart_Handle	ReadStringFromFile (const char *filename)
static Dart_Handle	MakeUint8Array (const void *buffer, intptr_t length)
static Dart_Handle	PrepareForScriptLoading (bool is_service_isolate, bool trace_loading)
static Dart_Handle	SetupPackageConfig (const char *packages_file)
static Dart_Handle	SetupIOLibrary (const char *namespc_path, const char *script_uri, bool disable_exit)
static bool	PostNull (Dart_Port port_id)
static bool	PostInt32 (Dart_Port port_id, int32_t value)
static bool	PostInt64 (Dart_Port port_id, int64_t value)
static bool	PostString (Dart_Port port_id, const char *value)
static Dart_Handle	GetDartType (const char *library_url, const char *class_name)
static Dart_Handle	NewDartOSError ()
static Dart_Handle	NewDartOSError (OSError *os_error)
static Dart_Handle	NewDartExceptionWithOSError (const char *library_url, const char *exception_name, const char *message, Dart_Handle os_error)
static Dart_Handle	NewDartExceptionWithMessage (const char *library_url, const char *exception_name, const char *message)
static Dart_Handle	NewDartArgumentError (const char *message)
static Dart_Handle	NewDartFormatException (const char *message)
static Dart_Handle	NewDartUnsupportedError (const char *message)
static Dart_Handle	NewDartIOException (const char *exception_name, const char *message, Dart_Handle os_error)
static Dart_Handle	NewString (const char *str)
static Dart_Handle	NewStringFormatted (const char *format,...)
static char *	ScopedCString (intptr_t length)
static char *	ScopedCopyCString (const char *str)
static char *	ScopedCStringFormatted (const char *format,...) PRINTF_ATTRIBUTE(1
static char static char *	ScopedCStringVFormatted (const char *format, va_list args)
static Dart_Handle	NewError (const char *format,...)
static Dart_Handle	NewInternalError (const char *message)
static Dart_Handle	LookupBuiltinLib ()
static bool	SetOriginalWorkingDirectory ()
static Dart_Handle	ResolveScript (Dart_Handle url)
static bool	IsAotMagicNumber (MagicNumber number)
static MagicNumber	SniffForMagicNumber (const char *filename)
static MagicNumber	SniffForMagicNumber (const uint8_t *text_buffer, intptr_t buffer_len)
static void	SetEnvironment (dart::SimpleHashMap *environment)
static Dart_Handle	EnvironmentCallback (Dart_Handle name)

Static Public Attributes
static constexpr int64_t	kMaxMagicNumberSize = 8
static const char *	original_working_directory = nullptr
static constexpr const char *	kDartScheme = "dart:"
static constexpr const char *	kAsyncLibURL = "dart:async"
static constexpr const char *	kBuiltinLibURL = "dart:_builtin"
static constexpr const char *	kCoreLibURL = "dart:core"
static constexpr const char *	kInternalLibURL = "dart:_internal"
static constexpr const char *	kIsolateLibURL = "dart:isolate"
static constexpr const char *	kHttpLibURL = "dart:_http"
static constexpr const char *	kIOLibURL = "dart:io"
static constexpr const char *	kIOLibPatchURL = "dart:io-patch"
static constexpr const char *	kCLILibURL = "dart:cli"
static constexpr const char *	kCLILibPatchURL = "dart:cli-patch"
static constexpr const char *	kUriLibURL = "dart:uri"
static constexpr const char *	kHttpScheme = "http:"
static constexpr const char *	kVMServiceLibURL = "dart:vmservice"

Detailed Description

Definition at line 108 of file dartutils.h.

Member Enumeration Documentation

MagicNumber

enum dart::bin::DartUtils::MagicNumber

Enumerator
kAppJITMagicNumber
kKernelMagicNumber
kKernelListMagicNumber
kGzipMagicNumber
kAotELFMagicNumber
kAotMachO32MagicNumber
kAotMachO64MagicNumber
kAotMachO64Arm64MagicNumber
kAotCoffARM32MagicNumber
kAotCoffARM64MagicNumber
kAotCoffRISCV32MagicNumber
kAotCoffRISCV64MagicNumber
kUnknownMagicNumber

Definition at line 256 of file dartutils.h.

                   {
    kAppJITMagicNumber,
    kKernelMagicNumber,
    kKernelListMagicNumber,
    kGzipMagicNumber,
    kAotELFMagicNumber,
    kAotMachO32MagicNumber,
    kAotMachO64MagicNumber,
    kAotMachO64Arm64MagicNumber,
    kAotCoffARM32MagicNumber,
    kAotCoffARM64MagicNumber,
    kAotCoffRISCV32MagicNumber,
    kAotCoffRISCV64MagicNumber,
    kUnknownMagicNumber
  };

Member Function Documentation

CloseFile()

void dart::bin::DartUtils::CloseFile ( void *  stream )

static

Definition at line 307 of file dartutils.cc.

                                      {
  File* file = reinterpret_cast<File*>(stream);
  file->Release();
}

DirName()

char * dart::bin::DartUtils::DirName ( const char *  url )

static

Definition at line 256 of file dartutils.cc.

                                        {
  const char* slash = strrchr(url, File::PathSeparator()[0]);
  if (slash == nullptr) {
    return Utils::StrDup(url);
  } else {
    return Utils::StrNDup(url, slash - url + 1);
  }
}

EntropySource()

bool dart::bin::DartUtils::EntropySource ( uint8_t *  buffer, intptr_t  length  )

static

Definition at line 312 of file dartutils.cc.

                                                              {
  return Crypto::GetRandomBytes(length, buffer);
}

EnvironmentCallback()

Dart_Handle dart::bin::DartUtils::EnvironmentCallback ( Dart_Handle  name )

static

Definition at line 841 of file dartutils.cc.

                                                           {
  uint8_t* utf8_array;
  intptr_t utf8_len;
  Dart_Handle result = Dart_Null();
  Dart_Handle handle = Dart_StringToUTF8(name, &utf8_array, &utf8_len);
  if (Dart_IsError(handle)) {
    handle = Dart_ThrowException(
        DartUtils::NewDartArgumentError(Dart_GetError(handle)));
  } else {
    char* name_chars = reinterpret_cast<char*>(malloc(utf8_len + 1));
    memmove(name_chars, utf8_array, utf8_len);
    name_chars[utf8_len] = '\0';
    const char* value = nullptr;
    if (environment_ != nullptr) {
      SimpleHashMap::Entry* entry =
          environment_->Lookup(GetHashmapKeyFromString(name_chars),
                               SimpleHashMap::StringHash(name_chars), false);
      if (entry != nullptr) {
        value = reinterpret_cast<char*>(entry->value);
      }
    }
    if (value != nullptr) {
      result = Dart_NewStringFromUTF8(reinterpret_cast<const uint8_t*>(value),
                                      strlen(value));
      if (Dart_IsError(result)) {
        result = Dart_Null();
      }
    }
    free(name_chars);
  }
  return result;
}

GetBooleanValue()

bool dart::bin::DartUtils::GetBooleanValue ( Dart_Handle  bool_obj )

static

Definition at line 141 of file dartutils.cc.

                                                    {
  bool value = false;
  Dart_Handle result = Dart_BooleanValue(bool_obj, &value);
  if (Dart_IsError(result)) {
    Dart_PropagateError(result);
  }
  return value;
}

GetDartType()

Dart_Handle dart::bin::DartUtils::GetDartType ( const char *  library_url, const char *  class_name  )

static

Definition at line 700 of file dartutils.cc.

                                                           {
  return Dart_GetNonNullableType(Dart_LookupLibrary(NewString(library_url)),
                                 NewString(class_name), 0, nullptr);
}

GetInt64Value()

bool dart::bin::DartUtils::GetInt64Value ( Dart_Handle  value_obj, int64_t *  value  )

static

Definition at line 116 of file dartutils.cc.

                                                                   {
  bool valid = Dart_IsInteger(value_obj);
  if (valid) {
    Dart_Handle result = Dart_IntegerFitsIntoInt64(value_obj, &valid);
    if (Dart_IsError(result)) {
      Dart_PropagateError(result);
    }
  }
  if (!valid) return false;
  Dart_Handle result = Dart_IntegerToInt64(value_obj, value);
  if (Dart_IsError(result)) {
    Dart_PropagateError(result);
  }
  return true;
}

GetInt64ValueCheckRange()

int64_t dart::bin::DartUtils::GetInt64ValueCheckRange ( Dart_Handle  value_obj, int64_t  lower, int64_t  upper  )

static

Definition at line 94 of file dartutils.cc.

                                                          {
  int64_t value = DartUtils::GetIntegerValue(value_obj);
  if (value < lower || upper < value) {
    Dart_PropagateError(Dart_NewApiError("Value outside expected range"));
  }
  return value;
}

GetIntegerValue()

int64_t dart::bin::DartUtils::GetIntegerValue ( Dart_Handle  value_obj )

static

Definition at line 85 of file dartutils.cc.

                                                        {
  int64_t value = 0;
  Dart_Handle result = Dart_IntegerToInt64(value_obj, &value);
  if (Dart_IsError(result)) {
    Dart_PropagateError(result);
  }
  return value;
}

GetIntptrValue()

intptr_t dart::bin::DartUtils::GetIntptrValue ( Dart_Handle  value_obj )

static

Definition at line 104 of file dartutils.cc.

                                                        {
  int64_t value = 0;
  Dart_Handle result = Dart_IntegerToInt64(value_obj, &value);
  if (Dart_IsError(result)) {
    Dart_PropagateError(result);
  }
  if (value < kIntptrMin || kIntptrMax < value) {
    Dart_PropagateError(Dart_NewApiError("Value outside intptr_t range"));
  }
  return static_cast<intptr_t>(value);
}

GetNativeBooleanArgument()

bool dart::bin::DartUtils::GetNativeBooleanArgument ( Dart_NativeArguments  args, intptr_t  index  )

static

Definition at line 150 of file dartutils.cc.

                                                         {
  bool value = false;
  Dart_Handle result = Dart_GetNativeBooleanArgument(args, index, &value);
  if (Dart_IsError(result)) {
    Dart_PropagateError(result);
  }
  return value;
}

GetNativeIntegerArgument()

int64_t dart::bin::DartUtils::GetNativeIntegerArgument ( Dart_NativeArguments  args, intptr_t  index  )

static

Definition at line 160 of file dartutils.cc.

                                                            {
  int64_t value = 0;
  Dart_Handle result = Dart_GetNativeIntegerArgument(args, index, &value);
  if (Dart_IsError(result)) {
    Dart_PropagateError(result);
  }
  return value;
}

GetNativeIntptrArgument()

intptr_t dart::bin::DartUtils::GetNativeIntptrArgument ( Dart_NativeArguments  args, intptr_t  index  )

static

Definition at line 170 of file dartutils.cc.

                                                            {
  int64_t value = GetNativeIntegerArgument(args, index);
  if (value < kIntptrMin || kIntptrMax < value) {
    Dart_PropagateError(Dart_NewApiError("Value outside intptr_t range"));
  }
  return static_cast<intptr_t>(value);
}

GetNativeStringArgument()

const char * dart::bin::DartUtils::GetNativeStringArgument ( Dart_NativeArguments  args, intptr_t  index  )

static

Definition at line 179 of file dartutils.cc.

                                                               {
  char* tmp = nullptr;
  Dart_Handle result =
      Dart_GetNativeStringArgument(args, index, reinterpret_cast<void**>(&tmp));
  if (Dart_IsError(result)) {
    Dart_PropagateError(result);
  }
  if (tmp != nullptr) {
    return tmp;
  }
  const char* cstring = nullptr;
  result = Dart_StringToCString(result, &cstring);
  if (Dart_IsError(result)) {
    Dart_PropagateError(result);
  }
  ASSERT(cstring != nullptr);
  return cstring;
}

GetNativeTypedDataArgument()

const char * dart::bin::DartUtils::GetNativeTypedDataArgument ( Dart_NativeArguments  args, intptr_t  index  )

static

Definition at line 199 of file dartutils.cc.

                                                                  {
  Dart_Handle handle = Dart_GetNativeArgument(args, index);
  TypedDataScope data(handle);
  ASSERT(data.type() == Dart_TypedData_kUint8);
  return data.GetScopedCString();
}

GetStringValue()

const char * dart::bin::DartUtils::GetStringValue ( Dart_Handle  str_obj )

static

Definition at line 132 of file dartutils.cc.

                                                         {
  const char* cstring = nullptr;
  Dart_Handle result = Dart_StringToCString(str_obj, &cstring);
  if (Dart_IsError(result)) {
    Dart_PropagateError(result);
  }
  return cstring;
}

IsAotMagicNumber()

static bool dart::bin::DartUtils::IsAotMagicNumber ( MagicNumber  number )

inlinestatic

Definition at line 275 of file dartutils.h.

                                                   {
    return (number >= DartUtils::kAotELFMagicNumber) &&
           (number <= DartUtils::kAotCoffRISCV64MagicNumber);
  }

IsDartBuiltinLibURL()

bool dart::bin::DartUtils::IsDartBuiltinLibURL ( const char *  url_name )

static

Definition at line 243 of file dartutils.cc.

                                                        {
  return (strcmp(url_name, kBuiltinLibURL) == 0);
}

IsDartCLILibURL()

bool dart::bin::DartUtils::IsDartCLILibURL ( const char *  url_name )

static

Definition at line 235 of file dartutils.cc.

                                                    {
  return (strcmp(url_name, kCLILibURL) == 0);
}

IsDartHttpLibURL()

bool dart::bin::DartUtils::IsDartHttpLibURL ( const char *  url_name )

static

Definition at line 239 of file dartutils.cc.

                                                     {
  return (strcmp(url_name, kHttpLibURL) == 0);
}

IsDartIOLibURL()

bool dart::bin::DartUtils::IsDartIOLibURL ( const char *  url_name )

static

Definition at line 231 of file dartutils.cc.

                                                   {
  return (strcmp(url_name, kIOLibURL) == 0);
}

IsDartSchemeURL()

bool dart::bin::DartUtils::IsDartSchemeURL ( const char *  url_name )

static

Definition at line 219 of file dartutils.cc.

                                                    {
  static const intptr_t kDartSchemeLen = strlen(kDartScheme);
  // If the URL starts with "dart:" then it is considered as a special
  // library URL which is handled differently from other URLs.
  return (strncmp(url_name, kDartScheme, kDartSchemeLen) == 0);
}

IsHttpSchemeURL()

bool dart::bin::DartUtils::IsHttpSchemeURL ( const char *  url_name )

static

Definition at line 226 of file dartutils.cc.

                                                    {
  static const intptr_t kHttpSchemeLen = strlen(kHttpScheme);
  return (strncmp(url_name, kHttpScheme, kHttpSchemeLen) == 0);
}

LookupBuiltinLib()

static Dart_Handle dart::bin::DartUtils::LookupBuiltinLib ( )

inlinestatic

Definition at line 248 of file dartutils.h.

                                        {
    return Dart_LookupLibrary(NewString(kBuiltinLibURL));
  }

MakeUint8Array()

Dart_Handle dart::bin::DartUtils::MakeUint8Array ( const void *  buffer, intptr_t  length  )

static

Definition at line 364 of file dartutils.cc.

                                                                      {
  Dart_Handle array = Dart_NewTypedData(Dart_TypedData_kUint8, len);
  RETURN_IF_ERROR(array);
  {
    Dart_TypedData_Type td_type;
    void* td_data;
    intptr_t td_len;
    Dart_Handle result =
        Dart_TypedDataAcquireData(array, &td_type, &td_data, &td_len);
    RETURN_IF_ERROR(result);
    ASSERT(td_type == Dart_TypedData_kUint8);
    ASSERT(td_len == len);
    ASSERT(td_data != nullptr);
    memmove(td_data, buffer, td_len);
    result = Dart_TypedDataReleaseData(array);
    RETURN_IF_ERROR(result);
  }
  return array;
}

MapExecutable()

static void * dart::bin::DartUtils::MapExecutable ( const char *  name, intptr_t *  file_len  )

static

NewDartArgumentError()

Dart_Handle dart::bin::DartUtils::NewDartArgumentError ( const char *  message )

static

Definition at line 750 of file dartutils.cc.

                                                               {
  return NewDartExceptionWithMessage(kCoreLibURL, "ArgumentError", message);
}

NewDartExceptionWithMessage()

Dart_Handle dart::bin::DartUtils::NewDartExceptionWithMessage ( const char *  library_url, const char *  exception_name, const char *  message  )

static

Definition at line 735 of file dartutils.cc.

                                                                        {
  // Create a Dart Exception object with a message.
  Dart_Handle type = GetDartType(library_url, exception_name);
  ASSERT(!Dart_IsError(type));
  if (message != nullptr) {
    Dart_Handle args[1];
    args[0] = NewString(message);
    return Dart_New(type, Dart_Null(), 1, args);
  } else {
    return Dart_New(type, Dart_Null(), 0, nullptr);
  }
}

NewDartExceptionWithOSError()

Dart_Handle dart::bin::DartUtils::NewDartExceptionWithOSError ( const char *  library_url, const char *  exception_name, const char *  message, Dart_Handle  os_error  )

static

Definition at line 722 of file dartutils.cc.

                                                                         {
  // Create a Dart Exception object with a message and an OSError.
  Dart_Handle type = GetDartType(library_url, exception_name);
  ASSERT(!Dart_IsError(type));
  Dart_Handle args[2];
  args[0] = NewString(message);
  args[1] = os_error;
  return Dart_New(type, Dart_Null(), 2, args);
}

NewDartFormatException()

Dart_Handle dart::bin::DartUtils::NewDartFormatException ( const char *  message )

static

Definition at line 754 of file dartutils.cc.

                                                                 {
  return NewDartExceptionWithMessage(kCoreLibURL, "FormatException", message);
}

NewDartIOException()

Dart_Handle dart::bin::DartUtils::NewDartIOException ( const char *  exception_name, const char *  message, Dart_Handle  os_error  )

static

Definition at line 762 of file dartutils.cc.

                                                                {
  // Create a dart:io exception object of the given type.
  return NewDartExceptionWithOSError(kIOLibURL, exception_name, message,
                                     os_error);
}

NewDartOSError() [1/2]

Dart_Handle dart::bin::DartUtils::NewDartOSError ( )

static

Definition at line 706 of file dartutils.cc.

                                      {
  // Extract the current OS error.
  OSError os_error;
  return NewDartOSError(&os_error);
}

NewDartOSError() [2/2]

Dart_Handle dart::bin::DartUtils::NewDartOSError ( OSError *  os_error )

static

Definition at line 712 of file dartutils.cc.

                                                       {
  // Create a dart:io OSError object with the information retrieved from the OS.
  Dart_Handle type = GetDartType(kIOLibURL, "OSError");
  ASSERT(!Dart_IsError(type));
  Dart_Handle args[2];
  args[0] = NewString(os_error->message());
  args[1] = Dart_NewInteger(os_error->code());
  return Dart_New(type, Dart_Null(), 2, args);
}

NewDartUnsupportedError()

Dart_Handle dart::bin::DartUtils::NewDartUnsupportedError ( const char *  message )

static

Definition at line 758 of file dartutils.cc.

                                                                  {
  return NewDartExceptionWithMessage(kCoreLibURL, "UnsupportedError", message);
}

NewError()

Dart_Handle dart::bin::DartUtils::NewError ( const char *  format,   ...  )

static

Definition at line 770 of file dartutils.cc.

                                                       {
  va_list measure_args;
  va_start(measure_args, format);
  intptr_t len = Utils::VSNPrint(nullptr, 0, format, measure_args);
  va_end(measure_args);
 
  char* buffer = reinterpret_cast<char*>(Dart_ScopeAllocate(len + 1));
  MSAN_UNPOISON(buffer, (len + 1));
  va_list print_args;
  va_start(print_args, format);
  Utils::VSNPrint(buffer, (len + 1), format, print_args);
  va_end(print_args);
 
  return Dart_NewApiError(buffer);
}

NewInternalError()

Dart_Handle dart::bin::DartUtils::NewInternalError ( const char *  message )

static

Definition at line 786 of file dartutils.cc.

                                                           {
  return NewDartExceptionWithMessage(kCoreLibURL, "_InternalError", message);
}

NewString()

static Dart_Handle dart::bin::DartUtils::NewString ( const char *  str )

inlinestatic

Definition at line 214 of file dartutils.h.

                                                {
    ASSERT(str != nullptr);
    return Dart_NewStringFromUTF8(reinterpret_cast<const uint8_t*>(str),
                                  strlen(str));
  }

NewStringFormatted()

Dart_Handle dart::bin::DartUtils::NewStringFormatted ( const char *  format,   ...  )

static

Definition at line 790 of file dartutils.cc.

                                                                 {
  va_list args;
  va_start(args, format);
  char* result = ScopedCStringVFormatted(format, args);
  va_end(args);
  return NewString(result);
}

OpenFile()

void * dart::bin::DartUtils::OpenFile ( const char *  name, bool  write  )

static

Definition at line 265 of file dartutils.cc.

                                                      {
  File* file =
      File::Open(nullptr, name, write ? File::kWriteTruncate : File::kRead);
  return reinterpret_cast<void*>(file);
}

OpenFileUri()

void * dart::bin::DartUtils::OpenFileUri ( const char *  uri, bool  write  )

static

Definition at line 271 of file dartutils.cc.

                                                        {
  File* file =
      File::OpenUri(nullptr, uri, write ? File::kWriteTruncate : File::kRead);
  return reinterpret_cast<void*>(file);
}

PostInt32()

bool dart::bin::DartUtils::PostInt32 ( Dart_Port  port_id, int32_t  value  )

static

Definition at line 676 of file dartutils.cc.

                                                          {
  // Post a message with the integer value.
  int32_t min = 0xc0000000;  // -1073741824
  int32_t max = 0x3fffffff;  // 1073741823
  ASSERT(min <= value && value < max);
  Dart_CObject object;
  object.type = Dart_CObject_kInt32;
  object.value.as_int32 = value;
  return Dart_PostCObject(port_id, &object);
}

PostInt64()

bool dart::bin::DartUtils::PostInt64 ( Dart_Port  port_id, int64_t  value  )

static

Definition at line 687 of file dartutils.cc.

                                                          {
  // Post a message with the integer value.
  Dart_CObject object;
  object.type = Dart_CObject_kInt64;
  object.value.as_int64 = value;
  return Dart_PostCObject(port_id, &object);
}

PostNull()

bool dart::bin::DartUtils::PostNull ( Dart_Port  port_id )

static

Definition at line 671 of file dartutils.cc.

                                          {
  // Post a message with just the null object.
  return Dart_PostCObject(port_id, CObject::Null()->AsApiCObject());
}

PostString()

bool dart::bin::DartUtils::PostString ( Dart_Port  port_id, const char *  value  )

static

Definition at line 695 of file dartutils.cc.

                                                               {
  Dart_CObject* object = CObject::NewString(value);
  return Dart_PostCObject(port_id, object);
}

PrepareForScriptLoading()

Dart_Handle dart::bin::DartUtils::PrepareForScriptLoading ( bool  is_service_isolate, bool  trace_loading  )

static

Definition at line 574 of file dartutils.cc.

                                                                   {
  // First ensure all required libraries are available.
  Dart_Handle url = NewString(kCoreLibURL);
  RETURN_IF_ERROR(url);
  Dart_Handle core_lib = Dart_LookupLibrary(url);
  RETURN_IF_ERROR(core_lib);
  url = NewString(kAsyncLibURL);
  RETURN_IF_ERROR(url);
  Dart_Handle async_lib = Dart_LookupLibrary(url);
  RETURN_IF_ERROR(async_lib);
  url = NewString(kIsolateLibURL);
  RETURN_IF_ERROR(url);
  Dart_Handle isolate_lib = Dart_LookupLibrary(url);
  RETURN_IF_ERROR(isolate_lib);
  url = NewString(kInternalLibURL);
  RETURN_IF_ERROR(url);
  Dart_Handle internal_lib = Dart_LookupLibrary(url);
  RETURN_IF_ERROR(internal_lib);
  Dart_Handle builtin_lib =
      Builtin::LoadAndCheckLibrary(Builtin::kBuiltinLibrary);
  RETURN_IF_ERROR(builtin_lib);
  Builtin::SetNativeResolver(Builtin::kBuiltinLibrary);
  Dart_Handle io_lib = Builtin::LoadAndCheckLibrary(Builtin::kIOLibrary);
  RETURN_IF_ERROR(io_lib);
  Builtin::SetNativeResolver(Builtin::kIOLibrary);
  Dart_Handle cli_lib = Builtin::LoadAndCheckLibrary(Builtin::kCLILibrary);
  RETURN_IF_ERROR(cli_lib);
  Builtin::SetNativeResolver(Builtin::kCLILibrary);
 
  // We need to ensure that all the scripts loaded so far are finalized
  // as we are about to invoke some Dart code below to setup closures.
  Dart_Handle result = Dart_FinalizeLoading(false);
  RETURN_IF_ERROR(result);
 
  result = PrepareBuiltinLibrary(builtin_lib, internal_lib, is_service_isolate,
                                 trace_loading);
  RETURN_IF_ERROR(result);
 
  RETURN_IF_ERROR(PrepareAsyncLibrary(async_lib, isolate_lib));
  RETURN_IF_ERROR(PrepareCoreLibrary(core_lib, io_lib, is_service_isolate));
  RETURN_IF_ERROR(PrepareIsolateLibrary(isolate_lib));
  RETURN_IF_ERROR(PrepareIOLibrary(io_lib));
  RETURN_IF_ERROR(PrepareCLILibrary(cli_lib));
  return result;
}

ReadFile()

void dart::bin::DartUtils::ReadFile ( uint8_t **  data, intptr_t *  file_len, void *  stream  )

static

Definition at line 277 of file dartutils.cc.

                                                                    {
  ASSERT(data != nullptr);
  ASSERT(len != nullptr);
  ASSERT(stream != nullptr);
  File* file_stream = reinterpret_cast<File*>(stream);
  int64_t file_len = file_stream->Length();
  if ((file_len < 0) || (file_len > kIntptrMax)) {
    *data = nullptr;
    *len = -1;  // Indicates read was not successful.
    return;
  }
  *len = static_cast<intptr_t>(file_len);
  *data = reinterpret_cast<uint8_t*>(malloc(*len));
  if (!file_stream->ReadFully(*data, *len)) {
    free(*data);
    *data = nullptr;
    *len = -1;  // Indicates read was not successful.
    return;
  }
}

ReadStringFromFile()

Dart_Handle dart::bin::DartUtils::ReadStringFromFile ( const char *  filename )

static

Definition at line 352 of file dartutils.cc.

                                                              {
  const char* error_msg = nullptr;
  intptr_t len;
  uint8_t* text_buffer = ReadFileFully(filename, &len, &error_msg);
  if (text_buffer == nullptr) {
    return Dart_NewApiError(error_msg);
  }
  Dart_Handle str = Dart_NewStringFromUTF8(text_buffer, len);
  free(text_buffer);
  return str;
}

RemoveScheme()

const char * dart::bin::DartUtils::RemoveScheme ( const char *  url )

static

Definition at line 247 of file dartutils.cc.

                                                   {
  const char* colon = strchr(url, ':');
  if (colon == nullptr) {
    return url;
  } else {
    return colon + 1;
  }
}

ResolveScript()

Dart_Handle dart::bin::DartUtils::ResolveScript ( Dart_Handle  url )

static

Definition at line 390 of file dartutils.cc.

                                                    {
  const int kNumArgs = 1;
  Dart_Handle dart_args[kNumArgs];
  dart_args[0] = url;
  return Dart_Invoke(DartUtils::LookupBuiltinLib(),
                     NewString("_resolveScriptUri"), kNumArgs, dart_args);
}

ScopedCopyCString()

static char * dart::bin::DartUtils::ScopedCopyCString ( const char *  str )

inlinestatic

Definition at line 232 of file dartutils.h.

                                                  {
    size_t str_len = strlen(str);
    char* result = ScopedCString(str_len + 1);
    memmove(result, str, str_len);
    result[str_len] = '\0';
    return result;
  }

ScopedCString()

static char * dart::bin::DartUtils::ScopedCString ( intptr_t  length )

inlinestatic

Definition at line 224 of file dartutils.h.

                                              {
    char* result = nullptr;
    result =
        reinterpret_cast<char*>(Dart_ScopeAllocate(length * sizeof(*result)));
    return result;
  }

ScopedCStringFormatted()

char * dart::bin::DartUtils::ScopedCStringFormatted ( const char *  format,   ...  )

static

Definition at line 819 of file dartutils.cc.

                                                               {
  va_list args;
  va_start(args, format);
  char* result = ScopedCStringVFormatted(format, args);
  va_end(args);
  return result;
}

ScopedCStringVFormatted()

char * dart::bin::DartUtils::ScopedCStringVFormatted ( const char *  format, va_list  args  )

static

Definition at line 798 of file dartutils.cc.

                                                                         {
  va_list measure_args;
  va_copy(measure_args, args);
  intptr_t len = Utils::VSNPrint(nullptr, 0, format, measure_args);
  if (len < 0) {
    return nullptr;
  }
  va_end(measure_args);
 
  char* buffer = ScopedCString(len + 1);
  MSAN_UNPOISON(buffer, (len + 1));
  va_list print_args;
  va_copy(print_args, args);
  len = Utils::VSNPrint(buffer, (len + 1), format, print_args);
  if (len < 0) {
    return nullptr;
  }
  va_end(print_args);
  return buffer;
}

SetEnvironment()

void dart::bin::DartUtils::SetEnvironment ( dart::SimpleHashMap *  environment )

static

Definition at line 837 of file dartutils.cc.

                                                             {
  environment_ = environment;
}

SetIntegerField()

Dart_Handle dart::bin::DartUtils::SetIntegerField ( Dart_Handle  handle, const char *  name, int64_t  val  )

static

Definition at line 207 of file dartutils.cc.

                                                    {
  return Dart_SetField(handle, NewString(name), Dart_NewInteger(val));
}

SetOriginalWorkingDirectory()

bool dart::bin::DartUtils::SetOriginalWorkingDirectory ( )

static

Definition at line 827 of file dartutils.cc.

                                            {
  // If we happen to re-initialize the Dart VM multiple times, make sure to free
  // the old string (allocated by getcwd()) before setting a new one.
  if (original_working_directory != nullptr) {
    free(const_cast<char*>(original_working_directory));
  }
  original_working_directory = Directory::CurrentNoScope();
  return original_working_directory != nullptr;
}

SetStringField()

Dart_Handle dart::bin::DartUtils::SetStringField ( Dart_Handle  handle, const char *  name, const char *  val  )

static

Definition at line 213 of file dartutils.cc.

                                                       {
  return Dart_SetField(handle, NewString(name), NewString(val));
}

SetupIOLibrary()

Dart_Handle dart::bin::DartUtils::SetupIOLibrary ( const char *  namespc_path, const char *  script_uri, bool  disable_exit  )

static

Definition at line 621 of file dartutils.cc.

                                                         {
  Dart_Handle io_lib_url = NewString(kIOLibURL);
  RETURN_IF_ERROR(io_lib_url);
  Dart_Handle io_lib = Dart_LookupLibrary(io_lib_url);
  RETURN_IF_ERROR(io_lib);
 
  if (namespc_path != nullptr) {
    Dart_Handle namespc_type = GetDartType(DartUtils::kIOLibURL, "_Namespace");
    RETURN_IF_ERROR(namespc_type);
    Dart_Handle args[1];
    args[0] = NewString(namespc_path);
    RETURN_IF_ERROR(args[0]);
    Dart_Handle result =
        Dart_Invoke(namespc_type, NewString("_setupNamespace"), 1, args);
    RETURN_IF_ERROR(result);
  }
 
  if (disable_exit) {
    Dart_Handle embedder_config_type =
        GetDartType(DartUtils::kIOLibURL, "_EmbedderConfig");
    RETURN_IF_ERROR(embedder_config_type);
    Dart_Handle result = Dart_SetField(embedder_config_type,
                                       NewString("_mayExit"), Dart_False());
    RETURN_IF_ERROR(result);
  }
 
  Dart_Handle platform_type = GetDartType(DartUtils::kIOLibURL, "_Platform");
  RETURN_IF_ERROR(platform_type);
  Dart_Handle script_name = NewString("_nativeScript");
  RETURN_IF_ERROR(script_name);
  Dart_Handle dart_script = NewString(script_uri);
  RETURN_IF_ERROR(dart_script);
  Dart_Handle set_script_name =
      Dart_SetField(platform_type, script_name, dart_script);
  RETURN_IF_ERROR(set_script_name);
 
#if !defined(PRODUCT)
  Dart_Handle network_profiling_type =
      GetDartType(DartUtils::kIOLibURL, "_NetworkProfiling");
  RETURN_IF_ERROR(network_profiling_type);
  Dart_Handle result =
      Dart_Invoke(network_profiling_type,
                  NewString("_registerServiceExtension"), 0, nullptr);
  RETURN_IF_ERROR(result);
#endif  // !defined(PRODUCT)
  return Dart_Null();
}

SetupPackageConfig()

Dart_Handle dart::bin::DartUtils::SetupPackageConfig ( const char *  packages_file )

static

Definition at line 559 of file dartutils.cc.

                                                                     {
  Dart_Handle result = Dart_Null();
 
  if (packages_config != nullptr) {
    result = NewString(packages_config);
    RETURN_IF_ERROR(result);
    const int kNumArgs = 1;
    Dart_Handle dart_args[kNumArgs];
    dart_args[0] = result;
    result = Dart_Invoke(DartUtils::LookupBuiltinLib(),
                         NewString("_setPackagesMap"), kNumArgs, dart_args);
  }
  return result;
}

SniffForMagicNumber() [1/2]

DartUtils::MagicNumber dart::bin::DartUtils::SniffForMagicNumber ( const char *  filename )

static

Definition at line 407 of file dartutils.cc.

                                                                        {
  MagicNumber magic_number = DartUtils::kUnknownMagicNumber;
  ASSERT(kMaxMagicNumberSize == appjit_magic_number.length);
  ASSERT(aotelf_magic_number.length <= appjit_magic_number.length);
  ASSERT(aotmacho32_magic_number.length <= appjit_magic_number.length);
  ASSERT(aotmacho64_magic_number.length <= appjit_magic_number.length);
  ASSERT(aotmacho64_arm64_magic_number.length <= appjit_magic_number.length);
  ASSERT(aotcoff_arm32_magic_number.length <= appjit_magic_number.length);
  ASSERT(aotcoff_arm64_magic_number.length <= appjit_magic_number.length);
  ASSERT(aotcoff_riscv32_magic_number.length <= appjit_magic_number.length);
  ASSERT(aotcoff_riscv64_magic_number.length <= appjit_magic_number.length);
  ASSERT(kernel_magic_number.length <= appjit_magic_number.length);
  ASSERT(kernel_list_magic_number.length <= appjit_magic_number.length);
  ASSERT(gzip_magic_number.length <= appjit_magic_number.length);
  if (File::GetType(nullptr, filename, true) == File::kIsFile) {
    File* file = File::Open(nullptr, filename, File::kRead);
    if (file != nullptr) {
      RefCntReleaseScope<File> rs(file);
      uint8_t header[kMaxMagicNumberSize];
      if (file->ReadFully(&header, kMaxMagicNumberSize)) {
        magic_number = DartUtils::SniffForMagicNumber(header, sizeof(header));
      }
    }
  }
  return magic_number;
}

SniffForMagicNumber() [2/2]

DartUtils::MagicNumber dart::bin::DartUtils::SniffForMagicNumber ( const uint8_t *  text_buffer, intptr_t  buffer_len  )

static

Definition at line 434 of file dartutils.cc.

                                                                              {
  if (CheckMagicNumber(buffer, buffer_length, appjit_magic_number)) {
    return kAppJITMagicNumber;
  }
 
  if (CheckMagicNumber(buffer, buffer_length, kernel_magic_number)) {
    return kKernelMagicNumber;
  }
 
  if (CheckMagicNumber(buffer, buffer_length, kernel_list_magic_number)) {
    return kKernelListMagicNumber;
  }
 
  if (CheckMagicNumber(buffer, buffer_length, gzip_magic_number)) {
    return kGzipMagicNumber;
  }
 
  if (CheckMagicNumber(buffer, buffer_length, gzip_magic_number)) {
    return kGzipMagicNumber;
  }
 
  if (CheckMagicNumber(buffer, buffer_length, aotelf_magic_number)) {
    return kAotELFMagicNumber;
  }
 
  if (CheckMagicNumber(buffer, buffer_length, aotmacho32_magic_number)) {
    return kAotMachO32MagicNumber;
  }
 
  if (CheckMagicNumber(buffer, buffer_length, aotmacho64_magic_number)) {
    return kAotMachO64MagicNumber;
  }
 
  if (CheckMagicNumber(buffer, buffer_length, aotmacho64_arm64_magic_number)) {
    return kAotMachO64Arm64MagicNumber;
  }
 
  if (CheckMagicNumber(buffer, buffer_length, aotcoff_arm32_magic_number)) {
    return kAotCoffARM32MagicNumber;
  }
 
  if (CheckMagicNumber(buffer, buffer_length, aotcoff_arm64_magic_number)) {
    return kAotCoffARM64MagicNumber;
  }
 
  if (CheckMagicNumber(buffer, buffer_length, aotcoff_riscv32_magic_number)) {
    return kAotCoffRISCV32MagicNumber;
  }
 
  if (CheckMagicNumber(buffer, buffer_length, aotcoff_riscv64_magic_number)) {
    return kAotCoffRISCV64MagicNumber;
  }
 
  return kUnknownMagicNumber;
}

WriteFile()

void dart::bin::DartUtils::WriteFile ( const void *  buffer, intptr_t  num_bytes, void *  stream  )

static

Definition at line 298 of file dartutils.cc.

                                        {
  ASSERT(stream != nullptr);
  File* file_stream = reinterpret_cast<File*>(stream);
  bool bytes_written = file_stream->WriteFully(buffer, num_bytes);
  ASSERT(bytes_written);
}

Member Data Documentation

kAsyncLibURL

constexpr const char* dart::bin::DartUtils::kAsyncLibURL = "dart:async"

staticconstexpr

Definition at line 291 of file dartutils.h.

kBuiltinLibURL

constexpr const char* dart::bin::DartUtils::kBuiltinLibURL = "dart:_builtin"

staticconstexpr

Definition at line 292 of file dartutils.h.

kCLILibPatchURL

constexpr const char* dart::bin::DartUtils::kCLILibPatchURL = "dart:cli-patch"

staticconstexpr

Definition at line 300 of file dartutils.h.

kCLILibURL

constexpr const char* dart::bin::DartUtils::kCLILibURL = "dart:cli"

staticconstexpr

Definition at line 299 of file dartutils.h.

kCoreLibURL

constexpr const char* dart::bin::DartUtils::kCoreLibURL = "dart:core"

staticconstexpr

Definition at line 293 of file dartutils.h.

kDartScheme

constexpr const char* dart::bin::DartUtils::kDartScheme = "dart:"

staticconstexpr

Definition at line 290 of file dartutils.h.

kHttpLibURL

constexpr const char* dart::bin::DartUtils::kHttpLibURL = "dart:_http"

staticconstexpr

Definition at line 296 of file dartutils.h.

kHttpScheme

constexpr const char* dart::bin::DartUtils::kHttpScheme = "http:"

staticconstexpr

Definition at line 302 of file dartutils.h.

kInternalLibURL

constexpr const char* dart::bin::DartUtils::kInternalLibURL = "dart:_internal"

staticconstexpr

Definition at line 294 of file dartutils.h.

kIOLibPatchURL

constexpr const char* dart::bin::DartUtils::kIOLibPatchURL = "dart:io-patch"

staticconstexpr

Definition at line 298 of file dartutils.h.

kIOLibURL

constexpr const char* dart::bin::DartUtils::kIOLibURL = "dart:io"

staticconstexpr

Definition at line 297 of file dartutils.h.

kIsolateLibURL

constexpr const char* dart::bin::DartUtils::kIsolateLibURL = "dart:isolate"

staticconstexpr

Definition at line 295 of file dartutils.h.

kMaxMagicNumberSize

constexpr int64_t dart::bin::DartUtils::kMaxMagicNumberSize = 8

staticconstexpr

Definition at line 271 of file dartutils.h.

kUriLibURL

constexpr const char* dart::bin::DartUtils::kUriLibURL = "dart:uri"

staticconstexpr

Definition at line 301 of file dartutils.h.

kVMServiceLibURL

constexpr const char* dart::bin::DartUtils::kVMServiceLibURL = "dart:vmservice"

staticconstexpr

Definition at line 303 of file dartutils.h.

original_working_directory

const char * dart::bin::DartUtils::original_working_directory = nullptr

static

Definition at line 288 of file dartutils.h.

---

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

• third_party/dart-lang/sdk/runtime/bin/dartutils.h
• third_party/dart-lang/sdk/runtime/bin/dartutils.cc