DyldChainedFixups.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_DYLD_CHAINED_FIXUPS_H
#define LIEF_MACHO_DYLD_CHAINED_FIXUPS_H
#include <memory>
#include "LIEF/span.hpp"
#include "LIEF/iterators.hpp"
#include "LIEF/compiler_attributes.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 {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 LIEF_LIFETIMEBOUND {
    return content_;
  }

  it_binding_info bindings() LIEF_LIFETIMEBOUND {
    return all_bindings_;
  }

  it_const_binding_info bindings() const LIEF_LIFETIMEBOUND {
    return all_bindings_;
  }

  it_chained_starts_in_segments_t chained_starts_in_segments() LIEF_LIFETIMEBOUND {
    return chained_starts_in_segment_;
  }
 
  it_const_chained_starts_in_segments_t
      chained_starts_in_segments() const LIEF_LIFETIMEBOUND {
    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