c1b4632528
Copying from the inline documentation: ``` Trace exporter plug-ins operate on traces, converting the trace data provided by an \a lldb_private::TraceCursor into a different format that can be digested by other tools, e.g. Chrome Trace Event Profiler. Trace exporters are supposed to operate on an architecture-agnostic fashion, as a TraceCursor, which feeds the data, hides the actual trace technology being used. ``` I want to use this to make the code in https://reviews.llvm.org/D105741 a plug-in. I also imagine that there will be more and more exporters being implemented, as an exporter creates something useful out of trace data. And tbh I don't want to keep adding more stuff to the lldb/Target folder. This is the minimal definition for a TraceExporter plugin. I plan to use this with the following commands: - thread trace export <plug-in name> [plug-in specific args] - This command would support autocompletion of plug-in names - thread trace export list - This command would list the available trace exporter plug-ins I don't plan to create yet a "process trace export" because it's easier to start analyzing the trace of a given thread than of the entire process. When we need a process-level command, we can implement it. I also don't plan to force each "export" command implementation to support multiple threads (for example, "thread trace start 1 2 3" or "thread trace start all" operate on many threads simultaneously). The reason is that the format used by the exporter might or might not support multiple threads, so I'm leaving this decision to each trace exporter plug-in. Differential Revision: https://reviews.llvm.org/D106501
67 lines
2.1 KiB
C++
67 lines
2.1 KiB
C++
//===-- CommandObjectThreadTraceExportCTF.cpp -----------------------------===//
|
|
//
|
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
// See https://llvm.org/LICENSE.txt for license information.
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#include "CommandObjectThreadTraceExportCTF.h"
|
|
|
|
#include "lldb/Host/OptionParser.h"
|
|
|
|
using namespace lldb;
|
|
using namespace lldb_private;
|
|
using namespace lldb_private::ctf;
|
|
using namespace llvm;
|
|
|
|
// CommandObjectThreadTraceExportCTF
|
|
|
|
#define LLDB_OPTIONS_thread_trace_export_ctf
|
|
#include "TraceExporterCTFCommandOptions.inc"
|
|
|
|
Status CommandObjectThreadTraceExportCTF::CommandOptions::SetOptionValue(
|
|
uint32_t option_idx, llvm::StringRef option_arg,
|
|
ExecutionContext *execution_context) {
|
|
Status error;
|
|
const int short_option = m_getopt_table[option_idx].val;
|
|
|
|
switch (short_option) {
|
|
case 't': {
|
|
int64_t thread_index;
|
|
if (option_arg.empty() || option_arg.getAsInteger(0, thread_index) ||
|
|
thread_index < 0)
|
|
error.SetErrorStringWithFormat("invalid integer value for option '%s'",
|
|
option_arg.str().c_str());
|
|
else
|
|
m_thread_index = thread_index;
|
|
break;
|
|
}
|
|
default:
|
|
llvm_unreachable("Unimplemented option");
|
|
}
|
|
return error;
|
|
}
|
|
|
|
void CommandObjectThreadTraceExportCTF::CommandOptions::OptionParsingStarting(
|
|
ExecutionContext *execution_context) {
|
|
m_thread_index = None;
|
|
}
|
|
|
|
llvm::ArrayRef<OptionDefinition>
|
|
CommandObjectThreadTraceExportCTF::CommandOptions::GetDefinitions() {
|
|
return llvm::makeArrayRef(g_thread_trace_export_ctf_options);
|
|
}
|
|
|
|
bool CommandObjectThreadTraceExportCTF::DoExecute(Args &command,
|
|
CommandReturnObject &result) {
|
|
Stream &s = result.GetOutputStream();
|
|
// TODO: create an actual instance of the exporter and invoke it
|
|
if (m_options.m_thread_index)
|
|
s.Printf("got thread index %d\n", (int)m_options.m_thread_index.getValue());
|
|
else
|
|
s.Printf("didn't get a thread index\n");
|
|
|
|
return result.Succeeded();
|
|
}
|