SymbolVersionRequirement.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_ELF_SYMBOL_VERSION_REQUIREMENTS_H
#define LIEF_ELF_SYMBOL_VERSION_REQUIREMENTS_H
 
#include <string_view>
#include <cstdint>
#include <memory>
#include <ostream>
#include <string>
#include <vector>
 
#include "LIEF/Object.hpp"
#include "LIEF/iterators.hpp"
#include "LIEF/visibility.h"
 
 
namespace LIEF::ELF {
class Parser;
class SymbolVersionAuxRequirement;
 
namespace details {
struct Elf64_Verneed;
struct Elf32_Verneed;
}

class LIEF_API SymbolVersionRequirement : public Object {
  friend class Parser;
 
  public:
  using aux_requirement_t =
      std::vector<std::unique_ptr<SymbolVersionAuxRequirement>>;
  using it_aux_requirement =
      ref_iterator<aux_requirement_t&, SymbolVersionAuxRequirement*>;
  using it_const_aux_requirement =
      const_ref_iterator<const aux_requirement_t&,
                         const SymbolVersionAuxRequirement*>;
 
  SymbolVersionRequirement() = default;
  SymbolVersionRequirement(const details::Elf64_Verneed& header);
  SymbolVersionRequirement(const details::Elf32_Verneed& header);
  ~SymbolVersionRequirement() override = default;
 
  SymbolVersionRequirement& operator=(SymbolVersionRequirement other);
  SymbolVersionRequirement(const SymbolVersionRequirement& other);
  void swap(SymbolVersionRequirement& other);

  uint16_t version() const {
    return version_;
  }

  size_t cnt() const {
    return aux_requirements_.size();
  }

  it_aux_requirement auxiliary_symbols() LIEF_LIFETIMEBOUND {
    return aux_requirements_;
  }
 
  it_const_aux_requirement auxiliary_symbols() const LIEF_LIFETIMEBOUND {
    return aux_requirements_;
  }

  std::string_view name() const LIEF_LIFETIMEBOUND {
    return name_;
  }
 
  void version(uint16_t version) {
    version_ = version;
  }
 
  void name(const std::string& name) {
    name_ = name;
  }

  SymbolVersionAuxRequirement& add_aux_requirement(
      const SymbolVersionAuxRequirement& aux_requirement
  ) LIEF_LIFETIMEBOUND;

  const SymbolVersionAuxRequirement*
      find_aux(const std::string& name) const LIEF_LIFETIMEBOUND;
 
  SymbolVersionAuxRequirement*
      find_aux(const std::string& name) LIEF_LIFETIMEBOUND {
    return const_cast<SymbolVersionAuxRequirement*>(
        static_cast<const SymbolVersionRequirement*>(this)->find_aux(name)
    );
  }

  bool remove_aux_requirement(const std::string& name) {
    if (SymbolVersionAuxRequirement* aux = find_aux(name)) {
      return remove_aux_requirement(*aux);
    }
    return false;
  }

  bool remove_aux_requirement(SymbolVersionAuxRequirement& aux);
 
  void accept(Visitor& visitor) const override;
 
  LIEF_API friend std::ostream& operator<<(std::ostream& os,
                                           const SymbolVersionRequirement& symr) {
    os << symr.version() << " " << symr.name();
    return os;
  }
 
  private:
  aux_requirement_t aux_requirements_;
  uint16_t version_ = 0;
  std::string name_;
};
 
}
 
#endif