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
50 lines
1.8 KiB
C++
50 lines
1.8 KiB
C++
//===- RemarkSerializer.cpp -----------------------------------------------===//
|
|
//
|
|
// 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
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This file provides tools for serializing remarks.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#include "llvm/Remarks/RemarkSerializer.h"
|
|
#include "llvm/Remarks/BitstreamRemarkSerializer.h"
|
|
#include "llvm/Remarks/YAMLRemarkSerializer.h"
|
|
|
|
using namespace llvm;
|
|
using namespace llvm::remarks;
|
|
|
|
Expected<std::unique_ptr<RemarkSerializer>>
|
|
remarks::createRemarkSerializer(Format RemarksFormat, raw_ostream &OS) {
|
|
switch (RemarksFormat) {
|
|
case Format::Unknown:
|
|
case Format::Auto:
|
|
return createStringError(std::errc::invalid_argument,
|
|
"Invalid remark serializer format.");
|
|
case Format::YAML:
|
|
return std::make_unique<YAMLRemarkSerializer>(OS);
|
|
case Format::Bitstream:
|
|
return std::make_unique<BitstreamRemarkSerializer>(OS);
|
|
}
|
|
llvm_unreachable("Unknown remarks::Format enum");
|
|
}
|
|
|
|
Expected<std::unique_ptr<RemarkSerializer>>
|
|
remarks::createRemarkSerializer(Format RemarksFormat, raw_ostream &OS,
|
|
remarks::StringTable StrTab) {
|
|
switch (RemarksFormat) {
|
|
case Format::Unknown:
|
|
case Format::Auto:
|
|
return createStringError(std::errc::invalid_argument,
|
|
"Invalid remark serializer format.");
|
|
case Format::YAML:
|
|
return std::make_unique<YAMLRemarkSerializer>(OS, std::move(StrTab));
|
|
case Format::Bitstream:
|
|
return std::make_unique<BitstreamRemarkSerializer>(OS, std::move(StrTab));
|
|
}
|
|
llvm_unreachable("Unknown remarks::Format enum");
|
|
}
|