| 1 | // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file |
| 2 | // for details. All rights reserved. Use of this source code is governed by a |
| 3 | // BSD-style license that can be found in the LICENSE file. |
| 4 | |
| 5 | #include <functional> |
| 6 | |
| 7 | #include "include/dart_native_api.h" |
| 8 | |
| 9 | #include "platform/assert.h" |
| 10 | #include "platform/utils.h" |
| 11 | #include "vm/dart_api_impl.h" |
| 12 | #include "vm/dart_api_message.h" |
| 13 | #include "vm/dart_api_state.h" |
| 14 | #include "vm/message.h" |
| 15 | #include "vm/native_message_handler.h" |
| 16 | #include "vm/port.h" |
| 17 | #include "vm/service_isolate.h" |
| 18 | |
| 19 | namespace dart { |
| 20 | |
| 21 | // --- Message sending/receiving from native code --- |
| 22 | |
| 23 | class IsolateLeaveScope { |
| 24 | public: |
| 25 | explicit IsolateLeaveScope(Isolate* current_isolate) |
| 26 | : saved_isolate_(current_isolate) { |
| 27 | if (current_isolate != NULL) { |
| 28 | ASSERT(current_isolate == Isolate::Current()); |
| 29 | Dart_ExitIsolate(); |
| 30 | } |
| 31 | } |
| 32 | ~IsolateLeaveScope() { |
| 33 | if (saved_isolate_ != NULL) { |
| 34 | Dart_Isolate I = reinterpret_cast<Dart_Isolate>(saved_isolate_); |
| 35 | Dart_EnterIsolate(I); |
| 36 | } |
| 37 | } |
| 38 | |
| 39 | private: |
| 40 | Isolate* saved_isolate_; |
| 41 | |
| 42 | DISALLOW_COPY_AND_ASSIGN(IsolateLeaveScope); |
| 43 | }; |
| 44 | |
| 45 | static bool PostCObjectHelper(Dart_Port port_id, Dart_CObject* message) { |
| 46 | ApiMessageWriter writer; |
| 47 | std::unique_ptr<Message> msg = |
| 48 | writer.WriteCMessage(message, port_id, Message::kNormalPriority); |
| 49 | |
| 50 | if (msg == nullptr) { |
| 51 | return false; |
| 52 | } |
| 53 | |
| 54 | // Post the message at the given port. |
| 55 | return PortMap::PostMessage(std::move(msg)); |
| 56 | } |
| 57 | |
| 58 | DART_EXPORT bool Dart_PostCObject(Dart_Port port_id, Dart_CObject* message) { |
| 59 | return PostCObjectHelper(port_id, message); |
| 60 | } |
| 61 | |
| 62 | DART_EXPORT bool Dart_PostInteger(Dart_Port port_id, int64_t message) { |
| 63 | if (Smi::IsValid(message)) { |
| 64 | return PortMap::PostMessage( |
| 65 | Message::New(port_id, Smi::New(message), Message::kNormalPriority)); |
| 66 | } |
| 67 | Dart_CObject cobj; |
| 68 | cobj.type = Dart_CObject_kInt64; |
| 69 | cobj.value.as_int64 = message; |
| 70 | return PostCObjectHelper(port_id, &cobj); |
| 71 | } |
| 72 | |
| 73 | DART_EXPORT Dart_Port Dart_NewNativePort(const char* name, |
| 74 | Dart_NativeMessageHandler handler, |
| 75 | bool handle_concurrently) { |
| 76 | if (name == NULL) { |
| 77 | name = "<UnnamedNativePort>" ; |
| 78 | } |
| 79 | if (handler == NULL) { |
| 80 | OS::PrintErr("%s expects argument 'handler' to be non-null.\n" , |
| 81 | CURRENT_FUNC); |
| 82 | return ILLEGAL_PORT; |
| 83 | } |
| 84 | // Start the native port without a current isolate. |
| 85 | IsolateLeaveScope saver(Isolate::Current()); |
| 86 | |
| 87 | NativeMessageHandler* nmh = new NativeMessageHandler(name, handler); |
| 88 | Dart_Port port_id = PortMap::CreatePort(nmh); |
| 89 | PortMap::SetPortState(port_id, PortMap::kLivePort); |
| 90 | nmh->Run(Dart::thread_pool(), NULL, NULL, 0); |
| 91 | return port_id; |
| 92 | } |
| 93 | |
| 94 | DART_EXPORT bool Dart_CloseNativePort(Dart_Port native_port_id) { |
| 95 | // Close the native port without a current isolate. |
| 96 | IsolateLeaveScope saver(Isolate::Current()); |
| 97 | |
| 98 | // TODO(turnidge): Check that the port is native before trying to close. |
| 99 | return PortMap::ClosePort(native_port_id); |
| 100 | } |
| 101 | |
| 102 | static Monitor* vm_service_calls_monitor = new Monitor(); |
| 103 | |
| 104 | DART_EXPORT bool Dart_InvokeVMServiceMethod(uint8_t* request_json, |
| 105 | intptr_t request_json_length, |
| 106 | uint8_t** response_json, |
| 107 | intptr_t* response_json_length, |
| 108 | char** error) { |
| 109 | #if !defined(PRODUCT) |
| 110 | Isolate* isolate = Isolate::Current(); |
| 111 | ASSERT(isolate == nullptr || !isolate->is_service_isolate()); |
| 112 | IsolateLeaveScope saver(isolate); |
| 113 | |
| 114 | // We only allow one isolate reload at a time. If this turns out to be on the |
| 115 | // critical path, we can change it to have a global datastructure which is |
| 116 | // mapping the reply ports to receive buffers. |
| 117 | MonitorLocker _(vm_service_calls_monitor); |
| 118 | |
| 119 | static Monitor* vm_service_call_monitor = new Monitor(); |
| 120 | static uint8_t* result_bytes = nullptr; |
| 121 | static intptr_t result_length = 0; |
| 122 | |
| 123 | ASSERT(result_bytes == nullptr); |
| 124 | ASSERT(result_length == 0); |
| 125 | |
| 126 | struct Utils { |
| 127 | static void HandleResponse(Dart_Port dest_port_id, Dart_CObject* message) { |
| 128 | MonitorLocker monitor(vm_service_call_monitor); |
| 129 | |
| 130 | RELEASE_ASSERT(message->type == Dart_CObject_kTypedData); |
| 131 | RELEASE_ASSERT(message->value.as_typed_data.type == |
| 132 | Dart_TypedData_kUint8); |
| 133 | result_length = message->value.as_typed_data.length; |
| 134 | result_bytes = reinterpret_cast<uint8_t*>(malloc(result_length)); |
| 135 | memmove(result_bytes, message->value.as_typed_data.values, result_length); |
| 136 | |
| 137 | monitor.Notify(); |
| 138 | } |
| 139 | }; |
| 140 | |
| 141 | auto port = |
| 142 | ::Dart_NewNativePort("service-rpc" , &Utils::HandleResponse, false); |
| 143 | if (port == ILLEGAL_PORT) { |
| 144 | if (error != nullptr) { |
| 145 | *error = ::dart::Utils::StrDup("Was unable to create native port." ); |
| 146 | } |
| 147 | return false; |
| 148 | } |
| 149 | |
| 150 | // Before sending the message we'll lock the monitor, which the receiver |
| 151 | // will later on notify once the answer has been received. |
| 152 | MonitorLocker monitor(vm_service_call_monitor); |
| 153 | |
| 154 | if (ServiceIsolate::SendServiceRpc(request_json, request_json_length, port, |
| 155 | error)) { |
| 156 | // We posted successfully and expect the vm-service to send the reply, so |
| 157 | // we will wait for it now. |
| 158 | auto wait_result = monitor.Wait(); |
| 159 | ASSERT(wait_result == Monitor::kNotified); |
| 160 | |
| 161 | // The caller takes ownership of the data. |
| 162 | *response_json = result_bytes; |
| 163 | *response_json_length = result_length; |
| 164 | |
| 165 | // Reset global data, which can be used by the next call (after the mutex |
| 166 | // has been released). |
| 167 | result_bytes = nullptr; |
| 168 | result_length = 0; |
| 169 | |
| 170 | // After the data has been received, we will not get any more messages on |
| 171 | // this port and can safely close it now. |
| 172 | Dart_CloseNativePort(port); |
| 173 | |
| 174 | return true; |
| 175 | } else { |
| 176 | // We couldn't post the message and will not receive any reply. Therefore we |
| 177 | // clean up the port and return an error. |
| 178 | Dart_CloseNativePort(port); |
| 179 | return false; |
| 180 | } |
| 181 | #else // !defined(PRODUCT) |
| 182 | if (error != nullptr) { |
| 183 | *error = Utils::StrDup("VM Service is not supported in PRODUCT mode." ); |
| 184 | } |
| 185 | return false; |
| 186 | #endif // !defined(PRODUCT) |
| 187 | } |
| 188 | |
| 189 | // --- Verification tools --- |
| 190 | |
| 191 | DART_EXPORT Dart_Handle Dart_CompileAll() { |
| 192 | #if defined(DART_PRECOMPILED_RUNTIME) |
| 193 | return Api::NewError("%s: Cannot compile on an AOT runtime." , CURRENT_FUNC); |
| 194 | #else |
| 195 | DARTSCOPE(Thread::Current()); |
| 196 | API_TIMELINE_DURATION(T); |
| 197 | Dart_Handle result = Api::CheckAndFinalizePendingClasses(T); |
| 198 | if (Api::IsError(result)) { |
| 199 | return result; |
| 200 | } |
| 201 | CHECK_CALLBACK_STATE(T); |
| 202 | const Error& error = Error::Handle(T->zone(), Library::CompileAll()); |
| 203 | if (!error.IsNull()) { |
| 204 | return Api::NewHandle(T, error.raw()); |
| 205 | } |
| 206 | return Api::Success(); |
| 207 | #endif // defined(DART_PRECOMPILED_RUNTIME) |
| 208 | } |
| 209 | |
| 210 | DART_EXPORT Dart_Handle Dart_ReadAllBytecode() { |
| 211 | #if defined(DART_PRECOMPILED_RUNTIME) |
| 212 | return Api::NewError("%s: Cannot read bytecode on an AOT runtime." , |
| 213 | CURRENT_FUNC); |
| 214 | #else |
| 215 | DARTSCOPE(Thread::Current()); |
| 216 | API_TIMELINE_DURATION(T); |
| 217 | Dart_Handle result = Api::CheckAndFinalizePendingClasses(T); |
| 218 | if (Api::IsError(result)) { |
| 219 | return result; |
| 220 | } |
| 221 | CHECK_CALLBACK_STATE(T); |
| 222 | const Error& error = Error::Handle(T->zone(), Library::ReadAllBytecode()); |
| 223 | if (!error.IsNull()) { |
| 224 | return Api::NewHandle(T, error.raw()); |
| 225 | } |
| 226 | return Api::Success(); |
| 227 | #endif // defined(DART_PRECOMPILED_RUNTIME) |
| 228 | } |
| 229 | |
| 230 | DART_EXPORT Dart_Handle Dart_FinalizeAllClasses() { |
| 231 | #if defined(DART_PRECOMPILED_RUNTIME) |
| 232 | return Api::NewError("%s: All classes are already finalized in AOT runtime." , |
| 233 | CURRENT_FUNC); |
| 234 | #else |
| 235 | DARTSCOPE(Thread::Current()); |
| 236 | API_TIMELINE_DURATION(T); |
| 237 | Dart_Handle result = Api::CheckAndFinalizePendingClasses(T); |
| 238 | if (Api::IsError(result)) { |
| 239 | return result; |
| 240 | } |
| 241 | CHECK_CALLBACK_STATE(T); |
| 242 | const Error& error = Error::Handle(T->zone(), Library::FinalizeAllClasses()); |
| 243 | if (!error.IsNull()) { |
| 244 | return Api::NewHandle(T, error.raw()); |
| 245 | } |
| 246 | return Api::Success(); |
| 247 | #endif // defined(DART_PRECOMPILED_RUNTIME) |
| 248 | } |
| 249 | |
| 250 | struct RunInSafepointAndRWCodeArgs { |
| 251 | Isolate* isolate; |
| 252 | std::function<void()>* callback; |
| 253 | }; |
| 254 | |
| 255 | DART_EXPORT void* Dart_ExecuteInternalCommand(const char* command, void* arg) { |
| 256 | if (!FLAG_enable_testing_pragmas) return nullptr; |
| 257 | |
| 258 | if (strcmp(command, "gc-on-nth-allocation" ) == 0) { |
| 259 | TransitionNativeToVM _(Thread::Current()); |
| 260 | intptr_t argument = reinterpret_cast<intptr_t>(arg); |
| 261 | ASSERT(argument > 0); |
| 262 | Isolate::Current()->heap()->CollectOnNthAllocation(argument); |
| 263 | return nullptr; |
| 264 | |
| 265 | } else if (strcmp(command, "gc-now" ) == 0) { |
| 266 | ASSERT(arg == nullptr); // Don't pass an argument to this command. |
| 267 | TransitionNativeToVM _(Thread::Current()); |
| 268 | Isolate::Current()->heap()->CollectAllGarbage(); |
| 269 | return nullptr; |
| 270 | |
| 271 | } else if (strcmp(command, "is-mutator-in-native" ) == 0) { |
| 272 | Isolate* const isolate = reinterpret_cast<Isolate*>(arg); |
| 273 | if (isolate->mutator_thread()->execution_state_cross_thread_for_testing() == |
| 274 | Thread::kThreadInNative) { |
| 275 | return arg; |
| 276 | } else { |
| 277 | return nullptr; |
| 278 | } |
| 279 | |
| 280 | } else if (strcmp(command, "run-in-safepoint-and-rw-code" ) == 0) { |
| 281 | const RunInSafepointAndRWCodeArgs* const args = |
| 282 | reinterpret_cast<RunInSafepointAndRWCodeArgs*>(arg); |
| 283 | Thread::EnterIsolateAsHelper(args->isolate, Thread::TaskKind::kUnknownTask); |
| 284 | Thread* const thread = Thread::Current(); |
| 285 | { |
| 286 | SafepointOperationScope scope(thread); |
| 287 | args->isolate->heap()->WriteProtectCode(/*read_only=*/false); |
| 288 | (*args->callback)(); |
| 289 | args->isolate->heap()->WriteProtectCode(/*read_only=*/true); |
| 290 | } |
| 291 | Thread::ExitIsolateAsHelper(); |
| 292 | return nullptr; |
| 293 | |
| 294 | } else { |
| 295 | UNREACHABLE(); |
| 296 | } |
| 297 | } |
| 298 | |
| 299 | } // namespace dart |
| 300 | |