BuildMetadata.hpp

Go to the documentation of this file.

/* Copyright 2022 - 2026 R. Thomas
 *
 * 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_PDB_BUILD_METADATA_H
#define LIEF_PDB_BUILD_METADATA_H
#include <string_view>
#include <cstdint>
#include <memory>
#include <ostream>
#include <string>
#include <vector>
 
#include "LIEF/compiler_attributes.hpp"
#include "LIEF/visibility.h"
#include <optional>
 
 
namespace LIEF::pdb {
 
namespace details {
class BuildMetadata;
}

class LIEF_API BuildMetadata {
  public:
  enum class LANG : uint8_t {
    C = 0x00,
    CPP = 0x01,
    FORTRAN = 0x02,
    MASM = 0x03,
    PASCAL_LANG = 0x04,
    BASIC = 0x05,
    COBOL = 0x06,
    LINK = 0x07,
    CVTRES = 0x08,
    CVTPGD = 0x09,
    CSHARP = 0x0a,
    VB = 0x0b,
    ILASM = 0x0c,
    JAVA = 0x0d,
    JSCRIPT = 0x0e,
    MSIL = 0x0f,
    HLSL = 0x10,
    OBJC = 0x11,
    OBJCPP = 0x12,
    SWIFT = 0x13,
    ALIASOBJ = 0x14,
    RUST = 0x15,
    GO = 0x16,
 
    UNKNOWN = 0xFF,
  };
 
  enum class CPU : uint16_t {
    INTEL_8080 = 0x0,
    INTEL_8086 = 0x1,
    INTEL_80286 = 0x2,
    INTEL_80386 = 0x3,
    INTEL_80486 = 0x4,
    PENTIUM = 0x5,
    PENTIUMPRO = 0x6,
    PENTIUM3 = 0x7,
    MIPS = 0x10,
    MIPS16 = 0x11,
    MIPS32 = 0x12,
    MIPS64 = 0x13,
    MIPSI = 0x14,
    MIPSII = 0x15,
    MIPSIII = 0x16,
    MIPSIV = 0x17,
    MIPSV = 0x18,
    M68000 = 0x20,
    M68010 = 0x21,
    M68020 = 0x22,
    M68030 = 0x23,
    M68040 = 0x24,
    ALPHA = 0x30,
    ALPHA_21164 = 0x31,
    ALPHA_21164A = 0x32,
    ALPHA_21264 = 0x33,
    ALPHA_21364 = 0x34,
    PPC601 = 0x40,
    PPC603 = 0x41,
    PPC604 = 0x42,
    PPC620 = 0x43,
    PPCFP = 0x44,
    PPCBE = 0x45,
    SH3 = 0x50,
    SH3E = 0x51,
    SH3DSP = 0x52,
    SH4 = 0x53,
    SHMEDIA = 0x54,
    ARM3 = 0x60,
    ARM4 = 0x61,
    ARM4T = 0x62,
    ARM5 = 0x63,
    ARM5T = 0x64,
    ARM6 = 0x65,
    ARM_XMAC = 0x66,
    ARM_WMMX = 0x67,
    ARM7 = 0x68,
    OMNI = 0x70,
    IA64 = 0x80,
    IA64_2 = 0x81,
    CEE = 0x90,
    AM33 = 0xa0,
    M32R = 0xb0,
    TRICORE = 0xc0,
    X64 = 0xd0,
    EBC = 0xe0,
    THUMB = 0xf0,
    ARMNT = 0xf4,
    ARM64 = 0xf6,
    HYBRID_X86ARM64 = 0xf7,
    ARM64EC = 0xf8,
    ARM64X = 0xf9,
    D3D11_SHADER = 0x100,
    UNKNOWN = 0xff,
  };

  struct version_t {
    uint16_t major = 0;

    uint16_t minor = 0;

    uint16_t build = 0;

    uint16_t qfe = 0;
  };

  struct build_info_t {
    std::string cwd;

    std::string build_tool;

    std::string source_file;

    std::string pdb;

    std::string command_line;
  };
 
  BuildMetadata(std::unique_ptr<details::BuildMetadata> impl);
  ~BuildMetadata();

  version_t frontend_version() const;

  version_t backend_version() const;

  std::string_view version() const LIEF_LIFETIMEBOUND;

  LANG language() const;

  CPU target_cpu() const;

  std::optional<build_info_t> build_info() const;

  std::vector<std::string> env() const;
 
  std::string to_string() const;
 
  LIEF_API friend std::ostream& operator<<(std::ostream& os,
                                           const BuildMetadata& meta) {
    os << meta.to_string();
    return os;
  }
 
  private:
  std::unique_ptr<details::BuildMetadata> impl_;
};
 
LIEF_API const char* to_string(BuildMetadata::CPU cpu);
LIEF_API const char* to_string(BuildMetadata::LANG cpu);
 
}
 
#endif