tag.h

Go to the documentation of this file.

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you 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 TVM_TARGET_TAG_H_
#define TVM_TARGET_TAG_H_
 
#include <tvm/ffi/reflection/registry.h>
#include <tvm/node/attr_registry_map.h>
#include <tvm/node/node.h>
#include <tvm/target/target.h>
 
#include <utility>
 
namespace tvm {
 
class TargetTagNode : public Object {
 public:
  ffi::String name;
  ffi::Map<ffi::String, Any> config;
 
  static void RegisterReflection() {
    namespace refl = tvm::ffi::reflection;
    refl::ObjectDef<TargetTagNode>()
        .def_ro("name", &TargetTagNode::name)
        .def_ro("config", &TargetTagNode::config);
  }
  TVM_FFI_DECLARE_OBJECT_INFO_FINAL("target.TargetTag", TargetTagNode, Object);
 
 private:
  uint32_t AttrRegistryIndex() const { return index_; }
  ffi::String AttrRegistryName() const { return name; }
  uint32_t index_;
 
  template <typename, typename>
  friend class AttrRegistry;
  template <typename>
  friend class AttrRegistryMapContainerMap;
  friend class TargetTagRegEntry;
};
 
class TargetTag : public ObjectRef {
 public:
  TVM_DLL static ffi::Optional<Target> Get(const ffi::String& target_tag_name);
  TVM_DLL static ffi::Map<ffi::String, Target> ListTags();
  TVM_DLL static Target AddTag(ffi::String name, ffi::Map<ffi::String, Any> config, bool override);
 
  TVM_FFI_DEFINE_OBJECT_REF_METHODS_NULLABLE(TargetTag, ObjectRef, TargetTagNode);
 
 private:
  TargetTagNode* operator->() { return static_cast<TargetTagNode*>(data_.get()); }
  friend class TargetTagRegEntry;
};
 
class TargetTagRegEntry {
 public:
  inline TargetTagRegEntry& set_config(ffi::Map<ffi::String, Any> config);
  inline TargetTagRegEntry& with_config(ffi::String key, Any value);
  inline TargetTagRegEntry& set_name();
  TVM_DLL static TargetTagRegEntry& RegisterOrGet(const ffi::String& target_tag_name);
 
 private:
  TargetTag tag_;
  ffi::String name;
 
  explicit TargetTagRegEntry(uint32_t reg_index) : tag_(ffi::make_object<TargetTagNode>()) {
    tag_->index_ = reg_index;
  }
  template <typename, typename>
  friend class AttrRegistry;
  friend class TargetTag;
};
 
inline TargetTagRegEntry& TargetTagRegEntry::set_config(ffi::Map<ffi::String, Any> config) {
  tag_->config = std::move(config);
  return *this;
}
 
inline TargetTagRegEntry& TargetTagRegEntry::with_config(ffi::String key, ffi::Any value) {
  tag_->config.Set(key, value);
  return *this;
}
 
inline TargetTagRegEntry& TargetTagRegEntry::set_name() {
  if (tag_->name.empty()) {
    tag_->name = name;
  }
  return *this;
}
 
#define TVM_TARGET_TAG_REGISTER_VAR_DEF \
  static DMLC_ATTRIBUTE_UNUSED ::tvm::TargetTagRegEntry& __make_##TargetTag
 
#define TVM_REGISTER_TARGET_TAG(TargetTagName)                   \
  TVM_STR_CONCAT(TVM_TARGET_TAG_REGISTER_VAR_DEF, __COUNTER__) = \
      ::tvm::TargetTagRegEntry::RegisterOrGet(TargetTagName).set_name()
 
}  // namespace tvm
 
#endif  // TVM_TARGET_TAG_H_