MachO/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_MACHO_PARSER_H
#define LIEF_MACHO_PARSER_H
#include <string_view>
#include <memory>
#include <vector>
 
#include "LIEF/errors.hpp"
#include "LIEF/path.hpp"
#include "LIEF/visibility.h"
 
#include "LIEF/Abstract/Parser.hpp"
 
#include "LIEF/MachO/ParserConfig.hpp"
 
namespace LIEF {
class BinaryStream;
 
namespace MachO {
class Binary;
class FatBinary;

class LIEF_API Parser : public LIEF::Parser {
  public:
  Parser& operator=(const Parser& copy) = delete;
  Parser(const Parser& copy) = delete;
 
  ~Parser();

  static std::unique_ptr<FatBinary>
      parse(std::string_view filename,
            const ParserConfig& conf = ParserConfig::deep());

  template<class PathT, enable_if_path_t<PathT> = 0>
  static std::unique_ptr<FatBinary>
      parse(const PathT& filename,
            const ParserConfig& conf = ParserConfig::deep()) {
    return parse(filename.string(), conf);
  }

  static std::unique_ptr<FatBinary>
      parse(const std::vector<uint8_t>& data,
            const ParserConfig& conf = ParserConfig::deep());
 

  static std::unique_ptr<FatBinary>
      parse(std::unique_ptr<BinaryStream> stream,
            const ParserConfig& conf = ParserConfig::deep());

  static std::unique_ptr<FatBinary>
      parse_from_memory(uintptr_t address,
                        const ParserConfig& conf = ParserConfig::deep());

  static std::unique_ptr<FatBinary>
      parse_from_memory(uintptr_t address, size_t size,
                        const ParserConfig& conf = ParserConfig::deep());

  static std::unique_ptr<FatBinary>
      parse_from_dump(std::string_view filepath, uint64_t addr,
                      const ParserConfig& conf = ParserConfig::deep());

  template<class PathT, enable_if_path_t<PathT> = 0>
  static std::unique_ptr<FatBinary>
      parse_from_dump(const PathT& filepath, uint64_t addr,
                      const ParserConfig& conf = ParserConfig::deep()) {
    return parse_from_dump(filepath.string(), addr, conf);
  }

  static std::unique_ptr<FatBinary>
      parse_from_dump(BinaryStream& stream, uint64_t addr,
                      const ParserConfig& conf = ParserConfig::deep());

  static std::unique_ptr<FatBinary>
      parse_from_dump(std::unique_ptr<BinaryStream> stream, uint64_t addr,
                      const ParserConfig& conf = ParserConfig::deep());
 
  private:
  LIEF_LOCAL Parser(std::string_view file, const ParserConfig& conf);
  LIEF_LOCAL Parser(std::vector<uint8_t> data, const ParserConfig& conf);
  LIEF_LOCAL Parser();
 
  LIEF_LOCAL ok_error_t parse();
  LIEF_LOCAL ok_error_t parse_fat();
 
  LIEF_LOCAL ok_error_t undo_reloc_bindings(uintptr_t base_address);
  LIEF_LOCAL ok_error_t unpack_tlv();
 
  std::unique_ptr<BinaryStream> stream_;
  std::vector<std::unique_ptr<Binary>> binaries_;
  ParserConfig config_;
};
}
}
#endif