Summary:
This change adds APIs to allow logging implementations to provide a
function for iterating through in-memory buffers (if they hold in-memory
buffers) and a way for users to generically deal with these buffers
in-process. These APIs are:
- __xray_log_set_buffer_iterator(...) and
__xray_log_remove_buffer_iterator(): installs and removes an
iterator function that takes an XRayBuffer and yields the next one.
- __xray_log_process_buffers(...): takes a function pointer that can
take a mode identifier (string) and an XRayBuffer to process this
data as they see fit.
The intent is to have the FDR mode implementation's buffers be
available through this `__xray_log_process_buffers(...)` API, so that
they can be streamed from memory instead of flushed to disk (useful for
getting the data to a network, or doing in-process analysis).
Basic mode logging will not support this mechanism as it's designed to
write the data mostly to disk.
Future implementations will may depend on this API as well, to allow for
programmatically working through the XRay buffers exposed to the
users in some fashion.
Reviewers: eizan, kpw, pelikan
Subscribers: llvm-commits
Differential Revision: https://reviews.llvm.org/D43495
llvm-svn: 326866
172 lines
6.2 KiB
C++
172 lines
6.2 KiB
C++
//===-- xray_log_interface.cc ---------------------------------------------===//
|
|
//
|
|
// The LLVM Compiler Infrastructure
|
|
//
|
|
// This file is distributed under the University of Illinois Open Source
|
|
// License. See LICENSE.TXT for details.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This file is a part of XRay, a function call tracing system.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
#include "xray/xray_log_interface.h"
|
|
|
|
#include "sanitizer_common/sanitizer_allocator_internal.h"
|
|
#include "sanitizer_common/sanitizer_atomic.h"
|
|
#include "sanitizer_common/sanitizer_mutex.h"
|
|
#include "xray/xray_interface.h"
|
|
#include "xray_defs.h"
|
|
|
|
namespace __xray {
|
|
static __sanitizer::SpinMutex XRayImplMutex;
|
|
static XRayLogImpl CurrentXRayImpl{nullptr, nullptr, nullptr, nullptr};
|
|
static XRayLogImpl *GlobalXRayImpl = nullptr;
|
|
|
|
// This is the default implementation of a buffer iterator, which always yields
|
|
// a null buffer.
|
|
XRayBuffer NullBufferIterator(XRayBuffer) XRAY_NEVER_INSTRUMENT {
|
|
return {nullptr, 0};
|
|
}
|
|
|
|
// This is the global function responsible for iterating through given buffers.
|
|
__sanitizer::atomic_uintptr_t XRayBufferIterator{
|
|
reinterpret_cast<uintptr_t>(&NullBufferIterator)};
|
|
|
|
// We use a linked list of Mode to XRayLogImpl mappings. This is a linked list
|
|
// when it should be a map because we're avoiding having to depend on C++
|
|
// standard library data structures at this level of the implementation.
|
|
struct ModeImpl {
|
|
ModeImpl *Next;
|
|
const char *Mode;
|
|
XRayLogImpl Impl;
|
|
};
|
|
|
|
static ModeImpl SentinelModeImpl{
|
|
nullptr, nullptr, {nullptr, nullptr, nullptr, nullptr}};
|
|
static ModeImpl *ModeImpls = &SentinelModeImpl;
|
|
static const ModeImpl *CurrentMode = nullptr;
|
|
|
|
} // namespace __xray
|
|
|
|
using namespace __xray;
|
|
|
|
void __xray_log_set_buffer_iterator(XRayBuffer (*Iterator)(XRayBuffer))
|
|
XRAY_NEVER_INSTRUMENT {
|
|
__sanitizer::atomic_store(&__xray::XRayBufferIterator,
|
|
reinterpret_cast<uintptr_t>(Iterator),
|
|
__sanitizer::memory_order_release);
|
|
}
|
|
|
|
void __xray_log_remove_buffer_iterator() XRAY_NEVER_INSTRUMENT {
|
|
__xray_log_set_buffer_iterator(&NullBufferIterator);
|
|
}
|
|
|
|
XRayLogRegisterStatus
|
|
__xray_log_register_mode(const char *Mode,
|
|
XRayLogImpl Impl) XRAY_NEVER_INSTRUMENT {
|
|
if (Impl.flush_log == nullptr || Impl.handle_arg0 == nullptr ||
|
|
Impl.log_finalize == nullptr || Impl.log_init == nullptr)
|
|
return XRayLogRegisterStatus::XRAY_INCOMPLETE_IMPL;
|
|
|
|
__sanitizer::SpinMutexLock Guard(&XRayImplMutex);
|
|
// First, look for whether the mode already has a registered implementation.
|
|
for (ModeImpl *it = ModeImpls; it != &SentinelModeImpl; it = it->Next) {
|
|
if (!__sanitizer::internal_strcmp(Mode, it->Mode))
|
|
return XRayLogRegisterStatus::XRAY_DUPLICATE_MODE;
|
|
}
|
|
auto *NewModeImpl =
|
|
static_cast<ModeImpl *>(__sanitizer::InternalAlloc(sizeof(ModeImpl)));
|
|
NewModeImpl->Next = ModeImpls;
|
|
NewModeImpl->Mode = __sanitizer::internal_strdup(Mode);
|
|
NewModeImpl->Impl = Impl;
|
|
ModeImpls = NewModeImpl;
|
|
return XRayLogRegisterStatus::XRAY_REGISTRATION_OK;
|
|
}
|
|
|
|
XRayLogRegisterStatus
|
|
__xray_log_select_mode(const char *Mode) XRAY_NEVER_INSTRUMENT {
|
|
__sanitizer::SpinMutexLock Guard(&XRayImplMutex);
|
|
for (ModeImpl *it = ModeImpls; it != &SentinelModeImpl; it = it->Next) {
|
|
if (!__sanitizer::internal_strcmp(Mode, it->Mode)) {
|
|
CurrentMode = it;
|
|
CurrentXRayImpl = it->Impl;
|
|
GlobalXRayImpl = &CurrentXRayImpl;
|
|
__xray_set_handler(it->Impl.handle_arg0);
|
|
return XRayLogRegisterStatus::XRAY_REGISTRATION_OK;
|
|
}
|
|
}
|
|
return XRayLogRegisterStatus::XRAY_MODE_NOT_FOUND;
|
|
}
|
|
|
|
const char *__xray_log_get_current_mode() XRAY_NEVER_INSTRUMENT {
|
|
__sanitizer::SpinMutexLock Guard(&XRayImplMutex);
|
|
if (CurrentMode != nullptr)
|
|
return CurrentMode->Mode;
|
|
return nullptr;
|
|
}
|
|
|
|
void __xray_set_log_impl(XRayLogImpl Impl) XRAY_NEVER_INSTRUMENT {
|
|
if (Impl.log_init == nullptr || Impl.log_finalize == nullptr ||
|
|
Impl.handle_arg0 == nullptr || Impl.flush_log == nullptr) {
|
|
__sanitizer::SpinMutexLock Guard(&XRayImplMutex);
|
|
GlobalXRayImpl = nullptr;
|
|
CurrentMode = nullptr;
|
|
__xray_remove_handler();
|
|
__xray_remove_handler_arg1();
|
|
return;
|
|
}
|
|
|
|
__sanitizer::SpinMutexLock Guard(&XRayImplMutex);
|
|
CurrentXRayImpl = Impl;
|
|
GlobalXRayImpl = &CurrentXRayImpl;
|
|
__xray_set_handler(Impl.handle_arg0);
|
|
}
|
|
|
|
void __xray_remove_log_impl() XRAY_NEVER_INSTRUMENT {
|
|
__sanitizer::SpinMutexLock Guard(&XRayImplMutex);
|
|
GlobalXRayImpl = nullptr;
|
|
__xray_remove_handler();
|
|
__xray_remove_handler_arg1();
|
|
}
|
|
|
|
XRayLogInitStatus __xray_log_init(size_t BufferSize, size_t MaxBuffers,
|
|
void *Args,
|
|
size_t ArgsSize) XRAY_NEVER_INSTRUMENT {
|
|
__sanitizer::SpinMutexLock Guard(&XRayImplMutex);
|
|
if (!GlobalXRayImpl)
|
|
return XRayLogInitStatus::XRAY_LOG_UNINITIALIZED;
|
|
return GlobalXRayImpl->log_init(BufferSize, MaxBuffers, Args, ArgsSize);
|
|
}
|
|
|
|
XRayLogInitStatus __xray_log_finalize() XRAY_NEVER_INSTRUMENT {
|
|
__sanitizer::SpinMutexLock Guard(&XRayImplMutex);
|
|
if (!GlobalXRayImpl)
|
|
return XRayLogInitStatus::XRAY_LOG_UNINITIALIZED;
|
|
return GlobalXRayImpl->log_finalize();
|
|
}
|
|
|
|
XRayLogFlushStatus __xray_log_flushLog() XRAY_NEVER_INSTRUMENT {
|
|
__sanitizer::SpinMutexLock Guard(&XRayImplMutex);
|
|
if (!GlobalXRayImpl)
|
|
return XRayLogFlushStatus::XRAY_LOG_NOT_FLUSHING;
|
|
return GlobalXRayImpl->flush_log();
|
|
}
|
|
|
|
XRayLogFlushStatus __xray_log_process_buffers(
|
|
void (*Processor)(const char *, XRayBuffer)) XRAY_NEVER_INSTRUMENT {
|
|
// We want to make sure that there will be no changes to the global state for
|
|
// the log by synchronising on the XRayBufferIteratorMutex.
|
|
if (!GlobalXRayImpl)
|
|
return XRayLogFlushStatus::XRAY_LOG_NOT_FLUSHING;
|
|
auto Iterator = reinterpret_cast<XRayBuffer (*)(XRayBuffer)>(
|
|
atomic_load(&XRayBufferIterator, __sanitizer::memory_order_acquire));
|
|
auto Buffer = (*Iterator)(XRayBuffer{nullptr, 0});
|
|
auto Mode = CurrentMode ? CurrentMode->Mode : nullptr;
|
|
while (Buffer.Data != nullptr) {
|
|
(*Processor)(Mode, Buffer);
|
|
Buffer = (*Iterator)(Buffer);
|
|
}
|
|
return XRayLogFlushStatus::XRAY_LOG_FLUSHED;
|
|
}
|