Improve g_module_open(), deprecate G_MODULE_SUFFIX
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
2022-10-14 01:04:13 +02:00
|
|
|
#include "config.h"
|
|
|
|
|
|
|
|
/*
|
|
|
|
* This is the only way to disable deprecation warnings for macros, and we need
|
|
|
|
* to continue using G_MODULE_SUFFIX in the implementation of
|
|
|
|
* g_module_build_path() which is also deprecated API.
|
|
|
|
*/
|
2022-11-16 13:01:35 +01:00
|
|
|
#ifndef GLIB_DISABLE_DEPRECATION_WARNINGS
|
Improve g_module_open(), deprecate G_MODULE_SUFFIX
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
2022-10-14 01:04:13 +02:00
|
|
|
#define GLIB_DISABLE_DEPRECATION_WARNINGS
|
2022-11-16 13:01:35 +01:00
|
|
|
#endif
|
|
|
|
|
Improve g_module_open(), deprecate G_MODULE_SUFFIX
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
2022-10-14 01:04:13 +02:00
|
|
|
#include <glib.h>
|
|
|
|
|
|
|
|
#if (G_MODULE_IMPL == G_MODULE_IMPL_AR) || (G_MODULE_IMPL == G_MODULE_IMPL_DL)
|
|
|
|
G_GNUC_INTERNAL gchar* _g_module_build_path (const gchar *directory,
|
|
|
|
const gchar *module_name);
|
|
|
|
|
|
|
|
gchar*
|
|
|
|
_g_module_build_path (const gchar *directory,
|
|
|
|
const gchar *module_name)
|
|
|
|
{
|
|
|
|
if (directory && *directory) {
|
|
|
|
if (strncmp (module_name, "lib", 3) == 0)
|
|
|
|
return g_strconcat (directory, "/", module_name, NULL);
|
|
|
|
else
|
|
|
|
return g_strconcat (directory, "/lib", module_name, "." G_MODULE_SUFFIX, NULL);
|
|
|
|
} else if (strncmp (module_name, "lib", 3) == 0)
|
|
|
|
return g_strdup (module_name);
|
|
|
|
else
|
|
|
|
return g_strconcat ("lib", module_name, "." G_MODULE_SUFFIX, NULL);
|
|
|
|
}
|
|
|
|
#endif
|