LLDB mainline
Public Member Functions | Protected Member Functions | Private Attributes | Friends | List of all members
lldb::SBSaveCoreOptions Class Reference

#include <SBSaveCoreOptions.h>

Public Member Functions

 SBSaveCoreOptions ()
 
 SBSaveCoreOptions (const lldb::SBSaveCoreOptions &rhs)
 
 ~SBSaveCoreOptions ()
 
const SBSaveCoreOptionsoperator= (const lldb::SBSaveCoreOptions &rhs)
 
SBError SetPluginName (const char *plugin)
 Set the plugin name.
 
const char * GetPluginName () const
 Get the Core dump plugin name, if set.
 
void SetStyle (lldb::SaveCoreStyle style)
 Set the Core dump style.
 
lldb::SaveCoreStyle GetStyle () const
 Get the Core dump style, if set.
 
void SetOutputFile (SBFileSpec output_file)
 
SBFileSpec GetOutputFile () const
 Get the output file spec.
 
SBError SetProcess (lldb::SBProcess process)
 Set the process to save, or unset if supplied with a default constructed process.
 
SBError AddThread (lldb::SBThread thread)
 Add a thread to save in the core file.
 
bool RemoveThread (lldb::SBThread thread)
 Remove a thread from the list of threads to save.
 
SBError AddMemoryRegionToSave (const SBMemoryRegionInfo &region)
 Add a memory region to save in the core file.
 
SBThreadCollection GetThreadsToSave () const
 Get an unsorted copy of all threads to save.
 
void Clear ()
 Reset all options.
 

Protected Member Functions

lldb_private::SaveCoreOptionsref () const
 

Private Attributes

std::unique_ptr< lldb_private::SaveCoreOptionsm_opaque_up
 

Friends

class SBProcess
 
class SBThreadCollection
 

Detailed Description

Definition at line 21 of file SBSaveCoreOptions.h.

Constructor & Destructor Documentation

◆ SBSaveCoreOptions() [1/2]

SBSaveCoreOptions::SBSaveCoreOptions ( )

Definition at line 20 of file SBSaveCoreOptions.cpp.

References LLDB_INSTRUMENT_VA, and m_opaque_up.

◆ SBSaveCoreOptions() [2/2]

SBSaveCoreOptions::SBSaveCoreOptions ( const lldb::SBSaveCoreOptions rhs)

Definition at line 26 of file SBSaveCoreOptions.cpp.

References LLDB_INSTRUMENT_VA, and m_opaque_up.

◆ ~SBSaveCoreOptions()

SBSaveCoreOptions::~SBSaveCoreOptions ( )
default

Member Function Documentation

◆ AddMemoryRegionToSave()

lldb::SBError SBSaveCoreOptions::AddMemoryRegionToSave ( const SBMemoryRegionInfo region)

Add a memory region to save in the core file.

Parameters
regionThe memory region to save.
Returns
An empty SBError upon success, or an error if the region is invalid.
Note
Ranges that overlapped will be unioned into a single region, this also supercedes stack minification. Specifying full regions and a non-custom core style will include the specified regions and union them with all style specific regions.

Definition at line 95 of file SBSaveCoreOptions.cpp.

References LLDB_INSTRUMENT_VA, m_opaque_up, and lldb::SBMemoryRegionInfo::ref().

◆ AddThread()

SBError SBSaveCoreOptions::AddThread ( lldb::SBThread  thread)

Add a thread to save in the core file.

Parameters
threadThe thread to save.
Note
This will set the process if it is not already set, or return and error if the SBThread is not from the set process.

Definition at line 84 of file SBSaveCoreOptions.cpp.

References lldb::SBThread::GetSP(), LLDB_INSTRUMENT_VA, and m_opaque_up.

◆ Clear()

void SBSaveCoreOptions::Clear ( )

Reset all options.

Definition at line 112 of file SBSaveCoreOptions.cpp.

References LLDB_INSTRUMENT_VA, and m_opaque_up.

◆ GetOutputFile()

SBFileSpec SBSaveCoreOptions::GetOutputFile ( ) const

Get the output file spec.

Returns
The output file spec.

Definition at line 66 of file SBSaveCoreOptions.cpp.

References LLDB_INSTRUMENT_VA, and m_opaque_up.

◆ GetPluginName()

