text: /* Copyright 2018 The TensorFlow Authors. All Rights Reserved.
  
  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 "tensorflow/core/kernels/partitioned_function_ops.h"
  
  #include "absl/strings/match.h"
  #include "tensorflow/core/common_runtime/function.h"
  #include "tensorflow/core/common_runtime/input_colocation_exemption_registry.h"
  #include "tensorflow/core/common_runtime/rendezvous_mgr.h"
  #include "tensorflow/core/framework/attr_value.pb.h"
  #include "tensorflow/core/framework/function.h"
  #include "tensorflow/core/framework/op_kernel.h"
  #include "tensorflow/core/framework/tensor.h"
  #include "tensorflow/core/framework/types.h"
  #include "tensorflow/core/framework/types.pb.h"
  #include "tensorflow/core/lib/random/random.h"
  #include "tensorflow/core/lib/strings/strcat.h"
  #include "tensorflow/core/profiler/lib/traceme.h"
  #include "tensorflow/core/protobuf/config.pb.h"
  #include "tensorflow/core/protobuf/rewriter_config.pb.h"
  #include "tensorflow/core/util/ptr_util.h"
  #ifndef __ANDROID__
  #include "tensorflow/core/grappler/optimizers/meta_optimizer.h"
  #endif
  
  #if GOOGLE_CUDA || TENSORFLOW_USE_ROCM
  #include "tensorflow/stream_executor/stream.h"
  #endif  // GOOGLE_CUDA || TENSORFLOW_USE_ROCM
  
  namespace tensorflow {
  
  PartitionedCallOp::PartitionedCallOp(OpKernelConstruction* ctx)
      : AsyncOpKernel(ctx),
        func_(new NameAttrList),
        config_proto_(new ConfigProto) {
    OP_REQUIRES_OK(
        ctx, ctx->GetAttr(FunctionLibraryDefinition::kFuncAttr, func_.get()));
    string deprecated_config_serialized;
    OP_REQUIRES_OK(ctx, ctx->GetAttr("config", &deprecated_config_serialized));
    string config_proto_serialized;
    OP_REQUIRES_OK(ctx, ctx->GetAttr("config_proto", &config_proto_serialized));
    OP_REQUIRES(
        ctx,
        deprecated_config_serialized.empty() || config_proto_serialized.empty(),
        errors::InvalidArgument("Provided both 'config' and 'config_proto' but "
                                "only one should be provided.  Note the "
                                "'config' option is deprecated."));
    if (!deprecated_config_serialized.empty()) {
      OP_REQUIRES(ctx,
                  config_proto_->mutable_graph_options()
                      ->mutable_rewrite_options()
                      ->ParseFromString(deprecated_config_serialized),
                  errors::InvalidArgument("Unable to parse config string as "
                                          "tensorflow::RewriteOptions proto."));
    } else {
      OP_REQUIRES(
          ctx, config_proto_->ParseFromString(config_proto_serialized),
          errors::InvalidArgument("Unable to parse config_proto string as "
                                  "tensorflow::ConfigProto proto."));
    }
    OP_REQUIRES_OK(ctx, ctx->GetAttr("executor_type", &executor_type_));
  }
  
  PartitionedCallOp::~PartitionedCallOp() {
    for (const auto& it : handles_) {
      Status status = it.first->ReleaseHandle(it.second);
      if (!status.ok()) {
        LOG(INFO) << "Ignoring error while destructing PartitionedCallOp: "
                  << status.ToString();
      }
    }
  }
  
  void PartitionedCallOp::ComputeAsync(OpKernelContext* ctx, DoneCallback done) {
    FunctionLibraryRuntime* lib = ctx->function_library();
    OP_REQUIRES_ASYNC(ctx, lib != nullptr,
                      errors::Internal("No function library is provided."), done);
  
    // The function body's graph is placed and partitioned the first time
    // `ComputeAsync` is invoked; every subsequent invocation calls each
    // of the function shards yielded by partitioning.
    //
    // The partitioning step yields a set of devices on which to run the
    // function, and exactly one function shard is created for each device
    // Inputs and outputs are pinned to the local device, for simplicity.
    //
    // TODO(akshayka): Support re-sharding the function on subsequent calls,
    // via, e.g., virtual device annotations and a list of device names
    // supplied through an attribute.
    //
    // TODO(akshayka): Add a fastpath for functions that execute on a single
    // device.
    FunctionLibraryRuntime::Handle handle;
    // If we are instantiating the function, we can efficiently extract the
    // inputs while instantiating. Else, we extract them separately below.
    std::vector<Tensor> inputs;
    bool inputs_extracted = false;
    {
      mutex_lock l(mu_);
      auto it = handles_.find(lib);
      if (it == handles_.end()) {
        OP_REQUIRES_OK_ASYNC(ctx, Instantiate(lib, ctx, &inputs, &handle), done);
        inputs_extracted = true;
        handles_[lib] = handle;
      } else {
        handle = it->second;
      }
    }
  
    if (!inputs_extracted) {
      OpInputList args;
      OP_REQUIRES_OK_ASYNC(ctx, ctx->input_list("args", &args), done);
      inputs.reserve(args.size());
      for (const Tensor& tensor : args) {
        inputs.push_back(tensor);
      }
    }
  
    RunFunction(handle, inputs, lib, ctx, done);
  }
  
  Status PartitionedCallOp::FillOutputDevices(
      const FunctionLibraryRuntime& lib, const Device& cpu_device,
      AttrSlice attrs, FunctionLibraryRuntime::InstantiateOptions* opts) {
    const FunctionLibraryDefinition* flib = lib.GetFunctionLibraryDefinition();
    const FunctionDef* fdef = flib->Find(func_->name());
    if (fdef == nullptr) {
      return errors::NotFound("Failed for find definition for function \"",
                              func_->name(), "\"");
    }
  
    bool is_type_list;
    for (const OpDef::ArgDef& ret_def : fdef->signature().output_arg()) {
      DataTypeVector dtypes;
      TF_RETURN_IF_ERROR(ArgNumType(attrs, ret_def, &is_type_list, &dtypes));
      for (DataType dtype : dtypes) {
        if (dtype == DT_RESOURCE) {
          // Resource memory type is HOST_MEMORY, however the actual resource
          // might be allocated on a device. We leave output device for resource
          // outputs empty, and rely on a Placer and colocation constraints to
          // infer correct placement for the function output.
          opts->output_devices.push_back("");
        } else {
          opts->output_devices.push_back(opts->target);
        }
      }
    }
    return Status::OK();
  }
  
  Status PartitionedCallOp::Instantiate(FunctionLibraryRuntime* lib,
                                        OpKernelContext* ctx,
                                        std::vector<Tensor>* inputs,
                                        FunctionLibraryRuntime::Handle* handle) {
    FunctionLibraryRuntime::InstantiateOptions opts;
    const auto* config = (ctx->function_library())
                             ? ctx->function_library()->config_proto()
                             : nullptr;
    if (config) {
      opts.config_proto = *config;
    }
  
  #ifndef __ANDROID__
    // Android tf library does not include grappler.
    grappler::GrapplerItem::OptimizationOptions optimization_options;
    // Tensorflow 2.0 in eager mode with automatic control dependencies will
    // prune all nodes that are not in the transitive fanin of the fetch nodes.
    // However because the function will be executed via FunctionLibraryRuntime,
    // and current function implementation does not prune stateful and dataset
    // ops, we rely on Grappler to do the correct graph pruning.
    optimization_options.allow_pruning_stateful_and_dataset_ops = true;
  
    // All the nested function calls will be executed and optimized via
    // PartitionedCallOp, there is no need to optimize functions now.
    optimization_options.optimize_function_library = false;
  
    opts.optimize_graph_fn =
        std::bind(grappler::OptimizeGraph, std::placeholders::_1,
                  std::placeholders::_2, std::placeholders::_3,
                  std::placeholders::_4, std::placeholders::_5, *config_proto_,
                  func_->name(), optimization_options, std::placeholders::_6);
  #endif
  
    // In some contexts like running the graph to evaluate constants,
    // the FLR won't have any device.
    opts.target = lib->device() == nullptr ? "" : lib->device()->name();
    opts.is_multi_device_function = true;
    opts.graph_collector = ctx->graph_collector();
    opts.executor_type = executor_type_;
  
    OpInputList args;
    TF_RETURN_IF_ERROR(ctx->input_list("args", &args));
    Device* cpu_device;
    TF_RETURN_IF_ERROR(lib->device_mgr()->LookupDevice("CPU:0", &cpu_device));
  
    inputs->reserve(args.size());
    for (const Tensor& tensor : args) {
      inputs->push_back(tensor);
      DataType dtype = tensor.dtype();
      if (dtype == DT_RESOURCE) {
        const ResourceHandle& handle = tensor.flat<ResourceHandle>()(0);
        opts.input_devices.push_back(handle.device());
      } else {
        opts.input_devices.push_back(opts.target);
      }
    }
  
    TF_RETURN_IF_ERROR(
        FillOutputDevices(*lib, *cpu_device, AttrSlice(&func_->attr()), &opts));
  
    TF_RETURN_IF_ERROR(
        lib->Instantiate(func_->name(), AttrSlice(&func_->attr()), opts, handle));
    return Status::OK();
  }
  
  void PartitionedCallOp::RunFunction(FunctionLibraryRuntime::Handle handle,
                                      const std::vector<Tensor>& inputs,
                                      FunctionLibraryRuntime* lib,
                                      OpKernelContext* ctx, DoneCallback done) {
    FunctionLibraryRuntime::Options run_opts;
    ResourceMgr* resource_mgr = lib->device()->resource_manager();
    ScopedStepContainer* step_container = new ScopedStepContainer(
        run_opts.step_id, [resource_mgr](const string& name) {
          resource_mgr->Cleanup(name).IgnoreError();
        });
    run_opts.step_container = step_container;
    run_opts.cancellation_manager = ctx->cancellation_manager();
    run_opts.stats_collector = ctx->stats_collector();
    run_opts.collective_executor = ctx->collective_executor();
    // TODO(akshayka): Consider selecting a runner on a per-device basis,
    // i.e., using device-specific threadpools when available.
    run_opts.runner = ctx->runner();
    run_opts.source_device =
        lib->device() == nullptr ? "" : lib->device()->name();
    run_opts.allow_dead_tensors = true;
  
    Rendezvous* rendez;
    OP_REQUIRES_OK_ASYNC(
        ctx,
        ctx->create_rendezvous(run_opts.step_id,
                               ctx->function_library()->device_mgr(), &rendez),
        done);
    run_opts.rendezvous = rendez;
  
    std::vector<Tensor>* rets = new std::vector<Tensor>;
    const string& func_name = func_->name();
    profiler::TraceMe trace_me(
        [&] {
          return absl::StrCat(
              "PartitionedCallOp #parent_step_id=", ctx->step_id(),
              ",function_step_id=", run_opts.step_id, "#");
        },
        /*level=*/2);
    lib->Run(run_opts, handle, inputs, rets,
             [rets, rendez, done, ctx, func_name,
              step_container](const Status& status) {
               if (!status.ok()) {
                 const string function_and_msg =
                     strings::StrCat(errors::FormatFunctionForError(func_name),
                                     " ", status.error_message());
                 ctx->SetStatus(Status(status.code(), function_and_msg));
               } else {
                 for (int i = 0; i < rets->size(); ++i) {
                   ctx->set_output(i, (*rets)[i]);
                 }
               }
               delete rets;
               delete step_container;
               rendez->Unref();
               done();
             });
  }
  
  REGISTER_KERNEL_BUILDER(Name("PartitionedCall").Device(DEVICE_CPU),
                          PartitionedCallOp);
  REGISTER_KERNEL_BUILDER(Name("StatefulPartitionedCall").Device(DEVICE_CPU),
                          PartitionedCallOp);
  REGISTER_KERNEL_BUILDER(Name("PartitionedCall").Device(DEVICE_GPU),
                          PartitionedCallOp);
  REGISTER_KERNEL_BUILDER(Name("StatefulPartitionedCall").Device(DEVICE_GPU),
                          PartitionedCallOp);
  
  REGISTER_INPUT_COLOCATION_EXEMPTION("PartitionedCall");
  REGISTER_INPUT_COLOCATION_EXEMPTION("StatefulPartitionedCall");
  
  #if TENSORFLOW_USE_SYCL
  REGISTER_KERNEL_BUILDER(Name("PartitionedCall").Device(DEVICE_SYCL),
                          PartitionedCallOp);
  REGISTER_KERNEL_BUILDER(Name("StatefulPartitionedCall").Device(DEVICE_SYCL),
                          PartitionedCallOp);
  #endif  // TENSORFLOW_USE_SYCL
  
  }  // namespace tensorflow
  