2010-06-09 00:52:24 +08:00
|
|
|
//===-- SBModule.cpp --------------------------------------------*- C++ -*-===//
|
|
|
|
//
|
|
|
|
// The LLVM Compiler Infrastructure
|
|
|
|
//
|
|
|
|
// This file is distributed under the University of Illinois Open Source
|
|
|
|
// License. See LICENSE.TXT for details.
|
|
|
|
//
|
|
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
|
|
|
|
#include "lldb/API/SBModule.h"
|
2010-09-11 02:31:35 +08:00
|
|
|
#include "lldb/API/SBAddress.h"
|
|
|
|
#include "lldb/API/SBFileSpec.h"
|
2012-02-05 10:38:54 +08:00
|
|
|
#include "lldb/API/SBProcess.h"
|
2010-09-20 13:20:02 +08:00
|
|
|
#include "lldb/API/SBStream.h"
|
2011-06-21 09:34:41 +08:00
|
|
|
#include "lldb/API/SBSymbolContextList.h"
|
2010-06-09 00:52:24 +08:00
|
|
|
#include "lldb/Core/Module.h"
|
2010-10-26 11:11:13 +08:00
|
|
|
#include "lldb/Core/Log.h"
|
2010-11-01 03:57:43 +08:00
|
|
|
#include "lldb/Core/StreamString.h"
|
2011-06-30 06:09:02 +08:00
|
|
|
#include "lldb/Core/ValueObjectList.h"
|
|
|
|
#include "lldb/Core/ValueObjectVariable.h"
|
2011-07-30 03:53:35 +08:00
|
|
|
#include "lldb/Symbol/SymbolVendor.h"
|
2011-06-30 06:09:02 +08:00
|
|
|
#include "lldb/Symbol/VariableList.h"
|
|
|
|
#include "lldb/Target/Target.h"
|
2010-06-09 00:52:24 +08:00
|
|
|
|
|
|
|
using namespace lldb;
|
2010-10-26 11:11:13 +08:00
|
|
|
using namespace lldb_private;
|
2010-06-09 00:52:24 +08:00
|
|
|
|
|
|
|
|
|
|
|
SBModule::SBModule () :
|
2010-06-23 09:19:29 +08:00
|
|
|
m_opaque_sp ()
|
2010-06-09 00:52:24 +08:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
|
|
|
SBModule::SBModule (const lldb::ModuleSP& module_sp) :
|
2010-06-23 09:19:29 +08:00
|
|
|
m_opaque_sp (module_sp)
|
2010-06-09 00:52:24 +08:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2010-11-06 07:17:00 +08:00
|
|
|
SBModule::SBModule(const SBModule &rhs) :
|
|
|
|
m_opaque_sp (rhs.m_opaque_sp)
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2012-02-05 10:38:54 +08:00
|
|
|
SBModule::SBModule (lldb::SBProcess &process, lldb::addr_t header_addr) :
|
|
|
|
m_opaque_sp ()
|
|
|
|
{
|
|
|
|
ProcessSP process_sp (process.GetSP());
|
|
|
|
if (process_sp)
|
2012-02-14 07:10:39 +08:00
|
|
|
{
|
|
|
|
const bool add_image_to_target = true;
|
|
|
|
const bool load_image_sections_in_target = true;
|
|
|
|
m_opaque_sp = process_sp->ReadModuleFromMemory (FileSpec(),
|
|
|
|
header_addr,
|
|
|
|
add_image_to_target,
|
|
|
|
load_image_sections_in_target);
|
|
|
|
}
|
2012-02-05 10:38:54 +08:00
|
|
|
}
|
|
|
|
|
2010-11-06 07:17:00 +08:00
|
|
|
const SBModule &
|
|
|
|
SBModule::operator = (const SBModule &rhs)
|
|
|
|
{
|
|
|
|
if (this != &rhs)
|
|
|
|
m_opaque_sp = rhs.m_opaque_sp;
|
|
|
|
return *this;
|
|
|
|
}
|
|
|
|
|
2010-06-09 00:52:24 +08:00
|
|
|
SBModule::~SBModule ()
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
|
|
|
bool
|
|
|
|
SBModule::IsValid () const
|
|
|
|
{
|
2010-06-23 09:19:29 +08:00
|
|
|
return m_opaque_sp.get() != NULL;
|
2010-06-09 00:52:24 +08:00
|
|
|
}
|
|
|
|
|
2011-12-20 04:39:44 +08:00
|
|
|
void
|
|
|
|
SBModule::Clear()
|
|
|
|
{
|
|
|
|
m_opaque_sp.reset();
|
|
|
|
}
|
|
|
|
|
2010-06-09 00:52:24 +08:00
|
|
|
SBFileSpec
|
|
|
|
SBModule::GetFileSpec () const
|
|
|
|
{
|
2010-11-06 09:53:30 +08:00
|
|
|
LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_API));
|
2010-10-26 11:11:13 +08:00
|
|
|
|
2010-06-09 00:52:24 +08:00
|
|
|
SBFileSpec file_spec;
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (module_sp)
|
|
|
|
file_spec.SetFileSpec(module_sp->GetFileSpec());
|
2010-10-26 11:11:13 +08:00
|
|
|
|
|
|
|
if (log)
|
|
|
|
{
|
2010-10-31 11:01:06 +08:00
|
|
|
log->Printf ("SBModule(%p)::GetFileSpec () => SBFileSpec(%p)",
|
2012-02-23 03:41:02 +08:00
|
|
|
module_sp.get(), file_spec.get());
|
2010-10-26 11:11:13 +08:00
|
|
|
}
|
|
|
|
|
2010-06-09 00:52:24 +08:00
|
|
|
return file_spec;
|
|
|
|
}
|
|
|
|
|
2011-04-30 09:09:13 +08:00
|
|
|
lldb::SBFileSpec
|
|
|
|
SBModule::GetPlatformFileSpec () const
|
|
|
|
{
|
|
|
|
LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_API));
|
|
|
|
|
|
|
|
SBFileSpec file_spec;
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (module_sp)
|
|
|
|
file_spec.SetFileSpec(module_sp->GetPlatformFileSpec());
|
2011-04-30 09:09:13 +08:00
|
|
|
|
|
|
|
if (log)
|
|
|
|
{
|
|
|
|
log->Printf ("SBModule(%p)::GetPlatformFileSpec () => SBFileSpec(%p)",
|
2012-02-23 03:41:02 +08:00
|
|
|
module_sp.get(), file_spec.get());
|
2011-04-30 09:09:13 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
return file_spec;
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
bool
|
|
|
|
SBModule::SetPlatformFileSpec (const lldb::SBFileSpec &platform_file)
|
|
|
|
{
|
|
|
|
bool result = false;
|
|
|
|
LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_API));
|
|
|
|
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (module_sp)
|
2011-04-30 09:09:13 +08:00
|
|
|
{
|
2012-02-23 03:41:02 +08:00
|
|
|
module_sp->SetPlatformFileSpec(*platform_file);
|
2011-04-30 09:09:13 +08:00
|
|
|
result = true;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (log)
|
|
|
|
{
|
|
|
|
log->Printf ("SBModule(%p)::SetPlatformFileSpec (SBFileSpec(%p (%s%s%s)) => %i",
|
2012-02-23 03:41:02 +08:00
|
|
|
module_sp.get(),
|
2011-04-30 09:09:13 +08:00
|
|
|
platform_file.get(),
|
|
|
|
platform_file->GetDirectory().GetCString(),
|
|
|
|
platform_file->GetDirectory() ? "/" : "",
|
|
|
|
platform_file->GetFilename().GetCString(),
|
|
|
|
result);
|
|
|
|
}
|
|
|
|
return result;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
2010-06-09 00:52:24 +08:00
|
|
|
const uint8_t *
|
|
|
|
SBModule::GetUUIDBytes () const
|
|
|
|
{
|
2010-11-06 09:53:30 +08:00
|
|
|
LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_API));
|
2010-10-26 11:11:13 +08:00
|
|
|
|
2010-10-30 12:51:46 +08:00
|
|
|
const uint8_t *uuid_bytes = NULL;
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (module_sp)
|
|
|
|
uuid_bytes = (const uint8_t *)module_sp->GetUUID().GetBytes();
|
2010-10-30 12:51:46 +08:00
|
|
|
|
|
|
|
if (log)
|
2010-10-26 11:11:13 +08:00
|
|
|
{
|
2010-10-30 12:51:46 +08:00
|
|
|
if (uuid_bytes)
|
2010-10-26 11:11:13 +08:00
|
|
|
{
|
2010-10-30 12:51:46 +08:00
|
|
|
StreamString s;
|
2012-02-23 03:41:02 +08:00
|
|
|
module_sp->GetUUID().Dump (&s);
|
|
|
|
log->Printf ("SBModule(%p)::GetUUIDBytes () => %s", module_sp.get(), s.GetData());
|
2010-10-26 11:11:13 +08:00
|
|
|
}
|
2010-10-30 12:51:46 +08:00
|
|
|
else
|
2012-02-23 03:41:02 +08:00
|
|
|
log->Printf ("SBModule(%p)::GetUUIDBytes () => NULL", module_sp.get());
|
2010-10-26 11:11:13 +08:00
|
|
|
}
|
2010-10-30 12:51:46 +08:00
|
|
|
return uuid_bytes;
|
2010-06-09 00:52:24 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
2011-04-01 08:35:55 +08:00
|
|
|
const char *
|
|
|
|
SBModule::GetUUIDString () const
|
|
|
|
{
|
|
|
|
LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_API));
|
|
|
|
|
|
|
|
static char uuid_string[80];
|
|
|
|
const char * uuid_c_string = NULL;
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (module_sp)
|
|
|
|
uuid_c_string = (const char *)module_sp->GetUUID().GetAsCString(uuid_string, sizeof(uuid_string));
|
2011-04-01 08:35:55 +08:00
|
|
|
|
|
|
|
if (log)
|
|
|
|
{
|
|
|
|
if (uuid_c_string)
|
|
|
|
{
|
|
|
|
StreamString s;
|
2012-02-23 03:41:02 +08:00
|
|
|
module_sp->GetUUID().Dump (&s);
|
|
|
|
log->Printf ("SBModule(%p)::GetUUIDString () => %s", module_sp.get(), s.GetData());
|
2011-04-01 08:35:55 +08:00
|
|
|
}
|
|
|
|
else
|
2012-02-23 03:41:02 +08:00
|
|
|
log->Printf ("SBModule(%p)::GetUUIDString () => NULL", module_sp.get());
|
2011-04-01 08:35:55 +08:00
|
|
|
}
|
|
|
|
return uuid_c_string;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2010-06-09 00:52:24 +08:00
|
|
|
bool
|
|
|
|
SBModule::operator == (const SBModule &rhs) const
|
|
|
|
{
|
2010-06-23 09:19:29 +08:00
|
|
|
if (m_opaque_sp)
|
|
|
|
return m_opaque_sp.get() == rhs.m_opaque_sp.get();
|
2010-06-09 00:52:24 +08:00
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
bool
|
|
|
|
SBModule::operator != (const SBModule &rhs) const
|
|
|
|
{
|
2010-06-23 09:19:29 +08:00
|
|
|
if (m_opaque_sp)
|
|
|
|
return m_opaque_sp.get() != rhs.m_opaque_sp.get();
|
2010-06-09 00:52:24 +08:00
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
2012-01-30 17:04:36 +08:00
|
|
|
ModuleSP
|
|
|
|
SBModule::GetSP () const
|
2011-09-24 08:52:29 +08:00
|
|
|
{
|
|
|
|
return m_opaque_sp;
|
|
|
|
}
|
2010-06-09 00:52:24 +08:00
|
|
|
|
|
|
|
void
|
2012-01-30 17:04:36 +08:00
|
|
|
SBModule::SetSP (const ModuleSP &module_sp)
|
2010-06-09 00:52:24 +08:00
|
|
|
{
|
2010-06-23 09:19:29 +08:00
|
|
|
m_opaque_sp = module_sp;
|
2010-06-09 00:52:24 +08:00
|
|
|
}
|
|
|
|
|
2011-09-24 08:52:29 +08:00
|
|
|
SBAddress
|
|
|
|
SBModule::ResolveFileAddress (lldb::addr_t vm_addr)
|
2010-09-11 02:31:35 +08:00
|
|
|
{
|
2011-09-24 08:52:29 +08:00
|
|
|
lldb::SBAddress sb_addr;
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (module_sp)
|
2011-09-24 08:52:29 +08:00
|
|
|
{
|
|
|
|
Address addr;
|
2012-02-23 03:41:02 +08:00
|
|
|
if (module_sp->ResolveFileAddress (vm_addr, addr))
|
2011-09-24 08:52:29 +08:00
|
|
|
sb_addr.ref() = addr;
|
|
|
|
}
|
|
|
|
return sb_addr;
|
2010-09-11 02:31:35 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
SBSymbolContext
|
|
|
|
SBModule::ResolveSymbolContextForAddress (const SBAddress& addr, uint32_t resolve_scope)
|
|
|
|
{
|
|
|
|
SBSymbolContext sb_sc;
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (module_sp && addr.IsValid())
|
|
|
|
module_sp->ResolveSymbolContextForAddress (addr.ref(), resolve_scope, *sb_sc);
|
2010-09-11 02:31:35 +08:00
|
|
|
return sb_sc;
|
|
|
|
}
|
|
|
|
|
2010-09-20 13:20:02 +08:00
|
|
|
bool
|
|
|
|
SBModule::GetDescription (SBStream &description)
|
|
|
|
{
|
2011-11-13 14:57:31 +08:00
|
|
|
Stream &strm = description.ref();
|
|
|
|
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (module_sp)
|
2010-09-20 13:20:02 +08:00
|
|
|
{
|
2012-02-23 03:41:02 +08:00
|
|
|
module_sp->GetDescription (&strm);
|
2010-09-20 13:20:02 +08:00
|
|
|
}
|
|
|
|
else
|
2011-11-13 14:57:31 +08:00
|
|
|
strm.PutCString ("No value");
|
2010-09-20 13:20:02 +08:00
|
|
|
|
|
|
|
return true;
|
|
|
|
}
|
2010-12-07 13:40:31 +08:00
|
|
|
|
|
|
|
size_t
|
|
|
|
SBModule::GetNumSymbols ()
|
|
|
|
{
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (module_sp)
|
2010-12-07 13:40:31 +08:00
|
|
|
{
|
2012-02-23 03:41:02 +08:00
|
|
|
ObjectFile *obj_file = module_sp->GetObjectFile();
|
2010-12-07 13:40:31 +08:00
|
|
|
if (obj_file)
|
|
|
|
{
|
|
|
|
Symtab *symtab = obj_file->GetSymtab();
|
|
|
|
if (symtab)
|
|
|
|
return symtab->GetNumSymbols();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
SBSymbol
|
|
|
|
SBModule::GetSymbolAtIndex (size_t idx)
|
|
|
|
{
|
|
|
|
SBSymbol sb_symbol;
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (module_sp)
|
2010-12-07 13:40:31 +08:00
|
|
|
{
|
2012-02-23 03:41:02 +08:00
|
|
|
ObjectFile *obj_file = module_sp->GetObjectFile();
|
2010-12-07 13:40:31 +08:00
|
|
|
if (obj_file)
|
|
|
|
{
|
|
|
|
Symtab *symtab = obj_file->GetSymtab();
|
|
|
|
if (symtab)
|
|
|
|
sb_symbol.SetSymbol(symtab->SymbolAtIndex (idx));
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return sb_symbol;
|
|
|
|
}
|
2011-06-21 09:34:41 +08:00
|
|
|
|
2011-09-24 08:52:29 +08:00
|
|
|
size_t
|
|
|
|
SBModule::GetNumSections ()
|
|
|
|
{
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (module_sp)
|
2011-09-24 08:52:29 +08:00
|
|
|
{
|
2012-02-23 03:41:02 +08:00
|
|
|
ObjectFile *obj_file = module_sp->GetObjectFile();
|
2011-09-24 08:52:29 +08:00
|
|
|
if (obj_file)
|
|
|
|
{
|
|
|
|
SectionList *section_list = obj_file->GetSectionList ();
|
|
|
|
if (section_list)
|
|
|
|
return section_list->GetSize();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
SBSection
|
|
|
|
SBModule::GetSectionAtIndex (size_t idx)
|
|
|
|
{
|
|
|
|
SBSection sb_section;
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (module_sp)
|
2011-09-24 08:52:29 +08:00
|
|
|
{
|
2012-02-23 03:41:02 +08:00
|
|
|
ObjectFile *obj_file = module_sp->GetObjectFile();
|
2011-09-24 08:52:29 +08:00
|
|
|
if (obj_file)
|
|
|
|
{
|
|
|
|
SectionList *section_list = obj_file->GetSectionList ();
|
|
|
|
|
|
|
|
if (section_list)
|
|
|
|
sb_section.SetSection(section_list->GetSectionAtIndex (idx).get());
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return sb_section;
|
|
|
|
}
|
|
|
|
|
Removed all of the "#ifndef SWIG" from the SB header files since we are using
interface (.i) files for each class.
Changed the FindFunction class from:
uint32_t
SBTarget::FindFunctions (const char *name,
uint32_t name_type_mask,
bool append,
lldb::SBSymbolContextList& sc_list)
uint32_t
SBModule::FindFunctions (const char *name,
uint32_t name_type_mask,
bool append,
lldb::SBSymbolContextList& sc_list)
To:
lldb::SBSymbolContextList
SBTarget::FindFunctions (const char *name,
uint32_t name_type_mask = lldb::eFunctionNameTypeAny);
lldb::SBSymbolContextList
SBModule::FindFunctions (const char *name,
uint32_t name_type_mask = lldb::eFunctionNameTypeAny);
This makes the API easier to use from python. Also added the ability to
append a SBSymbolContext or a SBSymbolContextList to a SBSymbolContextList.
Exposed properties for lldb.SBSymbolContextList in python:
lldb.SBSymbolContextList.modules => list() or all lldb.SBModule objects in the list
lldb.SBSymbolContextList.compile_units => list() or all lldb.SBCompileUnits objects in the list
lldb.SBSymbolContextList.functions => list() or all lldb.SBFunction objects in the list
lldb.SBSymbolContextList.blocks => list() or all lldb.SBBlock objects in the list
lldb.SBSymbolContextList.line_entries => list() or all lldb.SBLineEntry objects in the list
lldb.SBSymbolContextList.symbols => list() or all lldb.SBSymbol objects in the list
This allows a call to the SBTarget::FindFunctions(...) and SBModule::FindFunctions(...)
and then the result can be used to extract the desired information:
sc_list = lldb.target.FindFunctions("erase")
for function in sc_list.functions:
print function
for symbol in sc_list.symbols:
print symbol
Exposed properties for the lldb.SBSymbolContext objects in python:
lldb.SBSymbolContext.module => lldb.SBModule
lldb.SBSymbolContext.compile_unit => lldb.SBCompileUnit
lldb.SBSymbolContext.function => lldb.SBFunction
lldb.SBSymbolContext.block => lldb.SBBlock
lldb.SBSymbolContext.line_entry => lldb.SBLineEntry
lldb.SBSymbolContext.symbol => lldb.SBSymbol
Exposed properties for the lldb.SBBlock objects in python:
lldb.SBBlock.parent => lldb.SBBlock for the parent block that contains
lldb.SBBlock.sibling => lldb.SBBlock for the sibling block to the current block
lldb.SBBlock.first_child => lldb.SBBlock for the first child block to the current block
lldb.SBBlock.call_site => for inline functions, return a lldb.declaration object that gives the call site file, line and column
lldb.SBBlock.name => for inline functions this is the name of the inline function that this block represents
lldb.SBBlock.inlined_block => returns the inlined function block that contains this block (might return itself if the current block is an inlined block)
lldb.SBBlock.range[int] => access the address ranges for a block by index, a list() with start and end address is returned
lldb.SBBlock.ranges => an array or all address ranges for this block
lldb.SBBlock.num_ranges => the number of address ranges for this blcok
SBFunction objects can now get the SBType and the SBBlock that represents the
top scope of the function.
SBBlock objects can now get the variable list from the current block. The value
list returned allows varaibles to be viewed prior with no process if code
wants to check the variables in a function. There are two ways to get a variable
list from a SBBlock:
lldb::SBValueList
SBBlock::GetVariables (lldb::SBFrame& frame,
bool arguments,
bool locals,
bool statics,
lldb::DynamicValueType use_dynamic);
lldb::SBValueList
SBBlock::GetVariables (lldb::SBTarget& target,
bool arguments,
bool locals,
bool statics);
When a SBFrame is used, the values returned will be locked down to the frame
and the values will be evaluated in the context of that frame.
When a SBTarget is used, global an static variables can be viewed without a
running process.
llvm-svn: 149853
2012-02-06 09:44:54 +08:00
|
|
|
lldb::SBSymbolContextList
|
2011-06-21 09:34:41 +08:00
|
|
|
SBModule::FindFunctions (const char *name,
|
Removed all of the "#ifndef SWIG" from the SB header files since we are using
interface (.i) files for each class.
Changed the FindFunction class from:
uint32_t
SBTarget::FindFunctions (const char *name,
uint32_t name_type_mask,
bool append,
lldb::SBSymbolContextList& sc_list)
uint32_t
SBModule::FindFunctions (const char *name,
uint32_t name_type_mask,
bool append,
lldb::SBSymbolContextList& sc_list)
To:
lldb::SBSymbolContextList
SBTarget::FindFunctions (const char *name,
uint32_t name_type_mask = lldb::eFunctionNameTypeAny);
lldb::SBSymbolContextList
SBModule::FindFunctions (const char *name,
uint32_t name_type_mask = lldb::eFunctionNameTypeAny);
This makes the API easier to use from python. Also added the ability to
append a SBSymbolContext or a SBSymbolContextList to a SBSymbolContextList.
Exposed properties for lldb.SBSymbolContextList in python:
lldb.SBSymbolContextList.modules => list() or all lldb.SBModule objects in the list
lldb.SBSymbolContextList.compile_units => list() or all lldb.SBCompileUnits objects in the list
lldb.SBSymbolContextList.functions => list() or all lldb.SBFunction objects in the list
lldb.SBSymbolContextList.blocks => list() or all lldb.SBBlock objects in the list
lldb.SBSymbolContextList.line_entries => list() or all lldb.SBLineEntry objects in the list
lldb.SBSymbolContextList.symbols => list() or all lldb.SBSymbol objects in the list
This allows a call to the SBTarget::FindFunctions(...) and SBModule::FindFunctions(...)
and then the result can be used to extract the desired information:
sc_list = lldb.target.FindFunctions("erase")
for function in sc_list.functions:
print function
for symbol in sc_list.symbols:
print symbol
Exposed properties for the lldb.SBSymbolContext objects in python:
lldb.SBSymbolContext.module => lldb.SBModule
lldb.SBSymbolContext.compile_unit => lldb.SBCompileUnit
lldb.SBSymbolContext.function => lldb.SBFunction
lldb.SBSymbolContext.block => lldb.SBBlock
lldb.SBSymbolContext.line_entry => lldb.SBLineEntry
lldb.SBSymbolContext.symbol => lldb.SBSymbol
Exposed properties for the lldb.SBBlock objects in python:
lldb.SBBlock.parent => lldb.SBBlock for the parent block that contains
lldb.SBBlock.sibling => lldb.SBBlock for the sibling block to the current block
lldb.SBBlock.first_child => lldb.SBBlock for the first child block to the current block
lldb.SBBlock.call_site => for inline functions, return a lldb.declaration object that gives the call site file, line and column
lldb.SBBlock.name => for inline functions this is the name of the inline function that this block represents
lldb.SBBlock.inlined_block => returns the inlined function block that contains this block (might return itself if the current block is an inlined block)
lldb.SBBlock.range[int] => access the address ranges for a block by index, a list() with start and end address is returned
lldb.SBBlock.ranges => an array or all address ranges for this block
lldb.SBBlock.num_ranges => the number of address ranges for this blcok
SBFunction objects can now get the SBType and the SBBlock that represents the
top scope of the function.
SBBlock objects can now get the variable list from the current block. The value
list returned allows varaibles to be viewed prior with no process if code
wants to check the variables in a function. There are two ways to get a variable
list from a SBBlock:
lldb::SBValueList
SBBlock::GetVariables (lldb::SBFrame& frame,
bool arguments,
bool locals,
bool statics,
lldb::DynamicValueType use_dynamic);
lldb::SBValueList
SBBlock::GetVariables (lldb::SBTarget& target,
bool arguments,
bool locals,
bool statics);
When a SBFrame is used, the values returned will be locked down to the frame
and the values will be evaluated in the context of that frame.
When a SBTarget is used, global an static variables can be viewed without a
running process.
llvm-svn: 149853
2012-02-06 09:44:54 +08:00
|
|
|
uint32_t name_type_mask)
|
2011-06-21 09:34:41 +08:00
|
|
|
{
|
Removed all of the "#ifndef SWIG" from the SB header files since we are using
interface (.i) files for each class.
Changed the FindFunction class from:
uint32_t
SBTarget::FindFunctions (const char *name,
uint32_t name_type_mask,
bool append,
lldb::SBSymbolContextList& sc_list)
uint32_t
SBModule::FindFunctions (const char *name,
uint32_t name_type_mask,
bool append,
lldb::SBSymbolContextList& sc_list)
To:
lldb::SBSymbolContextList
SBTarget::FindFunctions (const char *name,
uint32_t name_type_mask = lldb::eFunctionNameTypeAny);
lldb::SBSymbolContextList
SBModule::FindFunctions (const char *name,
uint32_t name_type_mask = lldb::eFunctionNameTypeAny);
This makes the API easier to use from python. Also added the ability to
append a SBSymbolContext or a SBSymbolContextList to a SBSymbolContextList.
Exposed properties for lldb.SBSymbolContextList in python:
lldb.SBSymbolContextList.modules => list() or all lldb.SBModule objects in the list
lldb.SBSymbolContextList.compile_units => list() or all lldb.SBCompileUnits objects in the list
lldb.SBSymbolContextList.functions => list() or all lldb.SBFunction objects in the list
lldb.SBSymbolContextList.blocks => list() or all lldb.SBBlock objects in the list
lldb.SBSymbolContextList.line_entries => list() or all lldb.SBLineEntry objects in the list
lldb.SBSymbolContextList.symbols => list() or all lldb.SBSymbol objects in the list
This allows a call to the SBTarget::FindFunctions(...) and SBModule::FindFunctions(...)
and then the result can be used to extract the desired information:
sc_list = lldb.target.FindFunctions("erase")
for function in sc_list.functions:
print function
for symbol in sc_list.symbols:
print symbol
Exposed properties for the lldb.SBSymbolContext objects in python:
lldb.SBSymbolContext.module => lldb.SBModule
lldb.SBSymbolContext.compile_unit => lldb.SBCompileUnit
lldb.SBSymbolContext.function => lldb.SBFunction
lldb.SBSymbolContext.block => lldb.SBBlock
lldb.SBSymbolContext.line_entry => lldb.SBLineEntry
lldb.SBSymbolContext.symbol => lldb.SBSymbol
Exposed properties for the lldb.SBBlock objects in python:
lldb.SBBlock.parent => lldb.SBBlock for the parent block that contains
lldb.SBBlock.sibling => lldb.SBBlock for the sibling block to the current block
lldb.SBBlock.first_child => lldb.SBBlock for the first child block to the current block
lldb.SBBlock.call_site => for inline functions, return a lldb.declaration object that gives the call site file, line and column
lldb.SBBlock.name => for inline functions this is the name of the inline function that this block represents
lldb.SBBlock.inlined_block => returns the inlined function block that contains this block (might return itself if the current block is an inlined block)
lldb.SBBlock.range[int] => access the address ranges for a block by index, a list() with start and end address is returned
lldb.SBBlock.ranges => an array or all address ranges for this block
lldb.SBBlock.num_ranges => the number of address ranges for this blcok
SBFunction objects can now get the SBType and the SBBlock that represents the
top scope of the function.
SBBlock objects can now get the variable list from the current block. The value
list returned allows varaibles to be viewed prior with no process if code
wants to check the variables in a function. There are two ways to get a variable
list from a SBBlock:
lldb::SBValueList
SBBlock::GetVariables (lldb::SBFrame& frame,
bool arguments,
bool locals,
bool statics,
lldb::DynamicValueType use_dynamic);
lldb::SBValueList
SBBlock::GetVariables (lldb::SBTarget& target,
bool arguments,
bool locals,
bool statics);
When a SBFrame is used, the values returned will be locked down to the frame
and the values will be evaluated in the context of that frame.
When a SBTarget is used, global an static variables can be viewed without a
running process.
llvm-svn: 149853
2012-02-06 09:44:54 +08:00
|
|
|
lldb::SBSymbolContextList sb_sc_list;
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (name && module_sp)
|
2011-06-21 09:34:41 +08:00
|
|
|
{
|
Removed all of the "#ifndef SWIG" from the SB header files since we are using
interface (.i) files for each class.
Changed the FindFunction class from:
uint32_t
SBTarget::FindFunctions (const char *name,
uint32_t name_type_mask,
bool append,
lldb::SBSymbolContextList& sc_list)
uint32_t
SBModule::FindFunctions (const char *name,
uint32_t name_type_mask,
bool append,
lldb::SBSymbolContextList& sc_list)
To:
lldb::SBSymbolContextList
SBTarget::FindFunctions (const char *name,
uint32_t name_type_mask = lldb::eFunctionNameTypeAny);
lldb::SBSymbolContextList
SBModule::FindFunctions (const char *name,
uint32_t name_type_mask = lldb::eFunctionNameTypeAny);
This makes the API easier to use from python. Also added the ability to
append a SBSymbolContext or a SBSymbolContextList to a SBSymbolContextList.
Exposed properties for lldb.SBSymbolContextList in python:
lldb.SBSymbolContextList.modules => list() or all lldb.SBModule objects in the list
lldb.SBSymbolContextList.compile_units => list() or all lldb.SBCompileUnits objects in the list
lldb.SBSymbolContextList.functions => list() or all lldb.SBFunction objects in the list
lldb.SBSymbolContextList.blocks => list() or all lldb.SBBlock objects in the list
lldb.SBSymbolContextList.line_entries => list() or all lldb.SBLineEntry objects in the list
lldb.SBSymbolContextList.symbols => list() or all lldb.SBSymbol objects in the list
This allows a call to the SBTarget::FindFunctions(...) and SBModule::FindFunctions(...)
and then the result can be used to extract the desired information:
sc_list = lldb.target.FindFunctions("erase")
for function in sc_list.functions:
print function
for symbol in sc_list.symbols:
print symbol
Exposed properties for the lldb.SBSymbolContext objects in python:
lldb.SBSymbolContext.module => lldb.SBModule
lldb.SBSymbolContext.compile_unit => lldb.SBCompileUnit
lldb.SBSymbolContext.function => lldb.SBFunction
lldb.SBSymbolContext.block => lldb.SBBlock
lldb.SBSymbolContext.line_entry => lldb.SBLineEntry
lldb.SBSymbolContext.symbol => lldb.SBSymbol
Exposed properties for the lldb.SBBlock objects in python:
lldb.SBBlock.parent => lldb.SBBlock for the parent block that contains
lldb.SBBlock.sibling => lldb.SBBlock for the sibling block to the current block
lldb.SBBlock.first_child => lldb.SBBlock for the first child block to the current block
lldb.SBBlock.call_site => for inline functions, return a lldb.declaration object that gives the call site file, line and column
lldb.SBBlock.name => for inline functions this is the name of the inline function that this block represents
lldb.SBBlock.inlined_block => returns the inlined function block that contains this block (might return itself if the current block is an inlined block)
lldb.SBBlock.range[int] => access the address ranges for a block by index, a list() with start and end address is returned
lldb.SBBlock.ranges => an array or all address ranges for this block
lldb.SBBlock.num_ranges => the number of address ranges for this blcok
SBFunction objects can now get the SBType and the SBBlock that represents the
top scope of the function.
SBBlock objects can now get the variable list from the current block. The value
list returned allows varaibles to be viewed prior with no process if code
wants to check the variables in a function. There are two ways to get a variable
list from a SBBlock:
lldb::SBValueList
SBBlock::GetVariables (lldb::SBFrame& frame,
bool arguments,
bool locals,
bool statics,
lldb::DynamicValueType use_dynamic);
lldb::SBValueList
SBBlock::GetVariables (lldb::SBTarget& target,
bool arguments,
bool locals,
bool statics);
When a SBFrame is used, the values returned will be locked down to the frame
and the values will be evaluated in the context of that frame.
When a SBTarget is used, global an static variables can be viewed without a
running process.
llvm-svn: 149853
2012-02-06 09:44:54 +08:00
|
|
|
const bool append = true;
|
2011-06-21 09:34:41 +08:00
|
|
|
const bool symbols_ok = true;
|
2012-02-11 06:52:19 +08:00
|
|
|
const bool inlines_ok = true;
|
2012-02-23 03:41:02 +08:00
|
|
|
module_sp->FindFunctions (ConstString(name),
|
|
|
|
NULL,
|
|
|
|
name_type_mask,
|
|
|
|
symbols_ok,
|
|
|
|
inlines_ok,
|
|
|
|
append,
|
|
|
|
*sb_sc_list);
|
2011-06-21 09:34:41 +08:00
|
|
|
}
|
Removed all of the "#ifndef SWIG" from the SB header files since we are using
interface (.i) files for each class.
Changed the FindFunction class from:
uint32_t
SBTarget::FindFunctions (const char *name,
uint32_t name_type_mask,
bool append,
lldb::SBSymbolContextList& sc_list)
uint32_t
SBModule::FindFunctions (const char *name,
uint32_t name_type_mask,
bool append,
lldb::SBSymbolContextList& sc_list)
To:
lldb::SBSymbolContextList
SBTarget::FindFunctions (const char *name,
uint32_t name_type_mask = lldb::eFunctionNameTypeAny);
lldb::SBSymbolContextList
SBModule::FindFunctions (const char *name,
uint32_t name_type_mask = lldb::eFunctionNameTypeAny);
This makes the API easier to use from python. Also added the ability to
append a SBSymbolContext or a SBSymbolContextList to a SBSymbolContextList.
Exposed properties for lldb.SBSymbolContextList in python:
lldb.SBSymbolContextList.modules => list() or all lldb.SBModule objects in the list
lldb.SBSymbolContextList.compile_units => list() or all lldb.SBCompileUnits objects in the list
lldb.SBSymbolContextList.functions => list() or all lldb.SBFunction objects in the list
lldb.SBSymbolContextList.blocks => list() or all lldb.SBBlock objects in the list
lldb.SBSymbolContextList.line_entries => list() or all lldb.SBLineEntry objects in the list
lldb.SBSymbolContextList.symbols => list() or all lldb.SBSymbol objects in the list
This allows a call to the SBTarget::FindFunctions(...) and SBModule::FindFunctions(...)
and then the result can be used to extract the desired information:
sc_list = lldb.target.FindFunctions("erase")
for function in sc_list.functions:
print function
for symbol in sc_list.symbols:
print symbol
Exposed properties for the lldb.SBSymbolContext objects in python:
lldb.SBSymbolContext.module => lldb.SBModule
lldb.SBSymbolContext.compile_unit => lldb.SBCompileUnit
lldb.SBSymbolContext.function => lldb.SBFunction
lldb.SBSymbolContext.block => lldb.SBBlock
lldb.SBSymbolContext.line_entry => lldb.SBLineEntry
lldb.SBSymbolContext.symbol => lldb.SBSymbol
Exposed properties for the lldb.SBBlock objects in python:
lldb.SBBlock.parent => lldb.SBBlock for the parent block that contains
lldb.SBBlock.sibling => lldb.SBBlock for the sibling block to the current block
lldb.SBBlock.first_child => lldb.SBBlock for the first child block to the current block
lldb.SBBlock.call_site => for inline functions, return a lldb.declaration object that gives the call site file, line and column
lldb.SBBlock.name => for inline functions this is the name of the inline function that this block represents
lldb.SBBlock.inlined_block => returns the inlined function block that contains this block (might return itself if the current block is an inlined block)
lldb.SBBlock.range[int] => access the address ranges for a block by index, a list() with start and end address is returned
lldb.SBBlock.ranges => an array or all address ranges for this block
lldb.SBBlock.num_ranges => the number of address ranges for this blcok
SBFunction objects can now get the SBType and the SBBlock that represents the
top scope of the function.
SBBlock objects can now get the variable list from the current block. The value
list returned allows varaibles to be viewed prior with no process if code
wants to check the variables in a function. There are two ways to get a variable
list from a SBBlock:
lldb::SBValueList
SBBlock::GetVariables (lldb::SBFrame& frame,
bool arguments,
bool locals,
bool statics,
lldb::DynamicValueType use_dynamic);
lldb::SBValueList
SBBlock::GetVariables (lldb::SBTarget& target,
bool arguments,
bool locals,
bool statics);
When a SBFrame is used, the values returned will be locked down to the frame
and the values will be evaluated in the context of that frame.
When a SBTarget is used, global an static variables can be viewed without a
running process.
llvm-svn: 149853
2012-02-06 09:44:54 +08:00
|
|
|
return sb_sc_list;
|
2011-06-21 09:34:41 +08:00
|
|
|
}
|
|
|
|
|
2011-06-30 06:09:02 +08:00
|
|
|
|
|
|
|
SBValueList
|
|
|
|
SBModule::FindGlobalVariables (SBTarget &target, const char *name, uint32_t max_matches)
|
|
|
|
{
|
|
|
|
SBValueList sb_value_list;
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (name && module_sp)
|
2011-06-30 06:09:02 +08:00
|
|
|
{
|
|
|
|
VariableList variable_list;
|
2012-02-23 03:41:02 +08:00
|
|
|
const uint32_t match_count = module_sp->FindGlobalVariables (ConstString (name),
|
|
|
|
NULL,
|
|
|
|
false,
|
|
|
|
max_matches,
|
|
|
|
variable_list);
|
2011-06-30 06:09:02 +08:00
|
|
|
|
|
|
|
if (match_count > 0)
|
|
|
|
{
|
|
|
|
ValueObjectList &value_object_list = sb_value_list.ref();
|
|
|
|
for (uint32_t i=0; i<match_count; ++i)
|
|
|
|
{
|
|
|
|
lldb::ValueObjectSP valobj_sp;
|
2012-01-30 15:41:31 +08:00
|
|
|
TargetSP target_sp (target.GetSP());
|
|
|
|
valobj_sp = ValueObjectVariable::Create (target_sp.get(), variable_list.GetVariableAtIndex(i));
|
2011-06-30 06:09:02 +08:00
|
|
|
if (valobj_sp)
|
|
|
|
value_object_list.Append(valobj_sp);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return sb_value_list;
|
|
|
|
}
|
2011-07-30 03:53:35 +08:00
|
|
|
|
|
|
|
lldb::SBType
|
2011-12-20 04:16:22 +08:00
|
|
|
SBModule::FindFirstType (const char *name_cstr)
|
2011-07-30 03:53:35 +08:00
|
|
|
{
|
2011-08-04 06:57:10 +08:00
|
|
|
SBType sb_type;
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (name_cstr && module_sp)
|
2011-07-30 03:53:35 +08:00
|
|
|
{
|
2011-08-04 06:57:10 +08:00
|
|
|
SymbolContext sc;
|
|
|
|
TypeList type_list;
|
|
|
|
uint32_t num_matches = 0;
|
|
|
|
ConstString name(name_cstr);
|
|
|
|
|
2012-02-23 03:41:02 +08:00
|
|
|
num_matches = module_sp->FindTypes (sc,
|
|
|
|
name,
|
|
|
|
NULL,
|
|
|
|
false,
|
|
|
|
1,
|
|
|
|
type_list);
|
2011-08-04 06:57:10 +08:00
|
|
|
|
|
|
|
if (num_matches)
|
|
|
|
sb_type = lldb::SBType(type_list.GetTypeAtIndex(0));
|
2011-07-30 03:53:35 +08:00
|
|
|
}
|
2011-08-04 06:57:10 +08:00
|
|
|
return sb_type;
|
2011-07-30 03:53:35 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
lldb::SBTypeList
|
2011-12-20 04:16:22 +08:00
|
|
|
SBModule::FindTypes (const char *type)
|
2011-07-30 03:53:35 +08:00
|
|
|
{
|
|
|
|
|
|
|
|
SBTypeList retval;
|
|
|
|
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (type && module_sp)
|
2011-07-30 03:53:35 +08:00
|
|
|
{
|
2011-08-04 06:57:10 +08:00
|
|
|
SymbolContext sc;
|
|
|
|
TypeList type_list;
|
|
|
|
uint32_t num_matches = 0;
|
|
|
|
ConstString name(type);
|
2011-07-30 03:53:35 +08:00
|
|
|
|
2012-02-23 03:41:02 +08:00
|
|
|
num_matches = module_sp->FindTypes (sc,
|
|
|
|
name,
|
|
|
|
NULL,
|
|
|
|
false,
|
|
|
|
UINT32_MAX,
|
|
|
|
type_list);
|
2011-08-04 06:57:10 +08:00
|
|
|
|
|
|
|
for (size_t idx = 0; idx < num_matches; idx++)
|
|
|
|
{
|
|
|
|
TypeSP type_sp (type_list.GetTypeAtIndex(idx));
|
|
|
|
if (type_sp)
|
|
|
|
retval.Append(SBType(type_sp));
|
|
|
|
}
|
2011-07-30 03:53:35 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
return retval;
|
2011-08-10 10:10:13 +08:00
|
|
|
}
|
2011-09-24 08:52:29 +08:00
|
|
|
|
|
|
|
|
|
|
|
SBSection
|
|
|
|
SBModule::FindSection (const char *sect_name)
|
|
|
|
{
|
|
|
|
SBSection sb_section;
|
|
|
|
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (sect_name && module_sp)
|
2011-09-24 08:52:29 +08:00
|
|
|
{
|
2012-02-23 03:41:02 +08:00
|
|
|
ObjectFile *objfile = module_sp->GetObjectFile();
|
2011-09-24 08:52:29 +08:00
|
|
|
if (objfile)
|
|
|
|
{
|
|
|
|
SectionList *section_list = objfile->GetSectionList();
|
|
|
|
if (section_list)
|
|
|
|
{
|
|
|
|
ConstString const_sect_name(sect_name);
|
|
|
|
SectionSP section_sp (section_list->FindSectionByName(const_sect_name));
|
|
|
|
if (section_sp)
|
|
|
|
{
|
|
|
|
sb_section.SetSection(section_sp.get());
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return sb_section;
|
|
|
|
}
|
|
|
|
|
2012-01-29 14:07:39 +08:00
|
|
|
lldb::ByteOrder
|
|
|
|
SBModule::GetByteOrder ()
|
|
|
|
{
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (module_sp)
|
|
|
|
return module_sp->GetArchitecture().GetByteOrder();
|
2012-01-29 14:07:39 +08:00
|
|
|
return eByteOrderInvalid;
|
|
|
|
}
|
|
|
|
|
|
|
|
const char *
|
|
|
|
SBModule::GetTriple ()
|
|
|
|
{
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (module_sp)
|
2012-01-29 14:07:39 +08:00
|
|
|
{
|
2012-02-23 03:41:02 +08:00
|
|
|
std::string triple (module_sp->GetArchitecture().GetTriple().str());
|
2012-01-29 14:07:39 +08:00
|
|
|
// Unique the string so we don't run into ownership issues since
|
|
|
|
// the const strings put the string into the string pool once and
|
|
|
|
// the strings never comes out
|
|
|
|
ConstString const_triple (triple.c_str());
|
|
|
|
return const_triple.GetCString();
|
|
|
|
}
|
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
|
|
|
|
uint32_t
|
|
|
|
SBModule::GetAddressByteSize()
|
|
|
|
{
|
2012-02-23 03:41:02 +08:00
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (module_sp)
|
|
|
|
return module_sp->GetArchitecture().GetAddressByteSize();
|
2012-01-29 14:07:39 +08:00
|
|
|
return sizeof(void*);
|
|
|
|
}
|
|
|
|
|
2012-02-23 03:41:02 +08:00
|
|
|
|
|
|
|
uint32_t
|
|
|
|
SBModule::GetVersion (uint32_t *versions, uint32_t num_versions)
|
|
|
|
{
|
|
|
|
ModuleSP module_sp (GetSP ());
|
|
|
|
if (module_sp)
|
|
|
|
{
|
|
|
|
ObjectFile *obj_file = module_sp->GetObjectFile();
|
|
|
|
if (obj_file)
|
|
|
|
return obj_file->GetVersion (versions, num_versions);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (versions && num_versions)
|
|
|
|
{
|
|
|
|
for (uint32_t i=0; i<num_versions; ++i)
|
|
|
|
versions[i] = UINT32_MAX;
|
|
|
|
}
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|