12bc53e031
-- c99f979ad34f155fbeeea69b88bdc7458d89a21c by Derek Mauro <dmauro@google.com>: Remove a floating point division by zero test. This isn't testing behavior related to the library, and MSVC warns about it in opt mode. PiperOrigin-RevId: 285220804 -- 68b015491f0dbf1ab547994673281abd1f34cd4b by Gennadiy Rozental <rogeeff@google.com>: This CL introduces following changes to the class FlagImpl: * We eliminate the CommandLineFlagLocks struct. Instead callback guard and callback function are combined into a single CallbackData struct, while primary data lock is stored separately. * CallbackData member of class FlagImpl is initially set to be nullptr and is only allocated and initialized when a flag's callback is being set. For most flags we do not pay for the extra space and extra absl::Mutex now. * Primary data guard is stored in data_guard_ data member. This is a properly aligned character buffer of necessary size. During initialization of the flag we construct absl::Mutex in this space using placement new call. * We now avoid extra value copy after successful attempt to parse value out of string. Instead we swap flag's current value with tentative value we just produced. PiperOrigin-RevId: 285132636 -- ed45d118fb818969eb13094cf7827c885dfc562c by Tom Manshreck <shreck@google.com>: Change null-term* (and nul-term*) to NUL-term* in comments PiperOrigin-RevId: 285036610 -- 729619017944db895ce8d6d29c1995aa2e5628a5 by Derek Mauro <dmauro@google.com>: Use the Posix implementation of thread identity on MinGW. Some versions of MinGW suffer from thread_local bugs. PiperOrigin-RevId: 285022920 -- 39a25493503c76885bc3254c28f66a251c5b5bb0 by Greg Falcon <gfalcon@google.com>: Implementation detail change. Add further ABSL_NAMESPACE_BEGIN and _END annotation macros to files in Abseil. PiperOrigin-RevId: 285012012 GitOrigin-RevId: c99f979ad34f155fbeeea69b88bdc7458d89a21c Change-Id: I4c85d3704e45d11a9ac50d562f39640a6adbedc1
99 lines
3.5 KiB
C++
99 lines
3.5 KiB
C++
// Copyright 2018 The Abseil Authors.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// https://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
//
|
|
// -----------------------------------------------------------------------------
|
|
// File: symbolize.h
|
|
// -----------------------------------------------------------------------------
|
|
//
|
|
// This file configures the Abseil symbolizer for use in converting instruction
|
|
// pointer addresses (program counters) into human-readable names (function
|
|
// calls, etc.) within Abseil code.
|
|
//
|
|
// The symbolizer may be invoked from several sources:
|
|
//
|
|
// * Implicitly, through the installation of an Abseil failure signal handler.
|
|
// (See failure_signal_handler.h for more information.)
|
|
// * By calling `Symbolize()` directly on a program counter you obtain through
|
|
// `absl::GetStackTrace()` or `absl::GetStackFrames()`. (See stacktrace.h
|
|
// for more information.
|
|
// * By calling `Symbolize()` directly on a program counter you obtain through
|
|
// other means (which would be platform-dependent).
|
|
//
|
|
// In all of the above cases, the symbolizer must first be initialized before
|
|
// any program counter values can be symbolized. If you are installing a failure
|
|
// signal handler, initialize the symbolizer before you do so.
|
|
//
|
|
// Example:
|
|
//
|
|
// int main(int argc, char** argv) {
|
|
// // Initialize the Symbolizer before installing the failure signal handler
|
|
// absl::InitializeSymbolizer(argv[0]);
|
|
//
|
|
// // Now you may install the failure signal handler
|
|
// absl::FailureSignalHandlerOptions options;
|
|
// absl::InstallFailureSignalHandler(options);
|
|
//
|
|
// // Start running your main program
|
|
// ...
|
|
// return 0;
|
|
// }
|
|
//
|
|
#ifndef ABSL_DEBUGGING_SYMBOLIZE_H_
|
|
#define ABSL_DEBUGGING_SYMBOLIZE_H_
|
|
|
|
#include "absl/debugging/internal/symbolize.h"
|
|
|
|
namespace absl {
|
|
ABSL_NAMESPACE_BEGIN
|
|
|
|
// InitializeSymbolizer()
|
|
//
|
|
// Initializes the program counter symbolizer, given the path of the program
|
|
// (typically obtained through `main()`s `argv[0]`). The Abseil symbolizer
|
|
// allows you to read program counters (instruction pointer values) using their
|
|
// human-readable names within output such as stack traces.
|
|
//
|
|
// Example:
|
|
//
|
|
// int main(int argc, char *argv[]) {
|
|
// absl::InitializeSymbolizer(argv[0]);
|
|
// // Now you can use the symbolizer
|
|
// }
|
|
void InitializeSymbolizer(const char* argv0);
|
|
|
|
// Symbolize()
|
|
//
|
|
// Symbolizes a program counter (instruction pointer value) `pc` and, on
|
|
// success, writes the name to `out`. The symbol name is demangled, if possible.
|
|
// Note that the symbolized name may be truncated and will be NUL-terminated.
|
|
// Demangling is supported for symbols generated by GCC 3.x or newer). Returns
|
|
// `false` on failure.
|
|
//
|
|
// Example:
|
|
//
|
|
// // Print a program counter and its symbol name.
|
|
// static void DumpPCAndSymbol(void *pc) {
|
|
// char tmp[1024];
|
|
// const char *symbol = "(unknown)";
|
|
// if (absl::Symbolize(pc, tmp, sizeof(tmp))) {
|
|
// symbol = tmp;
|
|
// }
|
|
// absl::PrintF("%*p %s\n", pc, symbol);
|
|
// }
|
|
bool Symbolize(const void *pc, char *out, int out_size);
|
|
|
|
ABSL_NAMESPACE_END
|
|
} // namespace absl
|
|
|
|
#endif // ABSL_DEBUGGING_SYMBOLIZE_H_
|