5#ifndef V8_V8_PLATFORM_H_
6#define V8_V8_PLATFORM_H_
54 virtual void Run() = 0;
66 virtual void Run(
double deadline_in_seconds) = 0;
106 std::unique_ptr<Task> task,
142 std::unique_ptr<Task> task,
double delay_in_seconds,
192 double delay_in_seconds,
195 double delay_in_seconds,
403#if !defined(V8_USE_PERFETTO)
412 static uint8_t no = 0;
425 char phase,
const uint8_t* category_enabled_flag,
const char* name,
426 const char* scope, uint64_t
id, uint64_t bind_id, int32_t num_args,
427 const char** arg_names,
const uint8_t* arg_types,
428 const uint64_t* arg_values,
429 std::unique_ptr<ConvertableToTraceFormat>* arg_convertables,
430 unsigned int flags) {
434 char phase,
const uint8_t* category_enabled_flag,
const char* name,
435 const char* scope, uint64_t
id, uint64_t bind_id, int32_t num_args,
436 const char** arg_names,
const uint8_t* arg_types,
437 const uint64_t* arg_values,
438 std::unique_ptr<ConvertableToTraceFormat>* arg_convertables,
439 unsigned int flags, int64_t timestamp) {
448 const char* name, uint64_t handle) {}
508#define DEFINE_SHARED_MEMORY_HANDLE_WRAPPERS(Wrap, Unwrap) \
509 V8_DEPRECATE_SOON("Use SharedMemoryHandle::FromPlatformHandle instead") \
510 inline SharedMemoryHandle Wrap(SharedMemoryHandle::PlatformHandle handle) { \
511 return SharedMemoryHandle::FromPlatformHandle(handle); \
513 V8_DEPRECATE_SOON("Use SharedMemoryHandle::GetPlatformHandle instead") \
514 inline SharedMemoryHandle::PlatformHandle Unwrap( \
515 SharedMemoryHandle handle) { \
516 return handle.GetPlatformHandle(); \
521 MachMemoryEntryFromSharedMemoryHandle)
524 VMOFromSharedMemoryHandle)
527 FileMappingFromSharedMemoryHandle)
533#undef DEFINE_SHARED_MEMORY_HANDLE_WRAPPERS
591 kNoAccessWillJitLater
602 void* address)
const {
615 : address_(address), may_grow_(may_grow) {}
617 void* address_ =
nullptr;
618 bool may_grow_ =
false;
634 return AllocatePages(hint.
Address(), length, alignment, permissions);
650 virtual bool FreePages(
void* address,
size_t length) = 0;
656 size_t new_length) = 0;
727 virtual std::unique_ptr<SharedMemoryMapping>
RemapTo(
728 void* new_address)
const = 0;
756 size_t length,
const void* original_address) {
785 virtual void Free(
void*
object) = 0;
796 virtual int Pkey()
const {
return -1; }
866 size_t size()
const {
return size_; }
882 return (address >=
base()) && (address <
base() +
size());
1101 std::optional<MemoryProtectionKeyId> key = std::nullopt,
1102 std::optional<SharedMemoryHandle> handle = std::nullopt) = 0;
1156 const size_t page_size_;
1157 const size_t allocation_granularity_;
1255 std::unique_ptr<
Task> task,
1270 std::unique_ptr<
Task> task,
1286 std::unique_ptr<
Task> task,
double delay_in_seconds,
1289 std::move(task), delay_in_seconds,
1312 double delay_in_seconds,
1315 delay_in_seconds, location);
1369 TaskPriority priority, std::unique_ptr<JobTask> job_task,
1371 auto handle =
CreateJob(priority, std::move(job_task), location);
1372 handle->NotifyConcurrencyIncrease();
1392 TaskPriority priority, std::unique_ptr<JobTask> job_task,
1394 return CreateJobImpl(priority, std::move(job_task), location);
1400 virtual std::unique_ptr<ScopedBoostablePriority>
1471 return &default_observer;
1486 TaskPriority priority, std::unique_ptr<JobTask> job_task,
1493 std::unique_ptr<Task> task,
Definition: v8-platform.h:1167
virtual void EnterSection()
Definition: v8-platform.h:1169
virtual void LeaveSection()
Definition: v8-platform.h:1170
Definition: v8-platform.h:63
virtual void Run(double deadline_in_seconds)=0
virtual ~IdleTask()=default
Definition: v8-isolate.h:291
Definition: v8-platform.h:205
virtual void NotifyConcurrencyIncrease()=0
virtual bool ShouldYield()=0
virtual bool IsJoiningThread() const =0
virtual uint8_t GetTaskId()=0
Definition: v8-platform.h:240
virtual void NotifyConcurrencyIncrease()=0
virtual void CancelAndDetach()=0
virtual bool IsActive()=0
virtual bool UpdatePriorityEnabled() const
Definition: v8-platform.h:288
virtual void UpdatePriority(TaskPriority new_priority)
Definition: v8-platform.h:293
virtual ~JobHandle()=default
Definition: v8-platform.h:299
virtual void Run(JobDelegate *delegate)=0
virtual size_t GetMaxConcurrency(size_t worker_count) const =0
virtual ~JobTask()=default
Definition: v8-platform.h:597
bool MayGrow() const
Definition: v8-platform.h:610
void * Address() const
Definition: v8-platform.h:611
constexpr AllocationHint WithAddress(void *address) const
Definition: v8-platform.h:601
constexpr AllocationHint WithMayGrow() const
Definition: v8-platform.h:606
Definition: v8-platform.h:711
virtual ~SharedMemoryMapping()=default
virtual void * GetMemory() const =0
Definition: v8-platform.h:723
virtual std::unique_ptr< SharedMemoryMapping > RemapTo(void *new_address) const =0
virtual void * GetMemory() const =0
virtual size_t GetSize() const =0
virtual ~SharedMemory()=default
Definition: v8-platform.h:547
virtual void * GetRandomMmapAddr()=0
virtual bool ResizeAllocationAt(void *address, size_t old_length, size_t new_length, Permission permissions)
Definition: v8-platform.h:642
virtual ~PageAllocator()=default
virtual void * AllocatePages(size_t length, size_t alignment, Permission permissions, AllocationHint hint)
Definition: v8-platform.h:632
virtual bool ReleasePages(void *address, size_t length, size_t new_length)=0
Permission
Definition: v8-platform.h:578
@ kReadExecute
Definition: v8-platform.h:583
@ kRead
Definition: v8-platform.h:580
@ kNoAccess
Definition: v8-platform.h:579
@ kReadWrite
Definition: v8-platform.h:581
@ kReadWriteExecute
Definition: v8-platform.h:582
virtual bool DecommitPages(void *address, size_t size)=0
virtual size_t AllocatePageSize()=0
virtual void SetRandomMmapSeed(int64_t seed)=0
virtual void * AllocatePages(void *address, size_t length, size_t alignment, Permission permissions)=0
virtual bool CanAllocateSharedPages()
Definition: v8-platform.h:768
virtual bool RecommitPages(void *address, size_t length, Permission permissions)
Definition: v8-platform.h:669
virtual bool SetPermissions(void *address, size_t length, Permission permissions)=0
virtual bool SealPages(void *address, size_t length)
Definition: v8-platform.h:702
virtual bool FreePages(void *address, size_t length)=0
virtual std::unique_ptr< SharedMemory > AllocateSharedPages(size_t length, const void *original_address)
Definition: v8-platform.h:755
virtual bool DiscardSystemPages(void *address, size_t size)
Definition: v8-platform.h:682
virtual size_t CommitPageSize()=0
virtual bool ReserveForSharedMemoryMapping(void *address, size_t size)
Definition: v8-platform.h:742
Definition: v8-platform.h:368
virtual ~ScopedBlockingCall()=default
Definition: v8-platform.h:322
ScopedBoostablePriority(const ScopedBoostablePriority &)=delete
virtual ~ScopedBoostablePriority()=default
virtual bool BoostPriority()=0
ScopedBoostablePriority & operator=(const ScopedBoostablePriority &other)=delete
Definition: v8-platform.h:472
int PlatformHandle
Definition: v8-platform.h:490
static constexpr SharedMemoryHandle FromPlatformHandle(PlatformHandle handle)
Definition: v8-platform.h:493
PlatformHandle GetPlatformHandle() const
Definition: v8-platform.h:498
Definition: v8-source-location.h:22
static constexpr SourceLocation Current(const std::source_location &loc=std::source_location::current())
Definition: v8-source-location.h:28
Definition: v8-platform.h:75
void PostNonNestableDelayedTask(std::unique_ptr< Task > task, double delay_in_seconds, SourceLocation location=SourceLocation::Current())
Definition: v8-platform.h:141
TaskRunner & operator=(const TaskRunner &)=delete
virtual void PostIdleTaskImpl(std::unique_ptr< IdleTask > task, const SourceLocation &location)
Definition: v8-platform.h:197
TaskRunner(const TaskRunner &)=delete
virtual void PostNonNestableTaskImpl(std::unique_ptr< Task > task, const SourceLocation &location)
Definition: v8-platform.h:189
virtual void PostTaskImpl(std::unique_ptr< Task > task, const SourceLocation &location)
Definition: v8-platform.h:187
virtual void PostDelayedTaskImpl(std::unique_ptr< Task > task, double delay_in_seconds, const SourceLocation &location)
Definition: v8-platform.h:191
virtual bool NonNestableDelayedTasksEnabled() const
Definition: v8-platform.h:175
void PostIdleTask(std::unique_ptr< IdleTask > task, SourceLocation location=SourceLocation::Current())
Definition: v8-platform.h:157
virtual bool NonNestableTasksEnabled() const
Definition: v8-platform.h:170
void PostTask(std::unique_ptr< Task > task, SourceLocation location=SourceLocation::Current())
Definition: v8-platform.h:83
virtual ~TaskRunner()=default
virtual void PostNonNestableDelayedTaskImpl(std::unique_ptr< Task > task, double delay_in_seconds, const SourceLocation &location)
Definition: v8-platform.h:194
virtual bool IdleTasksEnabled()=0
void PostNonNestableTask(std::unique_ptr< Task > task, SourceLocation location=SourceLocation::Current())
Definition: v8-platform.h:105
void PostDelayedTask(std::unique_ptr< Task > task, double delay_in_seconds, SourceLocation location=SourceLocation::Current())
Definition: v8-platform.h:118
Definition: v8-platform.h:50
Definition: v8-platform.h:779
virtual int Pkey() const
Definition: v8-platform.h:796
virtual void * Allocate(size_t size)=0
virtual void Free(void *object)=0
virtual ~ThreadIsolatedAllocator()=default
virtual Type Type() const =0
Type
Definition: v8-platform.h:787
Definition: v8-platform.h:451
virtual void OnTraceEnabled()=0
virtual ~TraceStateObserver()=default
virtual void OnTraceDisabled()=0
Definition: v8-platform.h:396
virtual uint64_t AddTraceEventWithTimestamp(char phase, const uint8_t *category_enabled_flag, const char *name, const char *scope, uint64_t id, uint64_t bind_id, int32_t num_args, const char **arg_names, const uint8_t *arg_types, const uint64_t *arg_values, std::unique_ptr< ConvertableToTraceFormat > *arg_convertables, unsigned int flags, int64_t timestamp)
Definition: v8-platform.h:433
virtual const uint8_t * GetCategoryGroupEnabled(const char *name)
Definition: v8-platform.h:411
virtual ~TracingController()=default
virtual void AddTraceStateObserver(TraceStateObserver *)
Definition: v8-platform.h:462
virtual void RemoveTraceStateObserver(TraceStateObserver *)
Definition: v8-platform.h:468
virtual void UpdateTraceEventDuration(const uint8_t *category_enabled_flag, const char *name, uint64_t handle)
Definition: v8-platform.h:447
virtual uint64_t AddTraceEvent(char phase, const uint8_t *category_enabled_flag, const char *name, const char *scope, uint64_t id, uint64_t bind_id, int32_t num_args, const char **arg_names, const uint8_t *arg_types, const uint64_t *arg_values, std::unique_ptr< ConvertableToTraceFormat > *arg_convertables, unsigned int flags)
Definition: v8-platform.h:424
Definition: v8-platform.h:820
virtual bool CanAllocateSubspaces()=0
Address base() const
Definition: v8-platform.h:859
virtual void FreePages(Address address, size_t size)=0
virtual std::unique_ptr< VirtualAddressSpace > AllocateSubspace(Address hint, size_t size, size_t alignment, PagePermissions max_page_permissions, std::optional< MemoryProtectionKeyId > key=std::nullopt, std::optional< SharedMemoryHandle > handle=std::nullopt)=0
virtual void SetRandomSeed(int64_t seed)=0
static constexpr Address kNoHint
Definition: v8-platform.h:921
bool Contains(Address address) const
Definition: v8-platform.h:881
uintptr_t Address
Definition: v8-platform.h:822
virtual bool DiscardSystemPages(Address address, size_t size)
Definition: v8-platform.h:1138
virtual void FreeSharedPages(Address address, size_t size)=0
virtual void FreeGuardRegion(Address address, size_t size)=0
virtual bool SetPagePermissions(Address address, size_t size, PagePermissions permissions)=0
VirtualAddressSpace(size_t page_size, size_t allocation_granularity, Address base, size_t size, PagePermissions max_page_permissions)
Definition: v8-platform.h:824
int MemoryProtectionKeyId
Definition: v8-platform.h:1051
size_t size() const
Definition: v8-platform.h:866
virtual bool AllocateGuardRegion(Address address, size_t size)=0
virtual Address AllocateSharedPages(Address hint, size_t size, PagePermissions permissions, SharedMemoryHandle handle, uint64_t offset)=0
PagePermissions max_page_permissions() const
Definition: v8-platform.h:874
virtual std::optional< MemoryProtectionKeyId > ActiveMemoryProtectionKey()=0
size_t allocation_granularity() const
Definition: v8-platform.h:852
virtual Address RandomPageAddress()=0
virtual bool RecommitPages(Address address, size_t size, PagePermissions permissions)=0
virtual ~VirtualAddressSpace()=default
virtual bool DecommitPages(Address address, size_t size)=0
virtual Address AllocatePages(Address hint, size_t size, size_t alignment, PagePermissions permissions)=0
size_t page_size() const
Definition: v8-platform.h:842
Definition: libplatform.h:15
TaskPriority
Definition: v8-platform.h:25
SharedMemoryHandle SharedMemoryHandleFromFileDescriptor(SharedMemoryHandle::PlatformHandle handle)
Definition: v8-platform.h:530
SharedMemoryHandle::PlatformHandle FileDescriptorFromSharedMemoryHandle(SharedMemoryHandle handle)
Definition: v8-platform.h:530
BlockingType
Definition: v8-platform.h:353
std::optional< SharedMemoryHandle > PlatformSharedMemoryHandle
Definition: v8-platform.h:537
PagePermissions
Definition: v8-platform.h:802
#define V8_EXPORT
Definition: v8config.h:855
#define V8_DEPRECATE_SOON(message)
Definition: v8config.h:622
#define V8_WARN_UNUSED_RESULT
Definition: v8config.h:679