/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2015-2016 Cirilo Bernardo * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License * as published by the Free Software Foundation; either version 2 * of the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, you may find one here: * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html * or you may search the http://www.gnu.org website for the version 2 license, * or you may write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA */ #include #include #include #include #include #include #include "pluginldr.h" KICAD_PLUGIN_LDR::KICAD_PLUGIN_LDR() { ok = false; m_getPluginClass = NULL; m_getClassVersion = NULL; m_checkClassVersion = NULL; m_getPluginName = NULL; m_getVersion = NULL; return; } KICAD_PLUGIN_LDR::~KICAD_PLUGIN_LDR() { close(); return; } bool KICAD_PLUGIN_LDR::open( const wxString& aFullFileName, const char* aPluginClass ) { m_error.clear(); if( ok ) Close(); if( aFullFileName.empty() ) return false; m_fileName.clear(); m_PluginLoader.Load( aFullFileName, wxDL_LAZY ); if( !m_PluginLoader.IsLoaded() ) { #ifdef DEBUG std::ostringstream ostr; ostr << __FILE__ << ": " << __FUNCTION__ << ": " << __LINE__ << "\n"; ostr << " * could not open file: '" << aFullFileName.ToUTF8() << "'"; wxLogTrace( MASK_PLUGINLDR, "%s\n", ostr.str().c_str() ); #endif return false; } LINK_ITEM( m_getPluginClass, GET_PLUGIN_CLASS, "GetKicadPluginClass" ); LINK_ITEM( m_getClassVersion, GET_CLASS_VERSION, "GetClassVersion" ); LINK_ITEM( m_checkClassVersion, CHECK_CLASS_VERSION , "CheckClassVersion" ); LINK_ITEM( m_getPluginName, GET_PLUGIN_NAME, "GetKicadPluginName" ); LINK_ITEM( m_getVersion, GET_VERSION, "GetPluginVersion" ); #ifdef DEBUG bool fail = false; if( !m_getPluginClass ) { std::ostringstream ostr; ostr << __FILE__ << ": " << __FUNCTION__ << ": " << __LINE__ << "\n"; wxString errmsg = _( "incompatible plugin (missing function 'GetKicadPluginClass')" ); ostr << errmsg.ToUTF8() << "\n"; ostr << "'" << aFullFileName.ToUTF8() << "'"; wxLogTrace( MASK_PLUGINLDR, "%s\n", ostr.str().c_str() ); fail = true; } if( !m_getClassVersion ) { if( !fail ) { std::ostringstream ostr; ostr << __FILE__ << ": " << __FUNCTION__ << ": " << __LINE__ << "\n"; wxString errmsg = _( "incompatible plugin (missing function 'GetClassVersion')" ); ostr << errmsg.ToUTF8() << "\n"; ostr << "'" << aFullFileName.ToUTF8() << "'"; wxLogTrace( MASK_PLUGINLDR, "%s\n", ostr.str().c_str() ); fail = true; } else { std::ostringstream ostr; wxString errmsg = _( "missing function 'GetClassVersion'" ); ostr << errmsg.ToUTF8(); wxLogTrace( MASK_PLUGINLDR, "%s\n", ostr.str().c_str() ); } } if( !m_checkClassVersion ) { if( !fail ) { std::ostringstream ostr; ostr << __FILE__ << ": " << __FUNCTION__ << ": " << __LINE__ << "\n"; wxString errmsg = _( "incompatible plugin (missing function 'CheckClassVersion')" ); ostr << errmsg.ToUTF8() << "\n"; ostr << "'" << aFullFileName.ToUTF8() << "'"; wxLogTrace( MASK_PLUGINLDR, "%s\n", ostr.str().c_str() ); fail = true; } else { std::ostringstream ostr; wxString errmsg = _( "missing function 'CheckClassVersion'" ); ostr << errmsg.ToUTF8(); wxLogTrace( MASK_PLUGINLDR, "%s\n", ostr.str().c_str() ); } } if( !m_getPluginName ) { if( !fail ) { std::ostringstream ostr; ostr << __FILE__ << ": " << __FUNCTION__ << ": " << __LINE__ << "\n"; wxString errmsg = _( "incompatible plugin (missing function 'GetKicadPluginName')" ); ostr << errmsg.ToUTF8() << "\n"; ostr << "'" << aFullFileName.ToUTF8() << "'"; wxLogTrace( MASK_PLUGINLDR, "%s\n", ostr.str().c_str() ); fail = true; } else { std::ostringstream ostr; wxString errmsg = _( "missing function 'GetKicadPluginName'" ); ostr << errmsg.ToUTF8(); wxLogTrace( MASK_PLUGINLDR, "%s\n", ostr.str().c_str() ); } } if( !m_getVersion ) { if( !fail ) { std::ostringstream ostr; ostr << __FILE__ << ": " << __FUNCTION__ << ": " << __LINE__ << "\n"; wxString errmsg = _( "incompatible plugin (missing function 'GetVersion')" ); ostr << errmsg.ToUTF8() << "\n"; ostr << "'" << aFullFileName.ToUTF8() << "'"; wxLogTrace( MASK_PLUGINLDR, "%s\n", ostr.str().c_str() ); } else { std::ostringstream ostr; wxString errmsg = _( "missing function 'GetVersion'" ); ostr << errmsg.ToUTF8() << "\n"; wxLogTrace( MASK_PLUGINLDR, "%s\n", ostr.str().c_str() ); } } #endif if( !m_getPluginClass || !m_getClassVersion || !m_checkClassVersion || !m_getPluginName || !m_getVersion ) { m_error = "incompatible plugin interface (missing functions)"; close(); return false; } // note: since 'ok' is not yet set at this point we must use the function // pointers directly rather than invoking the functions exposed by this class // check that the Plugin Class matches char const* pclassName = m_getPluginClass(); if( !pclassName || strcmp( aPluginClass, pclassName ) ) { m_error = "Loader type ("; m_error.append( aPluginClass ); m_error.append( ") does not match Plugin type (" ); if( pclassName ) m_error.append( pclassName ); else m_error.append( "NULL" ); m_error.append( ")" ); close(); return false; } // perform a universally enforced version check (major number must match) unsigned char lMajor; unsigned char lMinor; unsigned char lPatch; unsigned char lRevno; unsigned char pMajor; unsigned char pMinor; unsigned char pPatch; unsigned char pRevno; m_getClassVersion( &pMajor, &pMinor, &pPatch, &pRevno ); GetLoaderVersion( &lMajor, &lMinor, &lPatch, &lRevno ); // major version changes by definition are incompatible and // that is enforced here. if( pMajor != lMajor ) { std::ostringstream ostr; ostr << "Loader Major version (" << lMajor; ostr << ") does not match Plugin Major version (" << pMajor << ")"; m_error = ostr.str(); close(); return false; } if( !m_checkClassVersion( lMajor, lMinor, lPatch, lRevno ) ) { std::ostringstream ostr; ostr << "Plugin Version (" << pMajor << "." << pMinor << "." << pPatch << "." << pRevno; ostr << ") does not support Loader Version (" << pMajor << "." << pMinor; ostr << "." << pPatch << "." << pRevno << ")"; m_error = ostr.str(); close(); return false; } m_fileName = aFullFileName; #ifdef DEBUG do { std::ostringstream ostr; ostr << __FILE__ << ": " << __FUNCTION__ << ": " << __LINE__ << "\n"; ostr << " * [INFO] opened plugin " << m_fileName.ToUTF8(); char const* cp = m_getPluginName(); if( NULL != cp ) ostr << " * [INFO] plugin name: '" << cp << "'\n"; wxLogTrace( MASK_PLUGINLDR, "%s\n", ostr.str().c_str() ); } while( 0 ); #endif ok = true; // set the plugin info string m_pluginInfo = GetKicadPluginName(); std::ostringstream ostr; unsigned char r0, r1, r2, r3; GetVersion( &r0, &r1, &r2, &r3 ); ostr << ":" << (unsigned int)r0 << "." << (unsigned int)r1; ostr << "." << (unsigned int)r2 << "." << (unsigned int)r3; m_pluginInfo.append( ostr.str() ); return true; } void KICAD_PLUGIN_LDR::close( void ) { ok = false; m_getPluginClass = NULL; m_getClassVersion = NULL; m_checkClassVersion = NULL; m_getPluginName = NULL; m_getVersion = NULL; m_PluginLoader.Unload(); return; } bool KICAD_PLUGIN_LDR::reopen( void ) { m_error.clear(); if( m_fileName.empty() ) return false; wxString fname = m_fileName; return Open( fname ); } std::string KICAD_PLUGIN_LDR::GetLastError( void ) const { return m_error; } char const* KICAD_PLUGIN_LDR::GetKicadPluginClass( void ) { m_error.clear(); if( !ok && !reopen() ) { if( m_error.empty() ) m_error = "[INFO] no open plugin / plugin could not be opened"; return NULL; } if( NULL == m_getPluginClass ) { m_error = "[BUG] GetPluginClass is not linked"; #ifdef DEBUG std::ostringstream ostr; ostr << __FILE__ << ": " << __FUNCTION__ << ": " << __LINE__ << "\n"; ostr << " * " << m_error; wxLogTrace( MASK_PLUGINLDR, "%s\n", ostr.str().c_str() ); #endif return NULL; } return m_getPluginClass(); } bool KICAD_PLUGIN_LDR::GetClassVersion( unsigned char* Major, unsigned char* Minor, unsigned char* Patch, unsigned char* Revision ) { m_error.clear(); if( Major ) *Major = 0; if( Minor ) *Minor = 0; if( Patch ) *Patch = 0; if( Revision ) *Revision = 0; unsigned char major; unsigned char minor; unsigned char patch; unsigned char revno; if( !ok && !reopen() ) { if( m_error.empty() ) m_error = "[INFO] no open plugin / plugin could not be opened"; return false; } if( NULL == m_checkClassVersion ) { m_error = "[BUG] CheckClassVersion is not linked"; #ifdef DEBUG std::ostringstream ostr; ostr << __FILE__ << ": " << __FUNCTION__ << ": " << __LINE__ << "\n"; ostr << " * " << m_error; wxLogTrace( MASK_PLUGINLDR, "%s\n", ostr.str().c_str() ); #endif return false; } m_getClassVersion( &major, &minor, &patch, &revno ); if( Major ) *Major = major; if( Minor ) *Minor = minor; if( Patch ) *Patch = patch; if( Revision ) *Revision = revno; return true; } bool KICAD_PLUGIN_LDR::CheckClassVersion( unsigned char Major, unsigned char Minor, unsigned char Patch, unsigned char Revision ) { m_error.clear(); if( !ok && !reopen() ) { if( m_error.empty() ) m_error = "[INFO] no open plugin / plugin could not be opened"; return false; } if( NULL == m_checkClassVersion ) { m_error = "[BUG] CheckClassVersion is not linked"; #ifdef DEBUG std::ostringstream ostr; ostr << __FILE__ << ": " << __FUNCTION__ << ": " << __LINE__ << "\n"; ostr << " * " << m_error; wxLogTrace( MASK_PLUGINLDR, "%s\n", ostr.str().c_str() ); #endif return false; } return m_checkClassVersion( Major, Minor, Patch, Revision ); } const char* KICAD_PLUGIN_LDR::GetKicadPluginName( void ) { m_error.clear(); if( !ok && !reopen() ) { if( m_error.empty() ) m_error = "[INFO] no open plugin / plugin could not be opened"; return NULL; } if( NULL == m_getPluginName ) { m_error = "[BUG] GetKicadPluginName is not linked"; #ifdef DEBUG std::ostringstream ostr; ostr << __FILE__ << ": " << __FUNCTION__ << ": " << __LINE__ << "\n"; ostr << " * " << m_error; wxLogTrace( MASK_PLUGINLDR, "%s\n", ostr.str().c_str() ); #endif return NULL; } return m_getPluginName(); } bool KICAD_PLUGIN_LDR::GetVersion( unsigned char* Major, unsigned char* Minor, unsigned char* Patch, unsigned char* Revision ) { m_error.clear(); if( !ok && !reopen() ) { if( m_error.empty() ) m_error = "[INFO] no open plugin / plugin could not be opened"; return false; } if( NULL == m_getVersion ) { m_error = "[BUG] GetKicadPluginName is not linked"; #ifdef DEBUG std::ostringstream ostr; ostr << __FILE__ << ": " << __FUNCTION__ << ": " << __LINE__ << "\n"; ostr << " * " << m_error; wxLogTrace( MASK_PLUGINLDR, "%s\n", ostr.str().c_str() ); #endif return false; } m_getVersion( Major, Minor, Patch, Revision ); return true; } void KICAD_PLUGIN_LDR::GetPluginInfo( std::string& aPluginInfo ) { aPluginInfo = m_pluginInfo; }