mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-29 15:52:07 +00:00
265e672179
# ignore-this-changeset --HG-- extra : amend_source : 4d301d3b0b8711c4692392aa76088ba7fd7d1022
116 lines
3.6 KiB
C++
116 lines
3.6 KiB
C++
/* -*- Mode: C++; tab-width: 20; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
|
|
#ifndef nsCocoaDebugUtils_h_
|
|
#define nsCocoaDebugUtils_h_
|
|
|
|
#include <CoreServices/CoreServices.h>
|
|
|
|
// Definitions and declarations of stuff used by us from the CoreSymbolication
|
|
// framework. This is an undocumented, private framework available on OS X
|
|
// 10.6 and up. It's used by Apple utilities like dtrace, atos, ReportCrash
|
|
// and crashreporterd.
|
|
|
|
typedef struct _CSTypeRef {
|
|
unsigned long type;
|
|
void* contents;
|
|
} CSTypeRef;
|
|
|
|
typedef CSTypeRef CSSymbolicatorRef;
|
|
typedef CSTypeRef CSSymbolOwnerRef;
|
|
typedef CSTypeRef CSSymbolRef;
|
|
typedef CSTypeRef CSSourceInfoRef;
|
|
|
|
typedef struct _CSRange {
|
|
unsigned long long location;
|
|
unsigned long long length;
|
|
} CSRange;
|
|
|
|
typedef unsigned long long CSArchitecture;
|
|
|
|
#define kCSNow LONG_MAX
|
|
|
|
extern "C" {
|
|
|
|
CSSymbolicatorRef CSSymbolicatorCreateWithPid(pid_t pid);
|
|
|
|
CSSymbolicatorRef CSSymbolicatorCreateWithPidFlagsAndNotification(
|
|
pid_t pid, uint32_t flags, uint32_t notification);
|
|
|
|
CSArchitecture CSSymbolicatorGetArchitecture(CSSymbolicatorRef symbolicator);
|
|
|
|
CSSymbolOwnerRef CSSymbolicatorGetSymbolOwnerWithAddressAtTime(
|
|
CSSymbolicatorRef symbolicator, unsigned long long address, long time);
|
|
|
|
const char* CSSymbolOwnerGetName(CSSymbolOwnerRef owner);
|
|
|
|
unsigned long long CSSymbolOwnerGetBaseAddress(CSSymbolOwnerRef owner);
|
|
|
|
CSSymbolRef CSSymbolOwnerGetSymbolWithAddress(CSSymbolOwnerRef owner,
|
|
unsigned long long address);
|
|
|
|
CSSourceInfoRef CSSymbolOwnerGetSourceInfoWithAddress(
|
|
CSSymbolOwnerRef owner, unsigned long long address);
|
|
|
|
const char* CSSymbolGetName(CSSymbolRef symbol);
|
|
|
|
CSRange CSSymbolGetRange(CSSymbolRef symbol);
|
|
|
|
const char* CSSourceInfoGetFilename(CSSourceInfoRef info);
|
|
|
|
uint32_t CSSourceInfoGetLineNumber(CSSourceInfoRef info);
|
|
|
|
CSTypeRef CSRetain(CSTypeRef);
|
|
|
|
void CSRelease(CSTypeRef);
|
|
|
|
bool CSIsNull(CSTypeRef);
|
|
|
|
void CSShow(CSTypeRef);
|
|
|
|
const char* CSArchitectureGetFamilyName(CSArchitecture);
|
|
|
|
} // extern "C"
|
|
|
|
class nsCocoaDebugUtils {
|
|
public:
|
|
// Like NSLog() but records more information (for example the full path to
|
|
// the executable and the "thread name"). Like NSLog(), writes to both
|
|
// stdout and the system log.
|
|
static void DebugLog(const char* aFormat, ...);
|
|
|
|
// Logs a stack trace of the current point of execution, to both stdout and
|
|
// the system log.
|
|
static void PrintStackTrace();
|
|
|
|
// Returns the name of the module that "owns" aAddress. This must be
|
|
// free()ed by the caller.
|
|
static char* GetOwnerName(void* aAddress);
|
|
|
|
// Returns a symbolicated representation of aAddress. This must be
|
|
// free()ed by the caller.
|
|
static char* GetAddressString(void* aAddress);
|
|
|
|
private:
|
|
static void DebugLogInt(bool aDecorate, const char* aFormat, ...);
|
|
static void DebugLogV(bool aDecorate, CFStringRef aFormat, va_list aArgs);
|
|
|
|
static void PrintAddress(void* aAddress);
|
|
|
|
// The values returned by GetOwnerNameInt() and GetAddressStringInt() must
|
|
// be free()ed by the caller.
|
|
static char* GetOwnerNameInt(void* aAddress, CSTypeRef aOwner = sInitializer);
|
|
static char* GetAddressStringInt(void* aAddress,
|
|
CSTypeRef aOwner = sInitializer);
|
|
|
|
static CSSymbolicatorRef GetSymbolicatorRef();
|
|
static void ReleaseSymbolicator();
|
|
|
|
static CSTypeRef sInitializer;
|
|
static CSSymbolicatorRef sSymbolicator;
|
|
};
|
|
|
|
#endif // nsCocoaDebugUtils_h_
|