#include <SBPlatform.h>

Public Member Functions
	SBPlatform ()

	SBPlatform (const char *platform_name)

	SBPlatform (const SBPlatform &rhs)

SBPlatform &	operator= (const SBPlatform &rhs)

	~SBPlatform ()

	operator bool () const

bool	IsValid () const

void	Clear ()

const char *	GetWorkingDirectory ()

bool	SetWorkingDirectory (const char *path)

const char *	GetName ()

SBError	ConnectRemote (SBPlatformConnectOptions &connect_options)

void	DisconnectRemote ()

bool	IsConnected ()

const char *	GetTriple ()

const char *	GetHostname ()

const char *	GetOSBuild ()

const char *	GetOSDescription ()

uint32_t	GetOSMajorVersion ()

uint32_t	GetOSMinorVersion ()

uint32_t	GetOSUpdateVersion ()

void	SetSDKRoot (const char *sysroot)

SBError	Put (SBFileSpec &src, SBFileSpec &dst)

SBError	Get (SBFileSpec &src, SBFileSpec &dst)

SBError	Install (SBFileSpec &src, SBFileSpec &dst)

SBError	Run (SBPlatformShellCommand &shell_command)

SBError	Launch (SBLaunchInfo &launch_info)

SBError	Kill (const lldb::pid_t pid)

SBError	MakeDirectory (const char *path, uint32_t file_permissions=eFilePermissionsDirectoryDefault)

uint32_t	GetFilePermissions (const char *path)

SBError	SetFilePermissions (const char *path, uint32_t file_permissions)

SBUnixSignals	GetUnixSignals () const

SBEnvironment	GetEnvironment ()
	Return the environment variables of the remote platform connection process.

SBError	SetLocateModuleCallback (lldb::SBPlatformLocateModuleCallback callback, void *callback_baton)
	Set a callback as an implementation for locating module in order to implement own module cache system.

Static Public Member Functions
static SBPlatform	GetHostPlatform ()

Protected Member Functions
lldb::PlatformSP	GetSP () const

void	SetSP (const lldb::PlatformSP &platform_sp)

SBError	ExecuteConnected (const std::function< lldb_private::Status(const lldb::PlatformSP &)> &func)

Protected Attributes
lldb::PlatformSP	m_opaque_sp

Friends
class	SBDebugger

class	SBTarget

Detailed Description

Definition at line 93 of file SBPlatform.h.

Constructor & Destructor Documentation

◆ SBPlatform() [1/3]

SBPlatform::SBPlatform ( )

Definition at line 291 of file SBPlatform.cpp.

References LLDB_INSTRUMENT_VA.

◆ SBPlatform() [2/3]

SBPlatform::SBPlatform ( const char * platform_name )

Definition at line 293 of file SBPlatform.cpp.

References lldb_private::Platform::Create(), LLDB_INSTRUMENT_VA, and m_opaque_sp.

◆ SBPlatform() [3/3]

SBPlatform::SBPlatform ( const SBPlatform & rhs )

Definition at line 299 of file SBPlatform.cpp.

References LLDB_INSTRUMENT_VA, and m_opaque_sp.

◆ ~SBPlatform()

SBPlatform::~SBPlatform ( )

default

Member Function Documentation

◆ Clear()

void SBPlatform::Clear ( )

Definition at line 332 of file SBPlatform.cpp.

References LLDB_INSTRUMENT_VA, and m_opaque_sp.

◆ ConnectRemote()

SBError SBPlatform::ConnectRemote ( SBPlatformConnectOptions & connect_options )

Definition at line 376 of file SBPlatform.cpp.

References lldb_private::Args::AppendArgument(), GetSP(), lldb::SBPlatformConnectOptions::GetURL(), LLDB_INSTRUMENT_VA, lldb::SBError::ref(), and lldb::SBError::SetErrorString().

◆ DisconnectRemote()

void SBPlatform::DisconnectRemote ( )

Definition at line 391 of file SBPlatform.cpp.

References GetSP(), and LLDB_INSTRUMENT_VA.

◆ ExecuteConnected()

SBError SBPlatform::ExecuteConnected ( const std::function< lldb_private::Status(const lldb::PlatformSP &)> & func )

protected

Definition at line 584 of file SBPlatform.cpp.

References GetSP(), lldb::SBError::ref(), and lldb::SBError::SetErrorString().

Referenced by Install(), Kill(), Launch(), Put(), and Run().

◆ Get()

SBError SBPlatform::Get	(	SBFileSpec &	src,
		SBFileSpec &	dst
	)

Definition at line 495 of file SBPlatform.cpp.

References GetSP(), LLDB_INSTRUMENT_VA, lldb::SBError::ref(), lldb::SBFileSpec::ref(), and lldb::SBError::SetErrorString().

◆ GetEnvironment()

SBEnvironment SBPlatform::GetEnvironment ( )

Return the environment variables of the remote platform connection process.

Returns: An lldb::SBEnvironment object which is a copy of the platform's environment.

