1 // Copyright 2022 The Abseil Authors. 2 // 3 // Licensed under the Apache License, Version 2.0 (the "License"); 4 // you may not use this file except in compliance with the License. 5 // You may obtain a copy of the License at 6 // 7 // https://www.apache.org/licenses/LICENSE-2.0 8 // 9 // Unless required by applicable law or agreed to in writing, software 10 // distributed under the License is distributed on an "AS IS" BASIS, 11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 // See the License for the specific language governing permissions and 13 // limitations under the License. 14 // 15 // ----------------------------------------------------------------------------- 16 // File: log/absl_vlog_is_on.h 17 // ----------------------------------------------------------------------------- 18 // 19 // This header defines the `ABSL_VLOG_IS_ON()` macro that controls the 20 // variable-verbosity conditional logging. 21 // 22 // It's used by `VLOG` in log.h, or it can also be used directly like this: 23 // 24 // if (ABSL_VLOG_IS_ON(2)) { 25 // foo_server.RecomputeStatisticsExpensive(); 26 // LOG(INFO) << foo_server.LastStatisticsAsString(); 27 // } 28 // 29 // Each source file has an effective verbosity level that's a non-negative 30 // integer computed from the `--vmodule` and `--v` flags. 31 // `ABSL_VLOG_IS_ON(n)` is true, and `VLOG(n)` logs, if that effective verbosity 32 // level is greater than or equal to `n`. 33 // 34 // `--vmodule` takes a comma-delimited list of key=value pairs. Each key is a 35 // pattern matched against filenames, and the values give the effective severity 36 // level applied to matching files. '?' and '*' characters in patterns are 37 // interpreted as single-character and zero-or-more-character wildcards. 38 // Patterns including a slash character are matched against full pathnames, 39 // while those without are matched against basenames only. One suffix (i.e. the 40 // last . and everything after it) is stripped from each filename prior to 41 // matching, as is the special suffix "-inl". 42 // 43 // Files are matched against globs in `--vmodule` in order, and the first match 44 // determines the verbosity level. 45 // 46 // Files which do not match any pattern in `--vmodule` use the value of `--v` as 47 // their effective verbosity level. The default is 0. 48 // 49 // SetVLogLevel helper function is provided to do limited dynamic control over 50 // V-logging by appending to `--vmodule`. Because these go at the beginning of 51 // the list, they take priority over any globs previously added. 52 // 53 // Resetting --vmodule will override all previous modifications to `--vmodule`, 54 // including via SetVLogLevel. 55 56 #ifndef ABSL_LOG_ABSL_VLOG_IS_ON_H_ 57 #define ABSL_LOG_ABSL_VLOG_IS_ON_H_ 58 59 #include "absl/base/attributes.h" 60 #include "absl/base/config.h" 61 #include "absl/log/internal/vlog_config.h" // IWYU pragma: export 62 #include "absl/strings/string_view.h" 63 64 // IWYU pragma: private, include "absl/log/log.h" 65 66 // This is expanded at the callsite to allow the compiler to optimize 67 // always-false cases out of the build. 68 // An ABSL_MAX_VLOG_VERBOSITY of 2 means that VLOG(3) and above should never 69 // log. 70 #ifdef ABSL_MAX_VLOG_VERBOSITY 71 #define ABSL_LOG_INTERNAL_MAX_LOG_VERBOSITY_CHECK(x) \ 72 ((x) <= ABSL_MAX_VLOG_VERBOSITY)&& 73 #else 74 #define ABSL_LOG_INTERNAL_MAX_LOG_VERBOSITY_CHECK(x) 75 #endif 76 77 // Each ABSL_VLOG_IS_ON call site gets its own VLogSite that registers with the 78 // global linked list of sites to asynchronously update its verbosity level on 79 // changes to --v or --vmodule. The verbosity can also be set by manually 80 // calling SetVLogLevel. 81 // 82 // ABSL_VLOG_IS_ON is not async signal safe, but it is guaranteed not to 83 // allocate new memory. 84 #define ABSL_VLOG_IS_ON(verbose_level) \ 85 (ABSL_LOG_INTERNAL_MAX_LOG_VERBOSITY_CHECK(verbose_level)[]() \ 86 ->::absl::log_internal::VLogSite * \ 87 { \ 88 ABSL_CONST_INIT static ::absl::log_internal::VLogSite site(__FILE__); \ 89 return &site; \ 90 }() \ 91 ->IsEnabled(verbose_level)) 92 93 #endif // ABSL_LOG_ABSL_VLOG_IS_ON_H_ 94