1 //===- Error.h --------------------------------------------------*- C++ -*-===//
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // In LLD, we have three levels of errors: fatal, error or warn.
12 // Fatal makes the program exit immediately with an error message.
13 // You shouldn't use it except for reporting a corrupted input file.
15 // Error prints out an error message and increment a global variable
16 // ErrorCount to record the fact that we met an error condition. It does
17 // not exit, so it is safe for a lld-as-a-library use case. It is generally
18 // useful because it can report more than one errors in a single run.
20 // Warn doesn't do anything but printing out a given message.
22 //===----------------------------------------------------------------------===//
24 #ifndef LLD_ELF_ERROR_H
25 #define LLD_ELF_ERROR_H
27 #include "lld/Core/LLVM.h"
29 #include "llvm/Support/Error.h"
34 extern uint64_t ErrorCount;
35 extern llvm::raw_ostream *ErrorOS;
36 extern llvm::StringRef Argv0;
38 void log(const Twine &Msg);
39 void warn(const Twine &Msg);
41 void error(const Twine &Msg);
42 void error(std::error_code EC, const Twine &Prefix);
44 LLVM_ATTRIBUTE_NORETURN void exitLld(int Val);
45 LLVM_ATTRIBUTE_NORETURN void fatal(const Twine &Msg);
46 LLVM_ATTRIBUTE_NORETURN void fatal(std::error_code EC, const Twine &Prefix);
47 LLVM_ATTRIBUTE_NORETURN void fatal(Error &E, const Twine &Prefix);
49 // check() functions are convenient functions to strip errors
50 // from error-or-value objects.
51 template <class T> T check(ErrorOr<T> E) {
52 if (auto EC = E.getError())
57 template <class T> T check(Expected<T> E) {
59 fatal(llvm::toString(E.takeError()));
63 template <class T> T check(ErrorOr<T> E, const Twine &Prefix) {
64 if (auto EC = E.getError())
65 fatal(Prefix + ": " + EC.message());
69 template <class T> T check(Expected<T> E, const Twine &Prefix) {
71 fatal(Prefix + ": " + errorToErrorCode(E.takeError()).message());