Do not pass a superblock to PDBFileBuilder.

[ruiu]

Summary

When we create a PDB file using PDBFileBuilder, the information
in the superblock, such as the size of the resulting file, is not
available.

Previously, PDBFileBuilder::initialize took a superblock assuming
that all the members of the struct are correct. That is useful when
you want to restore the exact information from a YAML file, but
that's probably the only use case in which that is useful.
When we are creating a PDB file on the fly, we have to backfill the
members.

This patch redefines PDBFileBuilder::initialize to take only a
block size. Now all the other members are left as default values,
so that they'll be updated when commit() is called.

[zturner]

test/DebugInfo/PDB/pdbdump-readwrite.test

8

Is the only difference in the two check prefixes the number of blocks? If so I would just delete the value and leave one check statement (see the NumDirectoryBytes field, or the NumStreams field, for example.

[ruiu]

test/DebugInfo/PDB/pdbdump-readwrite.test

8

FreeBlockMap and NumBlocks were different.

[ruiu]

• Merged two test CHECKs.

[ruiu]

I wonder if we need BlockSize parameter. Is there any situation you want to create a PDB file with a smaller block size?

include/llvm/DebugInfo/PDB/Raw/PDBFileBuilder.h

 class TpiStreamBuilder;
 
 class PDBFileBuilder {
 public:
   explicit PDBFileBuilder(BumpPtrAllocator &Allocator);
   PDBFileBuilder(const PDBFileBuilder &) = delete;
   PDBFileBuilder &operator=(const PDBFileBuilder &) = delete;
 
-  Error initialize(const msf::SuperBlock &Super);
+  Error initialize(uint32_t BlockSize);
 
   msf::MSFBuilder &getMsfBuilder();
   InfoStreamBuilder &getInfoBuilder();
   DbiStreamBuilder &getDbiBuilder();
   TpiStreamBuilder &getTpiBuilder();
   TpiStreamBuilder &getIpiBuilder();
 
   Expected<std::unique_ptr<PDBFile>>

lib/DebugInfo/PDB/Raw/PDBFileBuilder.cpp

 using namespace llvm::codeview;
 using namespace llvm::msf;
 using namespace llvm::pdb;
 using namespace llvm::support;
 
 PDBFileBuilder::PDBFileBuilder(BumpPtrAllocator &Allocator)
     : Allocator(Allocator) {}
 
-Error PDBFileBuilder::initialize(const msf::SuperBlock &Super) {
-  auto ExpectedMsf =
-      MSFBuilder::create(Allocator, Super.BlockSize, Super.NumBlocks);
+Error PDBFileBuilder::initialize(uint32_t BlockSize) {
+  auto ExpectedMsf = MSFBuilder::create(Allocator, BlockSize);
   if (!ExpectedMsf)
     return ExpectedMsf.takeError();
-
-  auto &MsfResult = *ExpectedMsf;
-  if (auto EC = MsfResult.setBlockMapAddr(Super.BlockMapAddr))
-    return EC;
-  Msf = llvm::make_unique<MSFBuilder>(std::move(MsfResult));
-  Msf->setFreePageMap(Super.FreeBlockMapBlock);
-  Msf->setUnknown1(Super.Unknown1);
+  Msf = llvm::make_unique<MSFBuilder>(std::move(*ExpectedMsf));
   return Error::success();
 }
 
 MSFBuilder &PDBFileBuilder::getMsfBuilder() { return *Msf; }
 
 InfoStreamBuilder &PDBFileBuilder::getInfoBuilder() {
   if (!Info)
     Info = llvm::make_unique<InfoStreamBuilder>(*Msf);
Error PDBFileBuilder::commit(const msf::WritableStream &Buffer) {
   }
 
   if (Ipi) {
     if (auto EC = Ipi->commit(Layout, Buffer))
       return EC;
   }
 
   return Buffer.commit();
-}
+}
 

test/DebugInfo/PDB/pdbdump-readwrite.test

 RUN: llvm-pdbdump pdb2yaml -dbi-module-info -dbi-module-source-info \
 RUN:   -dbi-stream -pdb-stream -tpi-stream -stream-directory \
 RUN:   -stream-metadata %p/Inputs/empty.pdb > %t.1
 RUN: llvm-pdbdump yaml2pdb -pdb=%t.2 %t.1
 
-RUN: llvm-pdbdump raw -headers -tpi-records %p/Inputs/empty.pdb | FileCheck %s
-RUN: llvm-pdbdump raw -headers -tpi-records %t.2 | FileCheck %s
+RUN: llvm-pdbdump raw -headers -tpi-records %p/Inputs/empty.pdb \
+RUN:   | FileCheck -check-prefix=CHECK1 %s
+RUN: llvm-pdbdump raw -headers -tpi-records %t.2 \
+RUN:   | FileCheck -check-prefix=CHECK2 %s
 
-CHECK:      FileHeaders {
-CHECK-NEXT:   BlockSize: 4096
-CHECK-NEXT:   FreeBlockMap: 2
-CHECK-NEXT:   NumBlocks: 25
-CHECK-NEXT:   NumDirectoryBytes:
-CHECK-NEXT:   Unknown1: 0
-CHECK-NEXT:   BlockMapAddr:
-CHECK-NEXT:   NumDirectoryBlocks: 1
-CHECK-NEXT:   DirectoryBlocks:
-CHECK-NEXT:   NumStreams:
-CHECK-NEXT: }
-CHECK:      PDB Stream {
-CHECK-NEXT:   Version: 20000404
-CHECK-NEXT:   Signature: 0x54E507E2
-CHECK-NEXT:   Age: 1
-CHECK-NEXT:   Guid: {0B355641-86A0-A249-896F-9988FAE52FF0}
-CHECK-NEXT: }
-CHECK:      Type Info Stream (TPI) {
-CHECK-NEXT:   TPI Version: 20040203
-CHECK-NEXT:   Record count: 75
-CHECK:      DBI Stream {
-CHECK-NEXT:   Dbi Version: 19990903
-CHECK-NEXT:   Age: 1
-CHECK-NEXT:   Incremental Linking: Yes
-CHECK-NEXT:   Has CTypes: No
-CHECK-NEXT:   Is Stripped: No
-CHECK-NEXT:   Machine Type: x86
-CHECK-NEXT:   Symbol Record Stream Index:
-CHECK-NEXT:   Public Symbol Stream Index:
-CHECK-NEXT:   Global Symbol Stream Index:
-CHECK-NEXT:   Toolchain Version: 12.0
-CHECK-NEXT:   mspdb120.dll version: 12.0.31101
-CHECK-NEXT: }
+CHECK1:      FileHeaders {
+CHECK1-NEXT:   BlockSize: 4096
+CHECK1-NEXT:   FreeBlockMap: 2
+CHECK1-NEXT:   NumBlocks: 25
+CHECK1-NEXT:   NumDirectoryBytes:
+CHECK1-NEXT:   Unknown1: 0
+CHECK1-NEXT:   BlockMapAddr:
+CHECK1-NEXT:   NumDirectoryBlocks: 1
+CHECK1-NEXT:   DirectoryBlocks:
+CHECK1-NEXT:   NumStreams:
+CHECK1-NEXT: }
+CHECK1:      PDB Stream {
+CHECK1-NEXT:   Version: 20000404
+CHECK1-NEXT:   Signature: 0x54E507E2
+CHECK1-NEXT:   Age: 1
+CHECK1-NEXT:   Guid: {0B355641-86A0-A249-896F-9988FAE52FF0}
+CHECK1-NEXT: }
+CHECK1:      Type Info Stream (TPI) {
+CHECK1-NEXT:   TPI Version: 20040203
+CHECK1-NEXT:   Record count: 75
+CHECK1:      DBI Stream {
+CHECK1-NEXT:   Dbi Version: 19990903
+CHECK1-NEXT:   Age: 1
+CHECK1-NEXT:   Incremental Linking: Yes
+CHECK1-NEXT:   Has CTypes: No
+CHECK1-NEXT:   Is Stripped: No
+CHECK1-NEXT:   Machine Type: x86
+CHECK1-NEXT:   Symbol Record Stream Index:
+CHECK1-NEXT:   Public Symbol Stream Index:
+CHECK1-NEXT:   Global Symbol Stream Index:
+CHECK1-NEXT:   Toolchain Version: 12.0
+CHECK1-NEXT:   mspdb120.dll version: 12.0.31101
+CHECK1-NEXT: }
+
+CHECK2:      FileHeaders {
+CHECK2-NEXT:   BlockSize: 4096
+CHECK2-NEXT:   FreeBlockMap: 1
+CHECK2-NEXT:   NumBlocks: 10
+CHECK2-NEXT:   NumDirectoryBytes:
+CHECK2-NEXT:   Unknown1: 0
+CHECK2-NEXT:   BlockMapAddr:
+CHECK2-NEXT:   NumDirectoryBlocks: 1
+CHECK2-NEXT:   DirectoryBlocks:
+CHECK2-NEXT:   NumStreams:
+CHECK2-NEXT: }
+CHECK2:      PDB Stream {
+CHECK2-NEXT:   Version: 20000404
+CHECK2-NEXT:   Signature: 0x54E507E2
+CHECK2-NEXT:   Age: 1
+CHECK2-NEXT:   Guid: {0B355641-86A0-A249-896F-9988FAE52FF0}
+CHECK2-NEXT: }
+CHECK2:      Type Info Stream (TPI) {
+CHECK2-NEXT:   TPI Version: 20040203
+CHECK2-NEXT:   Record count: 75
+CHECK2:      DBI Stream {
+CHECK2-NEXT:   Dbi Version: 19990903
+CHECK2-NEXT:   Age: 1
+CHECK2-NEXT:   Incremental Linking: Yes
+CHECK2-NEXT:   Has CTypes: No
+CHECK2-NEXT:   Is Stripped: No
+CHECK2-NEXT:   Machine Type: x86
+CHECK2-NEXT:   Symbol Record Stream Index:
+CHECK2-NEXT:   Public Symbol Stream Index:
+CHECK2-NEXT:   Global Symbol Stream Index:
+CHECK2-NEXT:   Toolchain Version: 12.0
+CHECK2-NEXT:   mspdb120.dll version: 12.0.31101
+CHECK2-NEXT: }

tools/llvm-pdbdump/llvm-pdbdump.cpp

static void yamlToPdb(StringRef Path) {
   if (OutFileOrError.getError())
     ExitOnErr(make_error<GenericError>(generic_error_code::invalid_path,
                                        opts::yaml2pdb::YamlPdbOutputFile));
 
   auto FileByteStream =
       llvm::make_unique<FileBufferByteStream>(std::move(*OutFileOrError));
   PDBFileBuilder Builder(Allocator);
 
-  ExitOnErr(Builder.initialize(YamlObj.Headers->SuperBlock));
+  ExitOnErr(Builder.initialize(YamlObj.Headers->SuperBlock.BlockSize));
   // Add each of the reserved streams.  We ignore stream metadata in the
   // yaml, because we will reconstruct our own view of the streams.  For
   // example, the YAML may say that there were 20 streams in the original
   // PDB, but maybe we only dump a subset of those 20 streams, so we will
   // have fewer, and the ones we do have may end up with different indices
   // than the ones in the original PDB.  So we just start with a clean slate.
   for (uint32_t I = 0; I < kSpecialStreamCount; ++I)
     ExitOnErr(Builder.getMsfBuilder().addStream(0));