const char * SBSaveCoreOptions::GetPluginName ( ) const

Get the Core dump plugin name, if set.

Returns
The name of the plugin, or null if not set.

Definition at line 58 of file SBSaveCoreOptions.cpp.

References lldb_private::ConstString::GetCString(), LLDB_INSTRUMENT_VA, and m_opaque_up.

◆ GetStyle()

lldb::SaveCoreStyle SBSaveCoreOptions::GetStyle ( ) const

Get the Core dump style, if set.

Returns
The core dump style, or undefined if not set.

Definition at line 74 of file SBSaveCoreOptions.cpp.

References LLDB_INSTRUMENT_VA, and m_opaque_up.

◆ GetThreadsToSave()

lldb::SBThreadCollection SBSaveCoreOptions::GetThreadsToSave ( ) const

Get an unsorted copy of all threads to save.

Returns
An unsorted copy of all threads to save. If no process is specified an empty collection will be returned.

Definition at line 104 of file SBSaveCoreOptions.cpp.

References LLDB_INSTRUMENT_VA, m_opaque_up, and SBThreadCollection.

◆ operator=()

const SBSaveCoreOptions & SBSaveCoreOptions::operator= ( const lldb::SBSaveCoreOptions rhs)

Definition at line 35 of file SBSaveCoreOptions.cpp.

References LLDB_INSTRUMENT_VA, and m_opaque_up.

◆ ref()

lldb_private::SaveCoreOptions & SBSaveCoreOptions::ref ( ) const
protected

Definition at line 117 of file SBSaveCoreOptions.cpp.

References m_opaque_up.

Referenced by lldb::SBProcess::SaveCore().

◆ RemoveThread()

bool SBSaveCoreOptions::RemoveThread ( lldb::SBThread  thread)

Remove a thread from the list of threads to save.

Parameters
threadThe thread to remove.
Returns
True if the thread was removed, false if it was not in the list.

Definition at line 89 of file SBSaveCoreOptions.cpp.

References lldb::SBThread::GetSP(), LLDB_INSTRUMENT_VA, and m_opaque_up.

◆ SetOutputFile()

void SBSaveCoreOptions::SetOutputFile ( lldb::SBFileSpec  file_spec)

Definition at line 53 of file SBSaveCoreOptions.cpp.

References LLDB_INSTRUMENT_VA, m_opaque_up, and lldb::SBFileSpec::ref().

Referenced by lldb::SBProcess::SaveCore().

◆ SetPluginName()

SBError SBSaveCoreOptions::SetPluginName ( const char *  plugin)

Set the plugin name.

Supplying null or empty string will reset the option.

Parameters
pluginName of the object file plugin.

Definition at line 43 of file SBSaveCoreOptions.cpp.

References LLDB_INSTRUMENT_VA, and m_opaque_up.

Referenced by lldb::SBProcess::SaveCore().

◆ SetProcess()

SBError SBSaveCoreOptions::SetProcess ( lldb::SBProcess  process)

Set the process to save, or unset if supplied with a default constructed process.

Parameters
processThe process to save.
Returns
Success if process was set, otherwise an error
Note
This will clear all process specific options if a different process is specified than the current set process, either explicitly from this api, or implicitly from any function that requires a process.

Definition at line 79 of file SBSaveCoreOptions.cpp.

References lldb::SBProcess::GetSP(), LLDB_INSTRUMENT_VA, and m_opaque_up.

◆ SetStyle()

void SBSaveCoreOptions::SetStyle ( lldb::SaveCoreStyle  style)

Set the Core dump style.

Parameters
styleThe style of the core dump.

Definition at line 48 of file SBSaveCoreOptions.cpp.

References LLDB_INSTRUMENT_VA, and m_opaque_up.

Referenced by lldb::SBProcess::SaveCore().

Friends And Related Function Documentation

◆ SBProcess

friend class SBProcess
friend

Definition at line 126 of file SBSaveCoreOptions.h.

◆ SBThreadCollection

friend class SBThreadCollection
friend

Definition at line 127 of file SBSaveCoreOptions.h.

Referenced by GetThreadsToSave().

Member Data Documentation

◆ m_opaque_up

std::unique_ptr<lldb_private::SaveCoreOptions> lldb::SBSaveCoreOptions::m_opaque_up
private

The documentation for this class was generated from the following files: