//%2006////////////////////////////////////////////////////////////////////////
//
// Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development
// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems.
// Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.;
// IBM Corp.; EMC Corporation, The Open Group.
// Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.;
// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.
// Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.;
// EMC Corporation; VERITAS Software Corporation; The Open Group.
// Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.;
// EMC Corporation; Symantec Corporation; The Open Group.
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to
// deal in the Software without restriction, including without limitation the
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
// sell copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN
// ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED
// "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
// LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
//
//==============================================================================
//
//%/////////////////////////////////////////////////////////////////////////////
/*!
  \file tool.c
  \brief General tooling facility.

  This module offers general tooling methods that may be used by different
  components on the CIMOM as well as on the remote side.

*/
#include "cmpir_common.h"
#include <stdio.h>

#ifdef PEGASUS_OS_TYPE_UNIX
#include <dlfcn.h>
#include <strings.h>
#elif defined PEGASUS_OS_TYPE_WINDOWS
#include <winsock2.h>
#include <Winbase.h>
#endif

#include "debug.h"
#include "tool.h"

#define GENERIC_ENTRY_POINT(n) \
        typedef CMPI##n##MI * (* GENERIC_##n##MI) ( CMPIBroker * broker, \
                                CMPIContext * ctx, \
                                                    const char * provider )
#define FIXED_ENTRY_POINT(n) \
        typedef CMPI##n##MI * (* FIXED_##n##MI) ( CMPIBroker * broker, \
                              CMPIContext * ctx )

#define LOAD_MI(n) \
        GENERIC_ENTRY_POINT(n); \
        FIXED_ENTRY_POINT(n); \
\
        CMPI##n##MI * tool_load_##n##MI ( const char * provider, \
                                          void * library, \
                      CMPIBroker * broker, \
                      CMPIContext * ctx ) \
{ \
    GENERIC_##n##MI g = \
        (GENERIC_##n##MI) \
                 __get_generic_entry_point ( library, #n ); \
\
    if ( g == NULL ) { \
        FIXED_##n##MI f = \
            (FIXED_##n##MI) \
            __get_fixed_entry_point ( provider, \
                          library, \
                          #n ); \
\
        if ( f == NULL ) return NULL; \
        return ( f ) ( broker, ctx ); \
    } \
    return ( g ) ( broker, ctx, provider ); \
}


/*****************************************************************************/

//! Loads a dynamic load library.
/*!
  Loads the libary named lib<libname>.so using dlopen().

  \param libname the library name.
  \return the library handle.
 */
void * tool_load_lib ( const char * libname )
{
    char filename[255];
    void *dllhand;

    //PEGASUS_CMPIR_LIBTYPE appends libname with the lib extn based on os.
    sprintf ( filename, PEGASUS_CMPIR_LIBTYPE, libname );

    //invoke dlopen under unix and LoadLibrary under windows OS.
    dllhand = (void *) PEGASUS_CMPIR_LOADLIBRARY(filename,RTLD_LAZY);
    if (dllhand == 0)
    {
#if defined PEGASUS_OS_TYPE_UNIX
        TRACE_CRITICAL( ("Trying to load library: %s failed with %s\n", libname,
                        dlerror()) );
#else
        TRACE_CRITICAL( ("Trying to load library: %s failed with %s\n", libname,
                        strerror(errno)) );
#endif
    }
    return dllhand;
}


static void * __get_generic_entry_point ( void * library,
                      const char * ptype )
{
    char entry_point[255];

    sprintf ( entry_point, "_Generic_Create_%sMI", ptype );

    //invokes dlsym on unix and GetProcAddress on windows
    return PEGASUS_CMPIR_GETPROCADDRESS(library,entry_point);
}


static void * __get_fixed_entry_point ( const char * provider,
                    void * library,
                    const char * ptype )
{
    char entry_point[255];
    sprintf ( entry_point, "%s_Create_%sMI", provider, ptype );

    //invokes dlsym on unix and GetProcAddress on windows
    return PEGASUS_CMPIR_GETPROCADDRESS( library, entry_point );
}


LOAD_MI(Instance)
LOAD_MI(Association)
LOAD_MI(Method)
LOAD_MI(Property)
LOAD_MI(Indication)


/****************************************************************************/

/*** Local Variables:  ***/
/*** mode: C           ***/
/*** c-basic-offset: 8 ***/
/*** End:              ***/