ARM64PrivateLinkage.hpp

/*******************************************************************************
 * Copyright (c) 2019, 2022 IBM Corp. and others
 *
 * This program and the accompanying materials are made available under
 * the terms of the Eclipse Public License 2.0 which accompanies this
 * distribution and is available at https://www.eclipse.org/legal/epl-2.0/
 * or the Apache License, Version 2.0 which accompanies this distribution and
 * is available at https://www.apache.org/licenses/LICENSE-2.0.
 *
 * This Source Code may also be made available under the following
 * Secondary Licenses when the conditions for such availability set
 * forth in the Eclipse Public License, v. 2.0 are satisfied: GNU
 * General Public License, version 2 with the GNU Classpath
 * Exception [1] and GNU General Public License, version 2 with the
 * OpenJDK Assembly Exception [2].
 *
 * [1] https://www.gnu.org/software/classpath/license.html
 * [2] http://openjdk.java.net/legal/assembly-exception.html
 *
 * SPDX-License-Identifier: EPL-2.0 OR Apache-2.0 OR GPL-2.0 WITH Classpath-exception-2.0 OR LicenseRef-GPL-2.0 WITH Assembly-exception
 *******************************************************************************/

#ifndef ARM64_PRIVATELINKAGE_INCL
#define ARM64_PRIVATELINKAGE_INCL

#include "codegen/Linkage.hpp"
#include "codegen/LinkageConventionsEnum.hpp"
#include "codegen/PrivateLinkage.hpp"

#include "infra/Assert.hpp"

class TR_ResolvedMethod;

namespace TR { class CodeGenerator; }
namespace TR { class Instruction; }
namespace TR { class Register; }
namespace TR { class ResolvedMethodSymbol; }

namespace J9
{

struct ARM64PICItem
   {
   TR_ALLOC(TR_Memory::Linkage);

   ARM64PICItem(TR_OpaqueClassBlock *clazz, TR_ResolvedMethod *method, float freq) :
      _clazz(clazz), _method(method), _frequency(freq) {}

   TR_OpaqueClassBlock *_clazz;
   TR_ResolvedMethod *_method;
   float _frequency;
   };

namespace ARM64
{

class PrivateLinkage : public J9::PrivateLinkage
   {
   protected:

   TR::ARM64LinkageProperties _properties;

   /**
    * @brief Builds method arguments
    * @param[in] node : caller node
    * @param[in] dependencies : register dependency conditions
    * @param[in] linkage : linkage type
    */
   int32_t buildPrivateLinkageArgs(
         TR::Node *callNode,
         TR::RegisterDependencyConditions *dependencies,
         TR_LinkageConventions linkage);

   /**
    * @brief Store informaiton of outgoing memory argument
    * @param[in] argReg : argument register
    * @param[in] offset : offset from Java SP
    * @param[in] opCode : opcode for storing argument
    * @param[in] memArg : MemoryArgument
    */
   void pushOutgoingMemArgument(
      TR::Register *argReg,
      int32_t offset,
      TR::InstOpCode::Mnemonic opCode,
      TR::ARM64MemoryArgument &memArg);

   public:

   /**
    * @brief Constructor
    * @param[in] cg : CodeGenerator
    */
   PrivateLinkage(TR::CodeGenerator *cg);

   /**
    * @brief Answers linkage properties
    * @return linkage properties
    */
   virtual TR::ARM64LinkageProperties& getProperties();

   /**
    * @brief Gets the RightToLeft flag
    * @return RightToLeft flag
    */
   virtual uint32_t getRightToLeft();

   /**
    * @brief Adjust stack index so that local references are aligned properly
    * @param[in/out] stackIndex : index on stack
    */
   virtual void alignLocalReferences(uint32_t &stackIndex);
   /**
    * @brief Maps symbols to locations on stack
    * @param[in] method : method for which symbols are mapped on stack
    */
   virtual void mapStack(TR::ResolvedMethodSymbol *method);
   /**
    * @brief Maps an automatic symbol to an index on stack
    * @param[in] p : automatic symbol
    * @param[in/out] stackIndex : index on stack
    */
   virtual void mapSingleAutomatic(TR::AutomaticSymbol *p, uint32_t &stackIndex);
   /**
    * @brief Maps an automatic symbol to an index on stack
    * @param[in] p : automatic symbol
    * @param[in] size : size
    * @param[in/out] stackIndex : index on stack
    */
   virtual void mapSingleAutomatic(TR::AutomaticSymbol *p, uint32_t size, uint32_t &stackIndex);

   /**
    * @brief Initializes ARM64 RealRegister linkage
    */
   virtual void initARM64RealRegisterLinkage();

   /**
    * @brief Calculates the amount of frame space required to save the
    *    preserved registers in this method.
    *
    * @param[out] registerSaveDescription : the bitmask of registers to preserve
    * @param[out] numGPRsSaved : the number of GPRs saved
    *
    * @return : number of bytes required to reserve on the frame for
    *           preserved registers
    */
   int32_t calculatePreservedRegisterSaveSize(
      uint32_t &registerSaveDescription,
      uint32_t &numGPRsSaved);

