Skip to content

Commit

Permalink
Replace OpKill With function call.
Browse files Browse the repository at this point in the history
We are no able to inline OpKill instructions into a continue construct.
See KhronosGroup#2433.  However, we have to be able to inline to correctly do
legalization.  This commit creates a pass that will wrap OpKill
instructions into a function of its own.  That way we are able to inline
the rest of the code.

The follow up to this will be to not inline any function that contains
an OpKill.

Fixes KhronosGroup#2726
  • Loading branch information
s-perron committed Aug 12, 2019
1 parent f701237 commit a77a8da
Show file tree
Hide file tree
Showing 14 changed files with 443 additions and 9 deletions.
1 change: 1 addition & 0 deletions Android.mk
Expand Up @@ -172,6 +172,7 @@ SPVTOOLS_OPT_SRC_FILES := \
source/opt/value_number_table.cpp \
source/opt/vector_dce.cpp \
source/opt/workaround1209.cpp
source/opt/wrap_opkill.cpp

# Locations of grammar files.
#
Expand Down
2 changes: 2 additions & 0 deletions BUILD.gn
Expand Up @@ -650,6 +650,8 @@ static_library("spvtools_opt") {
"source/opt/vector_dce.h",
"source/opt/workaround1209.cpp",
"source/opt/workaround1209.h",
"source/opt/wrap_opkill.cpp",
"source/opt/wrap_opkill.h",
]

deps = [
Expand Down
4 changes: 4 additions & 0 deletions include/spirv-tools/optimizer.hpp
Expand Up @@ -795,6 +795,10 @@ Optimizer::PassToken CreateGraphicsRobustAccessPass();
// for the first index.
Optimizer::PassToken CreateDescriptorScalarReplacementPass();

// Create a pass to replace all OpKill instruction with a function call to a
// function that has a single OpKill. This allows more code to be inlined.
Optimizer::PassToken CreateWrapOpKillPass();

} // namespace spvtools

