bump version numbers to 1.7.0 and updated changelog

[deb_libcec.git] / src / lib / platform / windows / dlfcn-win32.cpp

/*
 * dlfcn-win32
 * Copyright (c) 2007 Ramiro Polla
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 */

#include <windows.h>
#include <stdio.h>

#include "dlfcn-win32.h"

/* Note:
 * MSDN says these functions are not thread-safe. We make no efforts to have
 * any kind of thread safety.
 */

/* I have no special reason to have set MAX_GLOBAL_OBJECTS to this value. Any
 * comments are welcome.
 */
#define MAX_OBJECTS 255

static HMODULE global_objects[MAX_OBJECTS];

/* This function adds an object to the list of global objects.
 * The implementation is very simple and slow.
 * TODO: should failing this function be enough to fail the call to dlopen( )?
 */
static void global_object_add( HMODULE hModule )
{
    int i;

    for( i = 0 ; i < MAX_OBJECTS ; i++ )
    {
        if( !global_objects[i] )
        {
            global_objects[i] = hModule;
            break;
        }
    }
}

static void global_object_rem( HMODULE hModule )
{
    int i;

    for( i = 0 ; i < MAX_OBJECTS ; i++ )
    {
        if( global_objects[i] == hModule )
        {
            global_objects[i] = 0;
            break;
        }
    }
}

/* Argument to last function. Used in dlerror( ) */
static char last_name[MAX_PATH];

static int copy_string( char *dest, int dest_size, const char *src )
{
    int i = 0;

    if( src && dest )
    {
        for( i = 0 ; i < dest_size-1 ; i++ )
        {
            if( !src[i] )
                break;
            else
                dest[i] = src[i];
        }
    }
    dest[i] = '\0';

    return i;
}

void *dlopen( const char *file, int mode )
{
    HMODULE hModule;
    UINT uMode;

    /* Do not let Windows display the critical-error-handler message box */
    uMode = SetErrorMode( SEM_FAILCRITICALERRORS );

    if( file == 0 )
    {
        /* Save NULL pointer for error message */
        _snprintf_s( last_name, MAX_PATH, MAX_PATH, "0x%p", file );

        /* POSIX says that if the value of file is 0, a handle on a global
         * symbol object must be provided. That object must be able to access
         * all symbols from the original program file, and any objects loaded
         * with the RTLD_GLOBAL flag.
         * The return value from GetModuleHandle( ) allows us to retrieve
         * symbols only from the original program file. For objects loaded with
         * the RTLD_GLOBAL flag, we create our own list later on.
         */
        hModule = GetModuleHandle( NULL );
    }
    else
    {
        char lpFileName[MAX_PATH];
        int i;

        /* MSDN says backslashes *must* be used instead of forward slashes. */
        for( i = 0 ; i < sizeof(lpFileName)-1 ; i++ )
        {
            if( !file[i] )
                break;
            else if( file[i] == '/' )
                lpFileName[i] = '\\';
            else
                lpFileName[i] = file[i];
        }
        lpFileName[i] = '\0';

        /* Save file name for error message */
        copy_string( last_name, sizeof(last_name), lpFileName );

        /* POSIX says the search path is implementation-defined.
         * LOAD_WITH_ALTERED_SEARCH_PATH is used to make it behave more closely
         * to UNIX's search paths (start with system folders instead of current
         * folder).
         */
        hModule = LoadLibraryEx( (LPSTR) lpFileName, NULL,
                                 LOAD_WITH_ALTERED_SEARCH_PATH );
        /* If the object was loaded with RTLD_GLOBAL, add it to list of global
         * objects, so that its symbols may be retrieved even if the handle for
         * the original program file is passed. POSIX says that if the same
         * file is specified in multiple invocations, and any of them are
         * RTLD_GLOBAL, even if any further invocations use RTLD_LOCAL, the
         * symbols will remain global.
         */

        if( hModule && (mode & RTLD_GLOBAL) )
            global_object_add( hModule );
    }

    /* Return to previous state of the error-mode bit flags. */
    SetErrorMode( uMode );

    return (void *) hModule;
}

int dlclose( void *handle )
{
    HMODULE hModule = (HMODULE) handle;
    BOOL ret;

    /* Save handle for error message */
    _snprintf_s( last_name, MAX_PATH, MAX_PATH, "0x%p", handle );

    ret = FreeLibrary( hModule );

    /* If the object was loaded with RTLD_GLOBAL, remove it from list of global
     * objects.
     */
    if( ret )
        global_object_rem( hModule );

    /* dlclose's return value in inverted in relation to FreeLibrary's. */
    ret = !ret;

    return (int) ret;
}

void *dlsym( void *handle, const char *name )
{
    FARPROC symbol;
    HMODULE myhandle = (HMODULE) handle;

    /* Save symbol name for error message */
    copy_string( last_name, sizeof(last_name), name );

    symbol = GetProcAddress( myhandle, name );
#if 0
    if( symbol == NULL )
    {
        HMODULE hModule;

        /* If the handle for the original program file is passed, also search
         * in all globally loaded objects.
         */

        hModule = GetModuleHandle( NULL );

        if( hModule == handle )
        {
            int i;
           
            for( i = 0 ; i < MAX_OBJECTS ; i++ )
            {
                if( global_objects[i] != 0 )
                {
                    symbol = GetProcAddress( global_objects[i], name );
                    if( symbol != NULL )
                        break;
                }
            }
        }


        CloseHandle( hModule );
    }
#endif
    return (void*) symbol;
}

char *dlerror( void )
{
    DWORD dwMessageId;
    /* POSIX says this function doesn't have to be thread-safe, so we use one
     * static buffer.
     * MSDN says the buffer cannot be larger than 64K bytes, so we set it to
     * the limit.
     */
    static char lpBuffer[65535];
    DWORD ret;

    dwMessageId = GetLastError( );
   
    if( dwMessageId == 0 )
        return NULL;

    /* Format error message to:
     * "<argument to function that failed>": <Windows localized error message>
     */
    ret  = copy_string( lpBuffer, sizeof(lpBuffer), "\"" );
    ret += copy_string( lpBuffer+ret, sizeof(lpBuffer)-ret, last_name );
    ret += copy_string( lpBuffer+ret, sizeof(lpBuffer)-ret, "\": " );
    ret += FormatMessage( FORMAT_MESSAGE_FROM_SYSTEM, NULL, dwMessageId,
                          MAKELANGID( LANG_NEUTRAL, SUBLANG_DEFAULT ),
                          lpBuffer+ret, sizeof(lpBuffer)-ret, NULL );

    if( ret > 1 )
    {
        /* POSIX says the string must not have trailing <newline> */
        if( lpBuffer[ret-2] == '\r' && lpBuffer[ret-1] == '\n' )
            lpBuffer[ret-2] = '\0';
    }

    /* POSIX says that invoking dlerror( ) a second time, immediately following
     * a prior invocation, shall result in NULL being returned.
     */
    SetLastError(0);

    return lpBuffer;
}