   /**
    * @brief Copy linkage register indices to parameter symbols
    *
    * @param[in] method : the resolved method symbol
    */
   void setParameterLinkageRegisterIndex(TR::ResolvedMethodSymbol *method);

   /**
    * @brief Creates method prologue
    * @param[in] cursor : instruction cursor
    */
   virtual void createPrologue(TR::Instruction *cursor);
   /**
    * @brief Creates method epilogue
    * @param[in] cursor : instruction cursor
    */
   virtual void createEpilogue(TR::Instruction *cursor);

   /**
    * @brief Loads all parameters passed on the stack from the interpreter into
    *        the corresponding JITed method private linkage register.
    *
    * @param[in] cursor : the TR::Instruction to begin generating
    *        the load sequence at.
    *
    * @return : the instruction cursor after the load sequence
    */
   virtual TR::Instruction *loadStackParametersToLinkageRegisters(TR::Instruction *cursor);

   /**
    * @brief Stores parameters passed in linkage registers to the stack. This method is used only in FSD mode.
    *
    * @param[in] cursor : the instruction cursor to begin inserting copy instructions
    *
    * @return The instruction cursor after copies inserted.
    */
   virtual TR::Instruction *saveParametersToStack(TR::Instruction *cursor);

   /**
    * @brief Builds method arguments
    * @param[in] node : caller node
    * @param[in] dependencies : register dependency conditions
    */
   virtual int32_t buildArgs(
      TR::Node *callNode,
      TR::RegisterDependencyConditions *dependencies);

   /**
    * @brief Builds direct dispatch to method
    * @param[in] node : caller node
    */
   virtual TR::Register *buildDirectDispatch(TR::Node *callNode);

   /**
    * @brief Builds direct call to method
    * @param[in] node : caller node
    * @param[in] callSymRef : target symbol reference
    * @param[in] dependencies : register dependency conditions
    * @param[in] pp : linkage properties
    * @param[in] argSize : size of arguments
    */
   void buildDirectCall(
      TR::Node *callNode,
      TR::SymbolReference *callSymRef,
      TR::RegisterDependencyConditions *dependencies,
      const TR::ARM64LinkageProperties &pp,
      uint32_t argSize);

   /**
    * @brief Builds indirect dispatch to method
    * @param[in] node : caller node
    */
   virtual TR::Register *buildIndirectDispatch(TR::Node *callNode);

   /**
    * @brief Builds virtual dispatch to method
    * @param[in] node : caller node
    * @param[in] dependencies : register dependency conditions
    * @param[in] argSize : size of arguments
    */
   virtual void buildVirtualDispatch(
      TR::Node *callNode,
      TR::RegisterDependencyConditions *dependencies,
      uint32_t argSize);

   /**
    * @brief J9 private linkage override of OMR function
    */
   virtual intptr_t entryPointFromCompiledMethod();

   /**
    * @brief J9 private linkage override of OMR function
    */
   virtual intptr_t entryPointFromInterpretedMethod();

   /**
    * J9 private linkage override of OMR function
    */
   virtual void performPostBinaryEncoding();

   /**
    * @return Retrieve the interpretedMethodEntryPoint instruction
    */
   TR::Instruction *getInterpretedMethodEntryPoint() { return _interpretedMethodEntryPoint; }

   /**
    * @brief Sets the interpreted method entry point instruction
    * @param[in] ins : interpreted method entry point instruction
    */
   void setInterpretedMethodEntryPoint(TR::Instruction *ins) { _interpretedMethodEntryPoint = ins; }

   /**
    * @return Retrieve the jittedMethodEntryPoint instruction
    */
   TR::Instruction *getJittedMethodEntryPoint() { return _jittedMethodEntryPoint; }

   /**
    * @brief Sets the jitted method entry point instruction
    * @param[in] ins : jitted method entry point instruction
    */
   void setJittedMethodEntryPoint(TR::Instruction *ins) { _jittedMethodEntryPoint = ins; }

   protected:

   /**
    * The first TR::Instruction of the method when called from an interpreted method.
    */
   TR::Instruction *_interpretedMethodEntryPoint;

   /**
    * The first TR::Instruction of the method when called from a jitted method.
    */
   TR::Instruction *_jittedMethodEntryPoint;

   private:

   // Tactical GRA
   static uint32_t _globalRegisterNumberToRealRegisterMap[];
   };


class HelperLinkage : public PrivateLinkage
   {
   public:

   /**
    * @brief Constructor
    * @param[in] cg : CodeGenerator
    * @param[in] helperLinkage : linkage convention
    */
   HelperLinkage(TR::CodeGenerator *cg, TR_LinkageConventions helperLinkage) : _helperLinkage(helperLinkage), PrivateLinkage(cg)
      {
      TR_ASSERT(helperLinkage == TR_Helper || helperLinkage == TR_CHelper, "Unexpected helper linkage convention");
      }

   /**
    * @brief Builds method arguments for helper call
    * @param[in] node : caller node
    * @param[in] dependencies : register dependency conditions
    * @return total size that arguments occupy on Java stack
    */
   virtual int32_t buildArgs(
      TR::Node *callNode,
      TR::RegisterDependencyConditions *dependencies);
   protected:

   TR_LinkageConventions _helperLinkage;

   };

}

}

#endif