simulator/code_simulator_container.h

/*
 * Copyright (C) 2015 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_SIMULATOR_CODE_SIMULATOR_CONTAINER_H_
#define ART_SIMULATOR_CODE_SIMULATOR_CONTAINER_H_

#include <android-base/logging.h>

#include "arch/instruction_set.h"
#include "code_simulator.h"

namespace art {

class CodeSimulator;

// This class represents a runtime simulator root concept - one per Runtime instance.
// It also acts as a container - dynamically opens and closes libart-simulator.
class CodeSimulatorContainer {
 public:
  explicit CodeSimulatorContainer(InstructionSet target_isa);
  ~CodeSimulatorContainer();

  // Create a basic simulator executor. If this was not possible because libart-simulator was
  // previously not loaded (e.g: on target) then return nullptr instead.
  BasicCodeSimulator* CreateBasicExecutor(size_t stack_size);

  // Create an ART runtime aware simulator executor. If this was not possible because
  // libart-simulator was previously not loaded (e.g: on target) then return nullptr instead.
  CodeSimulator* CreateExecutor(size_t stack_size);

 private:
  // A handle for the libart_simulator dynamic library.
  void* libart_simulator_handle_;
  InstructionSet target_isa_;
  DISALLOW_COPY_AND_ASSIGN(CodeSimulatorContainer);
};

}  // namespace art

#endif  // ART_SIMULATOR_CODE_SIMULATOR_CONTAINER_H_