• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 //===--- SerializedDiagnosticPrinter.cpp - Serializer for diagnostics -----===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 
10 #include "clang/Frontend/SerializedDiagnosticPrinter.h"
11 #include "clang/Basic/Diagnostic.h"
12 #include "clang/Basic/DiagnosticOptions.h"
13 #include "clang/Basic/FileManager.h"
14 #include "clang/Basic/SourceManager.h"
15 #include "clang/Basic/Version.h"
16 #include "clang/Frontend/DiagnosticRenderer.h"
17 #include "clang/Frontend/FrontendDiagnostic.h"
18 #include "clang/Frontend/SerializedDiagnosticReader.h"
19 #include "clang/Frontend/SerializedDiagnostics.h"
20 #include "clang/Frontend/TextDiagnosticPrinter.h"
21 #include "clang/Lex/Lexer.h"
22 #include "llvm/ADT/DenseSet.h"
23 #include "llvm/ADT/STLExtras.h"
24 #include "llvm/ADT/SmallString.h"
25 #include "llvm/ADT/StringRef.h"
26 #include "llvm/Support/raw_ostream.h"
27 #include <utility>
28 #include <vector>
29 
30 using namespace clang;
31 using namespace clang::serialized_diags;
32 
33 namespace {
34 
35 class AbbreviationMap {
36   llvm::DenseMap<unsigned, unsigned> Abbrevs;
37 public:
AbbreviationMap()38   AbbreviationMap() {}
39 
set(unsigned recordID,unsigned abbrevID)40   void set(unsigned recordID, unsigned abbrevID) {
41     assert(Abbrevs.find(recordID) == Abbrevs.end()
42            && "Abbreviation already set.");
43     Abbrevs[recordID] = abbrevID;
44   }
45 
get(unsigned recordID)46   unsigned get(unsigned recordID) {
47     assert(Abbrevs.find(recordID) != Abbrevs.end() &&
48            "Abbreviation not set.");
49     return Abbrevs[recordID];
50   }
51 };
52 
53 typedef SmallVector<uint64_t, 64> RecordData;
54 typedef SmallVectorImpl<uint64_t> RecordDataImpl;
55 typedef ArrayRef<uint64_t> RecordDataRef;
56 
57 class SDiagsWriter;
58 
59 class SDiagsRenderer : public DiagnosticNoteRenderer {
60   SDiagsWriter &Writer;
61 public:
SDiagsRenderer(SDiagsWriter & Writer,const LangOptions & LangOpts,DiagnosticOptions * DiagOpts)62   SDiagsRenderer(SDiagsWriter &Writer, const LangOptions &LangOpts,
63                  DiagnosticOptions *DiagOpts)
64     : DiagnosticNoteRenderer(LangOpts, DiagOpts), Writer(Writer) {}
65 
~SDiagsRenderer()66   ~SDiagsRenderer() override {}
67 
68 protected:
69   void emitDiagnosticMessage(SourceLocation Loc,
70                              PresumedLoc PLoc,
71                              DiagnosticsEngine::Level Level,
72                              StringRef Message,
73                              ArrayRef<CharSourceRange> Ranges,
74                              const SourceManager *SM,
75                              DiagOrStoredDiag D) override;
76 
emitDiagnosticLoc(SourceLocation Loc,PresumedLoc PLoc,DiagnosticsEngine::Level Level,ArrayRef<CharSourceRange> Ranges,const SourceManager & SM)77   void emitDiagnosticLoc(SourceLocation Loc, PresumedLoc PLoc,
78                          DiagnosticsEngine::Level Level,
79                          ArrayRef<CharSourceRange> Ranges,
80                          const SourceManager &SM) override {}
81 
82   void emitNote(SourceLocation Loc, StringRef Message,
83                 const SourceManager *SM) override;
84 
85   void emitCodeContext(SourceLocation Loc,
86                        DiagnosticsEngine::Level Level,
87                        SmallVectorImpl<CharSourceRange>& Ranges,
88                        ArrayRef<FixItHint> Hints,
89                        const SourceManager &SM) override;
90 
91   void beginDiagnostic(DiagOrStoredDiag D,
92                        DiagnosticsEngine::Level Level) override;
93   void endDiagnostic(DiagOrStoredDiag D,
94                      DiagnosticsEngine::Level Level) override;
95 };
96 
97 typedef llvm::DenseMap<unsigned, unsigned> AbbrevLookup;
98 
99 class SDiagsMerger : SerializedDiagnosticReader {
100   SDiagsWriter &Writer;
101   AbbrevLookup FileLookup;
102   AbbrevLookup CategoryLookup;
103   AbbrevLookup DiagFlagLookup;
104 
105 public:
SDiagsMerger(SDiagsWriter & Writer)106   SDiagsMerger(SDiagsWriter &Writer)
107       : SerializedDiagnosticReader(), Writer(Writer) {}
108 
mergeRecordsFromFile(const char * File)109   std::error_code mergeRecordsFromFile(const char *File) {
110     return readDiagnostics(File);
111   }
112 
113 protected:
114   std::error_code visitStartOfDiagnostic() override;
115   std::error_code visitEndOfDiagnostic() override;
116   std::error_code visitCategoryRecord(unsigned ID, StringRef Name) override;
117   std::error_code visitDiagFlagRecord(unsigned ID, StringRef Name) override;
118   std::error_code visitDiagnosticRecord(
119       unsigned Severity, const serialized_diags::Location &Location,
120       unsigned Category, unsigned Flag, StringRef Message) override;
121   std::error_code visitFilenameRecord(unsigned ID, unsigned Size,
122                                       unsigned Timestamp,
123                                       StringRef Name) override;
124   std::error_code visitFixitRecord(const serialized_diags::Location &Start,
125                                    const serialized_diags::Location &End,
126                                    StringRef CodeToInsert) override;
127   std::error_code
128   visitSourceRangeRecord(const serialized_diags::Location &Start,
129                          const serialized_diags::Location &End) override;
130 
131 private:
132   std::error_code adjustSourceLocFilename(RecordData &Record,
133                                           unsigned int offset);
134 
135   void adjustAbbrevID(RecordData &Record, AbbrevLookup &Lookup,
136                       unsigned NewAbbrev);
137 
138   void writeRecordWithAbbrev(unsigned ID, RecordData &Record);
139 
140   void writeRecordWithBlob(unsigned ID, RecordData &Record, StringRef Blob);
141 };
142 
143 class SDiagsWriter : public DiagnosticConsumer {
144   friend class SDiagsRenderer;
145   friend class SDiagsMerger;
146 
147   struct SharedState;
148 
SDiagsWriter(IntrusiveRefCntPtr<SharedState> State)149   explicit SDiagsWriter(IntrusiveRefCntPtr<SharedState> State)
150       : LangOpts(nullptr), OriginalInstance(false), MergeChildRecords(false),
151         State(std::move(State)) {}
152 
153 public:
SDiagsWriter(StringRef File,DiagnosticOptions * Diags,bool MergeChildRecords)154   SDiagsWriter(StringRef File, DiagnosticOptions *Diags, bool MergeChildRecords)
155       : LangOpts(nullptr), OriginalInstance(true),
156         MergeChildRecords(MergeChildRecords),
157         State(new SharedState(File, Diags)) {
158     if (MergeChildRecords)
159       RemoveOldDiagnostics();
160     EmitPreamble();
161   }
162 
~SDiagsWriter()163   ~SDiagsWriter() override {}
164 
165   void HandleDiagnostic(DiagnosticsEngine::Level DiagLevel,
166                         const Diagnostic &Info) override;
167 
BeginSourceFile(const LangOptions & LO,const Preprocessor * PP)168   void BeginSourceFile(const LangOptions &LO, const Preprocessor *PP) override {
169     LangOpts = &LO;
170   }
171 
172   void finish() override;
173 
174 private:
175   /// \brief Build a DiagnosticsEngine to emit diagnostics about the diagnostics
176   DiagnosticsEngine *getMetaDiags();
177 
178   /// \brief Remove old copies of the serialized diagnostics. This is necessary
179   /// so that we can detect when subprocesses write diagnostics that we should
180   /// merge into our own.
181   void RemoveOldDiagnostics();
182 
183   /// \brief Emit the preamble for the serialized diagnostics.
184   void EmitPreamble();
185 
186   /// \brief Emit the BLOCKINFO block.
187   void EmitBlockInfoBlock();
188 
189   /// \brief Emit the META data block.
190   void EmitMetaBlock();
191 
192   /// \brief Start a DIAG block.
193   void EnterDiagBlock();
194 
195   /// \brief End a DIAG block.
196   void ExitDiagBlock();
197 
198   /// \brief Emit a DIAG record.
199   void EmitDiagnosticMessage(SourceLocation Loc,
200                              PresumedLoc PLoc,
201                              DiagnosticsEngine::Level Level,
202                              StringRef Message,
203                              const SourceManager *SM,
204                              DiagOrStoredDiag D);
205 
206   /// \brief Emit FIXIT and SOURCE_RANGE records for a diagnostic.
207   void EmitCodeContext(SmallVectorImpl<CharSourceRange> &Ranges,
208                        ArrayRef<FixItHint> Hints,
209                        const SourceManager &SM);
210 
211   /// \brief Emit a record for a CharSourceRange.
212   void EmitCharSourceRange(CharSourceRange R, const SourceManager &SM);
213 
214   /// \brief Emit the string information for the category.
215   unsigned getEmitCategory(unsigned category = 0);
216 
217   /// \brief Emit the string information for diagnostic flags.
218   unsigned getEmitDiagnosticFlag(DiagnosticsEngine::Level DiagLevel,
219                                  unsigned DiagID = 0);
220 
221   unsigned getEmitDiagnosticFlag(StringRef DiagName);
222 
223   /// \brief Emit (lazily) the file string and retrieved the file identifier.
224   unsigned getEmitFile(const char *Filename);
225 
226   /// \brief Add SourceLocation information the specified record.
227   void AddLocToRecord(SourceLocation Loc, const SourceManager *SM,
228                       PresumedLoc PLoc, RecordDataImpl &Record,
229                       unsigned TokSize = 0);
230 
231   /// \brief Add SourceLocation information the specified record.
AddLocToRecord(SourceLocation Loc,RecordDataImpl & Record,const SourceManager * SM,unsigned TokSize=0)232   void AddLocToRecord(SourceLocation Loc, RecordDataImpl &Record,
233                       const SourceManager *SM,
234                       unsigned TokSize = 0) {
235     AddLocToRecord(Loc, SM, SM ? SM->getPresumedLoc(Loc) : PresumedLoc(),
236                    Record, TokSize);
237   }
238 
239   /// \brief Add CharSourceRange information the specified record.
240   void AddCharSourceRangeToRecord(CharSourceRange R, RecordDataImpl &Record,
241                                   const SourceManager &SM);
242 
243   /// \brief Language options, which can differ from one clone of this client
244   /// to another.
245   const LangOptions *LangOpts;
246 
247   /// \brief Whether this is the original instance (rather than one of its
248   /// clones), responsible for writing the file at the end.
249   bool OriginalInstance;
250 
251   /// \brief Whether this instance should aggregate diagnostics that are
252   /// generated from child processes.
253   bool MergeChildRecords;
254 
255   /// \brief State that is shared among the various clones of this diagnostic
256   /// consumer.
257   struct SharedState : RefCountedBase<SharedState> {
SharedState__anon5ded11a90111::SDiagsWriter::SharedState258     SharedState(StringRef File, DiagnosticOptions *Diags)
259         : DiagOpts(Diags), Stream(Buffer), OutputFile(File.str()),
260           EmittedAnyDiagBlocks(false) {}
261 
262     /// \brief Diagnostic options.
263     IntrusiveRefCntPtr<DiagnosticOptions> DiagOpts;
264 
265     /// \brief The byte buffer for the serialized content.
266     SmallString<1024> Buffer;
267 
268     /// \brief The BitStreamWriter for the serialized diagnostics.
269     llvm::BitstreamWriter Stream;
270 
271     /// \brief The name of the diagnostics file.
272     std::string OutputFile;
273 
274     /// \brief The set of constructed record abbreviations.
275     AbbreviationMap Abbrevs;
276 
277     /// \brief A utility buffer for constructing record content.
278     RecordData Record;
279 
280     /// \brief A text buffer for rendering diagnostic text.
281     SmallString<256> diagBuf;
282 
283     /// \brief The collection of diagnostic categories used.
284     llvm::DenseSet<unsigned> Categories;
285 
286     /// \brief The collection of files used.
287     llvm::DenseMap<const char *, unsigned> Files;
288 
289     typedef llvm::DenseMap<const void *, std::pair<unsigned, StringRef> >
290     DiagFlagsTy;
291 
292     /// \brief Map for uniquing strings.
293     DiagFlagsTy DiagFlags;
294 
295     /// \brief Whether we have already started emission of any DIAG blocks. Once
296     /// this becomes \c true, we never close a DIAG block until we know that we're
297     /// starting another one or we're done.
298     bool EmittedAnyDiagBlocks;
299 
300     /// \brief Engine for emitting diagnostics about the diagnostics.
301     std::unique_ptr<DiagnosticsEngine> MetaDiagnostics;
302   };
303 
304   /// \brief State shared among the various clones of this diagnostic consumer.
305   IntrusiveRefCntPtr<SharedState> State;
306 };
307 } // end anonymous namespace
308 
309 namespace clang {
310 namespace serialized_diags {
311 std::unique_ptr<DiagnosticConsumer>
create(StringRef OutputFile,DiagnosticOptions * Diags,bool MergeChildRecords)312 create(StringRef OutputFile, DiagnosticOptions *Diags, bool MergeChildRecords) {
313   return llvm::make_unique<SDiagsWriter>(OutputFile, Diags, MergeChildRecords);
314 }
315 
316 } // end namespace serialized_diags
317 } // end namespace clang
318 
319 //===----------------------------------------------------------------------===//
320 // Serialization methods.
321 //===----------------------------------------------------------------------===//
322 
323 /// \brief Emits a block ID in the BLOCKINFO block.
EmitBlockID(unsigned ID,const char * Name,llvm::BitstreamWriter & Stream,RecordDataImpl & Record)324 static void EmitBlockID(unsigned ID, const char *Name,
325                         llvm::BitstreamWriter &Stream,
326                         RecordDataImpl &Record) {
327   Record.clear();
328   Record.push_back(ID);
329   Stream.EmitRecord(llvm::bitc::BLOCKINFO_CODE_SETBID, Record);
330 
331   // Emit the block name if present.
332   if (!Name || Name[0] == 0)
333     return;
334 
335   Record.clear();
336 
337   while (*Name)
338     Record.push_back(*Name++);
339 
340   Stream.EmitRecord(llvm::bitc::BLOCKINFO_CODE_BLOCKNAME, Record);
341 }
342 
343 /// \brief Emits a record ID in the BLOCKINFO block.
EmitRecordID(unsigned ID,const char * Name,llvm::BitstreamWriter & Stream,RecordDataImpl & Record)344 static void EmitRecordID(unsigned ID, const char *Name,
345                          llvm::BitstreamWriter &Stream,
346                          RecordDataImpl &Record){
347   Record.clear();
348   Record.push_back(ID);
349 
350   while (*Name)
351     Record.push_back(*Name++);
352 
353   Stream.EmitRecord(llvm::bitc::BLOCKINFO_CODE_SETRECORDNAME, Record);
354 }
355 
AddLocToRecord(SourceLocation Loc,const SourceManager * SM,PresumedLoc PLoc,RecordDataImpl & Record,unsigned TokSize)356 void SDiagsWriter::AddLocToRecord(SourceLocation Loc,
357                                   const SourceManager *SM,
358                                   PresumedLoc PLoc,
359                                   RecordDataImpl &Record,
360                                   unsigned TokSize) {
361   if (PLoc.isInvalid()) {
362     // Emit a "sentinel" location.
363     Record.push_back((unsigned)0); // File.
364     Record.push_back((unsigned)0); // Line.
365     Record.push_back((unsigned)0); // Column.
366     Record.push_back((unsigned)0); // Offset.
367     return;
368   }
369 
370   Record.push_back(getEmitFile(PLoc.getFilename()));
371   Record.push_back(PLoc.getLine());
372   Record.push_back(PLoc.getColumn()+TokSize);
373   Record.push_back(SM->getFileOffset(Loc));
374 }
375 
AddCharSourceRangeToRecord(CharSourceRange Range,RecordDataImpl & Record,const SourceManager & SM)376 void SDiagsWriter::AddCharSourceRangeToRecord(CharSourceRange Range,
377                                               RecordDataImpl &Record,
378                                               const SourceManager &SM) {
379   AddLocToRecord(Range.getBegin(), Record, &SM);
380   unsigned TokSize = 0;
381   if (Range.isTokenRange())
382     TokSize = Lexer::MeasureTokenLength(Range.getEnd(),
383                                         SM, *LangOpts);
384 
385   AddLocToRecord(Range.getEnd(), Record, &SM, TokSize);
386 }
387 
getEmitFile(const char * FileName)388 unsigned SDiagsWriter::getEmitFile(const char *FileName){
389   if (!FileName)
390     return 0;
391 
392   unsigned &entry = State->Files[FileName];
393   if (entry)
394     return entry;
395 
396   // Lazily generate the record for the file.
397   entry = State->Files.size();
398   StringRef Name(FileName);
399   RecordData::value_type Record[] = {RECORD_FILENAME, entry, 0 /* For legacy */,
400                                      0 /* For legacy */, Name.size()};
401   State->Stream.EmitRecordWithBlob(State->Abbrevs.get(RECORD_FILENAME), Record,
402                                    Name);
403 
404   return entry;
405 }
406 
EmitCharSourceRange(CharSourceRange R,const SourceManager & SM)407 void SDiagsWriter::EmitCharSourceRange(CharSourceRange R,
408                                        const SourceManager &SM) {
409   State->Record.clear();
410   State->Record.push_back(RECORD_SOURCE_RANGE);
411   AddCharSourceRangeToRecord(R, State->Record, SM);
412   State->Stream.EmitRecordWithAbbrev(State->Abbrevs.get(RECORD_SOURCE_RANGE),
413                                      State->Record);
414 }
415 
416 /// \brief Emits the preamble of the diagnostics file.
EmitPreamble()417 void SDiagsWriter::EmitPreamble() {
418   // Emit the file header.
419   State->Stream.Emit((unsigned)'D', 8);
420   State->Stream.Emit((unsigned)'I', 8);
421   State->Stream.Emit((unsigned)'A', 8);
422   State->Stream.Emit((unsigned)'G', 8);
423 
424   EmitBlockInfoBlock();
425   EmitMetaBlock();
426 }
427 
AddSourceLocationAbbrev(llvm::BitCodeAbbrev * Abbrev)428 static void AddSourceLocationAbbrev(llvm::BitCodeAbbrev *Abbrev) {
429   using namespace llvm;
430   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Fixed, 10)); // File ID.
431   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Fixed, 32)); // Line.
432   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Fixed, 32)); // Column.
433   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Fixed, 32)); // Offset;
434 }
435 
AddRangeLocationAbbrev(llvm::BitCodeAbbrev * Abbrev)436 static void AddRangeLocationAbbrev(llvm::BitCodeAbbrev *Abbrev) {
437   AddSourceLocationAbbrev(Abbrev);
438   AddSourceLocationAbbrev(Abbrev);
439 }
440 
EmitBlockInfoBlock()441 void SDiagsWriter::EmitBlockInfoBlock() {
442   State->Stream.EnterBlockInfoBlock(3);
443 
444   using namespace llvm;
445   llvm::BitstreamWriter &Stream = State->Stream;
446   RecordData &Record = State->Record;
447   AbbreviationMap &Abbrevs = State->Abbrevs;
448 
449   // ==---------------------------------------------------------------------==//
450   // The subsequent records and Abbrevs are for the "Meta" block.
451   // ==---------------------------------------------------------------------==//
452 
453   EmitBlockID(BLOCK_META, "Meta", Stream, Record);
454   EmitRecordID(RECORD_VERSION, "Version", Stream, Record);
455   BitCodeAbbrev *Abbrev = new BitCodeAbbrev();
456   Abbrev->Add(BitCodeAbbrevOp(RECORD_VERSION));
457   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Fixed, 32));
458   Abbrevs.set(RECORD_VERSION, Stream.EmitBlockInfoAbbrev(BLOCK_META, Abbrev));
459 
460   // ==---------------------------------------------------------------------==//
461   // The subsequent records and Abbrevs are for the "Diagnostic" block.
462   // ==---------------------------------------------------------------------==//
463 
464   EmitBlockID(BLOCK_DIAG, "Diag", Stream, Record);
465   EmitRecordID(RECORD_DIAG, "DiagInfo", Stream, Record);
466   EmitRecordID(RECORD_SOURCE_RANGE, "SrcRange", Stream, Record);
467   EmitRecordID(RECORD_CATEGORY, "CatName", Stream, Record);
468   EmitRecordID(RECORD_DIAG_FLAG, "DiagFlag", Stream, Record);
469   EmitRecordID(RECORD_FILENAME, "FileName", Stream, Record);
470   EmitRecordID(RECORD_FIXIT, "FixIt", Stream, Record);
471 
472   // Emit abbreviation for RECORD_DIAG.
473   Abbrev = new BitCodeAbbrev();
474   Abbrev->Add(BitCodeAbbrevOp(RECORD_DIAG));
475   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Fixed, 3));  // Diag level.
476   AddSourceLocationAbbrev(Abbrev);
477   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Fixed, 10)); // Category.
478   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Fixed, 10)); // Mapped Diag ID.
479   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::VBR, 16)); // Text size.
480   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Blob)); // Diagnostc text.
481   Abbrevs.set(RECORD_DIAG, Stream.EmitBlockInfoAbbrev(BLOCK_DIAG, Abbrev));
482 
483   // Emit abbrevation for RECORD_CATEGORY.
484   Abbrev = new BitCodeAbbrev();
485   Abbrev->Add(BitCodeAbbrevOp(RECORD_CATEGORY));
486   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Fixed, 16)); // Category ID.
487   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Fixed, 8));  // Text size.
488   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Blob));      // Category text.
489   Abbrevs.set(RECORD_CATEGORY, Stream.EmitBlockInfoAbbrev(BLOCK_DIAG, Abbrev));
490 
491   // Emit abbrevation for RECORD_SOURCE_RANGE.
492   Abbrev = new BitCodeAbbrev();
493   Abbrev->Add(BitCodeAbbrevOp(RECORD_SOURCE_RANGE));
494   AddRangeLocationAbbrev(Abbrev);
495   Abbrevs.set(RECORD_SOURCE_RANGE,
496               Stream.EmitBlockInfoAbbrev(BLOCK_DIAG, Abbrev));
497 
498   // Emit the abbreviation for RECORD_DIAG_FLAG.
499   Abbrev = new BitCodeAbbrev();
500   Abbrev->Add(BitCodeAbbrevOp(RECORD_DIAG_FLAG));
501   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Fixed, 10)); // Mapped Diag ID.
502   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Fixed, 16)); // Text size.
503   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Blob)); // Flag name text.
504   Abbrevs.set(RECORD_DIAG_FLAG, Stream.EmitBlockInfoAbbrev(BLOCK_DIAG,
505                                                            Abbrev));
506 
507   // Emit the abbreviation for RECORD_FILENAME.
508   Abbrev = new BitCodeAbbrev();
509   Abbrev->Add(BitCodeAbbrevOp(RECORD_FILENAME));
510   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Fixed, 10)); // Mapped file ID.
511   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Fixed, 32)); // Size.
512   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Fixed, 32)); // Modifcation time.
513   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Fixed, 16)); // Text size.
514   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Blob)); // File name text.
515   Abbrevs.set(RECORD_FILENAME, Stream.EmitBlockInfoAbbrev(BLOCK_DIAG,
516                                                           Abbrev));
517 
518   // Emit the abbreviation for RECORD_FIXIT.
519   Abbrev = new BitCodeAbbrev();
520   Abbrev->Add(BitCodeAbbrevOp(RECORD_FIXIT));
521   AddRangeLocationAbbrev(Abbrev);
522   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Fixed, 16)); // Text size.
523   Abbrev->Add(BitCodeAbbrevOp(BitCodeAbbrevOp::Blob));      // FixIt text.
524   Abbrevs.set(RECORD_FIXIT, Stream.EmitBlockInfoAbbrev(BLOCK_DIAG,
525                                                        Abbrev));
526 
527   Stream.ExitBlock();
528 }
529 
EmitMetaBlock()530 void SDiagsWriter::EmitMetaBlock() {
531   llvm::BitstreamWriter &Stream = State->Stream;
532   AbbreviationMap &Abbrevs = State->Abbrevs;
533 
534   Stream.EnterSubblock(BLOCK_META, 3);
535   RecordData::value_type Record[] = {RECORD_VERSION, VersionNumber};
536   Stream.EmitRecordWithAbbrev(Abbrevs.get(RECORD_VERSION), Record);
537   Stream.ExitBlock();
538 }
539 
getEmitCategory(unsigned int category)540 unsigned SDiagsWriter::getEmitCategory(unsigned int category) {
541   if (!State->Categories.insert(category).second)
542     return category;
543 
544   // We use a local version of 'Record' so that we can be generating
545   // another record when we lazily generate one for the category entry.
546   StringRef catName = DiagnosticIDs::getCategoryNameFromID(category);
547   RecordData::value_type Record[] = {RECORD_CATEGORY, category, catName.size()};
548   State->Stream.EmitRecordWithBlob(State->Abbrevs.get(RECORD_CATEGORY), Record,
549                                    catName);
550 
551   return category;
552 }
553 
getEmitDiagnosticFlag(DiagnosticsEngine::Level DiagLevel,unsigned DiagID)554 unsigned SDiagsWriter::getEmitDiagnosticFlag(DiagnosticsEngine::Level DiagLevel,
555                                              unsigned DiagID) {
556   if (DiagLevel == DiagnosticsEngine::Note)
557     return 0; // No flag for notes.
558 
559   StringRef FlagName = DiagnosticIDs::getWarningOptionForDiag(DiagID);
560   return getEmitDiagnosticFlag(FlagName);
561 }
562 
getEmitDiagnosticFlag(StringRef FlagName)563 unsigned SDiagsWriter::getEmitDiagnosticFlag(StringRef FlagName) {
564   if (FlagName.empty())
565     return 0;
566 
567   // Here we assume that FlagName points to static data whose pointer
568   // value is fixed.  This allows us to unique by diagnostic groups.
569   const void *data = FlagName.data();
570   std::pair<unsigned, StringRef> &entry = State->DiagFlags[data];
571   if (entry.first == 0) {
572     entry.first = State->DiagFlags.size();
573     entry.second = FlagName;
574 
575     // Lazily emit the string in a separate record.
576     RecordData::value_type Record[] = {RECORD_DIAG_FLAG, entry.first,
577                                        FlagName.size()};
578     State->Stream.EmitRecordWithBlob(State->Abbrevs.get(RECORD_DIAG_FLAG),
579                                      Record, FlagName);
580   }
581 
582   return entry.first;
583 }
584 
HandleDiagnostic(DiagnosticsEngine::Level DiagLevel,const Diagnostic & Info)585 void SDiagsWriter::HandleDiagnostic(DiagnosticsEngine::Level DiagLevel,
586                                     const Diagnostic &Info) {
587   // Enter the block for a non-note diagnostic immediately, rather than waiting
588   // for beginDiagnostic, in case associated notes are emitted before we get
589   // there.
590   if (DiagLevel != DiagnosticsEngine::Note) {
591     if (State->EmittedAnyDiagBlocks)
592       ExitDiagBlock();
593 
594     EnterDiagBlock();
595     State->EmittedAnyDiagBlocks = true;
596   }
597 
598   // Compute the diagnostic text.
599   State->diagBuf.clear();
600   Info.FormatDiagnostic(State->diagBuf);
601 
602   if (Info.getLocation().isInvalid()) {
603     // Special-case diagnostics with no location. We may not have entered a
604     // source file in this case, so we can't use the normal DiagnosticsRenderer
605     // machinery.
606 
607     // Make sure we bracket all notes as "sub-diagnostics".  This matches
608     // the behavior in SDiagsRenderer::emitDiagnostic().
609     if (DiagLevel == DiagnosticsEngine::Note)
610       EnterDiagBlock();
611 
612     EmitDiagnosticMessage(SourceLocation(), PresumedLoc(), DiagLevel,
613                           State->diagBuf, nullptr, &Info);
614 
615     if (DiagLevel == DiagnosticsEngine::Note)
616       ExitDiagBlock();
617 
618     return;
619   }
620 
621   assert(Info.hasSourceManager() && LangOpts &&
622          "Unexpected diagnostic with valid location outside of a source file");
623   SDiagsRenderer Renderer(*this, *LangOpts, &*State->DiagOpts);
624   Renderer.emitDiagnostic(Info.getLocation(), DiagLevel,
625                           State->diagBuf,
626                           Info.getRanges(),
627                           Info.getFixItHints(),
628                           &Info.getSourceManager(),
629                           &Info);
630 }
631 
getStableLevel(DiagnosticsEngine::Level Level)632 static serialized_diags::Level getStableLevel(DiagnosticsEngine::Level Level) {
633   switch (Level) {
634 #define CASE(X) case DiagnosticsEngine::X: return serialized_diags::X;
635   CASE(Ignored)
636   CASE(Note)
637   CASE(Remark)
638   CASE(Warning)
639   CASE(Error)
640   CASE(Fatal)
641 #undef CASE
642   }
643 
644   llvm_unreachable("invalid diagnostic level");
645 }
646 
EmitDiagnosticMessage(SourceLocation Loc,PresumedLoc PLoc,DiagnosticsEngine::Level Level,StringRef Message,const SourceManager * SM,DiagOrStoredDiag D)647 void SDiagsWriter::EmitDiagnosticMessage(SourceLocation Loc,
648                                          PresumedLoc PLoc,
649                                          DiagnosticsEngine::Level Level,
650                                          StringRef Message,
651                                          const SourceManager *SM,
652                                          DiagOrStoredDiag D) {
653   llvm::BitstreamWriter &Stream = State->Stream;
654   RecordData &Record = State->Record;
655   AbbreviationMap &Abbrevs = State->Abbrevs;
656 
657   // Emit the RECORD_DIAG record.
658   Record.clear();
659   Record.push_back(RECORD_DIAG);
660   Record.push_back(getStableLevel(Level));
661   AddLocToRecord(Loc, SM, PLoc, Record);
662 
663   if (const Diagnostic *Info = D.dyn_cast<const Diagnostic*>()) {
664     // Emit the category string lazily and get the category ID.
665     unsigned DiagID = DiagnosticIDs::getCategoryNumberForDiag(Info->getID());
666     Record.push_back(getEmitCategory(DiagID));
667     // Emit the diagnostic flag string lazily and get the mapped ID.
668     Record.push_back(getEmitDiagnosticFlag(Level, Info->getID()));
669   } else {
670     Record.push_back(getEmitCategory());
671     Record.push_back(getEmitDiagnosticFlag(Level));
672   }
673 
674   Record.push_back(Message.size());
675   Stream.EmitRecordWithBlob(Abbrevs.get(RECORD_DIAG), Record, Message);
676 }
677 
678 void
emitDiagnosticMessage(SourceLocation Loc,PresumedLoc PLoc,DiagnosticsEngine::Level Level,StringRef Message,ArrayRef<clang::CharSourceRange> Ranges,const SourceManager * SM,DiagOrStoredDiag D)679 SDiagsRenderer::emitDiagnosticMessage(SourceLocation Loc,
680                                       PresumedLoc PLoc,
681                                       DiagnosticsEngine::Level Level,
682                                       StringRef Message,
683                                       ArrayRef<clang::CharSourceRange> Ranges,
684                                       const SourceManager *SM,
685                                       DiagOrStoredDiag D) {
686   Writer.EmitDiagnosticMessage(Loc, PLoc, Level, Message, SM, D);
687 }
688 
EnterDiagBlock()689 void SDiagsWriter::EnterDiagBlock() {
690   State->Stream.EnterSubblock(BLOCK_DIAG, 4);
691 }
692 
ExitDiagBlock()693 void SDiagsWriter::ExitDiagBlock() {
694   State->Stream.ExitBlock();
695 }
696 
beginDiagnostic(DiagOrStoredDiag D,DiagnosticsEngine::Level Level)697 void SDiagsRenderer::beginDiagnostic(DiagOrStoredDiag D,
698                                      DiagnosticsEngine::Level Level) {
699   if (Level == DiagnosticsEngine::Note)
700     Writer.EnterDiagBlock();
701 }
702 
endDiagnostic(DiagOrStoredDiag D,DiagnosticsEngine::Level Level)703 void SDiagsRenderer::endDiagnostic(DiagOrStoredDiag D,
704                                    DiagnosticsEngine::Level Level) {
705   // Only end note diagnostics here, because we can't be sure when we've seen
706   // the last note associated with a non-note diagnostic.
707   if (Level == DiagnosticsEngine::Note)
708     Writer.ExitDiagBlock();
709 }
710 
EmitCodeContext(SmallVectorImpl<CharSourceRange> & Ranges,ArrayRef<FixItHint> Hints,const SourceManager & SM)711 void SDiagsWriter::EmitCodeContext(SmallVectorImpl<CharSourceRange> &Ranges,
712                                    ArrayRef<FixItHint> Hints,
713                                    const SourceManager &SM) {
714   llvm::BitstreamWriter &Stream = State->Stream;
715   RecordData &Record = State->Record;
716   AbbreviationMap &Abbrevs = State->Abbrevs;
717 
718   // Emit Source Ranges.
719   for (ArrayRef<CharSourceRange>::iterator I = Ranges.begin(), E = Ranges.end();
720        I != E; ++I)
721     if (I->isValid())
722       EmitCharSourceRange(*I, SM);
723 
724   // Emit FixIts.
725   for (ArrayRef<FixItHint>::iterator I = Hints.begin(), E = Hints.end();
726        I != E; ++I) {
727     const FixItHint &Fix = *I;
728     if (Fix.isNull())
729       continue;
730     Record.clear();
731     Record.push_back(RECORD_FIXIT);
732     AddCharSourceRangeToRecord(Fix.RemoveRange, Record, SM);
733     Record.push_back(Fix.CodeToInsert.size());
734     Stream.EmitRecordWithBlob(Abbrevs.get(RECORD_FIXIT), Record,
735                               Fix.CodeToInsert);
736   }
737 }
738 
emitCodeContext(SourceLocation Loc,DiagnosticsEngine::Level Level,SmallVectorImpl<CharSourceRange> & Ranges,ArrayRef<FixItHint> Hints,const SourceManager & SM)739 void SDiagsRenderer::emitCodeContext(SourceLocation Loc,
740                                      DiagnosticsEngine::Level Level,
741                                      SmallVectorImpl<CharSourceRange> &Ranges,
742                                      ArrayRef<FixItHint> Hints,
743                                      const SourceManager &SM) {
744   Writer.EmitCodeContext(Ranges, Hints, SM);
745 }
746 
emitNote(SourceLocation Loc,StringRef Message,const SourceManager * SM)747 void SDiagsRenderer::emitNote(SourceLocation Loc, StringRef Message,
748                               const SourceManager *SM) {
749   Writer.EnterDiagBlock();
750   PresumedLoc PLoc = SM ? SM->getPresumedLoc(Loc) : PresumedLoc();
751   Writer.EmitDiagnosticMessage(Loc, PLoc, DiagnosticsEngine::Note,
752                                Message, SM, DiagOrStoredDiag());
753   Writer.ExitDiagBlock();
754 }
755 
getMetaDiags()756 DiagnosticsEngine *SDiagsWriter::getMetaDiags() {
757   // FIXME: It's slightly absurd to create a new diagnostics engine here, but
758   // the other options that are available today are worse:
759   //
760   // 1. Teach DiagnosticsConsumers to emit diagnostics to the engine they are a
761   //    part of. The DiagnosticsEngine would need to know not to send
762   //    diagnostics back to the consumer that failed. This would require us to
763   //    rework ChainedDiagnosticsConsumer and teach the engine about multiple
764   //    consumers, which is difficult today because most APIs interface with
765   //    consumers rather than the engine itself.
766   //
767   // 2. Pass a DiagnosticsEngine to SDiagsWriter on creation - this would need
768   //    to be distinct from the engine the writer was being added to and would
769   //    normally not be used.
770   if (!State->MetaDiagnostics) {
771     IntrusiveRefCntPtr<DiagnosticIDs> IDs(new DiagnosticIDs());
772     auto Client =
773         new TextDiagnosticPrinter(llvm::errs(), State->DiagOpts.get());
774     State->MetaDiagnostics = llvm::make_unique<DiagnosticsEngine>(
775         IDs, State->DiagOpts.get(), Client);
776   }
777   return State->MetaDiagnostics.get();
778 }
779 
RemoveOldDiagnostics()780 void SDiagsWriter::RemoveOldDiagnostics() {
781   if (!llvm::sys::fs::remove(State->OutputFile))
782     return;
783 
784   getMetaDiags()->Report(diag::warn_fe_serialized_diag_merge_failure);
785   // Disable merging child records, as whatever is in this file may be
786   // misleading.
787   MergeChildRecords = false;
788 }
789 
finish()790 void SDiagsWriter::finish() {
791   // The original instance is responsible for writing the file.
792   if (!OriginalInstance)
793     return;
794 
795   // Finish off any diagnostic we were in the process of emitting.
796   if (State->EmittedAnyDiagBlocks)
797     ExitDiagBlock();
798 
799   if (MergeChildRecords) {
800     if (!State->EmittedAnyDiagBlocks)
801       // We have no diagnostics of our own, so we can just leave the child
802       // process' output alone
803       return;
804 
805     if (llvm::sys::fs::exists(State->OutputFile))
806       if (SDiagsMerger(*this).mergeRecordsFromFile(State->OutputFile.c_str()))
807         getMetaDiags()->Report(diag::warn_fe_serialized_diag_merge_failure);
808   }
809 
810   std::error_code EC;
811   auto OS = llvm::make_unique<llvm::raw_fd_ostream>(State->OutputFile.c_str(),
812                                                     EC, llvm::sys::fs::F_None);
813   if (EC) {
814     getMetaDiags()->Report(diag::warn_fe_serialized_diag_failure)
815         << State->OutputFile << EC.message();
816     return;
817   }
818 
819   // Write the generated bitstream to "Out".
820   OS->write((char *)&State->Buffer.front(), State->Buffer.size());
821   OS->flush();
822 }
823 
visitStartOfDiagnostic()824 std::error_code SDiagsMerger::visitStartOfDiagnostic() {
825   Writer.EnterDiagBlock();
826   return std::error_code();
827 }
828 
visitEndOfDiagnostic()829 std::error_code SDiagsMerger::visitEndOfDiagnostic() {
830   Writer.ExitDiagBlock();
831   return std::error_code();
832 }
833 
834 std::error_code
visitSourceRangeRecord(const serialized_diags::Location & Start,const serialized_diags::Location & End)835 SDiagsMerger::visitSourceRangeRecord(const serialized_diags::Location &Start,
836                                      const serialized_diags::Location &End) {
837   RecordData::value_type Record[] = {
838       RECORD_SOURCE_RANGE, FileLookup[Start.FileID], Start.Line, Start.Col,
839       Start.Offset, FileLookup[End.FileID], End.Line, End.Col, End.Offset};
840   Writer.State->Stream.EmitRecordWithAbbrev(
841       Writer.State->Abbrevs.get(RECORD_SOURCE_RANGE), Record);
842   return std::error_code();
843 }
844 
visitDiagnosticRecord(unsigned Severity,const serialized_diags::Location & Location,unsigned Category,unsigned Flag,StringRef Message)845 std::error_code SDiagsMerger::visitDiagnosticRecord(
846     unsigned Severity, const serialized_diags::Location &Location,
847     unsigned Category, unsigned Flag, StringRef Message) {
848   RecordData::value_type Record[] = {
849       RECORD_DIAG, Severity, FileLookup[Location.FileID], Location.Line,
850       Location.Col, Location.Offset, CategoryLookup[Category],
851       Flag ? DiagFlagLookup[Flag] : 0, Message.size()};
852 
853   Writer.State->Stream.EmitRecordWithBlob(
854       Writer.State->Abbrevs.get(RECORD_DIAG), Record, Message);
855   return std::error_code();
856 }
857 
858 std::error_code
visitFixitRecord(const serialized_diags::Location & Start,const serialized_diags::Location & End,StringRef Text)859 SDiagsMerger::visitFixitRecord(const serialized_diags::Location &Start,
860                                const serialized_diags::Location &End,
861                                StringRef Text) {
862   RecordData::value_type Record[] = {RECORD_FIXIT, FileLookup[Start.FileID],
863                                      Start.Line, Start.Col, Start.Offset,
864                                      FileLookup[End.FileID], End.Line, End.Col,
865                                      End.Offset, Text.size()};
866 
867   Writer.State->Stream.EmitRecordWithBlob(
868       Writer.State->Abbrevs.get(RECORD_FIXIT), Record, Text);
869   return std::error_code();
870 }
871 
visitFilenameRecord(unsigned ID,unsigned Size,unsigned Timestamp,StringRef Name)872 std::error_code SDiagsMerger::visitFilenameRecord(unsigned ID, unsigned Size,
873                                                   unsigned Timestamp,
874                                                   StringRef Name) {
875   FileLookup[ID] = Writer.getEmitFile(Name.str().c_str());
876   return std::error_code();
877 }
878 
visitCategoryRecord(unsigned ID,StringRef Name)879 std::error_code SDiagsMerger::visitCategoryRecord(unsigned ID, StringRef Name) {
880   CategoryLookup[ID] = Writer.getEmitCategory(ID);
881   return std::error_code();
882 }
883 
visitDiagFlagRecord(unsigned ID,StringRef Name)884 std::error_code SDiagsMerger::visitDiagFlagRecord(unsigned ID, StringRef Name) {
885   DiagFlagLookup[ID] = Writer.getEmitDiagnosticFlag(Name);
886   return std::error_code();
887 }
888