#endif // INCLUDE_SPIRV_TOOLS_OPTIMIZER_HPP_
2 changes: 2 additions & 0 deletions source/opt/CMakeLists.txt
Expand Up @@ -113,6 +113,7 @@ set(SPIRV_TOOLS_OPT_SOURCES
value_number_table.h
vector_dce.h
workaround1209.h
wrap_opkill.h

aggressive_dead_code_elim_pass.cpp
basic_block.cpp
Expand Down Expand Up @@ -212,6 +213,7 @@ set(SPIRV_TOOLS_OPT_SOURCES
value_number_table.cpp
vector_dce.cpp
workaround1209.cpp
wrap_opkill.cpp
)

if(MSVC)
Expand Down
18 changes: 18 additions & 0 deletions source/opt/ir_builder.h
Expand Up @@ -465,6 +465,20 @@ class InstructionBuilder {
return AddInstruction(std::move(new_inst));
}

Instruction* AddFunctionCall(uint32_t result_type, uint32_t function,
const std::vector<uint32_t>& parameters) {
std::vector<Operand> operands;
operands.push_back({SPV_OPERAND_TYPE_ID, {function}});
for (uint32_t id : parameters) {
operands.push_back({SPV_OPERAND_TYPE_ID, {id}});
}

std::unique_ptr<Instruction> new_inst(
new Instruction(GetContext(), SpvOpFunctionCall, result_type,
GetContext()->TakeNextId(), operands));
return AddInstruction(std::move(new_inst));
}

// Inserts the new instruction before the insertion point.
Instruction* AddInstruction(std::unique_ptr<Instruction>&& insn) {
Instruction* insn_ptr = &*insert_before_.InsertBefore(std::move(insn));
Expand Down Expand Up @@ -512,6 +526,10 @@ class InstructionBuilder {

// Returns true if the users requested to update |analysis|.
inline bool IsAnalysisUpdateRequested(IRContext::Analysis analysis) const {
if (!GetContext()->AreAnalysesValid(analysis)) {
// Do not try to update something that is not built.
return false;
}
return preserved_analyses_ & analysis;
}

Expand Down
18 changes: 14 additions & 4 deletions source/opt/optimizer.cpp
Expand Up @@ -107,8 +107,10 @@ Optimizer& Optimizer::RegisterPass(PassToken&& p) {
// or enable more copy propagation.
Optimizer& Optimizer::RegisterLegalizationPasses() {
return
// Remove unreachable block so that merge return works.
RegisterPass(CreateDeadBranchElimPass())
// Wrap OpKill instructions so all other code can be inlined.
RegisterPass(CreateWrapOpKillPass())
// Remove unreachable block so that merge return works.
.RegisterPass(CreateDeadBranchElimPass())
// Merge the returns so we can inline.
.RegisterPass(CreateMergeReturnPass())
// Make sure uses and definitions are in the same function.
Expand Down Expand Up @@ -154,7 +156,8 @@ Optimizer& Optimizer::RegisterLegalizationPasses() {
}

Optimizer& Optimizer::RegisterPerformancePasses() {
return RegisterPass(CreateDeadBranchElimPass())
return RegisterPass(CreateWrapOpKillPass())
.RegisterPass(CreateDeadBranchElimPass())
.RegisterPass(CreateMergeReturnPass())
.RegisterPass(CreateInlineExhaustivePass())
.RegisterPass(CreateAggressiveDCEPass())
Expand Down Expand Up @@ -190,7 +193,8 @@ Optimizer& Optimizer::RegisterPerformancePasses() {
}

Optimizer& Optimizer::RegisterSizePasses() {
return RegisterPass(CreateDeadBranchElimPass())
return RegisterPass(CreateWrapOpKillPass())
.RegisterPass(CreateDeadBranchElimPass())
.RegisterPass(CreateMergeReturnPass())
.RegisterPass(CreateInlineExhaustivePass())
.RegisterPass(CreateAggressiveDCEPass())
Expand Down Expand Up @@ -477,6 +481,8 @@ bool Optimizer::RegisterPassFromFlag(const std::string& flag) {
RegisterPass(CreateDecomposeInitializedVariablesPass());
} else if (pass_name == "graphics-robust-access") {
RegisterPass(CreateGraphicsRobustAccessPass());
} else if (pass_name == "wrap-opkill") {
RegisterPass(CreateWrapOpKillPass());
} else {
Errorf(consumer(), nullptr, {},
"Unknown flag '--%s'. Use --help for a list of valid flags",
Expand Down Expand Up @@ -893,4 +899,8 @@ Optimizer::PassToken CreateDescriptorScalarReplacementPass() {
MakeUnique<opt::DescriptorScalarReplacement>());
}

Optimizer::PassToken CreateWrapOpKillPass() {
return MakeUnique<Optimizer::PassToken::Impl>(MakeUnique<opt::WrapOpKill>());
}

} // namespace spvtools
1 change: 1 addition & 0 deletions source/opt/passes.h
Expand Up @@ -76,5 +76,6 @@
#include "source/opt/upgrade_memory_model.h"
#include "source/opt/vector_dce.h"
#include "source/opt/workaround1209.h"
#include "source/opt/wrap_opkill.h"

#endif // SOURCE_OPT_PASSES_H_
4 changes: 2 additions & 2 deletions source/opt/types.cpp
Expand Up @@ -571,10 +571,10 @@ void Pointer::GetExtraHashWords(std::vector<uint32_t>* words,

void Pointer::SetPointeeType(const Type* type) { pointee_type_ = type; }

Function::Function(Type* ret_type, const std::vector<const Type*>& params)
Function::Function(const Type* ret_type, const std::vector<const Type*>& params)
: Type(kFunction), return_type_(ret_type), param_types_(params) {}

Function::Function(Type* ret_type, std::vector<const Type*>& params)
Function::Function(const Type* ret_type, std::vector<const Type*>& params)
: Type(kFunction), return_type_(ret_type), param_types_(params) {}

bool Function::IsSameImpl(const Type* that, IsSameCache* seen) const {
Expand Down
4 changes: 2 additions & 2 deletions source/opt/types.h
Expand Up @@ -520,8 +520,8 @@ class Pointer : public Type {

class Function : public Type {
public:
Function(Type* ret_type, const std::vector<const Type*>& params);
Function(Type* ret_type, std::vector<const Type*>& params);
Function(const Type* ret_type, const std::vector<const Type*>& params);
Function(const Type* ret_type, std::vector<const Type*>& params);
Function(const Function&) = default;

std::string str() const override;
Expand Down
124 changes: 124 additions & 0 deletions source/opt/wrap_opkill.cpp
@@ -0,0 +1,124 @@
// Copyright (c) 2019 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

#include "source/opt/wrap_opkill.h"

#include "ir_builder.h"

namespace spvtools {
namespace opt {

Pass::Status WrapOpKill::Process() {
bool modified = false;

for (auto& func : *get_module()) {
func.ForEachInst([this, &modified](Instruction* inst) {
if (inst->opcode() == SpvOpKill) {
modified = true;
ReplaceWithFunctionCall(inst);
}
});
}

return (modified ? Status::SuccessWithChange : Status::SuccessWithoutChange);
}

void WrapOpKill::ReplaceWithFunctionCall(Instruction* inst) {
assert(inst->opcode() == SpvOpKill &&
"|inst| must be an OpKill instruction.");
InstructionBuilder ir_builder(
context(), inst,
IRContext::kAnalysisDefUse | IRContext::kAnalysisInstrToBlockMapping);
ir_builder.AddFunctionCall(GetVoidTypeId(), GetOpKillFuncId(), {});
ir_builder.AddUnreachable();
context()->KillInst(inst);
}

uint32_t WrapOpKill::GetVoidTypeId() {
if (void_type_id_ != 0) {
return void_type_id_;
}

analysis::TypeManager* type_mgr = context()->get_type_mgr();
analysis::Void void_type;
void_type_id_ = type_mgr->GetTypeInstruction(&void_type);
return void_type_id_;
}

uint32_t WrapOpKill::GetVoidFunctionTypeId() {
analysis::TypeManager* type_mgr = context()->get_type_mgr();
analysis::Void void_type;
const analysis::Type* registered_void_type =
type_mgr->GetRegisteredType(&void_type);

analysis::Function func_type(registered_void_type, {});
return type_mgr->GetTypeInstruction(&func_type);
}

uint32_t WrapOpKill::GetOpKillFuncId() {
if (opkill_func_id_ != 0) {
return opkill_func_id_;
}

opkill_func_id_ = TakeNextId();

// Generate the function start instruction
std::unique_ptr<Instruction> func_start(new Instruction(
context(), SpvOpFunction, GetVoidTypeId(), opkill_func_id_, {}));
func_start->AddOperand({SPV_OPERAND_TYPE_FUNCTION_CONTROL, {0}});
func_start->AddOperand({SPV_OPERAND_TYPE_ID, {GetVoidFunctionTypeId()}});
std::unique_ptr<Function> opkill_function(
new Function(std::move(func_start)));

// Generate the function end instruction
std::unique_ptr<Instruction> func_end(
new Instruction(context(), SpvOpFunctionEnd, 0, 0, {}));
opkill_function->SetFunctionEnd(std::move(func_end));

// Create the one basic block for the function.
std::unique_ptr<Instruction> label_inst(
new Instruction(context(), SpvOpLabel, 0, TakeNextId(), {}));
std::unique_ptr<BasicBlock> bb(new BasicBlock(std::move(label_inst)));

// Add the OpKill to the basic block
std::unique_ptr<Instruction> kill_inst(
new Instruction(context(), SpvOpKill, 0, 0, {}));
bb->AddInstruction(std::move(kill_inst));

// Add the bb to the function
opkill_function->AddBasicBlock(std::move(bb));

// Add the function to the module.
auto func = opkill_function.get();
context()->AddFunction(std::move(opkill_function));

if (context()->AreAnalysesValid(IRContext::kAnalysisDefUse)) {
func->ForEachInst(
[this](Instruction* inst) { context()->AnalyzeDefUse(inst); });
}

if (context()->AreAnalysesValid(IRContext::kAnalysisInstrToBlockMapping)) {
for (BasicBlock& basic_block : *func) {
context()->set_instr_block(basic_block.GetLabelInst(), &basic_block);
for (Instruction& inst : basic_block) {
context()->set_instr_block(&inst, &basic_block);
}
}
}

return opkill_func_id_;
}

} // namespace opt
} // namespace spvtools
69 changes: 69 additions & 0 deletions source/opt/wrap_opkill.h
@@ -0,0 +1,69 @@
// Copyright (c) 2019 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

#ifndef SOURCE_OPT_WRAP_OPKILL_H_
#define SOURCE_OPT_WRAP_OPKILL_H_

#include "source/opt/pass.h"

namespace spvtools {
namespace opt {

// Documented in optimizer.hpp
class WrapOpKill : public Pass {
public:
WrapOpKill() : opkill_func_id_(0), void_type_id_(0) {}

const char* name() const override { return "wrap-opkill"; }

Status Process() override;

IRContext::Analysis GetPreservedAnalyses() override {
return IRContext::kAnalysisDefUse |
IRContext::kAnalysisInstrToBlockMapping |
IRContext::kAnalysisDecorations | IRContext::kAnalysisCombinators |
IRContext::kAnalysisNameMap | IRContext::kAnalysisBuiltinVarId |
IRContext::kAnalysisIdToFuncMapping | IRContext::kAnalysisConstants |
IRContext::kAnalysisTypes;
}

private:
// Replaces the OpKill instruction |inst| with a function call to a function
// that contains a single instruction, which is OpKill. An OpUnreachable
// instruction will be placed after the function call.
void ReplaceWithFunctionCall(Instruction* inst);

// Returns the id of the void type.
uint32_t GetVoidTypeId();

// Returns the id of the function type for a void function with no parameters.
uint32_t GetVoidFunctionTypeId();

// Return the id of a function that has return type void, no no parameters,
// and contains a single instruction, which is an OpKill.
uint32_t GetOpKillFuncId();

// The id of the function whose body is a single OpKill instruction. If the
// id is 0, then the function has not been generated yet.
uint32_t opkill_func_id_;

// The id of the void type. If its value is 0, then the void type has not
// been found or created yet.
uint32_t void_type_id_;
};

} // namespace opt
} // namespace spvtools

#endif // SOURCE_OPT_WRAP_OPKILL_H_
1 change: 1 addition & 0 deletions test/opt/CMakeLists.txt
Expand Up @@ -97,6 +97,7 @@ add_spvtools_unittest(TARGET opt
value_table_test.cpp
vector_dce_test.cpp
workaround1209_test.cpp
wrap_opkill_test.cpp
LIBS SPIRV-Tools-opt
PCH_FILE pch_test_opt
)

0 comments on commit a77a8da

Please sign in to comment.