lldb_private::repro::Generator Class Reference

The generator is responsible for the logic needed to generate a reproducer. More...

#include <Reproducer.h>

Collaboration diagram for lldb_private::repro::Generator:

Public Member Functions
	Generator (FileSpec root)
	~Generator ()
void	Keep ()
	Method to indicate we want to keep the reproducer. More...
void	Discard ()
	Method to indicate we do not want to keep the reproducer. More...
void	SetAutoGenerate (bool b)
	Enable or disable auto generate. More...
bool	IsAutoGenerate () const
	Return whether auto generate is enabled. More...
template<typename T >
T *	Create ()
	Create and register a new provider. More...
template<typename T >
T *	Get ()
	Get an existing provider. More...
template<typename T >
T &	GetOrCreate ()
	Get a provider if it exists, otherwise create it. More...
const FileSpec &	GetRoot () const

Private Member Functions
ProviderBase *	Register (std::unique_ptr< ProviderBase > provider)
void	AddProvidersToIndex ()
	Builds and index with provider info. More...

Private Attributes
friend	Reproducer
llvm::DenseMap< const void *, std::unique_ptr< ProviderBase > >	m_providers
	Map of provider IDs to provider instances. More...
std::mutex	m_providers_mutex
FileSpec	m_root
	The reproducer root directory. More...
bool	m_done = false
	Flag to ensure that we never call both keep and discard. More...
bool	m_auto_generate = false
	Flag to auto generate a reproducer when it would otherwise be discarded. More...

Detailed Description

The generator is responsible for the logic needed to generate a reproducer.

For doing so it relies on providers, who serialize data that is necessary for reproducing a failure.

Definition at line 91 of file Reproducer.h.

Constructor & Destructor Documentation

Generator()

Generator::Generator

(

FileSpec

root

)

Definition at line 154 of file Reproducer.cpp.

~Generator()

Generator::~Generator

(

)

Definition at line 159 of file Reproducer.cpp.

References Discard(), lldb_private::repro::Finalize(), GetRoot(), Keep(), m_auto_generate, and m_done.

Member Function Documentation

AddProvidersToIndex()

void Generator::AddProvidersToIndex ( )

private

Builds and index with provider info.

Definition at line 206 of file Reproducer.cpp.

References lldb_private::FileSpec::AppendPathComponent(), lldb_private::FileSpec::GetPath(), m_providers, and m_root.

Referenced by Keep().

Create()

template<typename T >

T* lldb_private::repro::Generator::Create ( )

inline

Create and register a new provider.

Definition at line 113 of file Reproducer.h.

References m_root, and Register().

Discard()

void Generator::Discard

(

)

Method to indicate we do not want to keep the reproducer.

This is unaffected by whether or not generation reproduction is enabled, as we might need to clean up files already written to disk.

Definition at line 189 of file Reproducer.cpp.

References lldb_private::FileSpec::GetPath(), LLDB_SCOPED_TIMER, m_done, m_providers, and m_root.

Referenced by ~Generator().

Get()

template<typename T >

T* lldb_private::repro::Generator::Get ( )

inline

Get an existing provider.

Definition at line 119 of file Reproducer.h.

References m_providers.

GetOrCreate()

template<typename T >

T& lldb_private::repro::Generator::GetOrCreate ( )

inline

Get a provider if it exists, otherwise create it.

Definition at line 127 of file Reproducer.h.

GetRoot()

const FileSpec & Generator::GetRoot

(

)

const

Definition at line 204 of file Reproducer.cpp.

References m_root.

Referenced by ~Generator().

IsAutoGenerate()

bool Generator::IsAutoGenerate

(

)

const

Return whether auto generate is enabled.

Definition at line 202 of file Reproducer.cpp.

References m_auto_generate.

Keep()

void Generator::Keep

(

)

Method to indicate we want to keep the reproducer.

If reproducer generation is disabled, this does nothing.

Definition at line 178 of file Reproducer.cpp.

References AddProvidersToIndex(), LLDB_SCOPED_TIMER, m_done, and m_providers.

Referenced by ~Generator().

Register()

ProviderBase * Generator::Register ( std::unique_ptr< ProviderBase >  provider )

private

Definition at line 170 of file Reproducer.cpp.

References m_providers, and m_providers_mutex.

Referenced by Create().

SetAutoGenerate()

void Generator::SetAutoGenerate

(

bool

b

)

Enable or disable auto generate.

Definition at line 200 of file Reproducer.cpp.

References m_auto_generate.

Member Data Documentation

m_auto_generate

bool lldb_private::repro::Generator::m_auto_generate = false

private

Flag to auto generate a reproducer when it would otherwise be discarded.

Definition at line 155 of file Reproducer.h.

Referenced by IsAutoGenerate(), SetAutoGenerate(), and ~Generator().

m_done

bool lldb_private::repro::Generator::m_done = false

private

Flag to ensure that we never call both keep and discard.

Definition at line 152 of file Reproducer.h.

Referenced by Discard(), Keep(), and ~Generator().

m_providers

llvm::DenseMap<const void *, std::unique_ptr<ProviderBase> > lldb_private::repro::Generator::m_providers

private

Map of provider IDs to provider instances.

Definition at line 145 of file Reproducer.h.

Referenced by AddProvidersToIndex(), Discard(), Get(), Keep(), and Register().

m_providers_mutex

std::mutex lldb_private::repro::Generator::m_providers_mutex

private

Definition at line 146 of file Reproducer.h.

Referenced by Register().

m_root

FileSpec lldb_private::repro::Generator::m_root

private

The reproducer root directory.

Definition at line 149 of file Reproducer.h.

Referenced by AddProvidersToIndex(), Create(), Discard(), and GetRoot().

Reproducer

friend lldb_private::repro::Generator::Reproducer

private

Definition at line 137 of file Reproducer.h.

---

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

• Reproducer.h
• Reproducer.cpp