Definition at line 649 of file SBPlatform.cpp.

References GetSP(), and LLDB_INSTRUMENT_VA.

◆ GetFilePermissions()

uint32_t SBPlatform::GetFilePermissions ( const char * path )

Definition at line 613 of file SBPlatform.cpp.

References GetSP(), and LLDB_INSTRUMENT_VA.

◆ GetHostname()

const char * SBPlatform::GetHostname ( )

Definition at line 453 of file SBPlatform.cpp.

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

◆ GetHostPlatform()

SBPlatform SBPlatform::GetHostPlatform ( )

static

Definition at line 314 of file SBPlatform.cpp.

References lldb_private::Platform::GetHostPlatform(), LLDB_INSTRUMENT, and m_opaque_sp.

◆ GetName()

const char * SBPlatform::GetName ( )

Definition at line 338 of file SBPlatform.cpp.

References lldb_private::ConstString::AsCString(), GetSP(), and LLDB_INSTRUMENT_VA.

Referenced by lldb::SBDebugger::GetSelectedPlatform(), and lldb::SBDebugger::SetSelectedPlatform().

◆ GetOSBuild()

const char * SBPlatform::GetOSBuild ( )

Definition at line 423 of file SBPlatform.cpp.

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

◆ GetOSDescription()

const char * SBPlatform::GetOSDescription ( )

Definition at line 438 of file SBPlatform.cpp.

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

◆ GetOSMajorVersion()

uint32_t SBPlatform::GetOSMajorVersion ( )

Definition at line 462 of file SBPlatform.cpp.

References GetSP(), LLDB_INSTRUMENT_VA, and UINT32_MAX.

◆ GetOSMinorVersion()

uint32_t SBPlatform::GetOSMinorVersion ( )

Definition at line 471 of file SBPlatform.cpp.

References GetSP(), LLDB_INSTRUMENT_VA, and UINT32_MAX.

◆ GetOSUpdateVersion()

uint32_t SBPlatform::GetOSUpdateVersion ( )

Definition at line 480 of file SBPlatform.cpp.

References GetSP(), LLDB_INSTRUMENT_VA, and UINT32_MAX.

◆ GetSP()

lldb::PlatformSP SBPlatform::GetSP ( ) const

protected

◆ GetTriple()

const char * SBPlatform::GetTriple ( )

Definition at line 408 of file SBPlatform.cpp.

References lldb_private::ConstString::GetCString(), GetSP(), lldb_private::ArchSpec::GetTriple(), lldb_private::ArchSpec::IsValid(), and LLDB_INSTRUMENT_VA.

◆ GetUnixSignals()

SBUnixSignals SBPlatform::GetUnixSignals ( ) const

Definition at line 640 of file SBPlatform.cpp.

References GetSP(), and LLDB_INSTRUMENT_VA.

◆ GetWorkingDirectory()

const char * SBPlatform::GetWorkingDirectory ( )

Definition at line 353 of file SBPlatform.cpp.

References GetSP(), and LLDB_INSTRUMENT_VA.

◆ Install()

SBError SBPlatform::Install	(	SBFileSpec &	src,
		SBFileSpec &	dst
	)

Definition at line 530 of file SBPlatform.cpp.

References error(), ExecuteConnected(), lldb::SBFileSpec::Exists(), lldb_private::FileSpec::GetPath(), LLDB_INSTRUMENT_VA, and lldb::SBFileSpec::ref().

◆ IsConnected()

bool SBPlatform::IsConnected ( )

Definition at line 399 of file SBPlatform.cpp.

References GetSP(), and LLDB_INSTRUMENT_VA.

◆ IsValid()

bool SBPlatform::IsValid ( ) const

Definition at line 322 of file SBPlatform.cpp.

References LLDB_INSTRUMENT_VA.

◆ Kill()

SBError SBPlatform::Kill ( const lldb::pid_t pid )

Definition at line 577 of file SBPlatform.cpp.

References ExecuteConnected(), and LLDB_INSTRUMENT_VA.

◆ Launch()

SBError SBPlatform::Launch ( SBLaunchInfo & launch_info )

Definition at line 567 of file SBPlatform.cpp.

References error(), ExecuteConnected(), LLDB_INSTRUMENT_VA, lldb::SBLaunchInfo::ref(), and lldb::SBLaunchInfo::set_ref().

◆ MakeDirectory()

SBError SBPlatform::MakeDirectory	(	const char *	path,
		uint32_t	file_permissions = `eFilePermissionsDirectoryDefault`
	)

Definition at line 599 of file SBPlatform.cpp.

References GetSP(), LLDB_INSTRUMENT_VA, lldb::SBError::ref(), and lldb::SBError::SetErrorString().

◆ operator bool()

SBPlatform::operator bool ( ) const

explicit

Definition at line 326 of file SBPlatform.cpp.

References LLDB_INSTRUMENT_VA.

◆ operator=()

