MCDXContainerWriter.cpp

Go to the documentation of this file.

//===- llvm/MC/MCDXContainerWriter.cpp - DXContainer Writer -----*- C++ -*-===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
 
#include "llvm/MC/MCDXContainerWriter.h"
#include "llvm/BinaryFormat/DXContainer.h"
#include "llvm/MC/MCAssembler.h"
#include "llvm/MC/MCContext.h"
#include "llvm/MC/MCSection.h"
#include "llvm/MC/MCValue.h"
#include "llvm/Support/Alignment.h"
 
using namespace llvm;
 
static bool isSignaturePart(StringRef Name) {
  return Name == "ISG1" || Name == "OSG1" || Name == "PSG1";
}
 
MCDXContainerTargetWriter::~MCDXContainerTargetWriter() = default;
 
MCDXContainerBaseWriter::~MCDXContainerBaseWriter() = default;
 
bool MCDXContainerBaseWriter::shouldSkipSection(StringRef SectionName,
                                                size_t SectionSize) {
  // Skip empty and auxiliary sections.
  return SectionSize == 0 || SectionName == PdbFileNameSectionName ||
         SectionName == ModuleHashSectionName;
}
 
void MCDXContainerBaseWriter::write(raw_ostream &OS, const Triple &TT) {
  ArrayRef<MCDXContainerPart> Parts = collectParts();
 
  support::endian::Writer W(OS, llvm::endianness::little);
 
  // Start the file size as the header plus the size of the part offsets.
  // Presently DXContainer files usually contain 7-10 parts. Reserving space for
  // 16 part offsets gives us a little room for growth.
  llvm::SmallVector<uint64_t, 16> PartOffsets;
  uint64_t PartOffset = 0;
  bool HasPrivate = false;
  for (const MCDXContainerPart &Part : Parts) {
    if (HasPrivate)
      reportFatalInternalError(
          "PRIV must be the last section in a DXContainer");
    if (Part.Name == "PRIV")
      HasPrivate = true;
 
    uint64_t SectionSize = Part.Data.size();
    assert(SectionSize < std::numeric_limits<uint32_t>::max() &&
           "Section size too large for DXContainer");
 
    PartOffsets.push_back(PartOffset);
    // Signature writers supply their validator-dependent padding. Parts must
    // remain contiguous even when a legacy signature is not dword-aligned.
    if (!HasPrivate && !isSignaturePart(Part.Name))
      SectionSize = alignTo(SectionSize, Align(4));
    PartOffset += sizeof(dxbc::PartHeader) + SectionSize;
    // The DXIL part also writes a program header, so we need to include its
    // size when computing the offset for a part after the DXIL part.
    if (dxbc::isProgramPart(Part.Name))
      PartOffset += sizeof(dxbc::ProgramHeader);
  }
  assert(PartOffset < std::numeric_limits<uint32_t>::max() &&
         "Part data too large for DXContainer");
 
  uint64_t PartStart =
      sizeof(dxbc::Header) + (PartOffsets.size() * sizeof(uint32_t));
  uint64_t FileSize = PartStart + PartOffset;
  assert(FileSize < std::numeric_limits<uint32_t>::max() &&
         "File size too large for DXContainer");
 
  // Write the header.
  W.write<char>({'D', 'X', 'B', 'C'});
  // Write 16-bytes of 0's for the hash.
  W.OS.write_zeros(16);
  // Write 1.0 for file format version.
  W.write<uint16_t>(1u);
  W.write<uint16_t>(0u);
  // Write the file size.
  W.write<uint32_t>(static_cast<uint32_t>(FileSize));
  // Write the number of parts.
  W.write<uint32_t>(static_cast<uint32_t>(PartOffsets.size()));
  // Write the offsets for the part headers for each part.
  for (uint64_t Offset : PartOffsets)
    W.write<uint32_t>(static_cast<uint32_t>(PartStart + Offset));
 
  for (const MCDXContainerPart &Part : Parts) {
    uint64_t SectionSize = Part.Data.size();
    unsigned Start = W.OS.tell();
    // Write section header.
    W.write<char>(ArrayRef<char>(Part.Name.data(), 4));
 
    uint64_t PartSize = SectionSize;
 
    if (dxbc::isProgramPart(Part.Name))
      PartSize += sizeof(dxbc::ProgramHeader);
    // Signature payloads include padding only for validator 1.7 and later.
    bool IsPrivate = Part.Name == "PRIV";
    bool IsSignature = isSignaturePart(Part.Name);
    if (!IsPrivate && !IsSignature)
      PartSize = alignTo(PartSize, Align(4));
    W.write<uint32_t>(static_cast<uint32_t>(PartSize));
    if (dxbc::isProgramPart(Part.Name)) {
      dxbc::ProgramHeader Header;
      memset(reinterpret_cast<void *>(&Header), 0, sizeof(dxbc::ProgramHeader));
 
      VersionTuple Version = TT.getOSVersion();
      uint8_t MajorVersion = static_cast<uint8_t>(Version.getMajor());
      uint8_t MinorVersion =
          static_cast<uint8_t>(Version.getMinor().value_or(0));
      Header.Version =
          dxbc::ProgramHeader::getVersion(MajorVersion, MinorVersion);
      if (TT.hasEnvironment())
        Header.ShaderKind =
            static_cast<uint16_t>(TT.getEnvironment() - Triple::Pixel);
 
      // The program header's size field is in 32-bit words.
      Header.Size = (SectionSize + sizeof(dxbc::ProgramHeader) + 3) / 4;
      memcpy(Header.Bitcode.Magic, "DXIL", 4);
      VersionTuple DXILVersion = TT.getDXILVersion();
      Header.Bitcode.MajorVersion = DXILVersion.getMajor();
      Header.Bitcode.MinorVersion = DXILVersion.getMinor().value_or(0);
      Header.Bitcode.Offset = sizeof(dxbc::BitcodeHeader);
      Header.Bitcode.Size = SectionSize;
      if (sys::IsBigEndianHost)
        Header.swapBytes();
      W.write<char>(ArrayRef<char>(reinterpret_cast<char *>(&Header),
                                   sizeof(dxbc::ProgramHeader)));
    }
    W.write<char>(Part.Data);
    if (!IsPrivate && !IsSignature) {
      unsigned Size = W.OS.tell() - Start;
      W.OS.write_zeros(offsetToAlignment(Size, Align(4)));
    }
  }
}
 
void DXContainerObjectWriter::clearParts() {
  Parts.clear();
  SectionBuffers.clear();
}
 
ArrayRef<MCDXContainerPart> DXContainerObjectWriter::collectParts() {
  clearParts();
  for (const MCSection &Sec : *Asm) {
    if (shouldSkipSection(Sec.getName(), Asm->getSectionAddressSize(Sec)))
      continue;
 
    SectionBuffers.emplace_back();
    raw_svector_ostream OS(SectionBuffers.back());
    Asm->writeSectionData(OS, &Sec);
    Parts.push_back({Sec.getName(), StringRef(SectionBuffers.back())});
  }
  return Parts;
}
 
bool DXContainerObjectWriter::shouldSkipSection(StringRef SectionName,
                                                size_t SectionSize) {
  if (TargetObjectWriter->shouldSkipSection(SectionName))
    return true;
  if (SectionName == "SRCI")
    return true;
  return MCDXContainerBaseWriter::shouldSkipSection(SectionName, SectionSize);
}
 
uint64_t DXContainerObjectWriter::writeObject() {
  write(W.OS, getContext().getTargetTriple());
  clearParts();
 
  return 0;
}