// Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file // for details. All rights reserved. Use of this source code is governed by a // BSD-style license that can be found in the LICENSE file. #ifndef RUNTIME_BIN_DARTUTILS_H_ #define RUNTIME_BIN_DARTUTILS_H_ #include "bin/isolate_data.h" #include "include/dart_api.h" #include "include/dart_native_api.h" #include "platform/assert.h" #include "platform/globals.h" #include "platform/hashmap.h" namespace dart { namespace bin { // Forward declarations. class File; class OSError; /* Handles error handles returned from Dart API functions. If a value * is an error, uses Dart_PropagateError to throw it to the enclosing * Dart activation. Otherwise, returns the original handle. * * This function can be used to wrap most API functions, but API * functions can also be nested without this error check, since all * API functions return any error handles passed in as arguments, unchanged. */ static inline Dart_Handle ThrowIfError(Dart_Handle handle) { if (Dart_IsError(handle)) { Dart_PropagateError(handle); } return handle; } static inline void* GetHashmapKeyFromString(char* key) { return reinterpret_cast(key); } class CommandLineOptions { public: explicit CommandLineOptions(int max_count) : count_(0), max_count_(max_count), arguments_(NULL) { static const int kWordSize = sizeof(intptr_t); arguments_ = reinterpret_cast(malloc(max_count * kWordSize)); if (arguments_ == NULL) { max_count_ = 0; } } ~CommandLineOptions() { free(arguments_); count_ = 0; max_count_ = 0; arguments_ = NULL; } void Reset() { count_ = 0; } int count() const { return count_; } int max_count() const { return max_count_; } const char** arguments() const { return arguments_; } const char* GetArgument(int index) const { return (index >= 0 && index < count_) ? arguments_[index] : NULL; } void AddArgument(const char* argument) { if (count_ < max_count_) { arguments_[count_] = argument; count_ += 1; } else { abort(); // We should never get into this situation. } } void AddArguments(const char** argv, int argc) { if (count_ + argc >= max_count_) { abort(); // We should never get into this situation. } for (int i = 0; i < argc; ++i) { arguments_[count_++] = argv[i]; } } Dart_Handle CreateRuntimeOptions(); void operator delete(void* pointer) { abort(); } private: void* operator new(size_t size); int count_; int max_count_; const char** arguments_; DISALLOW_COPY_AND_ASSIGN(CommandLineOptions); }; class DartUtils { public: // Returns the integer value of a Dart object. If the object is not // an integer value an API error is propagated. static int64_t GetIntegerValue(Dart_Handle value_obj); // Returns the integer value of a Dart object. If the object is not // an integer value or outside the requested range an API error is // propagated. static int64_t GetInt64ValueCheckRange(Dart_Handle value_obj, int64_t lower, int64_t upper); // Returns the intptr_t value of a Dart object. If the object is not // an integer value or the value is outside the intptr_t range an // API error is propagated. static intptr_t GetIntptrValue(Dart_Handle value_obj); // Checks that the value object is an integer object that fits in a // signed 64-bit integer. If it is, the value is returned in the // value out parameter and true is returned. Otherwise, false is // returned. static bool GetInt64Value(Dart_Handle value_obj, int64_t* value); // Returns the string value of a Dart object. If the object is not // a string value an API error is propagated. static const char* GetStringValue(Dart_Handle str_obj); // Returns the boolean value of a Dart object. If the object is not // a boolean value an API error is propagated. static bool GetBooleanValue(Dart_Handle bool_obj); // Returns the boolean value of the argument at index. If the argument // is not a boolean value an API error is propagated. static bool GetNativeBooleanArgument(Dart_NativeArguments args, intptr_t index); // Returns the integer value of the argument at index. If the argument // is not an integer value an API error is propagated. static int64_t GetNativeIntegerArgument(Dart_NativeArguments args, intptr_t index); // Returns the intptr_t value of the argument at index. If the argument // is not an integer value or the value is outside the intptr_t range an // API error is propagated. static intptr_t GetNativeIntptrArgument(Dart_NativeArguments args, intptr_t index); // Returns the string value of the argument at index. If the argument // is not a string value an API error is propagated. static const char* GetNativeStringArgument(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 IsDartExtensionSchemeURL(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 uint8_t* 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 Dart_Handle GetDartType(const char* library_url, const char* class_name); // Create a new Dart OSError object with the current OS error. static Dart_Handle NewDartOSError(); // Create a new Dart OSError object with the provided OS error. 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); // Create a new Dart String object from a UTF8 encoded C String. static Dart_Handle NewString(const char* str) { ASSERT(str != NULL); return Dart_NewStringFromUTF8(reinterpret_cast(str), strlen(str)); } // Create a new Dart String object from a formatted string. static Dart_Handle NewStringFormatted(const char* format, ...); // Allocate length bytes for a C string with Dart_ScopeAllocate. static char* ScopedCString(intptr_t length) { char* result = NULL; result = reinterpret_cast(Dart_ScopeAllocate(length * sizeof(*result))); return result; } // Copy str into a buffer allocated with Dart_ScopeAllocate. static char* ScopedCopyCString(const char* str) { size_t str_len = strlen(str); char* result = ScopedCString(str_len + 1); memmove(result, str, str_len); result[str_len] = '\0'; return result; } // Create a new Dart InternalError object with the provided message. static Dart_Handle NewError(const char* format, ...); static Dart_Handle NewInternalError(const char* message); static Dart_Handle LookupBuiltinLib() { return Dart_LookupLibrary(NewString(kBuiltinLibURL)); } static bool SetOriginalWorkingDirectory(); static Dart_Handle ResolveScript(Dart_Handle url); enum MagicNumber { kAppJITMagicNumber, kKernelMagicNumber, kKernelListMagicNumber, kGzipMagicNumber, kUnknownMagicNumber }; // Checks if the buffer is a script snapshot, kernel file, or gzip file. static MagicNumber SniffForMagicNumber(const char* filename); // Checks if the buffer is a script snapshot, kernel file, or gzip file. static MagicNumber SniffForMagicNumber(const uint8_t* text_buffer, intptr_t buffer_len); // Global state that stores the original working directory.. static const char* original_working_directory; static const char* const kDartScheme; static const char* const kDartExtensionScheme; static const char* const kAsyncLibURL; static const char* const kBuiltinLibURL; static const char* const kCoreLibURL; static const char* const kInternalLibURL; static const char* const kIsolateLibURL; static const char* const kHttpLibURL; static const char* const kIOLibURL; static const char* const kIOLibPatchURL; static const char* const kCLILibURL; static const char* const kCLILibPatchURL; static const char* const kUriLibURL; static const char* const kHttpScheme; static const char* const kVMServiceLibURL; static void SetEnvironment(dart::SimpleHashMap* environment); static Dart_Handle EnvironmentCallback(Dart_Handle name); private: static Dart_Handle SetWorkingDirectory(); static Dart_Handle PrepareBuiltinLibrary(Dart_Handle builtin_lib, Dart_Handle internal_lib, bool is_service_isolate, bool trace_loading); static Dart_Handle PrepareCoreLibrary(Dart_Handle core_lib, Dart_Handle io_lib, bool is_service_isolate); static Dart_Handle PrepareAsyncLibrary(Dart_Handle async_lib, Dart_Handle isolate_lib); static Dart_Handle PrepareIOLibrary(Dart_Handle io_lib); static Dart_Handle PrepareIsolateLibrary(Dart_Handle isolate_lib); static Dart_Handle PrepareCLILibrary(Dart_Handle cli_lib); static dart::SimpleHashMap* environment_; DISALLOW_ALLOCATION(); DISALLOW_IMPLICIT_CONSTRUCTORS(DartUtils); }; class CObject { public: // These match the constants in sdk/lib/io/common.dart. static const int kSuccess = 0; static const int kArgumentError = 1; static const int kOSError = 2; static const int kFileClosedError = 3; explicit CObject(Dart_CObject* cobject) : cobject_(cobject) {} Dart_CObject_Type type() { return cobject_->type; } Dart_TypedData_Type byte_array_type() { ASSERT(type() == Dart_CObject_kTypedData || type() == Dart_CObject_kExternalTypedData); return cobject_->value.as_typed_data.type; } bool IsNull() { return type() == Dart_CObject_kNull; } bool IsBool() { return type() == Dart_CObject_kBool; } bool IsInt32() { return type() == Dart_CObject_kInt32; } bool IsInt64() { return type() == Dart_CObject_kInt64; } bool IsInt32OrInt64() { return IsInt32() || IsInt64(); } bool IsIntptr() { return IsInt32OrInt64(); } bool IsDouble() { return type() == Dart_CObject_kDouble; } bool IsString() { return type() == Dart_CObject_kString; } bool IsArray() { return type() == Dart_CObject_kArray; } bool IsTypedData() { return type() == Dart_CObject_kTypedData; } bool IsUint8Array() { return type() == Dart_CObject_kTypedData && byte_array_type() == Dart_TypedData_kUint8; } bool IsSendPort() { return type() == Dart_CObject_kSendPort; } bool IsTrue() { return type() == Dart_CObject_kBool && cobject_->value.as_bool; } bool IsFalse() { return type() == Dart_CObject_kBool && !cobject_->value.as_bool; } void* operator new(size_t size) { return Dart_ScopeAllocate(size); } static CObject* Null(); static CObject* True(); static CObject* False(); static CObject* Bool(bool value); static Dart_CObject* NewInt32(int32_t value); static Dart_CObject* NewInt64(int64_t value); static Dart_CObject* NewIntptr(intptr_t value); static Dart_CObject* NewDouble(double value); static Dart_CObject* NewString(intptr_t length); static Dart_CObject* NewString(const char* str); static Dart_CObject* NewArray(intptr_t length); static Dart_CObject* NewUint8Array(intptr_t length); static Dart_CObject* NewUint32Array(intptr_t length); static Dart_CObject* NewExternalUint8Array(intptr_t length, uint8_t* data, void* peer, Dart_HandleFinalizer callback); static Dart_CObject* NewIOBuffer(int64_t length); static void ShrinkIOBuffer(Dart_CObject* cobject, int64_t new_length); static void FreeIOBufferData(Dart_CObject* object); Dart_CObject* AsApiCObject() { return cobject_; } // Create a new CObject array with an illegal arguments error. static CObject* IllegalArgumentError(); // Create a new CObject array with a file closed error. static CObject* FileClosedError(); // Create a new CObject array with the current OS error. static CObject* NewOSError(); // Create a new CObject array with the specified OS error. static CObject* NewOSError(OSError* os_error); protected: CObject() : cobject_(NULL) {} Dart_CObject* cobject_; private: static Dart_CObject* New(Dart_CObject_Type type, int additional_bytes = 0); static Dart_CObject api_null_; static Dart_CObject api_true_; static Dart_CObject api_false_; static CObject null_; static CObject true_; static CObject false_; private: DISALLOW_COPY_AND_ASSIGN(CObject); }; #define DECLARE_COBJECT_CONSTRUCTORS(t) \ explicit CObject##t(Dart_CObject* cobject) : CObject(cobject) { \ ASSERT(type() == Dart_CObject_k##t); \ cobject_ = cobject; \ } \ explicit CObject##t(CObject* cobject) : CObject() { \ ASSERT(cobject != NULL); \ ASSERT(cobject->type() == Dart_CObject_k##t); \ cobject_ = cobject->AsApiCObject(); \ } #define DECLARE_COBJECT_TYPED_DATA_CONSTRUCTORS(t) \ explicit CObject##t##Array(Dart_CObject* cobject) : CObject(cobject) { \ ASSERT(type() == Dart_CObject_kTypedData); \ ASSERT(byte_array_type() == Dart_TypedData_k##t); \ cobject_ = cobject; \ } \ explicit CObject##t##Array(CObject* cobject) : CObject() { \ ASSERT(cobject != NULL); \ ASSERT(cobject->type() == Dart_CObject_kTypedData); \ ASSERT(cobject->byte_array_type() == Dart_TypedData_k##t); \ cobject_ = cobject->AsApiCObject(); \ } #define DECLARE_COBJECT_EXTERNAL_TYPED_DATA_CONSTRUCTORS(t) \ explicit CObjectExternal##t##Array(Dart_CObject* cobject) \ : CObject(cobject) { \ ASSERT(type() == Dart_CObject_kExternalTypedData); \ ASSERT(byte_array_type() == Dart_TypedData_k##t); \ cobject_ = cobject; \ } \ explicit CObjectExternal##t##Array(CObject* cobject) : CObject() { \ ASSERT(cobject != NULL); \ ASSERT(cobject->type() == Dart_CObject_kExternalTypedData); \ ASSERT(cobject->byte_array_type() == Dart_TypedData_k##t); \ cobject_ = cobject->AsApiCObject(); \ } class CObjectBool : public CObject { public: DECLARE_COBJECT_CONSTRUCTORS(Bool) bool Value() const { return cobject_->value.as_bool; } private: DISALLOW_COPY_AND_ASSIGN(CObjectBool); }; class CObjectInt32 : public CObject { public: DECLARE_COBJECT_CONSTRUCTORS(Int32) int32_t Value() const { return cobject_->value.as_int32; } private: DISALLOW_COPY_AND_ASSIGN(CObjectInt32); }; class CObjectInt64 : public CObject { public: DECLARE_COBJECT_CONSTRUCTORS(Int64) int64_t Value() const { return cobject_->value.as_int64; } private: DISALLOW_COPY_AND_ASSIGN(CObjectInt64); }; class CObjectIntptr : public CObject { public: explicit CObjectIntptr(Dart_CObject* cobject) : CObject(cobject) { ASSERT(type() == Dart_CObject_kInt32 || type() == Dart_CObject_kInt64); cobject_ = cobject; } explicit CObjectIntptr(CObject* cobject) : CObject() { ASSERT(cobject != NULL); ASSERT(cobject->type() == Dart_CObject_kInt64 || cobject->type() == Dart_CObject_kInt32); cobject_ = cobject->AsApiCObject(); } intptr_t Value() { intptr_t result; if (type() == Dart_CObject_kInt32) { result = cobject_->value.as_int32; } else { ASSERT(sizeof(result) == 8); result = static_cast(cobject_->value.as_int64); } return result; } private: DISALLOW_COPY_AND_ASSIGN(CObjectIntptr); }; class CObjectDouble : public CObject { public: DECLARE_COBJECT_CONSTRUCTORS(Double) double Value() const { return cobject_->value.as_double; } private: DISALLOW_COPY_AND_ASSIGN(CObjectDouble); }; class CObjectString : public CObject { public: DECLARE_COBJECT_CONSTRUCTORS(String) intptr_t Length() const { return strlen(cobject_->value.as_string); } char* CString() const { return cobject_->value.as_string; } private: DISALLOW_COPY_AND_ASSIGN(CObjectString); }; class CObjectArray : public CObject { public: DECLARE_COBJECT_CONSTRUCTORS(Array) intptr_t Length() const { return cobject_->value.as_array.length; } CObject* operator[](intptr_t index) const { return new CObject(cobject_->value.as_array.values[index]); } void SetAt(intptr_t index, CObject* value) { cobject_->value.as_array.values[index] = value->AsApiCObject(); } private: DISALLOW_COPY_AND_ASSIGN(CObjectArray); }; class CObjectSendPort : public CObject { public: DECLARE_COBJECT_CONSTRUCTORS(SendPort) Dart_Port Value() const { return cobject_->value.as_send_port.id; } Dart_Port OriginId() const { return cobject_->value.as_send_port.origin_id; } private: DISALLOW_COPY_AND_ASSIGN(CObjectSendPort); }; class CObjectTypedData : public CObject { public: explicit CObjectTypedData(Dart_CObject* cobject) : CObject(cobject) { ASSERT(type() == Dart_CObject_kTypedData); cobject_ = cobject; } explicit CObjectTypedData(CObject* cobject) : CObject() { ASSERT(cobject != NULL); ASSERT(cobject->type() == Dart_CObject_kTypedData); cobject_ = cobject->AsApiCObject(); } Dart_TypedData_Type Type() const { return cobject_->value.as_typed_data.type; } intptr_t Length() const { return cobject_->value.as_typed_data.length; } uint8_t* Buffer() const { return cobject_->value.as_typed_data.values; } private: DISALLOW_COPY_AND_ASSIGN(CObjectTypedData); }; class CObjectUint8Array : public CObject { public: DECLARE_COBJECT_TYPED_DATA_CONSTRUCTORS(Uint8) intptr_t Length() const { return cobject_->value.as_typed_data.length; } uint8_t* Buffer() const { return cobject_->value.as_typed_data.values; } private: DISALLOW_COPY_AND_ASSIGN(CObjectUint8Array); }; class CObjectExternalUint8Array : public CObject { public: DECLARE_COBJECT_EXTERNAL_TYPED_DATA_CONSTRUCTORS(Uint8) intptr_t Length() const { return cobject_->value.as_external_typed_data.length; } uint8_t* Data() const { return cobject_->value.as_external_typed_data.data; } void* Peer() const { return cobject_->value.as_external_typed_data.peer; } Dart_HandleFinalizer Callback() const { return cobject_->value.as_external_typed_data.callback; } private: DISALLOW_COPY_AND_ASSIGN(CObjectExternalUint8Array); }; class ScopedBlockingCall { public: ScopedBlockingCall() { Dart_ThreadDisableProfiling(); } ~ScopedBlockingCall() { Dart_ThreadEnableProfiling(); } private: DISALLOW_ALLOCATION(); DISALLOW_COPY_AND_ASSIGN(ScopedBlockingCall); }; struct MagicNumberData { static const intptr_t kMaxLength = 8; intptr_t length; const uint8_t bytes[kMaxLength]; }; extern MagicNumberData appjit_magic_number; extern MagicNumberData kernel_magic_number; extern MagicNumberData kernel_list_magic_number; extern MagicNumberData gzip_magic_number; } // namespace bin } // namespace dart #endif // RUNTIME_BIN_DARTUTILS_H_