clang  14.0.0git
ARCMT.cpp
Go to the documentation of this file.
1 //===--- ARCMT.cpp - Migration to ARC mode --------------------------------===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 
9 #include "Internals.h"
10 #include "clang/ARCMigrate/ARCMT.h"
11 #include "clang/AST/ASTConsumer.h"
13 #include "clang/Frontend/ASTUnit.h"
17 #include "clang/Frontend/Utils.h"
18 #include "clang/Lex/Preprocessor.h"
23 #include "llvm/ADT/Triple.h"
24 #include "llvm/Support/MemoryBuffer.h"
25 #include <utility>
26 using namespace clang;
27 using namespace arcmt;
28 
31  if (range.isInvalid())
32  return false;
33 
34  bool cleared = false;
35  ListTy::iterator I = List.begin();
36  while (I != List.end()) {
37  FullSourceLoc diagLoc = I->getLocation();
38  if ((IDs.empty() || // empty means clear all diagnostics in the range.
39  llvm::is_contained(IDs, I->getID())) &&
40  !diagLoc.isBeforeInTranslationUnitThan(range.getBegin()) &&
41  (diagLoc == range.getEnd() ||
42  diagLoc.isBeforeInTranslationUnitThan(range.getEnd()))) {
43  cleared = true;
44  ListTy::iterator eraseS = I++;
45  if (eraseS->getLevel() != DiagnosticsEngine::Note)
46  while (I != List.end() && I->getLevel() == DiagnosticsEngine::Note)
47  ++I;
48  // Clear the diagnostic and any notes following it.
49  I = List.erase(eraseS, I);
50  continue;
51  }
52 
53  ++I;
54  }
55 
56  return cleared;
57 }
58 
60  SourceRange range) const {
61  if (range.isInvalid())
62  return false;
63 
64  ListTy::const_iterator I = List.begin();
65  while (I != List.end()) {
66  FullSourceLoc diagLoc = I->getLocation();
67  if ((IDs.empty() || // empty means any diagnostic in the range.
68  llvm::is_contained(IDs, I->getID())) &&
69  !diagLoc.isBeforeInTranslationUnitThan(range.getBegin()) &&
70  (diagLoc == range.getEnd() ||
71  diagLoc.isBeforeInTranslationUnitThan(range.getEnd()))) {
72  return true;
73  }
74 
75  ++I;
76  }
77 
78  return false;
79 }
80 
82  for (ListTy::const_iterator I = List.begin(), E = List.end(); I != E; ++I)
83  Diags.Report(*I);
84 }
85 
87  for (ListTy::const_iterator I = List.begin(), E = List.end(); I != E; ++I)
88  if (I->getLevel() >= DiagnosticsEngine::Error)
89  return true;
90 
91  return false;
92 }
93 
94 namespace {
95 
96 class CaptureDiagnosticConsumer : public DiagnosticConsumer {
97  DiagnosticsEngine &Diags;
98  DiagnosticConsumer &DiagClient;
99  CapturedDiagList &CapturedDiags;
100  bool HasBegunSourceFile;
101 public:
102  CaptureDiagnosticConsumer(DiagnosticsEngine &diags,
103  DiagnosticConsumer &client,
104  CapturedDiagList &capturedDiags)
105  : Diags(diags), DiagClient(client), CapturedDiags(capturedDiags),
106  HasBegunSourceFile(false) { }
107 
108  void BeginSourceFile(const LangOptions &Opts,
109  const Preprocessor *PP) override {
110  // Pass BeginSourceFile message onto DiagClient on first call.
111  // The corresponding EndSourceFile call will be made from an
112  // explicit call to FinishCapture.
113  if (!HasBegunSourceFile) {
114  DiagClient.BeginSourceFile(Opts, PP);
115  HasBegunSourceFile = true;
116  }
117  }
118 
119  void FinishCapture() {
120  // Call EndSourceFile on DiagClient on completion of capture to
121  // enable VerifyDiagnosticConsumer to check diagnostics *after*
122  // it has received the diagnostic list.
123  if (HasBegunSourceFile) {
124  DiagClient.EndSourceFile();
125  HasBegunSourceFile = false;
126  }
127  }
128 
129  ~CaptureDiagnosticConsumer() override {
130  assert(!HasBegunSourceFile && "FinishCapture not called!");
131  }
132 
133  void HandleDiagnostic(DiagnosticsEngine::Level level,
134  const Diagnostic &Info) override {
136  level >= DiagnosticsEngine::Error || level == DiagnosticsEngine::Note) {
137  if (Info.getLocation().isValid())
138  CapturedDiags.push_back(StoredDiagnostic(level, Info));
139  return;
140  }
141 
142  // Non-ARC warnings are ignored.
143  Diags.setLastDiagnosticIgnored(true);
144  }
145 };
146 
147 } // end anonymous namespace
148 
149 static bool HasARCRuntime(CompilerInvocation &origCI) {
150  // This duplicates some functionality from Darwin::AddDeploymentTarget
151  // but this function is well defined, so keep it decoupled from the driver
152  // and avoid unrelated complications.
153  llvm::Triple triple(origCI.getTargetOpts().Triple);
154 
155  if (triple.isiOS())
156  return triple.getOSMajorVersion() >= 5;
157 
158  if (triple.isWatchOS())
159  return true;
160 
161  if (triple.getOS() == llvm::Triple::Darwin)
162  return triple.getOSMajorVersion() >= 11;
163 
164  if (triple.getOS() == llvm::Triple::MacOSX) {
165  unsigned Major, Minor, Micro;
166  triple.getOSVersion(Major, Minor, Micro);
167  return Major > 10 || (Major == 10 && Minor >= 7);
168  }
169 
170  return false;
171 }
172 
173 static CompilerInvocation *
175  const PCHContainerReader &PCHContainerRdr) {
176  std::unique_ptr<CompilerInvocation> CInvok;
177  CInvok.reset(new CompilerInvocation(origCI));
178  PreprocessorOptions &PPOpts = CInvok->getPreprocessorOpts();
179  if (!PPOpts.ImplicitPCHInclude.empty()) {
180  // We can't use a PCH because it was likely built in non-ARC mode and we
181  // want to parse in ARC. Include the original header.
182  FileManager FileMgr(origCI.getFileSystemOpts());
185  new DiagnosticsEngine(DiagID, &origCI.getDiagnosticOpts(),
186  new IgnoringDiagConsumer()));
188  PPOpts.ImplicitPCHInclude, FileMgr, PCHContainerRdr, *Diags);
189  if (!OriginalFile.empty())
190  PPOpts.Includes.insert(PPOpts.Includes.begin(), OriginalFile);
191  PPOpts.ImplicitPCHInclude.clear();
192  }
194  define += '=';
195  CInvok->getPreprocessorOpts().addMacroDef(define);
196  CInvok->getLangOpts()->ObjCAutoRefCount = true;
197  CInvok->getLangOpts()->setGC(LangOptions::NonGC);
198  CInvok->getDiagnosticOpts().ErrorLimit = 0;
199  CInvok->getDiagnosticOpts().PedanticErrors = 0;
200 
201  // Ignore -Werror flags when migrating.
202  std::vector<std::string> WarnOpts;
203  for (std::vector<std::string>::iterator
204  I = CInvok->getDiagnosticOpts().Warnings.begin(),
205  E = CInvok->getDiagnosticOpts().Warnings.end(); I != E; ++I) {
206  if (!StringRef(*I).startswith("error"))
207  WarnOpts.push_back(*I);
208  }
209  WarnOpts.push_back("error=arc-unsafe-retained-assign");
210  CInvok->getDiagnosticOpts().Warnings = std::move(WarnOpts);
211 
212  CInvok->getLangOpts()->ObjCWeakRuntime = HasARCRuntime(origCI);
213  CInvok->getLangOpts()->ObjCWeak = CInvok->getLangOpts()->ObjCWeakRuntime;
214 
215  return CInvok.release();
216 }
217 
218 static void emitPremigrationErrors(const CapturedDiagList &arcDiags,
219  DiagnosticOptions *diagOpts,
220  Preprocessor &PP) {
221  TextDiagnosticPrinter printer(llvm::errs(), diagOpts);
224  new DiagnosticsEngine(DiagID, diagOpts, &printer,
225  /*ShouldOwnClient=*/false));
226  Diags->setSourceManager(&PP.getSourceManager());
227 
228  printer.BeginSourceFile(PP.getLangOpts(), &PP);
229  arcDiags.reportDiagnostics(*Diags);
230  printer.EndSourceFile();
231 }
232 
233 //===----------------------------------------------------------------------===//
234 // checkForManualIssues.
235 //===----------------------------------------------------------------------===//
236 
238  CompilerInvocation &origCI, const FrontendInputFile &Input,
239  std::shared_ptr<PCHContainerOperations> PCHContainerOps,
240  DiagnosticConsumer *DiagClient, bool emitPremigrationARCErrors,
241  StringRef plistOut) {
242  if (!origCI.getLangOpts()->ObjC)
243  return false;
244 
245  LangOptions::GCMode OrigGCMode = origCI.getLangOpts()->getGC();
246  bool NoNSAllocReallocError = origCI.getMigratorOpts().NoNSAllocReallocError;
247  bool NoFinalizeRemoval = origCI.getMigratorOpts().NoFinalizeRemoval;
248 
249  std::vector<TransformFn> transforms = arcmt::getAllTransformations(OrigGCMode,
250  NoFinalizeRemoval);
251  assert(!transforms.empty());
252 
253  std::unique_ptr<CompilerInvocation> CInvok;
254  CInvok.reset(
255  createInvocationForMigration(origCI, PCHContainerOps->getRawReader()));
256  CInvok->getFrontendOpts().Inputs.clear();
257  CInvok->getFrontendOpts().Inputs.push_back(Input);
258 
259  CapturedDiagList capturedDiags;
260 
261  assert(DiagClient);
264  new DiagnosticsEngine(DiagID, &origCI.getDiagnosticOpts(),
265  DiagClient, /*ShouldOwnClient=*/false));
266 
267  // Filter of all diagnostics.
268  CaptureDiagnosticConsumer errRec(*Diags, *DiagClient, capturedDiags);
269  Diags->setClient(&errRec, /*ShouldOwnClient=*/false);
270 
271  std::unique_ptr<ASTUnit> Unit(ASTUnit::LoadFromCompilerInvocationAction(
272  std::move(CInvok), PCHContainerOps, Diags));
273  if (!Unit) {
274  errRec.FinishCapture();
275  return true;
276  }
277 
278  // Don't filter diagnostics anymore.
279  Diags->setClient(DiagClient, /*ShouldOwnClient=*/false);
280 
281  ASTContext &Ctx = Unit->getASTContext();
282 
283  if (Diags->hasFatalErrorOccurred()) {
284  Diags->Reset();
285  DiagClient->BeginSourceFile(Ctx.getLangOpts(), &Unit->getPreprocessor());
286  capturedDiags.reportDiagnostics(*Diags);
287  DiagClient->EndSourceFile();
288  errRec.FinishCapture();
289  return true;
290  }
291 
292  if (emitPremigrationARCErrors)
293  emitPremigrationErrors(capturedDiags, &origCI.getDiagnosticOpts(),
294  Unit->getPreprocessor());
295  if (!plistOut.empty()) {
298  I = capturedDiags.begin(), E = capturedDiags.end(); I != E; ++I)
299  arcDiags.push_back(*I);
300  writeARCDiagsToPlist(std::string(plistOut), arcDiags,
301  Ctx.getSourceManager(), Ctx.getLangOpts());
302  }
303 
304  // After parsing of source files ended, we want to reuse the
305  // diagnostics objects to emit further diagnostics.
306  // We call BeginSourceFile because DiagnosticConsumer requires that
307  // diagnostics with source range information are emitted only in between
308  // BeginSourceFile() and EndSourceFile().
309  DiagClient->BeginSourceFile(Ctx.getLangOpts(), &Unit->getPreprocessor());
310 
311  // No macros will be added since we are just checking and we won't modify
312  // source code.
313  std::vector<SourceLocation> ARCMTMacroLocs;
314 
315  TransformActions testAct(*Diags, capturedDiags, Ctx, Unit->getPreprocessor());
316  MigrationPass pass(Ctx, OrigGCMode, Unit->getSema(), testAct, capturedDiags,
317  ARCMTMacroLocs);
318  pass.setNoFinalizeRemoval(NoFinalizeRemoval);
319  if (!NoNSAllocReallocError)
320  Diags->setSeverity(diag::warn_arcmt_nsalloc_realloc, diag::Severity::Error,
321  SourceLocation());
322 
323  for (unsigned i=0, e = transforms.size(); i != e; ++i)
324  transforms[i](pass);
325 
326  capturedDiags.reportDiagnostics(*Diags);
327 
328  DiagClient->EndSourceFile();
329  errRec.FinishCapture();
330 
331  return capturedDiags.hasErrors() || testAct.hasReportedErrors();
332 }
333 
334 //===----------------------------------------------------------------------===//
335 // applyTransformations.
336 //===----------------------------------------------------------------------===//
337 
338 static bool
340  std::shared_ptr<PCHContainerOperations> PCHContainerOps,
341  DiagnosticConsumer *DiagClient, StringRef outputDir,
342  bool emitPremigrationARCErrors, StringRef plistOut) {
343  if (!origCI.getLangOpts()->ObjC)
344  return false;
345 
346  LangOptions::GCMode OrigGCMode = origCI.getLangOpts()->getGC();
347 
348  // Make sure checking is successful first.
349  CompilerInvocation CInvokForCheck(origCI);
350  if (arcmt::checkForManualIssues(CInvokForCheck, Input, PCHContainerOps,
351  DiagClient, emitPremigrationARCErrors,
352  plistOut))
353  return true;
354 
355  CompilerInvocation CInvok(origCI);
356  CInvok.getFrontendOpts().Inputs.clear();
357  CInvok.getFrontendOpts().Inputs.push_back(Input);
358 
359  MigrationProcess migration(CInvok, PCHContainerOps, DiagClient, outputDir);
360  bool NoFinalizeRemoval = origCI.getMigratorOpts().NoFinalizeRemoval;
361 
362  std::vector<TransformFn> transforms = arcmt::getAllTransformations(OrigGCMode,
363  NoFinalizeRemoval);
364  assert(!transforms.empty());
365 
366  for (unsigned i=0, e = transforms.size(); i != e; ++i) {
367  bool err = migration.applyTransform(transforms[i]);
368  if (err) return true;
369  }
370 
373  new DiagnosticsEngine(DiagID, &origCI.getDiagnosticOpts(),
374  DiagClient, /*ShouldOwnClient=*/false));
375 
376  if (outputDir.empty()) {
377  origCI.getLangOpts()->ObjCAutoRefCount = true;
378  return migration.getRemapper().overwriteOriginal(*Diags);
379  } else {
380  return migration.getRemapper().flushToDisk(outputDir, *Diags);
381  }
382 }
383 
385  CompilerInvocation &origCI, const FrontendInputFile &Input,
386  std::shared_ptr<PCHContainerOperations> PCHContainerOps,
387  DiagnosticConsumer *DiagClient) {
388  return applyTransforms(origCI, Input, PCHContainerOps, DiagClient,
389  StringRef(), false, StringRef());
390 }
391 
393  CompilerInvocation &origCI, const FrontendInputFile &Input,
394  std::shared_ptr<PCHContainerOperations> PCHContainerOps,
395  DiagnosticConsumer *DiagClient, StringRef outputDir,
396  bool emitPremigrationARCErrors, StringRef plistOut) {
397  assert(!outputDir.empty() && "Expected output directory path");
398  return applyTransforms(origCI, Input, PCHContainerOps, DiagClient, outputDir,
399  emitPremigrationARCErrors, plistOut);
400 }
401 
402 bool arcmt::getFileRemappings(std::vector<std::pair<std::string,std::string> > &
403  remap,
404  StringRef outputDir,
405  DiagnosticConsumer *DiagClient) {
406  assert(!outputDir.empty());
407 
410  new DiagnosticsEngine(DiagID, new DiagnosticOptions,
411  DiagClient, /*ShouldOwnClient=*/false));
412 
413  FileRemapper remapper;
414  bool err = remapper.initFromDisk(outputDir, *Diags,
415  /*ignoreIfFilesChanged=*/true);
416  if (err)
417  return true;
418 
419  remapper.forEachMapping(
420  [&](StringRef From, StringRef To) {
421  remap.push_back(std::make_pair(From.str(), To.str()));
422  },
423  [](StringRef, const llvm::MemoryBufferRef &) {});
424 
425  return false;
426 }
427 
428 
429 //===----------------------------------------------------------------------===//
430 // CollectTransformActions.
431 //===----------------------------------------------------------------------===//
432 
433 namespace {
434 
435 class ARCMTMacroTrackerPPCallbacks : public PPCallbacks {
436  std::vector<SourceLocation> &ARCMTMacroLocs;
437 
438 public:
439  ARCMTMacroTrackerPPCallbacks(std::vector<SourceLocation> &ARCMTMacroLocs)
440  : ARCMTMacroLocs(ARCMTMacroLocs) { }
441 
442  void MacroExpands(const Token &MacroNameTok, const MacroDefinition &MD,
443  SourceRange Range, const MacroArgs *Args) override {
444  if (MacroNameTok.getIdentifierInfo()->getName() == getARCMTMacroName())
445  ARCMTMacroLocs.push_back(MacroNameTok.getLocation());
446  }
447 };
448 
449 class ARCMTMacroTrackerAction : public ASTFrontendAction {
450  std::vector<SourceLocation> &ARCMTMacroLocs;
451 
452 public:
453  ARCMTMacroTrackerAction(std::vector<SourceLocation> &ARCMTMacroLocs)
454  : ARCMTMacroLocs(ARCMTMacroLocs) { }
455 
456  std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
457  StringRef InFile) override {
459  std::make_unique<ARCMTMacroTrackerPPCallbacks>(ARCMTMacroLocs));
460  return std::make_unique<ASTConsumer>();
461  }
462 };
463 
464 class RewritesApplicator : public TransformActions::RewriteReceiver {
465  Rewriter &rewriter;
467 
468 public:
469  RewritesApplicator(Rewriter &rewriter, ASTContext &ctx,
471  : rewriter(rewriter), Listener(listener) {
472  if (Listener)
473  Listener->start(ctx);
474  }
475  ~RewritesApplicator() override {
476  if (Listener)
477  Listener->finish();
478  }
479 
480  void insert(SourceLocation loc, StringRef text) override {
481  bool err = rewriter.InsertText(loc, text, /*InsertAfter=*/true,
482  /*indentNewLines=*/true);
483  if (!err && Listener)
484  Listener->insert(loc, text);
485  }
486 
487  void remove(CharSourceRange range) override {
488  Rewriter::RewriteOptions removeOpts;
489  removeOpts.IncludeInsertsAtBeginOfRange = false;
490  removeOpts.IncludeInsertsAtEndOfRange = false;
491  removeOpts.RemoveLineIfEmpty = true;
492 
493  bool err = rewriter.RemoveText(range, removeOpts);
494  if (!err && Listener)
495  Listener->remove(range);
496  }
497 
498  void increaseIndentation(CharSourceRange range,
499  SourceLocation parentIndent) override {
500  rewriter.IncreaseIndentation(range, parentIndent);
501  }
502 };
503 
504 } // end anonymous namespace.
505 
506 /// Anchor for VTable.
508 
510  const CompilerInvocation &CI,
511  std::shared_ptr<PCHContainerOperations> PCHContainerOps,
512  DiagnosticConsumer *diagClient, StringRef outputDir)
513  : OrigCI(CI), PCHContainerOps(std::move(PCHContainerOps)),
514  DiagClient(diagClient), HadARCErrors(false) {
515  if (!outputDir.empty()) {
518  new DiagnosticsEngine(DiagID, &CI.getDiagnosticOpts(),
519  DiagClient, /*ShouldOwnClient=*/false));
520  Remapper.initFromDisk(outputDir, *Diags, /*ignoreIfFilesChanged=*/true);
521  }
522 }
523 
525  RewriteListener *listener) {
526  std::unique_ptr<CompilerInvocation> CInvok;
527  CInvok.reset(
528  createInvocationForMigration(OrigCI, PCHContainerOps->getRawReader()));
529  CInvok->getDiagnosticOpts().IgnoreWarnings = true;
530 
531  Remapper.applyMappings(CInvok->getPreprocessorOpts());
532 
533  CapturedDiagList capturedDiags;
534  std::vector<SourceLocation> ARCMTMacroLocs;
535 
536  assert(DiagClient);
539  new DiagnosticsEngine(DiagID, new DiagnosticOptions,
540  DiagClient, /*ShouldOwnClient=*/false));
541 
542  // Filter of all diagnostics.
543  CaptureDiagnosticConsumer errRec(*Diags, *DiagClient, capturedDiags);
544  Diags->setClient(&errRec, /*ShouldOwnClient=*/false);
545 
546  std::unique_ptr<ARCMTMacroTrackerAction> ASTAction;
547  ASTAction.reset(new ARCMTMacroTrackerAction(ARCMTMacroLocs));
548 
549  std::unique_ptr<ASTUnit> Unit(ASTUnit::LoadFromCompilerInvocationAction(
550  std::move(CInvok), PCHContainerOps, Diags, ASTAction.get()));
551  if (!Unit) {
552  errRec.FinishCapture();
553  return true;
554  }
555  Unit->setOwnsRemappedFileBuffers(false); // FileRemapper manages that.
556 
557  HadARCErrors = HadARCErrors || capturedDiags.hasErrors();
558 
559  // Don't filter diagnostics anymore.
560  Diags->setClient(DiagClient, /*ShouldOwnClient=*/false);
561 
562  ASTContext &Ctx = Unit->getASTContext();
563 
564  if (Diags->hasFatalErrorOccurred()) {
565  Diags->Reset();
566  DiagClient->BeginSourceFile(Ctx.getLangOpts(), &Unit->getPreprocessor());
567  capturedDiags.reportDiagnostics(*Diags);
568  DiagClient->EndSourceFile();
569  errRec.FinishCapture();
570  return true;
571  }
572 
573  // After parsing of source files ended, we want to reuse the
574  // diagnostics objects to emit further diagnostics.
575  // We call BeginSourceFile because DiagnosticConsumer requires that
576  // diagnostics with source range information are emitted only in between
577  // BeginSourceFile() and EndSourceFile().
578  DiagClient->BeginSourceFile(Ctx.getLangOpts(), &Unit->getPreprocessor());
579 
580  Rewriter rewriter(Ctx.getSourceManager(), Ctx.getLangOpts());
581  TransformActions TA(*Diags, capturedDiags, Ctx, Unit->getPreprocessor());
582  MigrationPass pass(Ctx, OrigCI.getLangOpts()->getGC(),
583  Unit->getSema(), TA, capturedDiags, ARCMTMacroLocs);
584 
585  trans(pass);
586 
587  {
588  RewritesApplicator applicator(rewriter, Ctx, listener);
589  TA.applyRewrites(applicator);
590  }
591 
592  DiagClient->EndSourceFile();
593  errRec.FinishCapture();
594 
595  if (DiagClient->getNumErrors())
596  return true;
597 
599  I = rewriter.buffer_begin(), E = rewriter.buffer_end(); I != E; ++I) {
600  FileID FID = I->first;
601  RewriteBuffer &buf = I->second;
602  const FileEntry *file = Ctx.getSourceManager().getFileEntryForID(FID);
603  assert(file);
604  std::string newFname = std::string(file->getName());
605  newFname += "-trans";
606  SmallString<512> newText;
607  llvm::raw_svector_ostream vecOS(newText);
608  buf.write(vecOS);
609  std::unique_ptr<llvm::MemoryBuffer> memBuf(
610  llvm::MemoryBuffer::getMemBufferCopy(
611  StringRef(newText.data(), newText.size()), newFname));
612  SmallString<64> filePath(file->getName());
613  Unit->getFileManager().FixupRelativePath(filePath);
614  Remapper.remap(filePath.str(), std::move(memBuf));
615  }
616 
617  return false;
618 }
clang::DiagnosticsEngine::Level
Level
The level of the diagnostic, after it has been through mapping.
Definition: Diagnostic.h:194
clang::arcmt::MigrationProcess::RewriteListener::start
virtual void start(ASTContext &Ctx)
Definition: ARCMT.h:114
clang::comments::tok::text
@ text
Definition: CommentLexer.h:35
clang::CompilerInvocationRefBase::getTargetOpts
TargetOptions & getTargetOpts()
Definition: CompilerInvocation.h:107
clang::diag::Severity::Error
@ Error
Present this diagnostic as an error.
clang::ASTUnit::LoadFromCompilerInvocationAction
static ASTUnit * LoadFromCompilerInvocationAction(std::shared_ptr< CompilerInvocation > CI, std::shared_ptr< PCHContainerOperations > PCHContainerOps, IntrusiveRefCntPtr< DiagnosticsEngine > Diags, FrontendAction *Action=nullptr, ASTUnit *Unit=nullptr, bool Persistent=true, StringRef ResourceFilesPath=StringRef(), bool OnlyLocalDecls=false, CaptureDiagsKind CaptureDiagnostics=CaptureDiagsKind::None, unsigned PrecompilePreambleAfterNParses=0, bool CacheCodeCompletionResults=false, bool UserFilesAreVolatile=false, std::unique_ptr< ASTUnit > *ErrAST=nullptr)
Create an ASTUnit from a source file, via a CompilerInvocation object, by invoking the optionally pro...
Definition: ASTUnit.cpp:1501
clang::FullSourceLoc
A SourceLocation and its associated SourceManager.
Definition: SourceLocation.h:370
clang::SourceRange
A trivial tuple used to represent a source range.
Definition: SourceLocation.h:212
string
string(SUBSTRING ${CMAKE_CURRENT_BINARY_DIR} 0 ${PATH_LIB_START} PATH_HEAD) string(SUBSTRING $
Definition: CMakeLists.txt:22
clang::PreprocessorOptions
PreprocessorOptions - This class is used for passing the various options used in preprocessor initial...
Definition: PreprocessorOptions.h:64
clang::arcmt::MigrationPass
Definition: Internals.h:146
clang::FullSourceLoc::isBeforeInTranslationUnitThan
bool isBeforeInTranslationUnitThan(SourceLocation Loc) const
Determines the order of 2 source locations in the translation unit.
Definition: SourceLocation.cpp:251
clang::MacroDefinition
A description of the current definition of a macro.
Definition: MacroInfo.h:564
llvm::SmallVector
Definition: LLVM.h:38
clang::SourceLocation
Encodes a location in the source.
Definition: SourceLocation.h:88
clang::PPCallbacks
This interface provides a way to observe the actions of the preprocessor as it does its thing.
Definition: PPCallbacks.h:35
HasARCRuntime
static bool HasARCRuntime(CompilerInvocation &origCI)
Definition: ARCMT.cpp:149
ARCMT.h
clang::arcmt::TransformActions
Definition: Internals.h:49
clang::TextDiagnosticPrinter::EndSourceFile
void EndSourceFile() override
Callback to inform the diagnostic client that processing of a source file has ended.
Definition: TextDiagnosticPrinter.cpp:42
clang::arcmt::CapturedDiagList::iterator
ListTy::const_iterator iterator
Definition: Internals.h:40
clang::DiagnosticConsumer
Abstract interface, implemented by clients of the front-end, which formats and prints fully processed...
Definition: Diagnostic.h:1722
clang::Token::getIdentifierInfo
IdentifierInfo * getIdentifierInfo() const
Definition: Token.h:179
clang::MacroArgs
MacroArgs - An instance of this class captures information about the formal arguments specified to a ...
Definition: MacroArgs.h:29
clang::RewriteBuffer::write
raw_ostream & write(raw_ostream &Stream) const
Write to Stream the result of applying all changes to the original buffer.
Definition: Rewriter.cpp:37
clang::DiagnosticConsumer::getNumErrors
unsigned getNumErrors() const
Definition: Diagnostic.h:1731
clang::DiagnosticsEngine
Concrete class used by the front-end to report problems and issues.
Definition: Diagnostic.h:191
clang::FrontendInputFile
An input file for the front end.
Definition: FrontendOptions.h:185
clang::arcmt::getARCMTMacroName
static StringRef getARCMTMacroName()
Definition: Internals.h:174
clang::ASTReader::getOriginalSourceFile
StringRef getOriginalSourceFile()
Retrieve the name of the original source file name for the primary module file.
Definition: ASTReader.h:1699
Internals.h
clang::arcmt::FileRemapper::flushToDisk
bool flushToDisk(StringRef outputDir, DiagnosticsEngine &Diag)
Definition: FileRemapper.cpp:109
clang::DiagnosticsEngine::setLastDiagnosticIgnored
void setLastDiagnosticIgnored(bool Ignored)
Pretend that the last diagnostic issued was ignored, so any subsequent notes will be suppressed,...
Definition: Diagnostic.h:754
clang::arcmt::CapturedDiagList::hasDiagnostic
bool hasDiagnostic(ArrayRef< unsigned > IDs, SourceRange range) const
Definition: ARCMT.cpp:59
clang::LangOptions::GCMode
GCMode
Definition: LangOptions.h:63
FrontendAction.h
clang::Rewriter::RemoveText
bool RemoveText(SourceLocation Start, unsigned Length, RewriteOptions opts=RewriteOptions())
RemoveText - Remove the specified text region.
Definition: Rewriter.cpp:308
clang::DiagnosticConsumer::EndSourceFile
virtual void EndSourceFile()
Callback to inform the diagnostic client that processing of a source file has ended.
Definition: Diagnostic.h:1754
clang::Token
Token - This structure provides full information about a lexed token.
Definition: Token.h:34
clang::ASTContext::getSourceManager
SourceManager & getSourceManager()
Definition: ASTContext.h:695
clang::PreprocessorOptions::Includes
std::vector< std::string > Includes
Definition: PreprocessorOptions.h:67
clang::PCHContainerReader
This abstract interface provides operations for unwrapping containers for serialized ASTs (precompile...
Definition: PCHContainerOperations.h:57
clang::FrontendOptions::Inputs
SmallVector< FrontendInputFile, 0 > Inputs
The input files and their types.
Definition: FrontendOptions.h:386
clang::Preprocessor::getLangOpts
const LangOptions & getLangOpts() const
Definition: Preprocessor.h:960
clang::arcmt::CapturedDiagList
Definition: Internals.h:26
Preprocessor.h
clang::arcmt::MigrationProcess::MigrationProcess
MigrationProcess(const CompilerInvocation &CI, std::shared_ptr< PCHContainerOperations > PCHContainerOps, DiagnosticConsumer *diagClient, StringRef outputDir=StringRef())
Definition: ARCMT.cpp:509
clang::Rewriter::buffer_end
buffer_iterator buffer_end()
Definition: Rewriter.h:206
clang::arcmt::FileRemapper::forEachMapping
void forEachMapping(llvm::function_ref< void(StringRef, StringRef)> CaptureFile, llvm::function_ref< void(StringRef, const llvm::MemoryBufferRef &)> CaptureBuffer) const
Iterate through all the mappings.
Definition: FileRemapper.cpp:194
clang::Diagnostic
A little helper class (which is basically a smart pointer that forwards info from DiagnosticsEngine) ...
Definition: Diagnostic.h:1547
clang::arcmt::FileRemapper::initFromDisk
bool initFromDisk(StringRef outputDir, DiagnosticsEngine &Diag, bool ignoreIfFilesChanged)
Definition: FileRemapper.cpp:49
clang::Rewriter::RewriteOptions
Definition: Rewriter.h:38
clang::Rewriter::RewriteOptions::IncludeInsertsAtEndOfRange
bool IncludeInsertsAtEndOfRange
Given a source range, true to include previous inserts at the end of the range as part of the range i...
Definition: Rewriter.h:45
clang::Rewriter::RewriteOptions::RemoveLineIfEmpty
bool RemoveLineIfEmpty
If true and removing some text leaves a blank line also remove the empty line (false by default).
Definition: Rewriter.h:60
clang::CompilerInvocationValueBase::getFrontendOpts
FrontendOptions & getFrontendOpts()
Definition: CompilerInvocation.h:176
clang::arcmt::MigrationProcess::RewriteListener::insert
virtual void insert(SourceLocation loc, StringRef text)
Definition: ARCMT.h:117
clang::MigratorOptions::NoFinalizeRemoval
unsigned NoFinalizeRemoval
Definition: MigratorOptions.h:22
clang::arcmt::applyTransformations
bool applyTransformations(CompilerInvocation &origCI, const FrontendInputFile &Input, std::shared_ptr< PCHContainerOperations > PCHContainerOps, DiagnosticConsumer *DiagClient)
Works similar to checkForManualIssues but instead of checking, it applies automatic modifications to ...
Definition: ARCMT.cpp:384
clang::ASTContext
Holds long-lived AST nodes (such as types and decls) that can be referred to throughout the semantic ...
Definition: ASTContext.h:212
clang::arcmt::FileRemapper
Definition: FileRemapper.h:32
clang::DiagnosticIDs::isARCDiagnostic
static bool isARCDiagnostic(unsigned DiagID)
Return true if a given diagnostic falls into an ARC diagnostic category.
Definition: DiagnosticIDs.cpp:841
clang::arcmt::checkForManualIssues
bool checkForManualIssues(CompilerInvocation &CI, const FrontendInputFile &Input, std::shared_ptr< PCHContainerOperations > PCHContainerOps, DiagnosticConsumer *DiagClient, bool emitPremigrationARCErrors=false, StringRef plistOut=StringRef())
Creates an AST with the provided CompilerInvocation but with these changes: -if a PCH/PTH is set,...
Definition: ARCMT.cpp:237
clang::arcmt::MigrationProcess::RewriteListener::~RewriteListener
virtual ~RewriteListener()
Anchor for VTable.
Definition: ARCMT.cpp:507
clang::DiagnosticsEngine::Error
@ Error
Definition: Diagnostic.h:199
clang::arcmt::CapturedDiagList::hasErrors
bool hasErrors() const
Definition: ARCMT.cpp:86
Utils.h
createInvocationForMigration
static CompilerInvocation * createInvocationForMigration(CompilerInvocation &origCI, const PCHContainerReader &PCHContainerRdr)
Definition: ARCMT.cpp:174
clang::arcmt::CapturedDiagList::begin
iterator begin() const
Definition: Internals.h:41
clang::arcmt::CapturedDiagList::clearDiagnostic
bool clearDiagnostic(ArrayRef< unsigned > IDs, SourceRange range)
Definition: ARCMT.cpp:29
clang::arcmt::FileRemapper::overwriteOriginal
bool overwriteOriginal(DiagnosticsEngine &Diag, StringRef outputDir=StringRef())
Definition: FileRemapper.cpp:168
llvm::SmallString< 512 >
clang::arcmt::TransformActions::RewriteReceiver
Definition: Internals.h:111
clang::MigratorOptions::NoNSAllocReallocError
unsigned NoNSAllocReallocError
Definition: MigratorOptions.h:21
clang::CompilerInvocationRefBase::getLangOpts
LangOptions * getLangOpts()
Definition: CompilerInvocation.h:104
clang::arcmt::CapturedDiagList::reportDiagnostics
void reportDiagnostics(DiagnosticsEngine &diags) const
Definition: ARCMT.cpp:81
clang::CompilerInstance::getPreprocessor
Preprocessor & getPreprocessor() const
Return the current preprocessor.
Definition: CompilerInstance.h:444
clang::Rewriter::RewriteOptions::IncludeInsertsAtBeginOfRange
bool IncludeInsertsAtBeginOfRange
Given a source range, true to include previous inserts at the beginning of the range as part of the r...
Definition: Rewriter.h:41
clang::CompilerInstance
CompilerInstance - Helper class for managing a single instance of the Clang compiler.
Definition: CompilerInstance.h:74
clang::FileEntry
Cached information about one file (either on disk or in the virtual file system).
Definition: FileEntry.h:331
clang::arcmt::MigrationProcess::RewriteListener::remove
virtual void remove(CharSourceRange range)
Definition: ARCMT.h:118
clang::StoredDiagnostic
Represents a diagnostic in a form that can be retained until its corresponding source manager is dest...
Definition: Diagnostic.h:1671
clang::arcmt::writeARCDiagsToPlist
void writeARCDiagsToPlist(const std::string &outPath, ArrayRef< StoredDiagnostic > diags, SourceManager &SM, const LangOptions &LangOpts)
Definition: PlistReporter.cpp:34
clang::Preprocessor::getSourceManager
SourceManager & getSourceManager() const
Definition: Preprocessor.h:964
clang::arcmt::MigrationProcess::RewriteListener
Definition: ARCMT.h:110
clang::transformer::remove
ASTEdit remove(RangeSelector S)
Removes the source selected by S.
Definition: RewriteRule.cpp:146
clang::arcmt::MigrationProcess::applyTransform
bool applyTransform(TransformFn trans, RewriteListener *listener=nullptr)
Definition: ARCMT.cpp:524
clang::arcmt::MigrationProcess
Definition: ARCMT.h:96
clang::DiagnosticConsumer::BeginSourceFile
virtual void BeginSourceFile(const LangOptions &LangOpts, const Preprocessor *PP=nullptr)
Callback to inform the diagnostic client that processing of a source file is beginning.
Definition: Diagnostic.h:1746
false
#define false
Definition: stdbool.h:17
SemaDiagnostic.h
clang::arcmt::MigrationProcess::getRemapper
FileRemapper & getRemapper()
Definition: ARCMT.h:123
clang::LangOptions::NonGC
@ NonGC
Definition: LangOptions.h:63
clang::Diagnostic::getLocation
const SourceLocation & getLocation() const
Definition: Diagnostic.h:1558
TextDiagnosticPrinter.h
llvm::ArrayRef< unsigned >
clang::arcmt::getFileRemappings
bool getFileRemappings(std::vector< std::pair< std::string, std::string > > &remap, StringRef outputDir, DiagnosticConsumer *DiagClient)
Get the set of file remappings from the outputDir path that migrateWithTemporaryFiles produced.
Definition: ARCMT.cpp:402
clang::CharSourceRange
Represents a character-granular source range.
Definition: SourceLocation.h:255
clang::arcmt::FileRemapper::applyMappings
void applyMappings(PreprocessorOptions &PPOpts) const
Definition: FileRemapper.cpp:209
ASTUnit.h
clang::arcmt::TransformActions::applyRewrites
void applyRewrites(RewriteReceiver &receiver)
Definition: TransformActions.cpp:676
clang::DiagnosticIDs
Used for handling and querying diagnostic IDs.
Definition: DiagnosticIDs.h:166
clang::arcmt::getAllTransformations
std::vector< TransformFn > getAllTransformations(LangOptions::GCMode OrigGCMode, bool NoFinalizeRemoval)
Definition: Transforms.cpp:581
ASTConsumer.h
clang::TextDiagnosticPrinter::BeginSourceFile
void BeginSourceFile(const LangOptions &LO, const Preprocessor *PP) override
Callback to inform the diagnostic client that processing of a source file is beginning.
Definition: TextDiagnosticPrinter.cpp:36
DiagnosticCategories.h
clang::arcmt::MigrationProcess::RewriteListener::finish
virtual void finish()
Definition: ARCMT.h:115
clang::Token::getLocation
SourceLocation getLocation() const
Return a source location identifier for the specified offset in the current file.
Definition: Token.h:126
clang::LangOptions
Keeps track of the various options that can be enabled, which controls the dialect of C or C++ that i...
Definition: LangOptions.h:58
clang::Rewriter::InsertText
bool InsertText(SourceLocation Loc, StringRef Str, bool InsertAfter=true, bool indentNewLines=false)
InsertText - Insert the specified string at the specified location in the original buffer.
Definition: Rewriter.cpp:255
clang::arcmt::MigrationProcess::HadARCErrors
bool HadARCErrors
Definition: ARCMT.h:103
clang::Rewriter::buffer_begin
buffer_iterator buffer_begin()
Definition: Rewriter.h:205
std
Definition: Format.h:4034
emitPremigrationErrors
static void emitPremigrationErrors(const CapturedDiagList &arcDiags, DiagnosticOptions *diagOpts, Preprocessor &PP)
Definition: ARCMT.cpp:218
applyTransforms
static bool applyTransforms(CompilerInvocation &origCI, const FrontendInputFile &Input, std::shared_ptr< PCHContainerOperations > PCHContainerOps, DiagnosticConsumer *DiagClient, StringRef outputDir, bool emitPremigrationARCErrors, StringRef plistOut)
Definition: ARCMT.cpp:339
clang::IdentifierInfo::getName
StringRef getName() const
Return the actual identifier string.
Definition: IdentifierTable.h:195
clang::arcmt::migrateWithTemporaryFiles
bool migrateWithTemporaryFiles(CompilerInvocation &origCI, const FrontendInputFile &Input, std::shared_ptr< PCHContainerOperations > PCHContainerOps, DiagnosticConsumer *DiagClient, StringRef outputDir, bool emitPremigrationARCErrors, StringRef plistOut)
Applies automatic modifications and produces temporary files and metadata into the outputDir path.
Definition: ARCMT.cpp:392
clang
Definition: CalledOnceCheck.h:17
clang::FileManager
Implements support for file system lookup, file system caching, and directory search management.
Definition: FileManager.h:53
clang::Preprocessor::addPPCallbacks
void addPPCallbacks(std::unique_ptr< PPCallbacks > C)
Definition: Preprocessor.h:1058
clang::RewriteBuffer
RewriteBuffer - As code is rewritten, SourceBuffer's from the original input with modifications get a...
Definition: RewriteBuffer.h:25
clang::transformer::range
RangeSelector range(RangeSelector Begin, RangeSelector End)
DEPRECATED. Use enclose.
Definition: RangeSelector.h:41
clang::Rewriter::buffer_iterator
std::map< FileID, RewriteBuffer >::iterator buffer_iterator
Definition: Rewriter.h:65
ASTReader.h
clang::arcmt::TransformFn
void(* TransformFn)(MigrationPass &pass)
Definition: ARCMT.h:91
clang::TargetOptions::Triple
std::string Triple
The name of the target triple to compile for.
Definition: TargetOptions.h:29
clang::FileEntry::getName
StringRef getName() const
Definition: FileEntry.h:364
clang::FileID
An opaque identifier used by SourceManager which refers to a source file (MemoryBuffer) along with it...
Definition: SourceLocation.h:40
clang::arcmt::MigrationPass::setNoFinalizeRemoval
void setNoFinalizeRemoval(bool val)
Definition: Internals.h:169
clang::CompilerInvocation
Helper class for holding the data necessary to invoke the compiler.
Definition: CompilerInvocation.h:193
clang::SourceLocation::isValid
bool isValid() const
Return true if this is a valid SourceLocation object.
Definition: SourceLocation.h:112
clang::SourceManager::getFileEntryForID
const FileEntry * getFileEntryForID(FileID FID) const
Returns the FileEntry record for the provided FileID.
Definition: SourceManager.h:1030
clang::Rewriter
Rewriter - This is the main interface to the rewrite buffers.
Definition: Rewriter.h:32
clang::IgnoringDiagConsumer
A diagnostic client that ignores all diagnostics.
Definition: Diagnostic.h:1777
clang::TextDiagnosticPrinter
Definition: TextDiagnosticPrinter.h:27
CompilerInstance.h
clang::DiagnosticsEngine::Note
@ Note
Definition: Diagnostic.h:196
clang::arcmt::CapturedDiagList::end
iterator end() const
Definition: Internals.h:42
clang::arcmt::TransformActions::hasReportedErrors
bool hasReportedErrors() const
Definition: Internals.h:107
clang::ASTFrontendAction
Abstract base class to use for AST consumer-based frontend actions.
Definition: FrontendAction.h:243
clang::Diagnostic::getID
unsigned getID() const
Definition: Diagnostic.h:1557
Rewriter.h
PreprocessorOptions.h
clang::Preprocessor
Engages in a tight little dance with the lexer to efficiently preprocess tokens.
Definition: Preprocessor.h:130
clang::Rewriter::IncreaseIndentation
bool IncreaseIndentation(CharSourceRange range, SourceLocation parentIndent)
Increase indentation for the lines between the given source range.
Definition: Rewriter.cpp:344
clang::CompilerInvocationValueBase::getFileSystemOpts
FileSystemOptions & getFileSystemOpts()
Definition: CompilerInvocation.h:170
clang::arcmt::FileRemapper::remap
void remap(StringRef filePath, std::unique_ptr< llvm::MemoryBuffer > memBuf)
Definition: FileRemapper.cpp:223
clang::arcmt::CapturedDiagList::push_back
void push_back(const StoredDiagnostic &diag)
Definition: Internals.h:31
clang::ASTContext::getLangOpts
const LangOptions & getLangOpts() const
Definition: ASTContext.h:765
llvm::IntrusiveRefCntPtr
Definition: LLVM.h:47
clang::PreprocessorOptions::ImplicitPCHInclude
std::string ImplicitPCHInclude
The implicit PCH included at the start of the translation unit, or empty.
Definition: PreprocessorOptions.h:96
clang::DiagnosticOptions
Options for controlling the compiler diagnostics engine.
Definition: DiagnosticOptions.h:70
clang::DiagnosticsEngine::Report
DiagnosticBuilder Report(SourceLocation Loc, unsigned DiagID)
Issue the message to the client.
Definition: Diagnostic.h:1523
clang::CompilerInvocationRefBase::getDiagnosticOpts
DiagnosticOptions & getDiagnosticOpts() const
Definition: CompilerInvocation.h:110
clang::CompilerInvocationValueBase::getMigratorOpts
MigratorOptions & getMigratorOpts()
Definition: CompilerInvocation.h:156