PE/utils.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_PE_UTILS_H
#define LIEF_PE_UTILS_H
#include <string_view>
#include <string>
#include <vector>
 
#include "LIEF/PE/enums.hpp"
#include "LIEF/errors.hpp"
#include "LIEF/visibility.h"
 
namespace LIEF {
class BinaryStream;
 
namespace PE {
class Binary;
class Import;

enum class IMPHASH_MODE {
  DEFAULT = 0,

  LIEF = DEFAULT,

  PEFILE,

  VT = PEFILE,
 
};

LIEF_API bool is_pe(BinaryStream& stream);

LIEF_API bool is_pe(std::string_view file);

LIEF_API bool is_pe(const std::vector<uint8_t>& raw);

LIEF_API result<PE_TYPE> get_type(std::string_view file);

LIEF_API result<PE_TYPE> get_type(const std::vector<uint8_t>& raw);
 
// In this case we assume that stream contains a valid PE stream
LIEF_LOCAL result<PE_TYPE> get_type_from_stream(BinaryStream& stream);

LIEF_API std::string get_imphash(const Binary& binary,
                                 IMPHASH_MODE mode = IMPHASH_MODE::DEFAULT);

LIEF_API result<Import> resolve_ordinals(const Import& import, bool strict = false,
                                         bool use_std = false);
 
LIEF_API ALGORITHMS algo_from_oid(const std::string& oid);

LIEF_API bool check_layout(const Binary& bin, std::string* error_info = nullptr);
 
}
}
#endif