SBPlatform & SBPlatform::operator= ( const SBPlatform & rhs )

Definition at line 305 of file SBPlatform.cpp.

References LLDB_INSTRUMENT_VA, and m_opaque_sp.

◆ Put()

SBError SBPlatform::Put	(	SBFileSpec &	src,
		SBFileSpec &	dst
	)

Definition at line 508 of file SBPlatform.cpp.

References error(), ExecuteConnected(), lldb::SBFileSpec::Exists(), lldb_private::FileSpec::GetPath(), LLDB_INSTRUMENT_VA, and lldb::SBFileSpec::ref().

◆ Run()

SBError SBPlatform::Run ( SBPlatformShellCommand & shell_command )

Definition at line 543 of file SBPlatform.cpp.

References ExecuteConnected(), lldb::SBPlatformShellCommand::GetCommand(), lldb::SBPlatformShellCommand::GetWorkingDirectory(), LLDB_INSTRUMENT_VA, lldb::SBPlatformShellCommand::m_opaque_ptr, PlatformShellCommand::m_output, PlatformShellCommand::m_shell, PlatformShellCommand::m_signo, PlatformShellCommand::m_status, and PlatformShellCommand::m_timeout.

◆ SetFilePermissions()

SBError SBPlatform::SetFilePermissions	(	const char *	path,
		uint32_t	file_permissions
	)

Definition at line 625 of file SBPlatform.cpp.

References GetSP(), LLDB_INSTRUMENT_VA, lldb::SBError::ref(), and lldb::SBError::SetErrorString().

◆ SetLocateModuleCallback()

SBError SBPlatform::SetLocateModuleCallback	(	lldb::SBPlatformLocateModuleCallback	callback,
		void *	callback_baton
	)

Set a callback as an implementation for locating module in order to implement own module cache system.

For example, to leverage distributed build system, to bypass pulling files from remote platform, or to search symbol files from symbol servers. The target will call this callback to get a module file and a symbol file, and it will fallback to the LLDB implementation when this callback failed or returned non-existent file. This callback can set either module_file_spec or symbol_file_spec, or both module_file_spec and symbol_file_spec. The callback will be cleared if nullptr or None is set.

Definition at line 660 of file SBPlatform.cpp.

References error(), GetSP(), LLDB_INSTRUMENT_VA, and lldb::SBFileSpec::ref().

◆ SetSDKRoot()

void SBPlatform::SetSDKRoot ( const char * sysroot )

Definition at line 489 of file SBPlatform.cpp.

References GetSP(), and LLDB_INSTRUMENT_VA.

◆ SetSP()

void SBPlatform::SetSP ( const lldb::PlatformSP & platform_sp )

protected

Definition at line 349 of file SBPlatform.cpp.

References m_opaque_sp.

Referenced by lldb::SBDebugger::GetPlatformAtIndex(), and lldb::SBDebugger::GetSelectedPlatform().

◆ SetWorkingDirectory()

bool SBPlatform::SetWorkingDirectory ( const char * path )

Definition at line 362 of file SBPlatform.cpp.

References GetSP(), and LLDB_INSTRUMENT_VA.

Friends And Related Function Documentation

◆ SBDebugger

friend class SBDebugger

friend

Definition at line 185 of file SBPlatform.h.

◆ SBTarget

friend class SBTarget

friend

Definition at line 186 of file SBPlatform.h.

Member Data Documentation

◆ m_opaque_sp

lldb::PlatformSP lldb::SBPlatform::m_opaque_sp

protected

Definition at line 196 of file SBPlatform.h.

Referenced by Clear(), GetHostPlatform(), lldb::SBTarget::GetPlatform(), GetSP(), operator=(), SBPlatform(), and SetSP().

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

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ SBPlatform() [1/3]

◆ SBPlatform() [2/3]

◆ SBPlatform() [3/3]

◆ ~SBPlatform()

Member Function Documentation

◆ Clear()

◆ ConnectRemote()

◆ DisconnectRemote()

◆ ExecuteConnected()

◆ Get()

◆ GetEnvironment()

◆ GetFilePermissions()

◆ GetHostname()

◆ GetHostPlatform()

◆ GetName()

◆ GetOSBuild()

◆ GetOSDescription()

◆ GetOSMajorVersion()

◆ GetOSMinorVersion()

◆ GetOSUpdateVersion()

◆ GetSP()

◆ GetTriple()

◆ GetUnixSignals()

◆ GetWorkingDirectory()

◆ Install()

◆ IsConnected()

◆ IsValid()

◆ Kill()

◆ Launch()

◆ MakeDirectory()

◆ operator bool()

◆ operator=()

◆ Put()

◆ Run()

◆ SetFilePermissions()

◆ SetLocateModuleCallback()

◆ SetSDKRoot()

◆ SetSP()

◆ SetWorkingDirectory()

Friends And Related Function Documentation

◆ SBDebugger

◆ SBTarget

Member Data Documentation

◆ m_opaque_sp