From 0ebf5bdf043a27fd3dfb7f92e0cb63d88954c44d Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Fri, 19 Apr 2024 03:47:29 +0200 Subject: Adding upstream version 115.8.0esr. Signed-off-by: Daniel Baumann --- js/src/vm/PIC.h | 246 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 246 insertions(+) create mode 100644 js/src/vm/PIC.h (limited to 'js/src/vm/PIC.h') diff --git a/js/src/vm/PIC.h b/js/src/vm/PIC.h new file mode 100644 index 0000000000..e2f8cb37a6 --- /dev/null +++ b/js/src/vm/PIC.h @@ -0,0 +1,246 @@ +/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- + * vim: set ts=8 sts=2 et sw=2 tw=80: + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ + +#ifndef vm_PIC_h +#define vm_PIC_h + +#include "vm/GlobalObject.h" +#include "vm/NativeObject.h" + +namespace js { + +class Shape; + +template +class PICChain; + +/* + * The basic PICStub just has a pointer to the next stub. + */ +template +class PICStub { + friend class PICChain; + + private: + using CatStub = typename Category::Stub; + using CatChain = typename Category::Chain; + + protected: + CatStub* next_; + + PICStub() : next_(nullptr) {} + explicit PICStub(const CatStub* next) : next_(next) { MOZ_ASSERT(next_); } + explicit PICStub(const CatStub& other) : next_(other.next_) {} + + public: + CatStub* next() const { return next_; } + + protected: + void append(CatStub* stub) { + MOZ_ASSERT(!next_); + MOZ_ASSERT(!stub->next_); + next_ = stub; + } +}; + +/* + * The basic PIC just has a pointer to the list of stubs. + */ +template +class PICChain { + private: + using CatStub = typename Category::Stub; + using CatChain = typename Category::Chain; + + protected: + CatStub* stubs_; + + PICChain() : stubs_(nullptr) {} + // PICs should never be copy constructed. + PICChain(const PICChain& other) = delete; + + public: + CatStub* stubs() const { return stubs_; } + + void addStub(JSObject* obj, CatStub* stub); + + unsigned numStubs() const { + unsigned count = 0; + for (CatStub* stub = stubs_; stub; stub = stub->next()) { + count++; + } + return count; + } +}; + +// Class for object that holds ForOfPIC chain. +class ForOfPICObject : public NativeObject { + public: + enum { ChainSlot, SlotCount }; + + static const JSClass class_; +}; + +/* + * ForOfPIC defines a PIC category for optimizing for-of operations. + */ +struct ForOfPIC { + /* Forward declarations so template-substitution works. */ + class Stub; + class Chain; + + ForOfPIC() = delete; + ForOfPIC(const ForOfPIC& other) = delete; + + using BaseStub = PICStub; + using BaseChain = PICChain; + + /* + * A ForOfPIC has only one kind of stub for now: one that holds the shape + * of an array object that does not override its @@iterator property. + */ + class Stub : public BaseStub { + private: + // Shape of matching array object. + const HeapPtr shape_; + + public: + explicit Stub(Shape* shape) : BaseStub(), shape_(shape) { + MOZ_ASSERT(shape_); + } + + Shape* shape() { return shape_; } + + void trace(JSTracer* trc); + }; + + /* + * A ForOfPIC chain holds the following: + * + * Array.prototype (arrayProto_) + * To ensure that the incoming array has the standard proto. + * + * Array.prototype's shape (arrayProtoShape_) + * To ensure that Array.prototype has not been modified. + * + * ArrayIterator.prototype + * ArrayIterator.prototype's shape + * (arrayIteratorProto_, arrayIteratorProtoShape_) + * To ensure that an ArrayIterator.prototype has not been modified. + * + * Array.prototype's slot number for @@iterator + * Array.prototype's canonical value for @@iterator + * (arrayProtoIteratorSlot_, canonicalIteratorFunc_) + * To quickly retrieve and ensure that the iterator constructor + * stored in the slot has not changed. + * + * ArrayIterator.prototype's slot number for 'next' + * ArrayIterator.prototype's canonical value for 'next' + * (arrayIteratorProtoNextSlot_, canonicalNextFunc_) + * To quickly retrieve and ensure that the 'next' method for + * ArrayIterator objects has not changed. + */ + class Chain : public BaseChain { + private: + // Pointer to owning JSObject for memory accounting purposes. + const GCPtr picObject_; + + // Pointer to canonical Array.prototype and ArrayIterator.prototype + GCPtr arrayProto_; + GCPtr arrayIteratorProto_; + + // Shape of matching Array.prototype object, and slot containing + // the @@iterator for it, and the canonical value. + GCPtr arrayProtoShape_; + uint32_t arrayProtoIteratorSlot_; + GCPtr canonicalIteratorFunc_; + + // Shape of matching ArrayIteratorProto, and slot containing + // the 'next' property, and the canonical value. + GCPtr arrayIteratorProtoShape_; + uint32_t arrayIteratorProtoNextSlot_; + GCPtr canonicalNextFunc_; + + // Initialization flag marking lazy initialization of above fields. + bool initialized_; + + // Disabled flag is set when we don't want to try optimizing anymore + // because core objects were changed. + bool disabled_; + + static const unsigned MAX_STUBS = 10; + + public: + explicit Chain(JSObject* picObject) + : BaseChain(), + picObject_(picObject), + arrayProto_(nullptr), + arrayIteratorProto_(nullptr), + arrayProtoShape_(nullptr), + arrayProtoIteratorSlot_(-1), + canonicalIteratorFunc_(UndefinedValue()), + arrayIteratorProtoShape_(nullptr), + arrayIteratorProtoNextSlot_(-1), + initialized_(false), + disabled_(false) {} + + // Initialize the canonical iterator function. + bool initialize(JSContext* cx); + + // Try to optimize this chain for an object. + bool tryOptimizeArray(JSContext* cx, Handle array, + bool* optimized); + + // Check if %ArrayIteratorPrototype% still uses the default "next" method. + bool tryOptimizeArrayIteratorNext(JSContext* cx, bool* optimized); + + void trace(JSTracer* trc); + void finalize(JS::GCContext* gcx, JSObject* obj); + + void freeAllStubs(JS::GCContext* gcx); + + private: + // Check if the global array-related objects have not been messed with + // in a way that would disable this PIC. + bool isArrayStateStillSane(); + + // Check if ArrayIterator.next is still optimizable. + inline bool isArrayNextStillSane() { + return (arrayIteratorProto_->shape() == arrayIteratorProtoShape_) && + (arrayIteratorProto_->getSlot(arrayIteratorProtoNextSlot_) == + canonicalNextFunc_); + } + + // Check if a matching optimized stub for the given object exists. + bool hasMatchingStub(ArrayObject* obj); + + // Reset the PIC and all info associated with it. + void reset(JSContext* cx); + + // Erase the stub chain. + void eraseChain(JSContext* cx); + }; + + static NativeObject* createForOfPICObject(JSContext* cx, + Handle global); + + static inline Chain* fromJSObject(NativeObject* obj) { + MOZ_ASSERT(obj->is()); + return obj->maybePtrFromReservedSlot(ForOfPICObject::ChainSlot); + } + static inline Chain* getOrCreate(JSContext* cx) { + NativeObject* obj = cx->global()->getForOfPICObject(); + if (obj) { + return fromJSObject(obj); + } + return create(cx); + } + static Chain* create(JSContext* cx); +}; + +} // namespace js + +#endif /* vm_PIC_h */ -- cgit v1.2.3