solidity/libyul/optimiser/Semantics.h

245 lines
7.1 KiB
C
Raw Normal View History

2017-11-22 10:11:48 +00:00
/*
This file is part of solidity.
solidity is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
solidity is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with solidity. If not, see <http://www.gnu.org/licenses/>.
*/
// SPDX-License-Identifier: GPL-3.0
2017-11-22 10:11:48 +00:00
/**
* Specific AST walkers that collect semantical facts.
*/
#pragma once
2018-10-15 09:52:35 +00:00
#include <libyul/optimiser/ASTWalker.h>
#include <libyul/SideEffects.h>
2019-12-02 11:33:24 +00:00
#include <libyul/optimiser/CallGraphGenerator.h>
#include <libyul/AsmData.h>
2017-11-22 10:11:48 +00:00
#include <set>
2019-12-11 16:31:36 +00:00
namespace solidity::yul
2017-11-22 10:11:48 +00:00
{
2018-12-20 17:55:32 +00:00
struct Dialect;
2017-11-22 10:11:48 +00:00
/**
* Specific AST walker that determines side-effect free-ness and movability of code.
* Enters into function definitions.
2017-11-22 10:11:48 +00:00
*/
class SideEffectsCollector: public ASTWalker
2017-11-22 10:11:48 +00:00
{
public:
explicit SideEffectsCollector(
Dialect const& _dialect,
std::map<YulString, SideEffects> const* _functionSideEffects = nullptr
): m_dialect(_dialect), m_functionSideEffects(_functionSideEffects) {}
SideEffectsCollector(
Dialect const& _dialect,
Expression const& _expression,
std::map<YulString, SideEffects> const* _functionSideEffects = nullptr
);
SideEffectsCollector(Dialect const& _dialect, Statement const& _statement);
SideEffectsCollector(
Dialect const& _dialect,
Block const& _ast,
std::map<YulString, SideEffects> const* _functionSideEffects = nullptr
);
SideEffectsCollector(
Dialect const& _dialect,
ForLoop const& _ast,
std::map<YulString, SideEffects> const* _functionSideEffects = nullptr
);
2017-11-22 10:11:48 +00:00
using ASTWalker::operator();
void operator()(FunctionCall const& _functionCall) override;
2017-11-22 10:11:48 +00:00
bool movable() const { return m_sideEffects.movable; }
bool movableRelativeTo(SideEffects const& _other, bool _codeContainsMSize)
{
if (!m_sideEffects.cannotLoop)
return false;
if (m_sideEffects.movable)
return true;
if (
!m_sideEffects.movableApartFromEffects ||
m_sideEffects.storage == SideEffects::Write ||
m_sideEffects.otherState == SideEffects::Write ||
m_sideEffects.memory == SideEffects::Write
)
return false;
if (m_sideEffects.otherState == SideEffects::Read)
if (_other.otherState == SideEffects::Write)
return false;
if (m_sideEffects.storage == SideEffects::Read)
if (_other.storage == SideEffects::Write)
return false;
if (m_sideEffects.memory == SideEffects::Read)
if (_codeContainsMSize || _other.memory == SideEffects::Write)
return false;
return true;
}
2020-07-01 10:07:00 +00:00
bool canBeRemoved(bool _allowMSizeModification = false) const
{
if (_allowMSizeModification)
2020-07-01 10:07:00 +00:00
return m_sideEffects.canBeRemovedIfNoMSize;
else
2020-07-01 10:07:00 +00:00
return m_sideEffects.canBeRemoved;
}
2020-07-01 10:07:00 +00:00
bool cannotLoop() const { return m_sideEffects.cannotLoop; }
bool invalidatesStorage() const { return m_sideEffects.storage == SideEffects::Write; }
bool invalidatesMemory() const { return m_sideEffects.memory == SideEffects::Write; }
SideEffects sideEffects() { return m_sideEffects; }
2017-11-22 10:11:48 +00:00
private:
2018-12-20 17:55:32 +00:00
Dialect const& m_dialect;
std::map<YulString, SideEffects> const* m_functionSideEffects = nullptr;
SideEffects m_sideEffects;
};
2019-08-13 14:25:12 +00:00
/**
* This class can be used to determine the side-effects of user-defined functions.
*
* It is given a dialect and a mapping that represents the direct calls from user-defined
* functions to other user-defined functions and built-in functions.
*/
class SideEffectsPropagator
{
public:
static std::map<YulString, SideEffects> sideEffects(
Dialect const& _dialect,
2019-12-02 11:33:24 +00:00
CallGraph const& _directCallGraph
2019-08-13 14:25:12 +00:00
);
};
/**
* Class that can be used to find out if certain code contains the MSize instruction.
*
* Note that this is a purely syntactic property meaning that even if this is false,
* the code can still contain calls to functions that contain the msize instruction.
*
* The only safe way to determine this is by passing the full AST.
*/
class MSizeFinder: public ASTWalker
{
public:
static bool containsMSize(Dialect const& _dialect, Block const& _ast);
using ASTWalker::operator();
2020-03-31 23:58:22 +00:00
void operator()(FunctionCall const& _funCall) override;
private:
MSizeFinder(Dialect const& _dialect): m_dialect(_dialect) {}
Dialect const& m_dialect;
bool m_msizeFound = false;
};
2019-10-28 14:25:02 +00:00
/**
* Class that can be used to find out if the given function contains the ``leave`` statement.
*
* Returns true even in the case where the function definition contains another function definition
* that contains the leave statement.
*/
class LeaveFinder: public ASTWalker
{
public:
static bool containsLeave(FunctionDefinition const& _fun)
{
LeaveFinder f;
f(_fun);
return f.m_leaveFound;
}
using ASTWalker::operator();
2020-03-31 23:58:22 +00:00
void operator()(Leave const&) override { m_leaveFound = true; }
2019-10-28 14:25:02 +00:00
private:
LeaveFinder() = default;
bool m_leaveFound = false;
};
/**
* Specific AST walker that determines whether an expression is movable
* and collects the referenced variables.
* Can only be used on expressions.
*/
class MovableChecker: public SideEffectsCollector
{
public:
explicit MovableChecker(
Dialect const& _dialect,
std::map<YulString, SideEffects> const* _functionSideEffects = nullptr
): SideEffectsCollector(_dialect, _functionSideEffects) {}
MovableChecker(Dialect const& _dialect, Expression const& _expression);
void operator()(Identifier const& _identifier) override;
/// Disallow visiting anything apart from Expressions (this throws).
void visit(Statement const&) override;
using ASTWalker::visit;
std::set<YulString> const& referencedVariables() const { return m_variableReferences; }
private:
/// Which variables the current expression references.
std::set<YulString> m_variableReferences;
2017-11-22 10:11:48 +00:00
};
2019-05-13 09:00:45 +00:00
/**
* Helper class to find "irregular" control flow.
* This includes termination, break and continue.
*/
class TerminationFinder
{
public:
2019-10-28 14:25:02 +00:00
// TODO check all uses of TerminationFinder!
enum class ControlFlow { FlowOut, Break, Continue, Terminate, Leave };
2019-05-13 09:00:45 +00:00
2019-05-20 12:30:32 +00:00
TerminationFinder(Dialect const& _dialect): m_dialect(_dialect) {}
2019-05-13 09:00:45 +00:00
/// @returns the index of the first statement in the provided sequence
2019-10-28 14:25:02 +00:00
/// that is an unconditional ``break``, ``continue``, ``leave`` or a
2019-05-13 09:00:45 +00:00
/// call to a terminating builtin function.
/// If control flow can continue at the end of the list,
/// returns `FlowOut` and ``size_t(-1)``.
/// The function might return ``FlowOut`` even though control
/// flow cannot actually continue.
2019-05-20 12:30:32 +00:00
std::pair<ControlFlow, size_t> firstUnconditionalControlFlowChange(
2019-05-13 09:00:45 +00:00
std::vector<Statement> const& _statements
);
/// @returns the control flow type of the given statement.
/// This function could return FlowOut even if control flow never continues.
2019-05-20 12:30:32 +00:00
ControlFlow controlFlowKind(Statement const& _statement);
2019-05-13 09:00:45 +00:00
/// @returns true if the expression statement is a direct
/// call to a builtin terminating function like
/// ``stop``, ``revert`` or ``return``.
2019-05-20 12:30:32 +00:00
bool isTerminatingBuiltin(ExpressionStatement const& _exprStmnt);
private:
Dialect const& m_dialect;
2019-05-13 09:00:45 +00:00
};
2017-11-22 10:11:48 +00:00
}