PluginManager Class Reference

Plugin manager - loads plugins: shared libs or DLLs. More...

Classes
struct	Data

Public Member Functions
Data *	findData (const char *nm)
const Data *	findData (const char *nm) const
const Data *	findDataWithDispName (const char *) const
const char *	getAutoDir (bool usr) const
ObjectSet< Data > &	getData ()
const char *	getFileName (const Data &) const
void	getNotLoadedByUser (BufferStringSet &) const
bool	isPresent (const char *) const
bool	load (const char *libnm)
	Explicit load of a plugin. More...
void	loadAuto (bool late)
	see class comments More...
void	loadAuto (bool late, bool filter)
void	unLoadAll ()
const char *	userName (const char *) const

Static Public Member Functions
static PluginManager &	getInstance ()
static const char *	moduleName (const char *)
	returns without path, 'lib' and extension More...
static const char *	sKeyDontLoad ()

Private Member Functions
	PluginManager ()
Data *	fndData (const char *) const
void	getALOEntries (const char *, bool)
void	getDefDirs ()
void	mkALOList ()
void	openALOEntries ()

Private Attributes
BufferString	appdir_
BufferString	applibdir_
ObjectSet< Data >	data_
BufferString	userdir_
BufferString	userlibdir_

Friends
PluginManager &	PIM ()

Detailed Description

Plugin manager - loads plugins: shared libs or DLLs.

Note: there are macros making most of the below stuff not interesting. See header file odplugin.h.

For shared libs to be in any way useful, an init function must be called. The name of that function should predictable. It is constructed as follows: InitxxxPlugin where xxx is the name of the plugin file, where: libxxx.so -> xxx xxx.dll -> xxx etc.

The signature is:

extern "C" { const char* InitxxxPlugin(int,char**); }

Optional extras:

1) If you want the plugin to be loaded automatically at startup define:

extern "C" int GetxxxPluginType(void);

if not defined, PI_AUTO_INIT_NONE is assumed, which means it will not be loaded if not explicitly done so.

Loading from startup is done from $HOME/.od/plugins/$PLFSUBDIR/libs or $dGB_APPL/plugins/$PLFSUBDIR/libs. The plguniins in these directories will be loaded only if they are mentioned in a .alo file in the parent directory, $HOME/.od/plugins/$PLFSUBDIR or $dGB_APPL/plugins/$PLFSUBDIR. The alo files are handled in alphabetical order.

2) It may be a good idea to define a function:

extern "C" PluginInfo* GetxxxPluginInfo(void);

Make sure it returns an object of type PluginManager::Info*. Make sure it points to an existing object (static or made with new/malloc);

3) The user of PIM() can decide not to load all of the .alo load libs. After construction, the getData() list is filled. You can change the source_ to None before calling loadAuto().

<>

Constructor & Destructor Documentation

PluginManager()

PluginManager::PluginManager ( )

private

Member Function Documentation

findData() [1/2]

Data* PluginManager::findData ( const char *  nm )

inline

findData() [2/2]

const Data* PluginManager::findData ( const char *  nm ) const

inline

findDataWithDispName()

const Data* PluginManager::findDataWithDispName

(

const char *

)

const

fndData()

Data* PluginManager::fndData ( const char *  ) const

private

getALOEntries()

void PluginManager::getALOEntries ( const char *  , bool    )

private

getAutoDir()

const char* PluginManager::getAutoDir ( bool  usr ) const

inline

getData()

ObjectSet<Data>& PluginManager::getData ( )

inline

getDefDirs()

void PluginManager::getDefDirs ( )

private

getFileName()

const char* PluginManager::getFileName

(

const Data &

)

const

getInstance()

static PluginManager& PluginManager::getInstance ( )

static

getNotLoadedByUser()

void PluginManager::getNotLoadedByUser

(

BufferStringSet &

)

const

isPresent()

bool PluginManager::isPresent

(

const char *

)

const

load()

bool PluginManager::load

(

const char *

libnm

)

Explicit load of a plugin.

loadAuto() [1/2]

void PluginManager::loadAuto

(

bool

late

)

see class comments

loadAuto() [2/2]

void PluginManager::loadAuto	(	bool	late,
		bool	filter
	)

mkALOList()

void PluginManager::mkALOList ( )

private

moduleName()

static const char* PluginManager::moduleName ( const char *  )

static

returns without path, 'lib' and extension

openALOEntries()

void PluginManager::openALOEntries ( )

private

sKeyDontLoad()

static const char* PluginManager::sKeyDontLoad ( )

inlinestatic

unLoadAll()

void PluginManager::unLoadAll

(

)

userName()

const char* PluginManager::userName

(

const char *

)

const

returns name in plugin-info, or moduleName if plugin info is not available.

Friends And Related Function Documentation

PIM

PluginManager& PIM ( )

friend

Member Data Documentation

appdir_

BufferString PluginManager::appdir_

private

applibdir_

BufferString PluginManager::applibdir_

private

data_

ObjectSet<Data> PluginManager::data_

private

userdir_

BufferString PluginManager::userdir_

private

userlibdir_

BufferString PluginManager::userlibdir_

private