tvm
function.h
Go to the documentation of this file.
1 /*
2  * Licensed to the Apache Software Foundation (ASF) under one
3  * or more contributor license agreements. See the NOTICE file
4  * distributed with this work for additional information
5  * regarding copyright ownership. The ASF licenses this file
6  * to you under the Apache License, Version 2.0 (the
7  * "License"); you may not use this file except in compliance
8  * with the License. You may obtain a copy of the License at
9  *
10  * http://www.apache.org/licenses/LICENSE-2.0
11  *
12  * Unless required by applicable law or agreed to in writing,
13  * software distributed under the License is distributed on an
14  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15  * KIND, either express or implied. See the License for the
16  * specific language governing permissions and limitations
17  * under the License.
18  */
19 
24 #ifndef TVM_IR_FUNCTION_H_
25 #define TVM_IR_FUNCTION_H_
26 
27 #include <tvm/ir/attrs.h>
28 #include <tvm/ir/expr.h>
32 
33 #include <string>
34 #include <type_traits>
35 
36 namespace tvm {
37 
44 enum class CallingConv : int {
51  kDefault = 0,
58  kCPackedFunc = 1,
66 };
67 
71 enum class LinkageType : int {
75  kInternal = 0,
80  kExternal = 1
81 };
82 
88 namespace attr {
96 constexpr const char* kCallingConv = "calling_conv";
97 
105 constexpr const char* kTarget = "target";
106 
126 constexpr const char* kGlobalSymbol = "global_symbol";
127 
128 } // namespace attr
129 
139 class BaseFuncNode : public RelayExprNode {
140  public:
143 
163  template <typename TObjectRef>
165  const std::string& attr_key,
166  Optional<TObjectRef> default_value = Optional<TObjectRef>(nullptr)) const {
167  return attrs.GetAttr(attr_key, default_value);
168  }
169  // variant that uses TObjectRef to enable implicit conversion to default value.
170  template <typename TObjectRef>
171  Optional<TObjectRef> GetAttr(const std::string& attr_key, TObjectRef default_value) const {
172  return GetAttr<TObjectRef>(attr_key, Optional<TObjectRef>(default_value));
173  }
174 
194  bool HasNonzeroAttr(const std::string& attr_key) const { return attrs.HasNonzeroAttr(attr_key); }
215  if (GetAttr<String>(attr::kGlobalSymbol))
216  return LinkageType::kExternal;
217  else
218  return LinkageType::kInternal;
219  }
220 
221  static constexpr const char* _type_key = "BaseFunc";
222  static constexpr const uint32_t _type_child_slots = 2;
224 };
225 
230 class BaseFunc : public RelayExpr {
231  public:
233 };
234 
235 } // namespace tvm
236 #endif // TVM_IR_FUNCTION_H_
Runtime Array container types.
Base node of all functions.
Definition: function.h:139
static constexpr const uint32_t _type_child_slots
Definition: function.h:222
bool HasNonzeroAttr(const std::string &attr_key) const
Check whether the function has an non-zero integer attr.
Definition: function.h:194
Optional< TObjectRef > GetAttr(const std::string &attr_key, Optional< TObjectRef > default_value=Optional< TObjectRef >(nullptr)) const
Get a function attribute.
Definition: function.h:164
LinkageType GetLinkageType() const
Get the type of the linkage.
Definition: function.h:214
Optional< TObjectRef > GetAttr(const std::string &attr_key, TObjectRef default_value) const
Definition: function.h:171
DictAttrs attrs
Additional attributes storing the meta-data.
Definition: function.h:142
TVM_DECLARE_BASE_OBJECT_INFO(BaseFuncNode, RelayExprNode)
static constexpr const char * _type_key
Definition: function.h:221
Managed reference to BaseFuncNode.
Definition: function.h:230
TVM_DEFINE_OBJECT_REF_METHODS(BaseFunc, RelayExpr, BaseFuncNode)
Managed reference to DictAttrsNode.
Definition: attrs.h:227
bool HasNonzeroAttr(const std::string &attr_key) const
Check whether the function has an non-zero integer attr.
Definition: attrs.h:297
Optional< TObjectRef > GetAttr(const std::string &attr_key, Optional< TObjectRef > default_value=Optional< TObjectRef >(nullptr)) const
Get a function attribute.
Definition: attrs.h:258
Base node of all non-primitive expressions.
Definition: expr.h:362
Managed reference to RelayExprNode.
Definition: expr.h:442
Optional container that to represent to a Nullable variant of T.
Definition: optional.h:51
Helpers for attribute objects.
Base expr nodes in TVM.
Runtime Map container types.
constexpr const char * kCallingConv
Indicates the special calling convention.
Definition: function.h:96
constexpr const char * kTarget
Compilation target of the function.
Definition: function.h:105
constexpr const char * kGlobalSymbol
Global linker symbol of the function in generated code.
Definition: function.h:126
runtime implementation for LibTorch/TorchScript.
Definition: analyzer.h:36
CallingConv
Possible Calling conventions.
Definition: function.h:44
@ kDefault
Default calling convention.
@ kCPackedFunc
PackedFunc that exposes a CPackedFunc signature.
@ kDeviceKernelLaunch
Device kernel launch.
LinkageType
Supported linkage types.
Definition: function.h:71
@ kExternal
External linkage.
@ kInternal
Internal linkage.
Runtime String container types.