// Copyright (c) 2015-2016 The Khronos Group Inc. // // Permission is hereby granted, free of charge, to any person obtaining a // copy of this software and/or associated documentation files (the // "Materials"), to deal in the Materials without restriction, including // without limitation the rights to use, copy, modify, merge, publish, // distribute, sublicense, and/or sell copies of the Materials, and to // permit persons to whom the Materials are furnished to do so, subject to // the following conditions: // // The above copyright notice and this permission notice shall be included // in all copies or substantial portions of the Materials. // // MODIFICATIONS TO THIS FILE MAY MEAN IT NO LONGER ACCURATELY REFLECTS // KHRONOS STANDARDS. THE UNMODIFIED, NORMATIVE VERSIONS OF KHRONOS // SPECIFICATIONS AND HEADER INFORMATION ARE LOCATED AT // https://www.khronos.org/registry/ // // THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. // IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY // CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, // TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE // MATERIALS OR THE USE OR OTHER DEALINGS IN THE MATERIALS. // Validation tests for Control Flow Graph #include #include #include #include #include #include #include #include "gmock/gmock.h" #include "TestFixture.h" #include "UnitSPIRV.h" #include "ValidateFixtures.h" #include "source/diagnostic.h" #include "source/validate.h" using std::array; using std::make_pair; using std::pair; using std::string; using std::stringstream; using std::vector; using ::testing::HasSubstr; using ::testing::MatchesRegex; using libspirv::BasicBlock; using libspirv::ValidationState_t; using ValidateCFG = spvtest::ValidateBase; using spvtest::ScopedContext; namespace { string nameOps() { return ""; } template string nameOps(pair head, Args... names) { return "OpName %" + head.first + " \"" + head.second + "\"\n" + nameOps(names...); } template string nameOps(string head, Args... names) { return "OpName %" + head + " \"" + head + "\"\n" + nameOps(names...); } /// This class allows the easy creation of complex control flow without writing /// SPIR-V. This class is used in the test cases below. class Block { string label_; string body_; SpvOp type_; vector successors_; public: /// Creates a Block with a given label /// /// @param[in]: label the label id of the block /// @param[in]: type the branch instruciton that ends the block explicit Block(string label, SpvOp type = SpvOpBranch) : label_(label), body_(), type_(type), successors_() {} /// Sets the instructions which will appear in the body of the block Block& setBody(std::string body) { body_ = body; return *this; } /// Converts the block into a SPIR-V string operator string() { stringstream out; out << std::setw(8) << "%" + label_ + " = OpLabel \n"; if (!body_.empty()) { out << body_; } switch (type_) { case SpvOpBranchConditional: out << "OpBranchConditional %cond "; for (Block& b : successors_) { out << "%" + b.label_ + " "; } break; case SpvOpSwitch: { out << "OpSwitch %one %" + successors_.front().label_; stringstream ss; for (size_t i = 1; i < successors_.size(); i++) { ss << " " << i << " %" << successors_[i].label_; } out << ss.str(); } break; case SpvOpReturn: assert(successors_.size() == 0); out << "OpReturn\n"; break; case SpvOpUnreachable: assert(successors_.size() == 0); out << "OpUnreachable\n"; break; case SpvOpBranch: assert(successors_.size() == 1); out << "OpBranch %" + successors_.front().label_; break; default: assert(1 == 0 && "Unhandled"); } out << "\n"; return out.str(); } friend Block& operator>>(Block& curr, vector successors); friend Block& operator>>(Block& lhs, Block& successor); }; /// Assigns the successors for the Block on the lhs Block& operator>>(Block& lhs, vector successors) { if (lhs.type_ == SpvOpBranchConditional) { assert(successors.size() == 2); } else if (lhs.type_ == SpvOpSwitch) { assert(successors.size() > 1); } lhs.successors_ = successors; return lhs; } /// Assigns the successor for the Block on the lhs Block& operator>>(Block& lhs, Block& successor) { assert(lhs.type_ == SpvOpBranch); lhs.successors_.push_back(successor); return lhs; } const char* header(SpvCapability cap) { static const char* shader_header = "OpCapability Shader\n" "OpMemoryModel Logical GLSL450\n"; static const char* kernel_header = "OpCapability Kernel\n" "OpMemoryModel Logical OpenCL\n"; return (cap == SpvCapabilityShader) ? shader_header : kernel_header; } const char* types_consts() { static const char* types = "%voidt = OpTypeVoid\n" "%boolt = OpTypeBool\n" "%intt = OpTypeInt 32 1\n" "%one = OpConstant %intt 1\n" "%two = OpConstant %intt 2\n" "%ptrt = OpTypePointer Function %intt\n" "%funct = OpTypeFunction %voidt\n"; return types; } INSTANTIATE_TEST_CASE_P(StructuredControlFlow, ValidateCFG, ::testing::Values(SpvCapabilityShader, SpvCapabilityKernel)); TEST_P(ValidateCFG, Simple) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); Block loop("loop", SpvOpBranchConditional); Block cont("cont"); Block merge("merge", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if (is_shader) { loop.setBody("OpLoopMerge %merge %cont None\n"); } string str = header(GetParam()) + nameOps("loop", "entry", "cont", "merge", make_pair("func", "Main")) + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> loop; str += loop >> vector({cont, merge}); str += cont >> loop; str += merge; str += "OpFunctionEnd\n"; CompileSuccessfully(str); ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } TEST_P(ValidateCFG, Variable) { Block entry("entry"); Block cont("cont"); Block exit("exit", SpvOpReturn); entry.setBody("%var = OpVariable %ptrt Function\n"); string str = header(GetParam()) + nameOps(make_pair("func", "Main")) + types_consts() + " %func = OpFunction %voidt None %funct\n"; str += entry >> cont; str += cont >> exit; str += exit; str += "OpFunctionEnd\n"; CompileSuccessfully(str); ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } TEST_P(ValidateCFG, VariableNotInFirstBlockBad) { Block entry("entry"); Block cont("cont"); Block exit("exit", SpvOpReturn); // This operation should only be performed in the entry block cont.setBody("%var = OpVariable %ptrt Function\n"); string str = header(GetParam()) + nameOps(make_pair("func", "Main")) + types_consts() + " %func = OpFunction %voidt None %funct\n"; str += entry >> cont; str += cont >> exit; str += exit; str += "OpFunctionEnd\n"; CompileSuccessfully(str); ASSERT_EQ(SPV_ERROR_INVALID_CFG, ValidateInstructions()); EXPECT_THAT( getDiagnosticString(), HasSubstr( "Variables can only be defined in the first block of a function")); } TEST_P(ValidateCFG, BlockAppearsBeforeDominatorBad) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); Block cont("cont"); Block branch("branch", SpvOpBranchConditional); Block merge("merge", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if (is_shader) branch.setBody("OpSelectionMerge %merge None\n"); string str = header(GetParam()) + nameOps("cont", "branch", make_pair("func", "Main")) + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> branch; str += cont >> merge; // cont appears before its dominator str += branch >> vector({cont, merge}); str += merge; str += "OpFunctionEnd\n"; CompileSuccessfully(str); ASSERT_EQ(SPV_ERROR_INVALID_CFG, ValidateInstructions()); EXPECT_THAT(getDiagnosticString(), MatchesRegex("Block .\\[cont\\] appears in the binary " "before its dominator .\\[branch\\]")); } TEST_P(ValidateCFG, MergeBlockTargetedByMultipleHeaderBlocksBad) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); Block loop("loop"); Block selection("selection", SpvOpBranchConditional); Block merge("merge", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if (is_shader) loop.setBody(" OpLoopMerge %merge %loop None\n"); // cannot share the same merge if (is_shader) selection.setBody("OpSelectionMerge %merge None\n"); string str = header(GetParam()) + nameOps("merge", make_pair("func", "Main")) + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> loop; str += loop >> selection; str += selection >> vector({loop, merge}); str += merge; str += "OpFunctionEnd\n"; CompileSuccessfully(str); if (is_shader) { ASSERT_EQ(SPV_ERROR_INVALID_CFG, ValidateInstructions()); EXPECT_THAT(getDiagnosticString(), MatchesRegex("Block .\\[merge\\] is already a merge block " "for another header")); } else { ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } } TEST_P(ValidateCFG, MergeBlockTargetedByMultipleHeaderBlocksSelectionBad) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); Block loop("loop", SpvOpBranchConditional); Block selection("selection", SpvOpBranchConditional); Block merge("merge", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if (is_shader) selection.setBody(" OpSelectionMerge %merge None\n"); // cannot share the same merge if (is_shader) loop.setBody(" OpLoopMerge %merge %loop None\n"); string str = header(GetParam()) + nameOps("merge", make_pair("func", "Main")) + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> selection; str += selection >> vector({merge, loop}); str += loop >> vector({loop, merge}); str += merge; str += "OpFunctionEnd\n"; CompileSuccessfully(str); if (is_shader) { ASSERT_EQ(SPV_ERROR_INVALID_CFG, ValidateInstructions()); EXPECT_THAT(getDiagnosticString(), MatchesRegex("Block .\\[merge\\] is already a merge block " "for another header")); } else { ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } } TEST_P(ValidateCFG, BranchTargetFirstBlockBad) { Block entry("entry"); Block bad("bad"); Block end("end", SpvOpReturn); string str = header(GetParam()) + nameOps("entry", "bad", make_pair("func", "Main")) + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> bad; str += bad >> entry; // Cannot target entry block str += end; str += "OpFunctionEnd\n"; CompileSuccessfully(str); ASSERT_EQ(SPV_ERROR_INVALID_CFG, ValidateInstructions()); EXPECT_THAT(getDiagnosticString(), MatchesRegex("First block .\\[entry\\] of funciton .\\[Main\\] " "is targeted by block .\\[bad\\]")); } TEST_P(ValidateCFG, BranchConditionalTrueTargetFirstBlockBad) { Block entry("entry"); Block bad("bad", SpvOpBranchConditional); Block exit("exit", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); bad.setBody(" OpLoopMerge %entry %exit None\n"); string str = header(GetParam()) + nameOps("entry", "bad", make_pair("func", "Main")) + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> bad; str += bad >> vector({entry, exit}); // cannot target entry block str += exit; str += "OpFunctionEnd\n"; CompileSuccessfully(str); ASSERT_EQ(SPV_ERROR_INVALID_CFG, ValidateInstructions()); EXPECT_THAT(getDiagnosticString(), MatchesRegex("First block .\\[entry\\] of funciton .\\[Main\\] " "is targeted by block .\\[bad\\]")); } TEST_P(ValidateCFG, BranchConditionalFalseTargetFirstBlockBad) { Block entry("entry"); Block bad("bad", SpvOpBranchConditional); Block t("t"); Block merge("merge"); Block end("end", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); bad.setBody("OpLoopMerge %merge %cont None\n"); string str = header(GetParam()) + nameOps("entry", "bad", make_pair("func", "Main")) + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> bad; str += bad >> vector({t, entry}); str += merge >> end; str += end; str += "OpFunctionEnd\n"; CompileSuccessfully(str); ASSERT_EQ(SPV_ERROR_INVALID_CFG, ValidateInstructions()); EXPECT_THAT(getDiagnosticString(), MatchesRegex("First block .\\[entry\\] of funciton .\\[Main\\] " "is targeted by block .\\[bad\\]")); } TEST_P(ValidateCFG, SwitchTargetFirstBlockBad) { Block entry("entry"); Block bad("bad", SpvOpSwitch); Block block1("block1"); Block block2("block2"); Block block3("block3"); Block def("def"); // default block Block merge("merge"); Block end("end", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); bad.setBody("OpSelectionMerge %merge None\n"); string str = header(GetParam()) + nameOps("entry", "bad", make_pair("func", "Main")) + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> bad; str += bad >> vector({def, block1, block2, block3, entry}); str += def >> merge; str += block1 >> merge; str += block2 >> merge; str += block3 >> merge; str += merge >> end; str += end; str += "OpFunctionEnd\n"; CompileSuccessfully(str); ASSERT_EQ(SPV_ERROR_INVALID_CFG, ValidateInstructions()); EXPECT_THAT(getDiagnosticString(), MatchesRegex("First block .\\[entry\\] of funciton .\\[Main\\] " "is targeted by block .\\[bad\\]")); } TEST_P(ValidateCFG, BranchToBlockInOtherFunctionBad) { Block entry("entry"); Block middle("middle", SpvOpBranchConditional); Block end("end", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); middle.setBody("OpSelectionMerge %end None\n"); Block entry2("entry2"); Block middle2("middle2"); Block end2("end2", SpvOpReturn); string str = header(GetParam()) + nameOps("middle2", make_pair("func", "Main")) + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> middle; str += middle >> vector({end, middle2}); str += end; str += "OpFunctionEnd\n"; str += "%func2 = OpFunction %voidt None %funct\n"; str += entry2 >> middle2; str += middle2 >> end2; str += end2; str += "OpFunctionEnd\n"; CompileSuccessfully(str); ASSERT_EQ(SPV_ERROR_INVALID_CFG, ValidateInstructions()); EXPECT_THAT( getDiagnosticString(), MatchesRegex("Block\\(s\\) \\{.\\[middle2\\] .\\} are referenced but not " "defined in function .\\[Main\\]")); } TEST_P(ValidateCFG, HeaderDoesntDominatesMergeBad) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); Block head("head", SpvOpBranchConditional); Block f("f"); Block merge("merge", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if (is_shader) head.setBody("OpSelectionMerge %merge None\n"); string str = header(GetParam()) + nameOps("head", "merge", make_pair("func", "Main")) + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> merge; str += head >> vector({merge, f}); str += f >> merge; str += merge; str += "OpFunctionEnd\n"; CompileSuccessfully(str); if (is_shader) { ASSERT_EQ(SPV_ERROR_INVALID_CFG, ValidateInstructions()); EXPECT_THAT( getDiagnosticString(), MatchesRegex("The selection construct with the selection header " ".\\[head\\] does not dominate the merge block " ".\\[merge\\]")); } else { ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } } TEST_P(ValidateCFG, UnreachableMerge) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); Block branch("branch", SpvOpBranchConditional); Block t("t", SpvOpReturn); Block f("f", SpvOpReturn); Block merge("merge", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if (is_shader) branch.setBody("OpSelectionMerge %merge None\n"); string str = header(GetParam()) + nameOps("branch", "merge", make_pair("func", "Main")) + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> branch; str += branch >> vector({t, f}); str += t; str += f; str += merge; str += "OpFunctionEnd\n"; CompileSuccessfully(str); ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } TEST_P(ValidateCFG, UnreachableMergeDefinedByOpUnreachable) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); Block branch("branch", SpvOpBranchConditional); Block t("t", SpvOpReturn); Block f("f", SpvOpReturn); Block merge("merge", SpvOpUnreachable); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if (is_shader) branch.setBody("OpSelectionMerge %merge None\n"); string str = header(GetParam()) + nameOps("branch", "merge", make_pair("func", "Main")) + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> branch; str += branch >> vector({t, f}); str += t; str += f; str += merge; str += "OpFunctionEnd\n"; CompileSuccessfully(str); ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } TEST_P(ValidateCFG, UnreachableBlock) { Block entry("entry"); Block unreachable("unreachable"); Block exit("exit", SpvOpReturn); string str = header(GetParam()) + nameOps("unreachable", "exit", make_pair("func", "Main")) + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> exit; str += unreachable >> exit; str += exit; str += "OpFunctionEnd\n"; CompileSuccessfully(str); ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } TEST_P(ValidateCFG, UnreachableBranch) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); Block unreachable("unreachable", SpvOpBranchConditional); Block unreachablechildt("unreachablechildt"); Block unreachablechildf("unreachablechildf"); Block merge("merge"); Block exit("exit", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if (is_shader) unreachable.setBody("OpSelectionMerge %merge None\n"); string str = header(GetParam()) + nameOps("unreachable", "exit", make_pair("func", "Main")) + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> exit; str += unreachable >> vector({unreachablechildt, unreachablechildf}); str += unreachablechildt >> merge; str += unreachablechildf >> merge; str += merge >> exit; str += exit; str += "OpFunctionEnd\n"; CompileSuccessfully(str); ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } TEST_P(ValidateCFG, EmptyFunction) { string str = header(GetParam()) + string(types_consts()) + "%func = OpFunction %voidt None %funct\n" + "OpFunctionEnd\n"; CompileSuccessfully(str); ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } TEST_P(ValidateCFG, SingleBlockLoop) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); Block loop("loop", SpvOpBranchConditional); Block exit("exit", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if (is_shader) loop.setBody("OpLoopMerge %exit %loop None\n"); string str = header(GetParam()) + string(types_consts()) + "%func = OpFunction %voidt None %funct\n"; str += entry >> loop; str += loop >> vector({loop, exit}); str += exit; str += "OpFunctionEnd"; CompileSuccessfully(str); ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } TEST_P(ValidateCFG, NestedLoops) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); Block loop1("loop1"); Block loop1_cont_break_block("loop1_cont_break_block", SpvOpBranchConditional); Block loop2("loop2", SpvOpBranchConditional); Block loop2_merge("loop2_merge"); Block loop1_merge("loop1_merge"); Block exit("exit", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if (is_shader) { loop1.setBody("OpLoopMerge %loop1_merge %loop2 None\n"); loop2.setBody("OpLoopMerge %loop2_merge %loop2 None\n"); } string str = header(GetParam()) + nameOps("loop2", "loop2_merge") + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> loop1; str += loop1 >> loop1_cont_break_block; str += loop1_cont_break_block >> vector({loop1_merge, loop2}); str += loop2 >> vector({loop2, loop2_merge}); str += loop2_merge >> loop1; str += loop1_merge >> exit; str += exit; str += "OpFunctionEnd"; CompileSuccessfully(str); ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } TEST_P(ValidateCFG, NestedSelection) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); const int N = 256; vector if_blocks; vector merge_blocks; Block inner("inner"); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if_blocks.emplace_back("if0", SpvOpBranchConditional); if (is_shader) if_blocks[0].setBody("OpSelectionMerge %if_merge0 None\n"); merge_blocks.emplace_back("if_merge0", SpvOpReturn); for (int i = 1; i < N; i++) { stringstream ss; ss << i; if_blocks.emplace_back("if" + ss.str(), SpvOpBranchConditional); if (is_shader) if_blocks[i].setBody("OpSelectionMerge %if_merge" + ss.str() + " None\n"); merge_blocks.emplace_back("if_merge" + ss.str(), SpvOpBranch); } string str = header(GetParam()) + string(types_consts()) + "%func = OpFunction %voidt None %funct\n"; str += entry >> if_blocks[0]; for (int i = 0; i < N - 1; i++) { str += if_blocks[i] >> vector({if_blocks[i + 1], merge_blocks[i]}); } str += if_blocks.back() >> vector({inner, merge_blocks.back()}); str += inner >> merge_blocks.back(); for (int i = N - 1; i > 0; i--) { str += merge_blocks[i] >> merge_blocks[i - 1]; } str += merge_blocks[0]; str += "OpFunctionEnd"; CompileSuccessfully(str); ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } TEST_P(ValidateCFG, BackEdgeBlockDoesntPostDominateContinueTargetBad) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); Block loop1("loop1", SpvOpBranchConditional); Block loop2("loop2", SpvOpBranchConditional); Block loop2_merge("loop2_merge", SpvOpBranchConditional); Block be_block("be_block"); Block exit("exit", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if (is_shader) { loop1.setBody("OpLoopMerge %exit %loop2_merge None\n"); loop2.setBody("OpLoopMerge %loop2_merge %loop2 None\n"); } string str = header(GetParam()) + nameOps("loop1", "loop2", "be_block", "loop2_merge") + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> loop1; str += loop1 >> vector({loop2, exit}); str += loop2 >> vector({loop2, loop2_merge}); str += loop2_merge >> vector({be_block, exit}); str += be_block >> loop1; str += exit; str += "OpFunctionEnd"; CompileSuccessfully(str); if (GetParam() == SpvCapabilityShader) { ASSERT_EQ(SPV_ERROR_INVALID_CFG, ValidateInstructions()); EXPECT_THAT(getDiagnosticString(), MatchesRegex("The continue construct with the continue target " ".\\[loop2_merge\\] is not post dominated by the " "back-edge block .\\[be_block\\]")); } else { ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } } TEST_P(ValidateCFG, BranchingToNonLoopHeaderBlockBad) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); Block split("split", SpvOpBranchConditional); Block t("t"); Block f("f"); Block exit("exit", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if (is_shader) split.setBody("OpSelectionMerge %exit None\n"); string str = header(GetParam()) + nameOps("split", "f") + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> split; str += split >> vector({t, f}); str += t >> exit; str += f >> split; str += exit; str += "OpFunctionEnd"; CompileSuccessfully(str); if (is_shader) { ASSERT_EQ(SPV_ERROR_INVALID_CFG, ValidateInstructions()); EXPECT_THAT( getDiagnosticString(), MatchesRegex("Back-edges \\(.\\[f\\] -> .\\[split\\]\\) can only " "be formed between a block and a loop header.")); } else { ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } } TEST_P(ValidateCFG, BranchingToSameNonLoopHeaderBlockBad) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); Block split("split", SpvOpBranchConditional); Block exit("exit", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if (is_shader) split.setBody("OpSelectionMerge %exit None\n"); string str = header(GetParam()) + nameOps("split") + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> split; str += split >> vector({split, exit}); str += exit; str += "OpFunctionEnd"; CompileSuccessfully(str); if (is_shader) { ASSERT_EQ(SPV_ERROR_INVALID_CFG, ValidateInstructions()); EXPECT_THAT(getDiagnosticString(), MatchesRegex( "Back-edges \\(.\\[split\\] -> .\\[split\\]\\) can only be " "formed between a block and a loop header.")); } else { ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } } TEST_P(ValidateCFG, MultipleBackEdgesToLoopHeaderBad) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); Block loop("loop", SpvOpBranchConditional); Block cont("cont", SpvOpBranchConditional); Block merge("merge", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if (is_shader) loop.setBody("OpLoopMerge %merge %loop None\n"); string str = header(GetParam()) + nameOps("cont", "loop") + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> loop; str += loop >> vector({cont, merge}); str += cont >> vector({loop, loop}); str += merge; str += "OpFunctionEnd"; CompileSuccessfully(str); if (is_shader) { ASSERT_EQ(SPV_ERROR_INVALID_CFG, ValidateInstructions()); EXPECT_THAT(getDiagnosticString(), MatchesRegex( "Loop header .\\[loop\\] targeted by multiple back-edges")); } else { ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } } TEST_P(ValidateCFG, ContinueTargetMustBePostDominatedByBackEdge) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); Block loop("loop", SpvOpBranchConditional); Block cheader("cheader", SpvOpBranchConditional); Block be_block("be_block"); Block merge("merge", SpvOpReturn); Block exit("exit", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if (is_shader) loop.setBody("OpLoopMerge %merge %cheader None\n"); string str = header(GetParam()) + nameOps("cheader", "be_block") + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> loop; str += loop >> vector({cheader, merge}); str += cheader >> vector({exit, be_block}); str += exit; // Branches out of a continue construct str += be_block >> loop; str += merge; str += "OpFunctionEnd"; CompileSuccessfully(str); if (is_shader) { ASSERT_EQ(SPV_ERROR_INVALID_CFG, ValidateInstructions()); EXPECT_THAT(getDiagnosticString(), MatchesRegex("The continue construct with the continue target " ".\\[cheader\\] is not post dominated by the " "back-edge block .\\[be_block\\]")); } else { ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } } TEST_P(ValidateCFG, BranchOutOfConstructToMergeBad) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); Block loop("loop", SpvOpBranchConditional); Block cont("cont", SpvOpBranchConditional); Block merge("merge", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if (is_shader) loop.setBody("OpLoopMerge %merge %loop None\n"); string str = header(GetParam()) + nameOps("cont", "loop") + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> loop; str += loop >> vector({cont, merge}); str += cont >> vector({loop, merge}); str += merge; str += "OpFunctionEnd"; CompileSuccessfully(str); if (is_shader) { ASSERT_EQ(SPV_ERROR_INVALID_CFG, ValidateInstructions()); EXPECT_THAT(getDiagnosticString(), MatchesRegex("The continue construct with the continue target " ".\\[loop\\] is not post dominated by the " "back-edge block .\\[cont\\]")); } else { ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } } TEST_P(ValidateCFG, BranchOutOfConstructBad) { bool is_shader = GetParam() == SpvCapabilityShader; Block entry("entry"); Block loop("loop", SpvOpBranchConditional); Block cont("cont", SpvOpBranchConditional); Block merge("merge"); Block exit("exit", SpvOpReturn); entry.setBody("%cond = OpSLessThan %intt %one %two\n"); if (is_shader) loop.setBody("OpLoopMerge %merge %loop None\n"); string str = header(GetParam()) + nameOps("cont", "loop") + types_consts() + "%func = OpFunction %voidt None %funct\n"; str += entry >> loop; str += loop >> vector({cont, merge}); str += cont >> vector({loop, exit}); str += merge >> exit; str += exit; str += "OpFunctionEnd"; CompileSuccessfully(str); if (is_shader) { ASSERT_EQ(SPV_ERROR_INVALID_CFG, ValidateInstructions()); EXPECT_THAT(getDiagnosticString(), MatchesRegex("The continue construct with the continue target " ".\\[loop\\] is not post dominated by the " "back-edge block .\\[cont\\]")); } else { ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } } TEST_F(ValidateCFG, OpSwitchToUnreachableBlock) { Block entry("entry", SpvOpSwitch); Block case0("case0"); Block case1("case1"); Block case2("case2"); Block def("default", SpvOpUnreachable); Block phi("phi", SpvOpReturn); string str = R"( OpCapability Shader OpMemoryModel Logical GLSL450 OpEntryPoint GLCompute %main "main" %id OpExecutionMode %main LocalSize 1 1 1 OpSource GLSL 430 OpName %main "main" OpDecorate %id BuiltIn GlobalInvocationId %void = OpTypeVoid %voidf = OpTypeFunction %void %u32 = OpTypeInt 32 0 %f32 = OpTypeFloat 32 %uvec3 = OpTypeVector %u32 3 %fvec3 = OpTypeVector %f32 3 %uvec3ptr = OpTypePointer Input %uvec3 %id = OpVariable %uvec3ptr Input %one = OpConstant %u32 1 %three = OpConstant %u32 3 %main = OpFunction %void None %voidf )"; entry.setBody( "%idval = OpLoad %uvec3 %id\n" "%x = OpCompositeExtract %u32 %idval 0\n" "%selector = OpUMod %u32 %x %three\n" "OpSelectionMerge %phi None\n"); str += entry >> vector({def, case0, case1, case2}); str += case1 >> phi; str += def; str += phi; str += case0 >> phi; str += case2 >> phi; str += "OpFunctionEnd"; CompileSuccessfully(str); ASSERT_EQ(SPV_SUCCESS, ValidateInstructions()); } /// TODO(umar): Switch instructions /// TODO(umar): Nested CFG constructs } /// namespace