Home | History | Annotate | Download | only in libplatform
      1 // Copyright 2014 the V8 project authors. All rights reserved.
      2 // Use of this source code is governed by a BSD-style license that can be
      3 // found in the LICENSE file.
      4 
      5 #ifndef V8_LIBPLATFORM_LIBPLATFORM_H_
      6 #define V8_LIBPLATFORM_LIBPLATFORM_H_
      7 
      8 #include "libplatform/libplatform-export.h"
      9 #include "libplatform/v8-tracing.h"
     10 #include "v8-platform.h"  // NOLINT(build/include)
     11 
     12 namespace v8 {
     13 namespace platform {
     14 
     15 /**
     16  * Returns a new instance of the default v8::Platform implementation.
     17  *
     18  * The caller will take ownership of the returned pointer. |thread_pool_size|
     19  * is the number of worker threads to allocate for background jobs. If a value
     20  * of zero is passed, a suitable default based on the current number of
     21  * processors online will be chosen.
     22  */
     23 V8_PLATFORM_EXPORT v8::Platform* CreateDefaultPlatform(
     24     int thread_pool_size = 0);
     25 
     26 /**
     27  * Pumps the message loop for the given isolate.
     28  *
     29  * The caller has to make sure that this is called from the right thread.
     30  * Returns true if a task was executed, and false otherwise. This call does
     31  * not block if no task is pending. The |platform| has to be created using
     32  * |CreateDefaultPlatform|.
     33  */
     34 V8_PLATFORM_EXPORT bool PumpMessageLoop(v8::Platform* platform,
     35                                         v8::Isolate* isolate);
     36 
     37 /**
     38  * Attempts to set the tracing controller for the given platform.
     39  *
     40  * The |platform| has to be created using |CreateDefaultPlatform|.
     41  */
     42 V8_PLATFORM_EXPORT void SetTracingController(
     43     v8::Platform* platform,
     44     v8::platform::tracing::TracingController* tracing_controller);
     45 
     46 }  // namespace platform
     47 }  // namespace v8
     48 
     49 #endif  // V8_LIBPLATFORM_LIBPLATFORM_H_
     50