Quelle  agent_spec.h

/*
 * Copyright (C) 2025 The Android Open Source Project
 *
 * 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.
 */

#ifndef ART_RUNTIME_TI_AGENT_SPEC_H_
#define ART_RUNTIME_TI_AGENT_SPEC_H_

#include <android-base/logging.h>
#include <android-base/macros.h>
#include <dlfcn.h>
#include <jni.h>  // for jint, JavaVM* etc declarations

#include <memory>

#include "base/macros.h"

namespace art HIDDEN {
namespace ti {

class Agent;

enum LoadError {
  kNoError,              // No error occurred..
  kLoadingError,         // dlopen or dlsym returned an error.
  kInitializationError,  // The entrypoint did not return 0. This might require an abort.
};

class AgentSpec {
 public:
  explicit AgentSpec(const std::string& arg);

  const std::string& GetName() const { return name_; }

  const std::string& GetArgs() const { return args_; }

  bool HasArgs() const { return !GetArgs().empty(); }

  std::unique_ptr<Agent> Load(/*out*/ jint* call_res,
                              /*out*/ LoadError* error,
                              /*out*/ std::string* error_msg);

  // Tries to attach the agent using its OnAttach method. Returns true on success.
  std::unique_ptr<Agent> Attach(JNIEnv* env,
                                jobject class_loader,
                                /*out*/ jint* call_res,
                                /*out*/ LoadError* error,
                                /*out*/ std::string* error_msg);

 private:
  std::unique_ptr<Agent> DoDlOpen(JNIEnv* env,
                                  jobject class_loader,
                                  /*out*/ LoadError* error,
                                  /*out*/ std::string* error_msg);

  std::unique_ptr<Agent> DoLoadHelper(JNIEnv* env,
                                      bool attaching,
                                      jobject class_loader,
                                      /*out*/ jint* call_res,
                                      /*out*/ LoadError* error,
                                      /*out*/ std::string* error_msg);

  std::string name_;
  std::string args_;

  friend std::ostream& operator<<(std::ostream& os, AgentSpec const& m);
};

std::ostream& operator<<(std::ostream& os, AgentSpec const& m);

}  // namespace ti
}  // namespace art

#endif  // ART_RUNTIME_TI_AGENT_SPEC_H_