dfbd76bda0
Currently there are two serialization modes for bitstream Remarks: standalone and separate. The separate mode splits remark metadata (e.g. the string table) from actual remark data. The metadata is written into the object file by the AsmPrinter, while the remark data is stored in a separate remarks file. This means we can't use bitstream remarks with tools like opt that don't generate an object file. Also, it is confusing to post-process bitstream remarks files, because only the standalone files can be read by llvm-remarkutil. We always need to use dsymutil to convert the separate files to standalone files, which only works for MachO. It is not possible for clang/opt to directly emit bitstream remark files in standalone mode, because the string table can only be serialized after all remarks were emitted. Therefore, this change completely removes the separate serialization mode. Instead, the remark string table is now always written to the end of the remarks file. This requires us to tell the serializer when to finalize remark serialization. This automatically happens when the serializer goes out of scope. However, often the remark file goes out of scope before the serializer is destroyed. To diagnose this, I have added an assert to alert users that they need to explicitly call finalizeLLVMOptimizationRemarks. This change paves the way for further improvements to the remark infrastructure, including more tooling (e.g. #159784), size optimizations for bitstream remarks, and more. Pull Request: https://github.com/llvm/llvm-project/pull/156715
49 lines
1.8 KiB
C++
49 lines
1.8 KiB
C++
//===- unittest/Support/BitstreamRemarksFormatTest.cpp - BitCodes tests ---===//
|
|
//
|
|
// 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/Remarks/BitstreamRemarkContainer.h"
|
|
#include "gtest/gtest.h"
|
|
|
|
using namespace llvm;
|
|
|
|
// The goal for this test is to observe test failures and carefully update the
|
|
// constants when they change.
|
|
|
|
// This should not change over time.
|
|
TEST(BitstreamRemarksFormat, Magic) {
|
|
EXPECT_EQ(remarks::ContainerMagic, "RMRK");
|
|
}
|
|
|
|
// This should be updated whenever any of the tests below are modified.
|
|
TEST(BitstreamRemarksFormat, ContainerVersion) {
|
|
EXPECT_EQ(remarks::CurrentContainerVersion, 1UL);
|
|
}
|
|
|
|
// The values of the current blocks should not change over time.
|
|
// When adding new blocks, make sure to append them to the enum.
|
|
TEST(BitstreamRemarksFormat, BlockIDs) {
|
|
EXPECT_EQ(remarks::META_BLOCK_ID, 8);
|
|
EXPECT_EQ(remarks::REMARK_BLOCK_ID, 9);
|
|
}
|
|
|
|
// The values of the current records should not change over time.
|
|
// When adding new records, make sure to append them to the enum.
|
|
TEST(BitstreamRemarksFormat, RecordIDs) {
|
|
EXPECT_EQ(remarks::RECORD_FIRST, 1);
|
|
EXPECT_EQ(remarks::RECORD_META_CONTAINER_INFO, 1);
|
|
EXPECT_EQ(remarks::RECORD_META_REMARK_VERSION, 2);
|
|
EXPECT_EQ(remarks::RECORD_META_STRTAB, 3);
|
|
EXPECT_EQ(remarks::RECORD_META_EXTERNAL_FILE, 4);
|
|
EXPECT_EQ(remarks::RECORD_REMARK_HEADER, 5);
|
|
EXPECT_EQ(remarks::RECORD_REMARK_DEBUG_LOC, 6);
|
|
EXPECT_EQ(remarks::RECORD_REMARK_HOTNESS, 7);
|
|
EXPECT_EQ(remarks::RECORD_REMARK_ARG_WITH_DEBUGLOC, 8);
|
|
EXPECT_EQ(remarks::RECORD_REMARK_ARG_WITHOUT_DEBUGLOC, 9);
|
|
EXPECT_EQ(remarks::RECORD_LAST, 9);
|
|
}
|