DyldChainedFixups.hpp

Go to the documentation of this file.

/* Copyright 2017 - 2025 R. Thomas
 * Copyright 2017 - 2025 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_DYLD_CHAINED_FIXUPS_H
#define LIEF_MACHO_DYLD_CHAINED_FIXUPS_H
#include <memory>
#include "LIEF/span.hpp"
#include "LIEF/iterators.hpp"
#include "LIEF/visibility.h"
#include "LIEF/MachO/LoadCommand.hpp"
#include "LIEF/MachO/DyldChainedFormat.hpp"
 
namespace LIEF {
namespace MachO {
 
class Binary;
class BinaryParser;
class BindingInfoIterator;
class Builder;
class ChainedBindingInfo;
class ChainedBindingInfoList;
class DyldChainedFixupsCreator;
class LinkEdit;
class SegmentCommand;
 
namespace details {
struct linkedit_data_command;
struct dyld_chained_fixups_header;
struct dyld_chained_starts_in_segment;
}

class LIEF_API DyldChainedFixups : public LoadCommand {
  friend class BinaryParser;
  friend class Builder;
  friend class LinkEdit;
  friend class BindingInfoIterator;
  friend class Binary;
  friend class DyldChainedFixupsCreator;
 
  public:
  struct chained_starts_in_segment {
    uint32_t offset            = 0; 
    uint32_t size              = 0; 
    uint16_t page_size         = 0; 
    uint64_t segment_offset    = 0; 
    uint32_t max_valid_pointer = 0; 
    DYLD_CHAINED_PTR_FORMAT pointer_format = DYLD_CHAINED_PTR_FORMAT::NONE; 

    size_t page_count() const {
      return page_start.size();
    }
 
    std::vector<uint16_t> page_start;   
    std::vector<uint16_t> chain_starts; 
 
    SegmentCommand& segment; 
 
    LIEF_API friend std::ostream& operator<<(std::ostream& os, const chained_starts_in_segment& info);
 
    static chained_starts_in_segment create_empty_chained(SegmentCommand& segment) {
      return chained_starts_in_segment(0, segment);
    }
 
    private:
    friend class BinaryParser;
    friend class DyldChainedFixupsCreator;
    chained_starts_in_segment(uint32_t offset, SegmentCommand& segment) :
      offset(offset),
      segment(segment)
    {}
    chained_starts_in_segment(uint32_t offset, const details::dyld_chained_starts_in_segment& info,
                              SegmentCommand& segment);
  };

  using chained_starts_in_segments_t = std::vector<chained_starts_in_segment>;

  using it_chained_starts_in_segments_t = ref_iterator<chained_starts_in_segments_t&>;

  using it_const_chained_starts_in_segments_t = const_ref_iterator<const chained_starts_in_segments_t&>;

  using binding_info_t = std::vector<std::unique_ptr<ChainedBindingInfo>>;

  using it_binding_info = ref_iterator<binding_info_t&, ChainedBindingInfo*>;

  using it_const_binding_info = const_ref_iterator<const binding_info_t&, ChainedBindingInfo*>;
 
 
  DyldChainedFixups();
  DyldChainedFixups(const details::linkedit_data_command& cmd);
  std::unique_ptr<LoadCommand> clone() const override {
    return std::unique_ptr<DyldChainedFixups>(new DyldChainedFixups(*this));
  }
 
  ~DyldChainedFixups() override;

  uint32_t data_offset() const {
    return data_offset_;
  }

  uint32_t data_size() const {
    return data_size_;
  }
 
  void data_offset(uint32_t offset) {
    data_offset_ = offset;
  }
  void data_size(uint32_t size) {
    data_size_ = size;
  }

  span<const uint8_t> payload() const {
    return content_;
  }

  it_binding_info bindings() {
    return all_bindings_;
  }

  it_const_binding_info bindings() const {
    return all_bindings_;
  }

  it_chained_starts_in_segments_t chained_starts_in_segments() {
    return chained_starts_in_segment_;
  }
 
  it_const_chained_starts_in_segments_t chained_starts_in_segments() const {
    return chained_starts_in_segment_;
  }

  uint32_t fixups_version() const { return fixups_version_; }
  void fixups_version(uint32_t version) { fixups_version_ = version; }

  uint32_t starts_offset() const { return starts_offset_; }
  void starts_offset(uint32_t offset) { starts_offset_ = offset; }

  uint32_t imports_offset() const { return imports_offset_; }
  void imports_offset(uint32_t offset) { imports_offset_ = offset; }

  uint32_t symbols_offset() const { return symbols_offset_; }
  void symbols_offset(uint32_t offset) { symbols_offset_ = offset; }

  uint32_t imports_count() const { return imports_count_; }
  void imports_count(uint32_t cnt) { imports_count_ = cnt; }

  uint32_t symbols_format() const { return symbols_format_; }
  void symbols_format(uint32_t fmt) { symbols_format_ = fmt; }

  DYLD_CHAINED_FORMAT imports_format() const { return imports_format_; }
  void imports_format(DYLD_CHAINED_FORMAT fmt) { imports_format_ = fmt; }
 
  chained_starts_in_segment& add(chained_starts_in_segment start_info) {
    chained_starts_in_segment_.push_back(std::move(start_info));
    return chained_starts_in_segment_.back();
  }
 
  void accept(Visitor& visitor) const override;
 
  std::ostream& print(std::ostream& os) const override;
 
  static bool classof(const LoadCommand* cmd) {
    return cmd->command() == LoadCommand::TYPE::DYLD_CHAINED_FIXUPS;
  }
 
  private:
  LIEF_LOCAL void update_with(const details::dyld_chained_fixups_header& header);
  LIEF_LOCAL DyldChainedFixups& operator=(const DyldChainedFixups& other);
  LIEF_LOCAL DyldChainedFixups(const DyldChainedFixups& other);
 
  uint32_t data_offset_ = 0;
  uint32_t data_size_   = 0;
 
  // Raw payload of the DyldChainedFixups.
  // This payload is located in the __LINKEDIT segment
  span<uint8_t> content_;
 
  uint32_t fixups_version_ = 0;
  uint32_t starts_offset_  = 0;
  uint32_t imports_offset_ = 0;
  uint32_t symbols_offset_ = 0;
  uint32_t imports_count_  = 0;
  uint32_t symbols_format_ = 0;
  DYLD_CHAINED_FORMAT imports_format_ = DYLD_CHAINED_FORMAT::IMPORT;
 
  chained_starts_in_segments_t chained_starts_in_segment_;
 
  std::vector<std::unique_ptr<ChainedBindingInfoList>> internal_bindings_;
  binding_info_t all_bindings_;
};
 
}
}
#endif