Debian Codegraph @

third_party/spirv-tools/source/fuzz/transformation_function_call.h

raw
1 // Copyright (c) 2020 Google LLC
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at
6 //
7 // http://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and
13 // limitations under the License.
14
15 #ifndef SOURCE_FUZZ_TRANSFORMATION_FUNCTION_CALL_H_
16 #define SOURCE_FUZZ_TRANSFORMATION_FUNCTION_CALL_H_
17
18 #include "source/fuzz/protobufs/spirvfuzz_protobufs.h"
19 #include "source/fuzz/transformation.h"
20 #include "source/fuzz/transformation_context.h"
21 #include "source/opt/ir_context.h"
22
23 namespace spvtools {
24 namespace fuzz {
25
26 class TransformationFunctionCall : public Transformation {
27 public:
28 explicit TransformationFunctionCall(
29 const protobufs::TransformationFunctionCall& message);
30
31 TransformationFunctionCall(
32 uint32_t fresh_id, uint32_t callee_id,
33 const std::vector<uint32_t>& argument_id,
34 const protobufs::InstructionDescriptor& instruction_to_insert_before);
35
36 // - |message_.fresh_id| must be fresh
37 // - |message_.instruction_to_insert_before| must identify an instruction
38 // before which an OpFunctionCall can be legitimately inserted
39 // - |message_.function_id| must be the id of a function, and calling the
40 // function before the identified instruction must not introduce recursion
41 // - |message_.arg_id| must provide suitable arguments for the function call
42 // (they must have the right types and be available according to dominance
43 // rules)
44 // - If the insertion point is not in a dead block then |message_function_id|
45 // must refer to a livesafe function, and every pointer argument in
46 // |message_.arg_id| must refer to an arbitrary-valued variable
47 bool IsApplicable(
48 opt::IRContext* ir_context,
49 const TransformationContext& transformation_context) const override;
50
51 // Adds an instruction of the form:
52 // |fresh_id| = OpFunctionCall %type |callee_id| |arg_id...|
53 // before |instruction_to_insert_before|, where %type is the return type of
54 // |callee_id|.
55 void Apply(opt::IRContext* ir_context,
56 TransformationContext* transformation_context) const override;
57
58 std::unordered_set<uint32_t> GetFreshIds() const override;
59
60 protobufs::Transformation ToMessage() const override;
61
62 private:
63 protobufs::TransformationFunctionCall message_;
64 };
65
66 } // namespace fuzz
67 } // namespace spvtools
68
69 #endif // SOURCE_FUZZ_TRANSFORMATION_FUNCTION_CALL_H_