ART/Parser.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_ART_PARSER_H
#define LIEF_ART_PARSER_H
#include <string_view>
#include <memory>
#include <vector>
 
#include "LIEF/ART/types.hpp"
#include "LIEF/path.hpp"
#include "LIEF/visibility.h"
 
namespace LIEF {
class BinaryStream;
namespace ART {
class File;
 

class LIEF_API Parser {
  public:
  static std::unique_ptr<File> parse(std::string_view file);

  template<class PathT, enable_if_path_t<PathT> = 0>
  static std::unique_ptr<File> parse(const PathT& file) {
    return parse(file.string());
  }
 
  static std::unique_ptr<File> parse(std::vector<uint8_t> data,
                                     std::string_view name = "");
 
  Parser& operator=(const Parser& copy) = delete;
  Parser(const Parser& copy) = delete;
 
  private:
  Parser();
  Parser(std::string_view file);
  Parser(std::vector<uint8_t> data);
  ~Parser();
 
  void init(std::string_view name, art_version_t version);
 
  template<typename ART_T>
  void parse_file();
 
  template<typename ART_T>
  size_t parse_header();
 
  template<typename ART_T, typename PTR_T>
  void parse_sections();
 
  template<typename ART_T, typename PTR_T>
  void parse_roots();
 
  template<typename ART_T, typename PTR_T>
  void parse_methods();
 
  // Section parsing
  template<typename ART_T, typename PTR_T>
  void parse_objects(size_t offset, size_t size);
 
  template<typename ART_T, typename PTR_T>
  void parse_art_fields(size_t offset, size_t size);
 
  template<typename ART_T, typename PTR_T>
  void parse_art_methods(size_t offset, size_t size);
 
  template<typename ART_T, typename PTR_T>
  void parse_interned_strings(size_t offset, size_t size);
 
  // Parse an **Array** of java.lang.DexCache objects
  template<typename ART_T, typename PTR_T>
  void parse_dex_caches(size_t offset, size_t size);
 
  // Parse a **Single** java.lang.DexCache object
  template<typename ART_T, typename PTR_T>
  void parse_dex_cache(size_t object_offset);
 
  // Parse an **Array** of java.lang.Class objects
  template<typename ART_T, typename PTR_T>
  void parse_class_roots(size_t offset, size_t size);
 
  // Parse java.lang.Class objects
  template<typename ART_T, typename PTR_T>
  void parse_class(size_t offset);
 
  // Parse java.lang.String objects
  template<typename ART_T, typename PTR_T>
  void parse_jstring(size_t offset);
 

  // template<typename ART_T, typename PTR_T>
  // void parse_class_roots(size_t object_offset);
 
  std::unique_ptr<File> file_;
  std::unique_ptr<BinaryStream> stream_;
  uint32_t imagebase_ = 0;
};
}
}
#endif