mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-12-25 15:06:14 +01:00
d941558ee9
G_MODULE_SUFFIX is deprecated now because you will get the wrong results using it most of the time: 1. The suffix on macOS is usually 'dylib', but it's 'so' when using Autotools, so there's no way to get the suffix correct using a pre-processor macro. 2. Prefixes also vary in a platform-specific way. You may or may not have a 'lib' prefix for the name on Windows and on Cygwin the prefix is 'cyg'. 3. The library name itself can vary per platform. For instance, you may want to load foo-1.dll on Windows and libfoo.1.dylib on macOS. This is for libraries, not modules, but that is still a use-case that people use the GModule API for. g_module_build_path() does take care of (2) on Cygwin, but it fundamentally cannot handle the possibility of multiple options for the module name, since it does not do any I/O. Hence, it is also deprecated. Instead, g_module_open() has been improved so that it takes care of all this by searching the filesystem for combinations of possible suffixes and prefixes on each platform. Along the way, the documentation for it was also improved to make it clearer what it does. Closes https://gitlab.gnome.org/GNOME/glib/-/issues/520 Closes https://gitlab.gnome.org/GNOME/glib/-/issues/1413
170 lines
3.6 KiB
C
170 lines
3.6 KiB
C
/* GMODULE - GLIB wrapper code for dynamic module loading
|
|
* Copyright (C) 1998, 2000 Tim Janik
|
|
*
|
|
* SPDX-License-Identifier: LGPL-2.1-or-later
|
|
*
|
|
* 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, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
/*
|
|
* MT safe
|
|
*/
|
|
|
|
/* because we are compatible with archive format only since AIX 4.3 */
|
|
|
|
#define __AR_BIG__
|
|
|
|
#include "config.h"
|
|
|
|
#include <ar.h>
|
|
#include <stdlib.h>
|
|
|
|
#include <dlfcn.h>
|
|
|
|
/* --- functions --- */
|
|
static gchar*
|
|
fetch_dlerror (gboolean replace_null)
|
|
{
|
|
gchar *msg = dlerror ();
|
|
|
|
/* make sure we always return an error message != NULL, if
|
|
* expected to do so. */
|
|
|
|
if (!msg && replace_null)
|
|
return "unknown dl-error";
|
|
|
|
return msg;
|
|
}
|
|
|
|
static gchar* _g_module_get_member(const gchar* file_name)
|
|
{
|
|
gchar* member = NULL;
|
|
struct fl_hdr file_header;
|
|
struct ar_hdr ar_header;
|
|
long first_member;
|
|
long name_len;
|
|
int fd;
|
|
|
|
fd = open(file_name, O_RDONLY);
|
|
if (fd == -1)
|
|
return NULL;
|
|
|
|
if (read(fd, (void*)&file_header, FL_HSZ) != FL_HSZ)
|
|
goto exit;
|
|
|
|
if (strncmp(file_header.fl_magic, AIAMAGBIG, SAIAMAG) != 0)
|
|
goto exit;
|
|
|
|
/* read first archive file member header */
|
|
|
|
first_member = atol(file_header.fl_fstmoff);
|
|
|
|
if (lseek(fd, first_member, SEEK_SET) != first_member)
|
|
goto exit;
|
|
|
|
if (read(fd, (void*)&ar_header, AR_HSZ - 2) != AR_HSZ - 2)
|
|
goto exit;
|
|
|
|
/* read member name */
|
|
|
|
name_len = atol(ar_header.ar_namlen);
|
|
|
|
member = g_malloc(name_len+1);
|
|
if (!member)
|
|
goto exit;
|
|
|
|
if (read(fd, (void*)member, name_len) != name_len)
|
|
{
|
|
g_free(member);
|
|
member = NULL;
|
|
goto exit;
|
|
}
|
|
|
|
member[name_len] = 0;
|
|
|
|
exit:
|
|
close(fd);
|
|
|
|
return member;
|
|
}
|
|
|
|
static gpointer
|
|
_g_module_open (const gchar *file_name,
|
|
gboolean bind_lazy,
|
|
gboolean bind_local,
|
|
GError **error)
|
|
{
|
|
gpointer handle;
|
|
gchar* member;
|
|
gchar* full_name;
|
|
|
|
/* extract name of first member of archive */
|
|
|
|
member = _g_module_get_member (file_name);
|
|
if (member != NULL)
|
|
{
|
|
full_name = g_strconcat (file_name, "(", member, ")", NULL);
|
|
g_free (member);
|
|
}
|
|
else
|
|
full_name = g_strdup (file_name);
|
|
|
|
handle = dlopen (full_name,
|
|
(bind_local ? RTLD_LOCAL : RTLD_GLOBAL) | RTLD_MEMBER | (bind_lazy ? RTLD_LAZY : RTLD_NOW));
|
|
|
|
g_free (full_name);
|
|
|
|
if (!handle)
|
|
{
|
|
const gchar *message = fetch_dlerror (TRUE);
|
|
|
|
g_module_set_error (message);
|
|
g_set_error_literal (error, G_MODULE_ERROR, G_MODULE_ERROR_FAILED, message);
|
|
}
|
|
|
|
return handle;
|
|
}
|
|
|
|
static gpointer
|
|
_g_module_self (void)
|
|
{
|
|
gpointer handle;
|
|
|
|
handle = dlopen (NULL, RTLD_GLOBAL | RTLD_LAZY);
|
|
if (!handle)
|
|
g_module_set_error (fetch_dlerror (TRUE));
|
|
|
|
return handle;
|
|
}
|
|
|
|
static void
|
|
_g_module_close (gpointer handle)
|
|
{
|
|
if (dlclose (handle) != 0)
|
|
g_module_set_error (fetch_dlerror (TRUE));
|
|
}
|
|
|
|
static gpointer
|
|
_g_module_symbol (gpointer handle,
|
|
const gchar *symbol_name)
|
|
{
|
|
gpointer p;
|
|
|
|
p = dlsym (handle, symbol_name);
|
|
if (!p)
|
|
g_module_set_error (fetch_dlerror (FALSE));
|
|
|
|
return p;
|
|
}
|