hphp/runtime/vm/jit/irlower.h

   1 /*
   2    +----------------------------------------------------------------------+
   3    | HipHop for PHP                                                       |
   4    +----------------------------------------------------------------------+
   5    | Copyright (c) 2010-present Facebook, Inc. (http://www.facebook.com)  |
   6    +----------------------------------------------------------------------+
   7    | This source file is subject to version 3.01 of the PHP license,      |
   8    | that is bundled with this package in the file LICENSE, and is        |
   9    | available through the world-wide-web at the following url:           |
  10    | http://www.php.net/license/3_01.txt                                  |
  11    | If you did not receive a copy of the PHP license and are unable to   |
  12    | obtain it through the world-wide-web, please send a note to          |
  13    | license@php.net so we can mail you a copy immediately.               |
  14    +----------------------------------------------------------------------+
  15 */
  16
  17 #pragma once
  18
  19 #include "hphp/runtime/vm/jit/code-cache.h"
  20 #include "hphp/runtime/vm/jit/state-vector.h"
  21 #include "hphp/runtime/vm/jit/types.h"
  22 #include "hphp/runtime/vm/jit/vasm-emit.h"
  23 #include "hphp/runtime/vm/jit/vasm-reg.h"
  24 #include "hphp/runtime/vm/jit/vasm-unit.h"
  25 #include "hphp/runtime/vm/jit/vasm.h"
  26
  27 namespace HPHP::jit {
  28
  29 struct IRUnit;
  30 struct Vout;
  31
  32 ///////////////////////////////////////////////////////////////////////////////
  33
  34 namespace irlower {
  35
  36 ///////////////////////////////////////////////////////////////////////////////
  37
  38 enum class SyncOptions {
  39   None,
  40   Sync,
  41 };
  42
  43 /*
  44  * State updated and tracked across vasm generation for individual instructions
  45  * and blocks.
  46  */
  47 struct IRLS {
  48   explicit IRLS(const IRUnit& unit)
  49     : unit(unit)
  50     , labels(unit, Vlabel())
  51     , locs(unit, Vloc{})
  52   {}
  53
  54   /*
  55    * The unit being lowered to vasm.
  56    */
  57   const IRUnit& unit;
  58
  59   /*
  60    * The vasm output streams.
  61    *
  62    * These may be updated during codegen of an instruction to point to new
  63    * Vblocks.
  64    */
  65   Vout* vmain{nullptr};
  66   Vout* vcold{nullptr};
  67
  68   /*
  69    * Vasm block labels, one for each HHIR block.
  70    */
  71   StateVector<Block,Vlabel> labels;
  72
  73   /*
  74    * Vlocs for each SSATmp used or defined in a reachable block.
  75    */
  76   StateVector<SSATmp,Vloc> locs;
  77 };
  78
  79 /*
  80  * Estimate the cost of unit.
  81  */
  82 Vcost computeIRUnitCost(const IRUnit& unit);
  83
  84 /*
  85  * Optimize a vunit.
  86  */
  87 void optimize(Vunit& unit, CodeKind kind, bool regAlloc = true);
  88
  89 /*
  90  * Lower the given HHIR unit to a Vunit, then optimize, regalloc, and return
  91  * the Vunit. Returns nullptr on failure.
  92  */
  93 std::unique_ptr<Vunit> lowerUnit(const IRUnit&,
  94                                  CodeKind kind = CodeKind::Trace,
  95                                  bool regAlloc = true) noexcept;
  96
  97 ///////////////////////////////////////////////////////////////////////////////
  98
  99 }}
 100