/proc/self/cwd/external/com_google_absl/absl/base/internal/raw_logging.cc
Line | Count | Source (jump to first uncovered line) |
1 | | // Copyright 2017 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 | | #include "absl/base/internal/raw_logging.h" |
16 | | |
17 | | #include <cstdarg> |
18 | | #include <cstddef> |
19 | | #include <cstdio> |
20 | | #include <cstdlib> |
21 | | #include <cstring> |
22 | | #include <string> |
23 | | |
24 | | #ifdef __EMSCRIPTEN__ |
25 | | #include <emscripten/console.h> |
26 | | #endif |
27 | | |
28 | | #include "absl/base/attributes.h" |
29 | | #include "absl/base/config.h" |
30 | | #include "absl/base/internal/atomic_hook.h" |
31 | | #include "absl/base/internal/errno_saver.h" |
32 | | #include "absl/base/log_severity.h" |
33 | | |
34 | | // We know how to perform low-level writes to stderr in POSIX and Windows. For |
35 | | // these platforms, we define the token ABSL_LOW_LEVEL_WRITE_SUPPORTED. |
36 | | // Much of raw_logging.cc becomes a no-op when we can't output messages, |
37 | | // although a FATAL ABSL_RAW_LOG message will still abort the process. |
38 | | |
39 | | // ABSL_HAVE_POSIX_WRITE is defined when the platform provides posix write() |
40 | | // (as from unistd.h) |
41 | | // |
42 | | // This preprocessor token is also defined in raw_io.cc. If you need to copy |
43 | | // this, consider moving both to config.h instead. |
44 | | #if defined(__linux__) || defined(__APPLE__) || defined(__FreeBSD__) || \ |
45 | | defined(__hexagon__) || defined(__Fuchsia__) || \ |
46 | | defined(__native_client__) || defined(__OpenBSD__) || \ |
47 | | defined(__EMSCRIPTEN__) || defined(__ASYLO__) |
48 | | |
49 | | #include <unistd.h> |
50 | | |
51 | | #define ABSL_HAVE_POSIX_WRITE 1 |
52 | | #define ABSL_LOW_LEVEL_WRITE_SUPPORTED 1 |
53 | | #else |
54 | | #undef ABSL_HAVE_POSIX_WRITE |
55 | | #endif |
56 | | |
57 | | // ABSL_HAVE_SYSCALL_WRITE is defined when the platform provides the syscall |
58 | | // syscall(SYS_write, /*int*/ fd, /*char* */ buf, /*size_t*/ len); |
59 | | // for low level operations that want to avoid libc. |
60 | | #if (defined(__linux__) || defined(__FreeBSD__)) && !defined(__ANDROID__) |
61 | | #include <sys/syscall.h> |
62 | | #define ABSL_HAVE_SYSCALL_WRITE 1 |
63 | | #define ABSL_LOW_LEVEL_WRITE_SUPPORTED 1 |
64 | | #else |
65 | | #undef ABSL_HAVE_SYSCALL_WRITE |
66 | | #endif |
67 | | |
68 | | #ifdef _WIN32 |
69 | | #include <io.h> |
70 | | |
71 | | #define ABSL_HAVE_RAW_IO 1 |
72 | | #define ABSL_LOW_LEVEL_WRITE_SUPPORTED 1 |
73 | | #else |
74 | | #undef ABSL_HAVE_RAW_IO |
75 | | #endif |
76 | | |
77 | | namespace absl { |
78 | | ABSL_NAMESPACE_BEGIN |
79 | | namespace raw_log_internal { |
80 | | namespace { |
81 | | |
82 | | // TODO(gfalcon): We want raw-logging to work on as many platforms as possible. |
83 | | // Explicitly `#error` out when not `ABSL_LOW_LEVEL_WRITE_SUPPORTED`, except for |
84 | | // a selected set of platforms for which we expect not to be able to raw log. |
85 | | |
86 | | #ifdef ABSL_LOW_LEVEL_WRITE_SUPPORTED |
87 | | constexpr char kTruncated[] = " ... (message truncated)\n"; |
88 | | |
89 | | // sprintf the format to the buffer, adjusting *buf and *size to reflect the |
90 | | // consumed bytes, and return whether the message fit without truncation. If |
91 | | // truncation occurred, if possible leave room in the buffer for the message |
92 | | // kTruncated[]. |
93 | | bool VADoRawLog(char** buf, int* size, const char* format, va_list ap) |
94 | | ABSL_PRINTF_ATTRIBUTE(3, 0); |
95 | 0 | bool VADoRawLog(char** buf, int* size, const char* format, va_list ap) { |
96 | 0 | if (*size < 0) return false; |
97 | 0 | int n = vsnprintf(*buf, static_cast<size_t>(*size), format, ap); |
98 | 0 | bool result = true; |
99 | 0 | if (n < 0 || n > *size) { |
100 | 0 | result = false; |
101 | 0 | if (static_cast<size_t>(*size) > sizeof(kTruncated)) { |
102 | 0 | n = *size - static_cast<int>(sizeof(kTruncated)); |
103 | 0 | } else { |
104 | 0 | n = 0; // no room for truncation message |
105 | 0 | } |
106 | 0 | } |
107 | 0 | *size -= n; |
108 | 0 | *buf += n; |
109 | 0 | return result; |
110 | 0 | } |
111 | | #endif // ABSL_LOW_LEVEL_WRITE_SUPPORTED |
112 | | |
113 | | constexpr int kLogBufSize = 3000; |
114 | | |
115 | | // CAVEAT: vsnprintf called from *DoRawLog below has some (exotic) code paths |
116 | | // that invoke malloc() and getenv() that might acquire some locks. |
117 | | |
118 | | // Helper for RawLog below. |
119 | | // *DoRawLog writes to *buf of *size and move them past the written portion. |
120 | | // It returns true iff there was no overflow or error. |
121 | | bool DoRawLog(char** buf, int* size, const char* format, ...) |
122 | | ABSL_PRINTF_ATTRIBUTE(3, 4); |
123 | 0 | bool DoRawLog(char** buf, int* size, const char* format, ...) { |
124 | 0 | if (*size < 0) return false; |
125 | 0 | va_list ap; |
126 | 0 | va_start(ap, format); |
127 | 0 | int n = vsnprintf(*buf, static_cast<size_t>(*size), format, ap); |
128 | 0 | va_end(ap); |
129 | 0 | if (n < 0 || n > *size) return false; |
130 | 0 | *size -= n; |
131 | 0 | *buf += n; |
132 | 0 | return true; |
133 | 0 | } |
134 | | |
135 | | bool DefaultLogFilterAndPrefix(absl::LogSeverity, const char* file, int line, |
136 | 0 | char** buf, int* buf_size) { |
137 | 0 | DoRawLog(buf, buf_size, "[%s : %d] RAW: ", file, line); |
138 | 0 | return true; |
139 | 0 | } |
140 | | |
141 | | ABSL_INTERNAL_ATOMIC_HOOK_ATTRIBUTES |
142 | | absl::base_internal::AtomicHook<LogFilterAndPrefixHook> |
143 | | log_filter_and_prefix_hook(DefaultLogFilterAndPrefix); |
144 | | ABSL_INTERNAL_ATOMIC_HOOK_ATTRIBUTES |
145 | | absl::base_internal::AtomicHook<AbortHook> abort_hook; |
146 | | |
147 | | void RawLogVA(absl::LogSeverity severity, const char* file, int line, |
148 | | const char* format, va_list ap) ABSL_PRINTF_ATTRIBUTE(4, 0); |
149 | | void RawLogVA(absl::LogSeverity severity, const char* file, int line, |
150 | 0 | const char* format, va_list ap) { |
151 | 0 | char buffer[kLogBufSize]; |
152 | 0 | char* buf = buffer; |
153 | 0 | int size = sizeof(buffer); |
154 | 0 | #ifdef ABSL_LOW_LEVEL_WRITE_SUPPORTED |
155 | 0 | bool enabled = true; |
156 | | #else |
157 | | bool enabled = false; |
158 | | #endif |
159 | |
|
160 | | #ifdef ABSL_MIN_LOG_LEVEL |
161 | | if (severity < static_cast<absl::LogSeverity>(ABSL_MIN_LOG_LEVEL) && |
162 | | severity < absl::LogSeverity::kFatal) { |
163 | | enabled = false; |
164 | | } |
165 | | #endif |
166 | |
|
167 | 0 | enabled = log_filter_and_prefix_hook(severity, file, line, &buf, &size); |
168 | 0 | const char* const prefix_end = buf; |
169 | |
|
170 | 0 | #ifdef ABSL_LOW_LEVEL_WRITE_SUPPORTED |
171 | 0 | if (enabled) { |
172 | 0 | bool no_chop = VADoRawLog(&buf, &size, format, ap); |
173 | 0 | if (no_chop) { |
174 | 0 | DoRawLog(&buf, &size, "\n"); |
175 | 0 | } else { |
176 | 0 | DoRawLog(&buf, &size, "%s", kTruncated); |
177 | 0 | } |
178 | 0 | AsyncSignalSafeWriteError(buffer, static_cast<size_t>(buf - buffer)); |
179 | 0 | } |
180 | | #else |
181 | | static_cast<void>(format); |
182 | | static_cast<void>(ap); |
183 | | static_cast<void>(enabled); |
184 | | #endif |
185 | | |
186 | | // Abort the process after logging a FATAL message, even if the output itself |
187 | | // was suppressed. |
188 | 0 | if (severity == absl::LogSeverity::kFatal) { |
189 | 0 | abort_hook(file, line, buffer, prefix_end, buffer + kLogBufSize); |
190 | 0 | abort(); |
191 | 0 | } |
192 | 0 | } |
193 | | |
194 | | // Non-formatting version of RawLog(). |
195 | | // |
196 | | // TODO(gfalcon): When string_view no longer depends on base, change this |
197 | | // interface to take its message as a string_view instead. |
198 | | void DefaultInternalLog(absl::LogSeverity severity, const char* file, int line, |
199 | 0 | const std::string& message) { |
200 | 0 | RawLog(severity, file, line, "%.*s", static_cast<int>(message.size()), |
201 | 0 | message.data()); |
202 | 0 | } |
203 | | |
204 | | } // namespace |
205 | | |
206 | 0 | void AsyncSignalSafeWriteError(const char* s, size_t len) { |
207 | 0 | if (!len) return; |
208 | 0 | absl::base_internal::ErrnoSaver errno_saver; |
209 | | #if defined(__EMSCRIPTEN__) |
210 | | // In WebAssembly, bypass filesystem emulation via fwrite. |
211 | | if (s[len - 1] == '\n') { |
212 | | // Skip a trailing newline character as emscripten_errn adds one itself. |
213 | | len--; |
214 | | } |
215 | | // emscripten_errn was introduced in 3.1.41 but broken in standalone mode |
216 | | // until 3.1.43. |
217 | | #if ABSL_INTERNAL_EMSCRIPTEN_VERSION >= 3001043 |
218 | | emscripten_errn(s, len); |
219 | | #else |
220 | | char buf[kLogBufSize]; |
221 | | if (len >= kLogBufSize) { |
222 | | len = kLogBufSize - 1; |
223 | | constexpr size_t trunc_len = sizeof(kTruncated) - 2; |
224 | | memcpy(buf + len - trunc_len, kTruncated, trunc_len); |
225 | | buf[len] = '\0'; |
226 | | len -= trunc_len; |
227 | | } else { |
228 | | buf[len] = '\0'; |
229 | | } |
230 | | memcpy(buf, s, len); |
231 | | _emscripten_err(buf); |
232 | | #endif |
233 | | #elif defined(ABSL_HAVE_SYSCALL_WRITE) |
234 | | // We prefer calling write via `syscall` to minimize the risk of libc doing |
235 | | // something "helpful". |
236 | 0 | syscall(SYS_write, STDERR_FILENO, s, len); |
237 | | #elif defined(ABSL_HAVE_POSIX_WRITE) |
238 | | write(STDERR_FILENO, s, len); |
239 | | #elif defined(ABSL_HAVE_RAW_IO) |
240 | | _write(/* stderr */ 2, s, static_cast<unsigned>(len)); |
241 | | #else |
242 | | // stderr logging unsupported on this platform |
243 | | (void)s; |
244 | | (void)len; |
245 | | #endif |
246 | 0 | } |
247 | | |
248 | | void RawLog(absl::LogSeverity severity, const char* file, int line, |
249 | 0 | const char* format, ...) { |
250 | 0 | va_list ap; |
251 | 0 | va_start(ap, format); |
252 | 0 | RawLogVA(severity, file, line, format, ap); |
253 | 0 | va_end(ap); |
254 | 0 | } |
255 | | |
256 | 0 | bool RawLoggingFullySupported() { |
257 | 0 | #ifdef ABSL_LOW_LEVEL_WRITE_SUPPORTED |
258 | 0 | return true; |
259 | | #else // !ABSL_LOW_LEVEL_WRITE_SUPPORTED |
260 | | return false; |
261 | | #endif // !ABSL_LOW_LEVEL_WRITE_SUPPORTED |
262 | 0 | } |
263 | | |
264 | | ABSL_INTERNAL_ATOMIC_HOOK_ATTRIBUTES ABSL_DLL |
265 | | absl::base_internal::AtomicHook<InternalLogFunction> |
266 | | internal_log_function(DefaultInternalLog); |
267 | | |
268 | 0 | void RegisterLogFilterAndPrefixHook(LogFilterAndPrefixHook func) { |
269 | 0 | log_filter_and_prefix_hook.Store(func); |
270 | 0 | } |
271 | | |
272 | 0 | void RegisterAbortHook(AbortHook func) { abort_hook.Store(func); } |
273 | | |
274 | 0 | void RegisterInternalLogFunction(InternalLogFunction func) { |
275 | 0 | internal_log_function.Store(func); |
276 | 0 | } |
277 | | |
278 | | } // namespace raw_log_internal |
279 | | ABSL_NAMESPACE_END |
280 | | } // namespace absl |