/* * Copyright (c) 2011-2015, Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without modification, * are permitted provided that the following conditions are met: * * 1. Redistributions of source code must retain the above copyright notice, this * list of conditions and the following disclaimer. * * 2. Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation and/or * other materials provided with the distribution. * * 3. Neither the name of the copyright holder nor the names of its contributors * may be used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ #include <algorithm> #include "SystemClass.h" #include "SubsystemLibrary.h" #include "VirtualSubsystem.h" #include "LoggingElementBuilderTemplate.h" #include <cassert> #include "PluginLocation.h" #include "DynamicLibrary.hpp" #include "Utility.h" #include "Memory.hpp" #define base CConfigurableElement #ifndef PARAMETER_FRAMEWORK_PLUGIN_ENTRYPOINT_V1 #error Missing PARAMETER_FRAMEWORK_PLUGIN_ENTRYPOINT_V1 macro definition #endif #define QUOTE(X) #X #define MACRO_TO_STR(X) QUOTE(X) const char CSystemClass::entryPointSymbol[] = MACRO_TO_STR(PARAMETER_FRAMEWORK_PLUGIN_ENTRYPOINT_V1); using PluginEntryPointV1 = void (*)(CSubsystemLibrary *, core::log::Logger &); using std::list; using std::string; // FIXME: integrate SystemClass to core namespace using namespace core; CSystemClass::CSystemClass(log::Logger &logger) : _pSubsystemLibrary(new CSubsystemLibrary()), _logger(logger) { } CSystemClass::~CSystemClass() { delete _pSubsystemLibrary; // Destroy child subsystems *before* unloading the libraries (otherwise crashes will occur // as unmapped code will be referenced) clean(); } bool CSystemClass::childrenAreDynamic() const { return true; } string CSystemClass::getKind() const { return "SystemClass"; } bool CSystemClass::getMappingData(const std::string & /*strKey*/, const std::string *& /*pStrValue*/) const { // Although it could make sense to have mapping in the system class, // just like at subsystem level, it is currently not supported. return false; } string CSystemClass::getFormattedMapping() const { return ""; } bool CSystemClass::loadSubsystems(string &strError, const CSubsystemPlugins *pSubsystemPlugins, bool bVirtualSubsystemFallback) { // Start clean _pSubsystemLibrary->clean(); typedef TLoggingElementBuilderTemplate<CVirtualSubsystem> VirtualSubsystemBuilder; // Add virtual subsystem builder _pSubsystemLibrary->addElementBuilder("Virtual", new VirtualSubsystemBuilder(_logger)); // Set virtual subsytem as builder fallback if required if (bVirtualSubsystemFallback) { _pSubsystemLibrary->setDefaultBuilder( utility::make_unique<VirtualSubsystemBuilder>(_logger)); } // Add subsystem defined in shared libraries core::Results errors; bool bLoadPluginsSuccess = loadSubsystemsFromSharedLibraries(errors, pSubsystemPlugins); // Fill strError for caller, he has to decide if there is a problem depending on // bVirtualSubsystemFallback value strError = utility::asString(errors); return bLoadPluginsSuccess || bVirtualSubsystemFallback; } bool CSystemClass::loadSubsystemsFromSharedLibraries(core::Results &errors, const CSubsystemPlugins *pSubsystemPlugins) { // Plugin list list<string> lstrPluginFiles; size_t pluginLocation; for (pluginLocation = 0; pluginLocation < pSubsystemPlugins->getNbChildren(); pluginLocation++) { // Get Folder for current Plugin Location const CPluginLocation *pPluginLocation = static_cast<const CPluginLocation *>(pSubsystemPlugins->getChild(pluginLocation)); string strFolder(pPluginLocation->getFolder()); if (!strFolder.empty()) { strFolder += "/"; } // Iterator on Plugin List: list<string>::const_iterator it; const list<string> &pluginList = pPluginLocation->getPluginList(); for (it = pluginList.begin(); it != pluginList.end(); ++it) { // Fill Plugin files list lstrPluginFiles.push_back(strFolder + *it); } } // Actually load plugins while (!lstrPluginFiles.empty()) { // Because plugins might depend on one another, loading will be done // as an iteration process that finishes successfully when the remaining // list of plugins to load gets empty or unsuccessfully if the loading // process failed to load at least one of them // Attempt to load the complete list if (!loadPlugins(lstrPluginFiles, errors)) { // Unable to load at least one plugin break; } } if (!lstrPluginFiles.empty()) { // Unable to load at least one plugin errors.push_back("Unable to load the following plugins: " + utility::asString(lstrPluginFiles, ", ") + "."); return false; } return true; } // Plugin loading bool CSystemClass::loadPlugins(list<string> &lstrPluginFiles, core::Results &errors) { assert(lstrPluginFiles.size()); bool bAtLeastOneSubsystemPluginSuccessfullyLoaded = false; auto it = lstrPluginFiles.begin(); while (it != lstrPluginFiles.end()) { string strPluginFileName = *it; // Load attempt try { auto library = utility::make_unique<DynamicLibrary>(strPluginFileName); // Load symbol from library auto subSystemBuilder = library->getSymbol<PluginEntryPointV1>(entryPointSymbol); // Store libraries handles _subsystemLibraryHandleList.push_back(std::move(library)); // Fill library subSystemBuilder(_pSubsystemLibrary, _logger); } catch (std::exception &e) { errors.push_back(e.what()); // Next plugin ++it; continue; } // Account for this success bAtLeastOneSubsystemPluginSuccessfullyLoaded = true; // Remove successfully loaded plugin from list and select next lstrPluginFiles.erase(it++); } return bAtLeastOneSubsystemPluginSuccessfullyLoaded; } const CSubsystemLibrary *CSystemClass::getSubsystemLibrary() const { return _pSubsystemLibrary; } void CSystemClass::checkForSubsystemsToResync(CSyncerSet &syncerSet, core::Results &infos) { size_t uiNbChildren = getNbChildren(); size_t uiChild; for (uiChild = 0; uiChild < uiNbChildren; uiChild++) { CSubsystem *pSubsystem = static_cast<CSubsystem *>(getChild(uiChild)); // Collect and consume the need for a resync if (pSubsystem->needResync(true)) { infos.push_back("Resynchronizing subsystem: " + pSubsystem->getName()); // get all subsystem syncers pSubsystem->fillSyncerSet(syncerSet); } } } void CSystemClass::cleanSubsystemsNeedToResync() { size_t uiNbChildren = getNbChildren(); size_t uiChild; for (uiChild = 0; uiChild < uiNbChildren; uiChild++) { CSubsystem *pSubsystem = static_cast<CSubsystem *>(getChild(uiChild)); // Consume the need for a resync pSubsystem->needResync(true); } }