[PATCH] D32579: [XRay][compiler-rt] Document and update the XRay Logging API

[Dean Michael Berris via Phabricator via llvm-commits]

dberris created this revision.

In this patch we document the requirements for implementations that want
to install handlers for the dynamically-controlled XRay "framework".
This clarifies what the expectations are for implementations that
want to install their handlers using this API (similar to how the FDR
logging implementation does so). It also gives users some guarantees on
semantics for the APIs.

If all goes well, users can decide to use the XRay APIs to control the
tracing/logging at the application level, without having to depend on
implementation details of the installed logging implementation. This
lets users choose the implementation that comes with compiler-rt, or
potentially multiple other implementations that use the same APIs.

We also add one convenience function (__xray_remove_log_impl()) for
explicitly removing the currently installed log implementation.


https://reviews.llvm.org/D32579

Files:
  include/xray/xray_log_interface.h
  lib/xray/xray_log_interface.cc

-------------- next part --------------
A non-text attachment was scrubbed...
Name: D32579.96866.patch
Type: text/x-patch
Size: 8717 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/llvm-commits/attachments/20170427/a7e03f57/attachment.bin>