• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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 <stddef.h>
18 #include <cstdarg>
19 #include <cstdio>
20 #include <cstdlib>
21 #include <cstring>
22 
23 #include "absl/base/attributes.h"
24 #include "absl/base/config.h"
25 #include "absl/base/internal/atomic_hook.h"
26 #include "absl/base/log_severity.h"
27 
28 // We know how to perform low-level writes to stderr in POSIX and Windows.  For
29 // these platforms, we define the token ABSL_LOW_LEVEL_WRITE_SUPPORTED.
30 // Much of raw_logging.cc becomes a no-op when we can't output messages,
31 // although a FATAL ABSL_RAW_LOG message will still abort the process.
32 
33 // ABSL_HAVE_POSIX_WRITE is defined when the platform provides posix write()
34 // (as from unistd.h)
35 //
36 // This preprocessor token is also defined in raw_io.cc.  If you need to copy
37 // this, consider moving both to config.h instead.
38 #if defined(__linux__) || defined(__APPLE__) || defined(__FreeBSD__) || \
39     defined(__Fuchsia__) || defined(__native_client__) || \
40     defined(__EMSCRIPTEN__) || defined(__ASYLO__)
41 
42 #include <unistd.h>
43 
44 #define ABSL_HAVE_POSIX_WRITE 1
45 #define ABSL_LOW_LEVEL_WRITE_SUPPORTED 1
46 #else
47 #undef ABSL_HAVE_POSIX_WRITE
48 #endif
49 
50 // ABSL_HAVE_SYSCALL_WRITE is defined when the platform provides the syscall
51 //   syscall(SYS_write, /*int*/ fd, /*char* */ buf, /*size_t*/ len);
52 // for low level operations that want to avoid libc.
53 #if (defined(__linux__) || defined(__FreeBSD__)) && !defined(__ANDROID__)
54 #include <sys/syscall.h>
55 #define ABSL_HAVE_SYSCALL_WRITE 1
56 #define ABSL_LOW_LEVEL_WRITE_SUPPORTED 1
57 #else
58 #undef ABSL_HAVE_SYSCALL_WRITE
59 #endif
60 
61 #ifdef _WIN32
62 #include <io.h>
63 
64 #define ABSL_HAVE_RAW_IO 1
65 #define ABSL_LOW_LEVEL_WRITE_SUPPORTED 1
66 #else
67 #undef ABSL_HAVE_RAW_IO
68 #endif
69 
70 namespace absl {
71 ABSL_NAMESPACE_BEGIN
72 namespace raw_logging_internal {
73 namespace {
74 
75 // TODO(gfalcon): We want raw-logging to work on as many platforms as possible.
76 // Explicitly `#error` out when not `ABSL_LOW_LEVEL_WRITE_SUPPORTED`, except for
77 // a selected set of platforms for which we expect not to be able to raw log.
78 
79 ABSL_INTERNAL_ATOMIC_HOOK_ATTRIBUTES
80     absl::base_internal::AtomicHook<LogPrefixHook>
81         log_prefix_hook;
82 ABSL_INTERNAL_ATOMIC_HOOK_ATTRIBUTES
83     absl::base_internal::AtomicHook<AbortHook>
84         abort_hook;
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);
VADoRawLog(char ** buf,int * size,const char * format,va_list ap)95 bool VADoRawLog(char** buf, int* size, const char* format, va_list ap) {
96   int n = vsnprintf(*buf, *size, format, ap);
97   bool result = true;
98   if (n < 0 || n > *size) {
99     result = false;
100     if (static_cast<size_t>(*size) > sizeof(kTruncated)) {
101       n = *size - sizeof(kTruncated);  // room for truncation message
102     } else {
103       n = 0;  // no room for truncation message
104     }
105   }
106   *size -= n;
107   *buf += n;
108   return result;
109 }
110 #endif  // ABSL_LOW_LEVEL_WRITE_SUPPORTED
111 
112 constexpr int kLogBufSize = 3000;
113 
114 // CAVEAT: vsnprintf called from *DoRawLog below has some (exotic) code paths
115 // that invoke malloc() and getenv() that might acquire some locks.
116 
117 // Helper for RawLog below.
118 // *DoRawLog writes to *buf of *size and move them past the written portion.
119 // It returns true iff there was no overflow or error.
120 bool DoRawLog(char** buf, int* size, const char* format, ...)
121     ABSL_PRINTF_ATTRIBUTE(3, 4);
DoRawLog(char ** buf,int * size,const char * format,...)122 bool DoRawLog(char** buf, int* size, const char* format, ...) {
123   va_list ap;
124   va_start(ap, format);
125   int n = vsnprintf(*buf, *size, format, ap);
126   va_end(ap);
127   if (n < 0 || n > *size) return false;
128   *size -= n;
129   *buf += n;
130   return true;
131 }
132 
133 void RawLogVA(absl::LogSeverity severity, const char* file, int line,
134               const char* format, va_list ap) ABSL_PRINTF_ATTRIBUTE(4, 0);
RawLogVA(absl::LogSeverity severity,const char * file,int line,const char * format,va_list ap)135 void RawLogVA(absl::LogSeverity severity, const char* file, int line,
136               const char* format, va_list ap) {
137   char buffer[kLogBufSize];
138   char* buf = buffer;
139   int size = sizeof(buffer);
140 #ifdef ABSL_LOW_LEVEL_WRITE_SUPPORTED
141   bool enabled = true;
142 #else
143   bool enabled = false;
144 #endif
145 
146 #ifdef ABSL_MIN_LOG_LEVEL
147   if (severity < static_cast<absl::LogSeverity>(ABSL_MIN_LOG_LEVEL) &&
148       severity < absl::LogSeverity::kFatal) {
149     enabled = false;
150   }
151 #endif
152 
153   auto log_prefix_hook_ptr = log_prefix_hook.Load();
154   if (log_prefix_hook_ptr) {
155     enabled = log_prefix_hook_ptr(severity, file, line, &buf, &size);
156   } else {
157     if (enabled) {
158       DoRawLog(&buf, &size, "[%s : %d] RAW: ", file, line);
159     }
160   }
161   const char* const prefix_end = buf;
162 
163 #ifdef ABSL_LOW_LEVEL_WRITE_SUPPORTED
164   if (enabled) {
165     bool no_chop = VADoRawLog(&buf, &size, format, ap);
166     if (no_chop) {
167       DoRawLog(&buf, &size, "\n");
168     } else {
169       DoRawLog(&buf, &size, "%s", kTruncated);
170     }
171     SafeWriteToStderr(buffer, strlen(buffer));
172   }
173 #else
174   static_cast<void>(format);
175   static_cast<void>(ap);
176 #endif
177 
178   // Abort the process after logging a FATAL message, even if the output itself
179   // was suppressed.
180   if (severity == absl::LogSeverity::kFatal) {
181     abort_hook(file, line, buffer, prefix_end, buffer + kLogBufSize);
182     abort();
183   }
184 }
185 
186 // Non-formatting version of RawLog().
187 //
188 // TODO(gfalcon): When string_view no longer depends on base, change this
189 // interface to take its message as a string_view instead.
DefaultInternalLog(absl::LogSeverity severity,const char * file,int line,const std::string & message)190 void DefaultInternalLog(absl::LogSeverity severity, const char* file, int line,
191                         const std::string& message) {
192   RawLog(severity, file, line, "%.*s", static_cast<int>(message.size()),
193          message.data());
194 }
195 
196 }  // namespace
197 
SafeWriteToStderr(const char * s,size_t len)198 void SafeWriteToStderr(const char *s, size_t len) {
199 #if defined(ABSL_HAVE_SYSCALL_WRITE)
200   syscall(SYS_write, STDERR_FILENO, s, len);
201 #elif defined(ABSL_HAVE_POSIX_WRITE)
202   write(STDERR_FILENO, s, len);
203 #elif defined(ABSL_HAVE_RAW_IO)
204   _write(/* stderr */ 2, s, len);
205 #else
206   // stderr logging unsupported on this platform
207   (void) s;
208   (void) len;
209 #endif
210 }
211 
RawLog(absl::LogSeverity severity,const char * file,int line,const char * format,...)212 void RawLog(absl::LogSeverity severity, const char* file, int line,
213             const char* format, ...) {
214   va_list ap;
215   va_start(ap, format);
216   RawLogVA(severity, file, line, format, ap);
217   va_end(ap);
218 }
219 
RawLoggingFullySupported()220 bool RawLoggingFullySupported() {
221 #ifdef ABSL_LOW_LEVEL_WRITE_SUPPORTED
222   return true;
223 #else  // !ABSL_LOW_LEVEL_WRITE_SUPPORTED
224   return false;
225 #endif  // !ABSL_LOW_LEVEL_WRITE_SUPPORTED
226 }
227 
228 ABSL_INTERNAL_ATOMIC_HOOK_ATTRIBUTES ABSL_DLL
229     absl::base_internal::AtomicHook<InternalLogFunction>
230         internal_log_function(DefaultInternalLog);
231 
RegisterLogPrefixHook(LogPrefixHook func)232 void RegisterLogPrefixHook(LogPrefixHook func) { log_prefix_hook.Store(func); }
233 
RegisterAbortHook(AbortHook func)234 void RegisterAbortHook(AbortHook func) { abort_hook.Store(func); }
235 
RegisterInternalLogFunction(InternalLogFunction func)236 void RegisterInternalLogFunction(InternalLogFunction func) {
237   internal_log_function.Store(func);
238 }
239 
240 }  // namespace raw_logging_internal
241 ABSL_NAMESPACE_END
242 }  // namespace absl
243