summaryrefslogtreecommitdiff
path: root/Source/JavaScriptCore/ftl/FTLOSRExit.h
diff options
context:
space:
mode:
Diffstat (limited to 'Source/JavaScriptCore/ftl/FTLOSRExit.h')
-rw-r--r--Source/JavaScriptCore/ftl/FTLOSRExit.h143
1 files changed, 143 insertions, 0 deletions
diff --git a/Source/JavaScriptCore/ftl/FTLOSRExit.h b/Source/JavaScriptCore/ftl/FTLOSRExit.h
new file mode 100644
index 000000000..903527af0
--- /dev/null
+++ b/Source/JavaScriptCore/ftl/FTLOSRExit.h
@@ -0,0 +1,143 @@
+/*
+ * Copyright (C) 2013-2015 Apple Inc. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
+ * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR
+ * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+ * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+ * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
+ * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef FTLOSRExit_h
+#define FTLOSRExit_h
+
+#if ENABLE(FTL_JIT)
+
+#include "B3ValueRep.h"
+#include "CodeOrigin.h"
+#include "DFGExitProfile.h"
+#include "DFGNodeOrigin.h"
+#include "DFGOSRExitBase.h"
+#include "FTLAbbreviatedTypes.h"
+#include "FTLExitTimeObjectMaterialization.h"
+#include "FTLExitValue.h"
+#include "FTLFormattedValue.h"
+#include "FTLOSRExitHandle.h"
+#include "FTLStackmapArgumentList.h"
+#include "HandlerInfo.h"
+#include "MethodOfGettingAValueProfile.h"
+#include "Operands.h"
+#include "Reg.h"
+#include "ValueProfile.h"
+#include "VirtualRegister.h"
+
+namespace JSC {
+
+class TrackedReferences;
+
+namespace B3 {
+class StackmapGenerationParams;
+namespace Air {
+struct GenerationContext;
+} // namespace Air
+} // namespace B3
+
+namespace DFG {
+struct NodeOrigin;
+} // namespace DFG;
+
+namespace FTL {
+
+class State;
+struct OSRExitDescriptorImpl;
+struct OSRExitHandle;
+
+struct OSRExitDescriptor {
+ OSRExitDescriptor(
+ DataFormat profileDataFormat, MethodOfGettingAValueProfile,
+ unsigned numberOfArguments, unsigned numberOfLocals);
+
+ // The first argument to the exit call may be a value we wish to profile.
+ // If that's the case, the format will be not Invalid and we'll have a
+ // method of getting a value profile. Note that all of the ExitArgument's
+ // are already aware of this possible off-by-one, so there is no need to
+ // correct them.
+ DataFormat m_profileDataFormat;
+ MethodOfGettingAValueProfile m_valueProfile;
+
+ Operands<ExitValue> m_values;
+ Bag<ExitTimeObjectMaterialization> m_materializations;
+
+ void validateReferences(const TrackedReferences&);
+
+ // Call this once we have a place to emit the OSR exit jump and we have data about how the state
+ // should be recovered. This effectively emits code that does the exit, though the code is really a
+ // patchable jump and we emit the real code lazily. The description of how to emit the real code is
+ // up to the OSRExit object, which this creates. Note that it's OK to drop the OSRExitHandle object
+ // on the ground. It contains information that is mostly not useful if you use this API, since after
+ // this call, the OSRExit is simply ready to go.
+ RefPtr<OSRExitHandle> emitOSRExit(
+ State&, ExitKind, const DFG::NodeOrigin&, CCallHelpers&, const B3::StackmapGenerationParams&,
+ unsigned offset = 0);
+
+ // In some cases you want an OSRExit to come into existence, but you don't want to emit it right now.
+ // This will emit the OSR exit in a late path. You can't be sure exactly when that will happen, but
+ // you know that it will be done by the time late path emission is done. So, a linker task will
+ // surely happen after that. You can use the OSRExitHandle to retrieve the exit's label.
+ //
+ // This API is meant to be used for things like exception handling, where some patchpoint wants to
+ // have a place to jump to for OSR exit. It doesn't care where that OSR exit is emitted so long as it
+ // eventually gets access to its label.
+ RefPtr<OSRExitHandle> emitOSRExitLater(
+ State&, ExitKind, const DFG::NodeOrigin&, const B3::StackmapGenerationParams&,
+ unsigned offset = 0);
+
+private:
+ // This is the low-level interface. It will create a handle representing the desire to emit code for
+ // an OSR exit. You can call OSRExitHandle::emitExitThunk() once you have a place to emit it. Note
+ // that the above two APIs are written in terms of this and OSRExitHandle::emitExitThunk().
+ RefPtr<OSRExitHandle> prepareOSRExitHandle(
+ State&, ExitKind, const DFG::NodeOrigin&, const B3::StackmapGenerationParams&,
+ unsigned offset = 0);
+};
+
+struct OSRExit : public DFG::OSRExitBase {
+ OSRExit(
+ OSRExitDescriptor*, ExitKind,
+ CodeOrigin, CodeOrigin codeOriginForExitProfile
+ );
+
+ OSRExitDescriptor* m_descriptor;
+ MacroAssemblerCodeRef m_code;
+ // This tells us where to place a jump.
+ CodeLocationJump m_patchableJump;
+ Vector<B3::ValueRep> m_valueReps;
+
+ CodeLocationJump codeLocationForRepatch(CodeBlock* ftlCodeBlock) const;
+ void considerAddingAsFrequentExitSite(CodeBlock* profiledCodeBlock)
+ {
+ OSRExitBase::considerAddingAsFrequentExitSite(profiledCodeBlock, ExitFromFTL);
+ }
+};
+
+} } // namespace JSC::FTL
+
+#endif // ENABLE(FTL_JIT)
+
+#endif // FTLOSRExit_h
+