folly/experimental/logging/test/FatalHelper.cpp

   1 /*
   2  * Copyright 2004-present Facebook, Inc.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *   http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16 #include <folly/experimental/logging/Init.h>
  17 #include <folly/experimental/logging/xlog.h>
  18 #include <folly/init/Init.h>
  19 #include <folly/portability/Stdlib.h>
  20
  21 DEFINE_string(logging, "", "Logging category configuration string");
  22 DEFINE_string(
  23     handler_style,
  24     "async",
  25     "Log handler style: async, immediate, or none");
  26
  27 DEFINE_string(
  28     category,
  29     "",
  30     "Crash with a message to this category instead of the default");
  31 DEFINE_bool(crash, true, "Crash with a fatal log message.");
  32
  33 using folly::LogLevel;
  34
  35 namespace {
  36 /**
  37  * Helper class to optionally log a fatal message during static initialization
  38  * or destruction.
  39  *
  40  * Since command line arguments have not been processed during static
  41  * initialization, we check an environment variable.
  42  */
  43 class InitChecker {
  44  public:
  45   InitChecker() : value_{getenv("CRASH_DURING_INIT")} {
  46     if (value_ && strcmp(value_, "shutdown") != 0) {
  47       XLOG(FATAL) << "crashing during static initialization";
  48     }
  49   }
  50   ~InitChecker() {
  51     if (value_) {
  52       XLOG(FATAL) << "crashing during static destruction";
  53     }
  54   }
  55
  56   const char* value_{nullptr};
  57 };
  58
  59 static InitChecker initChecker;
  60 }
  61
  62 /*
  63  * This is a simple helper program to exercise the LOG(FATAL) functionality.
  64  */
  65 int main(int argc, char* argv[]) {
  66   // Call folly::init() and then initialize log levels and handlers
  67   folly::init(&argc, &argv);
  68
  69   if (FLAGS_handler_style == "async") {
  70     initLoggingGlogStyle(FLAGS_logging, LogLevel::INFO, true);
  71   } else if (FLAGS_handler_style == "immediate") {
  72     initLoggingGlogStyle(FLAGS_logging, LogLevel::INFO, false);
  73   } else if (FLAGS_handler_style != "none") {
  74     XLOGF(FATAL, "unknown log handler style \"{}\"", FLAGS_handler_style);
  75   }
  76
  77   if (!FLAGS_category.empty()) {
  78     folly::Logger logger{FLAGS_category};
  79     FB_LOG(logger, FATAL, "crashing to category ", FLAGS_category);
  80   }
  81
  82   if (!FLAGS_crash) {
  83     return 0;
  84   }
  85
  86   XLOG(FATAL) << "test program crashing!";
  87   // Even though main() is defined to return an integer, the compiler
  88   // should be able to detect that XLOG(FATAL) never returns.  It shouldn't
  89   // complain that we don't return an integer here.
  90 }