OAT/Header.hpp

Go to the documentation of this file.

/* Copyright 2017 - 2026 R. Thomas
 * Copyright 2017 - 2026 Quarkslab
 *
 * 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 LIEF_OAT_HEADER_H
#define LIEF_OAT_HEADER_H
#include <string_view>
#include <array>
#include <map>
#include <string>
#include <vector>
 
#include "LIEF/OAT/enums.hpp"
#include "LIEF/OAT/type_traits.hpp"
#include "LIEF/iterators.hpp"
 
#include "LIEF/Object.hpp"
#include "LIEF/visibility.h"
 
 
namespace LIEF::OAT {
class Parser;
 
class LIEF_API Header : public Object {
  friend class Parser;
 
  public:
  struct element_t {
    element_t(HEADER_KEYS key, const std::string& value) :
      key(key),
      value(const_cast<std::string*>(&value)) {}
 
    HEADER_KEYS key;
    std::string* value = nullptr;
  };
  using magic_t = std::array<uint8_t, 4>; // oat\n
  using key_values_t = std::map<HEADER_KEYS, std::string>;
  using it_key_values_t = ref_iterator<std::vector<element_t>>;
  using it_const_key_values_t = const_ref_iterator<std::vector<element_t>>;

  using keys_t = std::vector<HEADER_KEYS>;
  using values_t = std::vector<std::string>;
 
  public:
  static std::string key_to_string(HEADER_KEYS key);
 
  public:
  Header();
  Header(const Header&);
  Header& operator=(const Header&);
 
  template<class T>
  LIEF_LOCAL Header(const T* header);

  Header::magic_t magic() const;

  oat_version_t version() const;
 
  uint32_t checksum() const;
 
  INSTRUCTION_SETS instruction_set() const;
  // TODO instruction_set_features_bitmap_() const;
 
 
  uint32_t nb_dex_files() const;
 
  // Since OAT 131
  uint32_t oat_dex_files_offset() const;
 
  uint32_t executable_offset() const;
  uint32_t i2i_bridge_offset() const;
  uint32_t i2c_code_bridge_offset() const;
  uint32_t jni_dlsym_lookup_offset() const;
 
  uint32_t quick_generic_jni_trampoline_offset() const;
  uint32_t quick_imt_conflict_trampoline_offset() const;
  uint32_t quick_resolution_trampoline_offset() const;
  uint32_t quick_to_interpreter_bridge_offset() const;
 
  int32_t image_patch_delta() const;
 
  uint32_t image_file_location_oat_checksum() const;
  uint32_t image_file_location_oat_data_begin() const;
 
  uint32_t key_value_size() const;
 
  it_key_values_t key_values() LIEF_LIFETIMEBOUND;
  it_const_key_values_t key_values() const LIEF_LIFETIMEBOUND;
 
  keys_t keys() const;
  values_t values() const;
 
  const std::string* get(HEADER_KEYS key) const LIEF_LIFETIMEBOUND;
  std::string* get(HEADER_KEYS key) LIEF_LIFETIMEBOUND;
 
  Header& set(HEADER_KEYS key, std::string_view value) LIEF_LIFETIMEBOUND;
 
  const std::string* operator[](HEADER_KEYS key) const;
  std::string* operator[](HEADER_KEYS key);
 
  void magic(const magic_t& magic);
 
  void accept(Visitor& visitor) const override;
 
 
  LIEF_API friend std::ostream& operator<<(std::ostream& os, const Header& hdr);
 
  private:
  magic_t magic_;
  oat_version_t version_ = 0;
  uint32_t checksum_ = 0;
  INSTRUCTION_SETS instruction_set_ = INSTRUCTION_SETS::INST_SET_NONE;
  uint32_t instruction_set_features_bitmap_ = 0;
  uint32_t dex_file_count_ = 0;
  uint32_t oat_dex_files_offset_ = 0; // Since OAT 131 / Android 8.1.0
  uint32_t executable_offset_ = 0;
  uint32_t i2i_bridge_offset_ = 0;
  uint32_t i2c_code_bridge_offset_ = 0;
  uint32_t jni_dlsym_lookup_offset_ = 0;
 
  uint32_t quick_generic_jni_trampoline_offset_ = 0;
  uint32_t quick_imt_conflict_trampoline_offset_ = 0;
  uint32_t quick_resolution_trampoline_offset_ = 0;
  uint32_t quick_to_interpreter_bridge_offset_ = 0;
 
  int32_t image_patch_delta_ = 0;
 
  uint32_t image_file_location_oat_checksum_ = 0;
  uint32_t image_file_location_oat_data_begin_ = 0;
 
  uint32_t key_value_store_size_ = 0;
 
  key_values_t dex2oat_context_;
};
 
}
 
 
#endif