d5d8d91c1d
Summary: This patch introduces new SB APIs for tracing support inside LLDB. The idea is to gather trace data from LLDB and provide it through this APIs to external tools integrating with LLDB. These tools will be responsible for interpreting and presenting the trace data to their users. The patch implements the following new SB APIs -> -> StartTrace - starts tracing with given parameters -> StopTrace - stops tracing. -> GetTraceData - read the trace data . -> GetMetaData - read the meta data assosciated with the trace. -> GetTraceConfig - read the trace configuration Tracing is associated with a user_id that is returned by the StartTrace API and this id needs to be used for accessing the trace data and also Stopping the trace. The user_id itself may map to tracing the complete process or just an individual thread. The APIs require an additional thread parameter when the user of these APIs wishes to perform thread specific manipulations on the tracing instances. The patch also includes the corresponding python wrappers for the C++ based APIs. Reviewers: k8stone, lldb-commits, clayborg Reviewed By: clayborg Subscribers: jingham, mgorny Differential Revision: https://reviews.llvm.org/D29581 llvm-svn: 301389
59 lines
1.5 KiB
C++
59 lines
1.5 KiB
C++
//===-- SBTraceOptions ------------------------------------------*- C++ -*-===//
|
|
//
|
|
// The LLVM Compiler Infrastructure
|
|
//
|
|
// This file is distributed under the University of Illinois Open Source
|
|
// License. See LICENSE.TXT for details.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef SBTRACEOPTIONS_H_
|
|
#define SBTRACEOPTIONS_H_
|
|
|
|
#include "lldb/API/SBDefines.h"
|
|
|
|
namespace lldb {
|
|
|
|
class LLDB_API SBTraceOptions {
|
|
public:
|
|
SBTraceOptions();
|
|
|
|
lldb::TraceType getType() const;
|
|
|
|
uint64_t getTraceBufferSize() const;
|
|
|
|
/// The trace parameters consist of any custom parameters
|
|
/// apart from the generic parameters such as
|
|
/// TraceType, trace_buffer_size and meta_data_buffer_size.
|
|
/// The returned parameters would be formatted as a JSON Dictionary.
|
|
lldb::SBStructuredData getTraceParams(lldb::SBError &error);
|
|
|
|
uint64_t getMetaDataBufferSize() const;
|
|
|
|
/// SBStructuredData is meant to hold any custom parameters
|
|
/// apart from meta buffer size and trace size. They should
|
|
/// be formatted as a JSON Dictionary.
|
|
void setTraceParams(lldb::SBStructuredData ¶ms);
|
|
|
|
void setType(lldb::TraceType type);
|
|
|
|
void setTraceBufferSize(uint64_t size);
|
|
|
|
void setMetaDataBufferSize(uint64_t size);
|
|
|
|
void setThreadID(lldb::tid_t thread_id);
|
|
|
|
lldb::tid_t getThreadID();
|
|
|
|
bool IsValid();
|
|
|
|
protected:
|
|
friend class SBProcess;
|
|
friend class SBTrace;
|
|
|
|
lldb::TraceOptionsSP m_traceoptions_sp;
|
|
};
|
|
}
|
|
|
|
#endif /* SBTRACEOPTIONS_H_ */
|