Files
clang-p2996/lldb/tools/debugserver/source/MacOSX/Genealogy.h
Jason Molenda 705b180964 Initial merge of some of the iOS 8 / Mac OS X Yosemite specific
lldb support.  I'll be doing more testing & cleanup but I wanted to
get the initial checkin done.

This adds a new SBExpressionOptions::SetLanguage API for selecting a
language of an expression.

I added adds a new SBThread::GetInfoItemByPathString for retriving
information about a thread from that thread's StructuredData.

I added a new StructuredData class for representing
key-value/array/dictionary information (e.g. JSON formatted data).
Helper functions to read JSON and create a StructuredData object,
and to print a StructuredData object in JSON format are included.

A few Cocoa / Cocoa Touch data formatters were updated by Enrico
to track changes in iOS 8 / Yosemite.

Before we query a thread's extended information, the system runtime may 
provide hints to the remote debug stub that it will use to retrieve values
out of runtime structures.  I added a new SystemRuntime method 
AddThreadExtendedInfoPacketHints which allows the SystemRuntime to add 
key-value type data to the initial request that we send to the remote stub.

The thread-format formatter string can now retrieve values out of a thread's
extended info structured data.  The default thread-format string picks up
two of these - thread.info.activity.name and thread.info.trace_messages.

I added a new "jThreadExtendedInfo" packet in debugserver; I will
add documentation to the lldb-gdb-remote.txt doc soon.  It accepts
JSON formatted arguments (most importantly, "thread":threadnum) and
it returns a variety of information regarding the thread to lldb
in JSON format.  This JSON return is scanned into a StructuredData
object that is associated with the thread; UI layers can query the
thread's StructuredData to see if key-values are present, and if
so, show them to the user.  These key-values are likely to be
specific to different targets with some commonality among many
targets.  For instance, many targets will be able to advertise the
pthread_t value for a thread.

I added an initial rough cut of "thread info" command which will print
the information about a thread from the jThreadExtendedInfo result.
I need to do more work to make this format reasonably.

Han Ming added calls into the pmenergy and pmsample libraries if
debugserver is run on Mac OS X Yosemite to get information about the
inferior's power use.

I added support to debugserver for gathering the Genealogy information
about threads, if it exists, and returning it in the jThreadExtendedInfo
JSON result.

llvm-svn: 210874
2014-06-13 02:37:02 +00:00

117 lines
4.0 KiB
C++

//===-- Activity.h -----------------------------------------------*- C++ -*-===//
//
// The LLVM Compiler Infrastructure
//
// This file is distributed under the University of Illinois Open Source
// License. See LICENSE.TXT for details.
//
//===----------------------------------------------------------------------===//
#ifndef __Genealogy_h__
#define __Genealogy_h__
#include <string>
#include <vector>
#include <map>
#include <pthread.h>
#include <mach/task.h>
#include "GenealogySPI.h"
#include "MachThreadList.h"
class Genealogy
{
public:
Genealogy ();
~Genealogy ()
{
}
void
Clear();
struct Breadcrumb
{
uint32_t breadcrumb_id;
uint64_t activity_id;
uint64_t timestamp;
std::string name;
};
struct Activity
{
uint64_t activity_start;
uint64_t activity_id;
uint64_t parent_id;
std::string activity_name;
std::string reason;
};
struct Message
{
uint64_t timestamp;
uint64_t activity_id;
uint64_t trace_id;
uint64_t thread;
uint8_t type; // OS_TRACE_TYPE_RELEASE, OS_TRACE_TYPE_DEBUG, OS_TRACE_TYPE_ERROR, OS_TRACE_TYPE_FAULT
uint32_t process_info_index; // index # of the image uuid/file path, 0 means unknown
std::string message;
};
typedef std::vector<Message> MessageList;
typedef std::vector<Breadcrumb> BreadcrumbList;
typedef std::vector<Activity> ActivityList;
struct ThreadActivity
{
Activity current_activity;
MessageList messages;
BreadcrumbList breadcrumbs; // should be 0 or 1 breadcrumbs; no more than 1 BC for any given activity
};
typedef std::shared_ptr<ThreadActivity> ThreadActivitySP;
ThreadActivitySP
GetGenealogyInfoForThread (pid_t pid, nub_thread_t tid, const MachThreadList &thread_list, task_t task, bool &timed_out);
struct ProcessExecutableInfo
{
std::string image_path;
uuid_t image_uuid;
};
typedef std::shared_ptr<ProcessExecutableInfo> ProcessExecutableInfoSP;
ProcessExecutableInfoSP
GetProcessExecutableInfosAtIndex(uint32_t idx);
uint32_t
AddProcessExecutableInfo(ProcessExecutableInfoSP process_exe_info);
private:
void
GetActivities(pid_t pid, const MachThreadList &thread_list, task_t task);
// the spi we need to call into libtrace - look them up via dlsym at runtime
bool (*m_os_activity_diagnostic_for_pid) (pid_t pid, os_activity_t activity, uint32_t flags, os_diagnostic_block_t block);
void (*m_os_activity_iterate_processes) (os_activity_process_list_t processes, bool (^iterator)(os_activity_process_t process_info));
void (*m_os_activity_iterate_breadcrumbs) (os_activity_process_t process_info, bool (^iterator)(os_activity_breadcrumb_t breadcrumb));
void (*m_os_activity_iterate_messages) (os_trace_message_list_t messages, os_activity_process_t process_info, bool (^iterator)(os_trace_message_t tracemsg));
void (*m_os_activity_iterate_activities) (os_activity_list_t activities, os_activity_process_t process_info, bool (^iterator)(os_activity_entry_t activity));
uint8_t (*m_os_trace_get_type) (os_trace_message_t trace_msg);
char * (*m_os_trace_copy_formatted_message) (os_trace_message_t trace_msg);
os_activity_t (*m_os_activity_for_thread) (os_activity_process_t process, uint64_t thread_id);
os_activity_t (*m_os_activity_for_task_thread) (task_t target, uint64_t thread_id);
os_trace_message_list_t (*m_os_activity_messages_for_thread) (os_activity_process_t process, os_activity_t activity, uint64_t thread_id);
std::map<nub_thread_t, ThreadActivitySP> m_thread_activities;
std::vector<ProcessExecutableInfoSP> m_process_executable_infos;
bool m_diagnosticd_call_timed_out;
};
#endif // __Genealogy_h__