luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-12-28 16:36:14 +01:00
Code Issues Packages Projects Releases Wiki Activity
62bd79b6a2
glib/glib/glib-private.h

86 lines
3.3 KiB
C
Raw Normal View History

Add glib__private__() API to share between glib,gio; port GWakeup to it Historically we've added random symbols to the public API with warnings that they're private; examples are: glib_gettext(), glib_pgettext() g_thread_functions_for_glib_use, g_thread_use_default_impl, etc. And we almost added "GWakeup" to public API just to share between glib and gio. This new glib__private__() API exports a hidden vtable, and adds a macro GLIB_PRIVATE_CALL() that makes it generally convenient to use. This adds an extremely tiny cost for the double indirection; but it has the benefit that we don't need to either: 1) compile the code into both glib and gio (like GWakeup), with the inefficiency that implies. 2) Export a "do not use this" symbol; the serious problem with this is that someone CAN use it pretty easily. Particularly if we document it. It's far, far harder to peek into a structure without a public header file. https://bugzilla.gnome.org/show_bug.cgi?id=657992
2011-09-01 20:32:11 +02:00
/* glib-private.h - GLib-internal private API, shared between glib, gobject, gio
* Copyright (C) 2011 Red Hat, Inc.
*
* This library is free software; you can redistribute it and/or
glib/: LGPLv2+ -> LGPLv2.1+ All glib/*.{c,h} files have been processed, as well as gtester-report. 12 of those files are not licensed under LGPL: gbsearcharray.h gconstructor.h glibintl.h gmirroringtable.h gscripttable.h gtranslit-data.h gunibreak.h gunichartables.h gunicomp.h gunidecomp.h valgrind.h win_iconv.c Some of them are generated files, some are licensed under a BSD-style license and win_iconv.c is in the public domain. Sub-directories inside glib/: deprecated/: processed in a previous commit glib-mirroring-tab/: already LGPLv2.1+ gnulib/: not modified, the code is copied from gnulib libcharset/: a copy pcre/: a copy tests/: processed in a previous commit https://bugzilla.gnome.org/show_bug.cgi?id=776504
2017-01-05 12:47:07 +01:00
* modify it under the terms of the GNU Lesser General Public
Add glib__private__() API to share between glib,gio; port GWakeup to it Historically we've added random symbols to the public API with warnings that they're private; examples are: glib_gettext(), glib_pgettext() g_thread_functions_for_glib_use, g_thread_use_default_impl, etc. And we almost added "GWakeup" to public API just to share between glib and gio. This new glib__private__() API exports a hidden vtable, and adds a macro GLIB_PRIVATE_CALL() that makes it generally convenient to use. This adds an extremely tiny cost for the double indirection; but it has the benefit that we don't need to either: 1) compile the code into both glib and gio (like GWakeup), with the inefficiency that implies. 2) Export a "do not use this" symbol; the serious problem with this is that someone CAN use it pretty easily. Particularly if we document it. It's far, far harder to peek into a structure without a public header file. https://bugzilla.gnome.org/show_bug.cgi?id=657992
2011-09-01 20:32:11 +02:00
* License as published by the Free Software Foundation; either
glib/: LGPLv2+ -> LGPLv2.1+ All glib/*.{c,h} files have been processed, as well as gtester-report. 12 of those files are not licensed under LGPL: gbsearcharray.h gconstructor.h glibintl.h gmirroringtable.h gscripttable.h gtranslit-data.h gunibreak.h gunichartables.h gunicomp.h gunidecomp.h valgrind.h win_iconv.c Some of them are generated files, some are licensed under a BSD-style license and win_iconv.c is in the public domain. Sub-directories inside glib/: deprecated/: processed in a previous commit glib-mirroring-tab/: already LGPLv2.1+ gnulib/: not modified, the code is copied from gnulib libcharset/: a copy pcre/: a copy tests/: processed in a previous commit https://bugzilla.gnome.org/show_bug.cgi?id=776504
2017-01-05 12:47:07 +01:00
* version 2.1 of the License, or (at your option) any later version.
Add glib__private__() API to share between glib,gio; port GWakeup to it Historically we've added random symbols to the public API with warnings that they're private; examples are: glib_gettext(), glib_pgettext() g_thread_functions_for_glib_use, g_thread_use_default_impl, etc. And we almost added "GWakeup" to public API just to share between glib and gio. This new glib__private__() API exports a hidden vtable, and adds a macro GLIB_PRIVATE_CALL() that makes it generally convenient to use. This adds an extremely tiny cost for the double indirection; but it has the benefit that we don't need to either: 1) compile the code into both glib and gio (like GWakeup), with the inefficiency that implies. 2) Export a "do not use this" symbol; the serious problem with this is that someone CAN use it pretty easily. Particularly if we document it. It's far, far harder to peek into a structure without a public header file. https://bugzilla.gnome.org/show_bug.cgi?id=657992
2011-09-01 20:32:11 +02:00
*
* 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
glib/: LGPLv2+ -> LGPLv2.1+ All glib/*.{c,h} files have been processed, as well as gtester-report. 12 of those files are not licensed under LGPL: gbsearcharray.h gconstructor.h glibintl.h gmirroringtable.h gscripttable.h gtranslit-data.h gunibreak.h gunichartables.h gunicomp.h gunidecomp.h valgrind.h win_iconv.c Some of them are generated files, some are licensed under a BSD-style license and win_iconv.c is in the public domain. Sub-directories inside glib/: deprecated/: processed in a previous commit glib-mirroring-tab/: already LGPLv2.1+ gnulib/: not modified, the code is copied from gnulib libcharset/: a copy pcre/: a copy tests/: processed in a previous commit https://bugzilla.gnome.org/show_bug.cgi?id=776504
2017-01-05 12:47:07 +01:00
* Lesser General Public License for more details.
Add glib__private__() API to share between glib,gio; port GWakeup to it Historically we've added random symbols to the public API with warnings that they're private; examples are: glib_gettext(), glib_pgettext() g_thread_functions_for_glib_use, g_thread_use_default_impl, etc. And we almost added "GWakeup" to public API just to share between glib and gio. This new glib__private__() API exports a hidden vtable, and adds a macro GLIB_PRIVATE_CALL() that makes it generally convenient to use. This adds an extremely tiny cost for the double indirection; but it has the benefit that we don't need to either: 1) compile the code into both glib and gio (like GWakeup), with the inefficiency that implies. 2) Export a "do not use this" symbol; the serious problem with this is that someone CAN use it pretty easily. Particularly if we document it. It's far, far harder to peek into a structure without a public header file. https://bugzilla.gnome.org/show_bug.cgi?id=657992
2011-09-01 20:32:11 +02:00
*
glib/: LGPLv2+ -> LGPLv2.1+ All glib/*.{c,h} files have been processed, as well as gtester-report. 12 of those files are not licensed under LGPL: gbsearcharray.h gconstructor.h glibintl.h gmirroringtable.h gscripttable.h gtranslit-data.h gunibreak.h gunichartables.h gunicomp.h gunidecomp.h valgrind.h win_iconv.c Some of them are generated files, some are licensed under a BSD-style license and win_iconv.c is in the public domain. Sub-directories inside glib/: deprecated/: processed in a previous commit glib-mirroring-tab/: already LGPLv2.1+ gnulib/: not modified, the code is copied from gnulib libcharset/: a copy pcre/: a copy tests/: processed in a previous commit https://bugzilla.gnome.org/show_bug.cgi?id=776504
2017-01-05 12:47:07 +01:00
* 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/>.
Add glib__private__() API to share between glib,gio; port GWakeup to it Historically we've added random symbols to the public API with warnings that they're private; examples are: glib_gettext(), glib_pgettext() g_thread_functions_for_glib_use, g_thread_use_default_impl, etc. And we almost added "GWakeup" to public API just to share between glib and gio. This new glib__private__() API exports a hidden vtable, and adds a macro GLIB_PRIVATE_CALL() that makes it generally convenient to use. This adds an extremely tiny cost for the double indirection; but it has the benefit that we don't need to either: 1) compile the code into both glib and gio (like GWakeup), with the inefficiency that implies. 2) Export a "do not use this" symbol; the serious problem with this is that someone CAN use it pretty easily. Particularly if we document it. It's far, far harder to peek into a structure without a public header file. https://bugzilla.gnome.org/show_bug.cgi?id=657992
2011-09-01 20:32:11 +02:00
*/
#ifndef __GLIB_PRIVATE_H__
#define __GLIB_PRIVATE_H__
glib-private: #include <glib.h> This is really our only choice if we don't want to annoy the single-include checking when we use this from inside of gio.
2011-09-09 22:05:55 +02:00
#include <glib.h>
Add glib__private__() API to share between glib,gio; port GWakeup to it Historically we've added random symbols to the public API with warnings that they're private; examples are: glib_gettext(), glib_pgettext() g_thread_functions_for_glib_use, g_thread_use_default_impl, etc. And we almost added "GWakeup" to public API just to share between glib and gio. This new glib__private__() API exports a hidden vtable, and adds a macro GLIB_PRIVATE_CALL() that makes it generally convenient to use. This adds an extremely tiny cost for the double indirection; but it has the benefit that we don't need to either: 1) compile the code into both glib and gio (like GWakeup), with the inefficiency that implies. 2) Export a "do not use this" symbol; the serious problem with this is that someone CAN use it pretty easily. Particularly if we document it. It's far, far harder to peek into a structure without a public header file. https://bugzilla.gnome.org/show_bug.cgi?id=657992
2011-09-01 20:32:11 +02:00
#include "gwakeup.h"
W32: Add a stat() implementation for private use This commit adds new W32-only functions to gstdio.c, and a new header file, gstdioprivate.h. These functions are: g_win32_stat_utf8() g_win32_lstat_utf8() g_win32_fstat() and they fill a private structure, GWin32PrivateStat, which has all the fields that normal stat has, as well as some extras. These functions are then used throughout glib and gio to get better data about the system. Specifically: * Full, 64-bit size, guaranteed (g_stat() is forced to use 32-bit st_size) * Full, 64-bit file identifier (st_ino is 0 when normal stat() is used, and still is) * W32 File attributes (which stat() doesn't report); in particular, this allows symlinks to be correctly identified * Full, 64-bit time, guaranteed (g_stat() uses 32-bit st_*time on 32-bit Windows) * Allocated file size (as a W32 replacement for the missing st_blocks) st_mode remains unchanged (thus, no S_ISLNK), so when these are given back to glib users (via g_stat(), for example, which is now implemented by calling g_win32_stat_utf8), this field does not contain anything unexpected. g_lstat() now calls g_win32_lstat_utf8(), which works on symlinks the way it's supposed to. Also adds the g_win32_readlink_utf8() function, which behaves like readlink() (including its inability to return 0-terminated strings and inability to say how large the output buffer should be; these limitations are purely for compatibility with existing glib code). Thus, symlink support should now be much better, although far from being complete. A new W32-only test in gio/tests/file.c highlights the following features: * allocated size * 64-bit time * unique file IDs https://bugzilla.gnome.org/show_bug.cgi?id=788180
2017-09-29 12:14:41 +02:00
#include "gstdioprivate.h"
Add glib__private__() API to share between glib,gio; port GWakeup to it Historically we've added random symbols to the public API with warnings that they're private; examples are: glib_gettext(), glib_pgettext() g_thread_functions_for_glib_use, g_thread_use_default_impl, etc. And we almost added "GWakeup" to public API just to share between glib and gio. This new glib__private__() API exports a hidden vtable, and adds a macro GLIB_PRIVATE_CALL() that makes it generally convenient to use. This adds an extremely tiny cost for the double indirection; but it has the benefit that we don't need to either: 1) compile the code into both glib and gio (like GWakeup), with the inefficiency that implies. 2) Export a "do not use this" symbol; the serious problem with this is that someone CAN use it pretty easily. Particularly if we document it. It's far, far harder to peek into a structure without a public header file. https://bugzilla.gnome.org/show_bug.cgi?id=657992
2011-09-01 20:32:11 +02:00
glib worker: move to glib-private framework Remove the private glib_get_worker_context() symbol and move it over to using the glib-private stuff like GWakeup is doing. https://bugzilla.gnome.org/show_bug.cgi?id=657992
2011-09-09 20:30:25 +02:00
GMainContext * g_get_worker_context (void);
CVE-2012-3524: Hardening for being run in a setuid environment Some programs attempt to use libglib (or even libgio) when setuid. For a long time, GTK+ simply aborted if launched in this configuration, but we never had a real policy for GLib. I'm not sure whether we should advertise such support. However, given that there are real-world programs that do this currently, we can make them safer with not too much effort. Better to fix a problem caused by an interaction between two components in *both* places if possible. This patch adds a private function g_check_setuid() which is used to first ensure we don't run an external dbus-launch binary if DBUS_SESSION_BUS_ADDRESS isn't set. Second, we also ensure the local VFS is used in this case. The gdaemonvfs extension point will end up talking to the session bus which is typically undesirable in a setuid context. Implementing g_check_setuid() is interesting - whether or not we're running in a privilege-escalated path is operating system specific. Note that GTK+'s code to check euid versus uid worked historically on Unix, more modern systems have filesystem capabilities and SELinux domain transitions, neither of which are captured by the uid comparison. On Linux/glibc, the way this works is that the kernel sets an AT_SECURE flag in the ELF auxiliary vector, and glibc looks for it on startup. If found, then glibc sets a public-but-undocumented __libc_enable_secure variable which we can use. Unfortunately, while it *previously* worked to check this variable, a combination of newer binutils and RPM break it: http://www.openwall.com/lists/owl-dev/2012/08/14/1 So for now on Linux/glibc, we fall back to the historical Unix version until we get glibc fixed. On some BSD variants, there is a issetugid() function. On other Unix variants, we fall back to what GTK+ has been doing. Reported-By: Sebastian Krahmer <krahmer@suse.de> Signed-off-by: Colin Walters <walters@verbum.org>
2012-08-22 20:26:11 +02:00
gboolean g_check_setuid (void);
gmain: Handle case where source id overflows 0 is not a valid source id, but for long-lived programs that rapidly create/destroy sources, it's possible for the source id to overflow. We should handle this, because the documentation implies we will. https://bugzilla.gnome.org/show_bug.cgi?id=687098
2012-11-08 15:12:25 +01:00
GMainContext * g_main_context_new_with_next_id (guint next_id);
glib worker: move to glib-private framework Remove the private glib_get_worker_context() symbol and move it over to using the glib-private stuff like GWakeup is doing. https://bugzilla.gnome.org/show_bug.cgi?id=657992
2011-09-09 20:30:25 +02:00
win32: prototype _glib_get_dll_directory() and _glib_get_locale_dir() Rather than using "extern" declarations of these win32 functions everywhere they're needed, just prototype them in glib-private.h. (Which also fixes the fact that they weren't prototyped in the files where they're defined.) https://bugzilla.gnome.org/show_bug.cgi?id=688109
2012-11-10 16:51:18 +01:00
#ifdef G_OS_WIN32
gchar *_glib_get_dll_directory (void);
win32: visibility fixups Add/remove visibility macros according to if symbols were previously part of our public win32 API.
2013-01-13 21:34:27 +01:00
GLIB_AVAILABLE_IN_ALL
win32: prototype _glib_get_dll_directory() and _glib_get_locale_dir() Rather than using "extern" declarations of these win32 functions everywhere they're needed, just prototype them in glib-private.h. (Which also fixes the fact that they weren't prototyped in the files where they're defined.) https://bugzilla.gnome.org/show_bug.cgi?id=688109
2012-11-10 16:51:18 +01:00
gchar *_glib_get_locale_dir (void);
#endif
GDir: add some glib-private APIs Add a simple UNIX-only API that is used to create a GDir object from a DIR* that is aquired using opendir() or fdopendir(). This makes it possible to use GDir with openat(), which in turn will allow use of GDir in the existing GLocalFile implementation of g_file_measure_disk_usage(), avoiding the current MSVC compatibility problems there. Also add an API similar to g_dir_open(), but without the GError handling (since we want to create a better error message from inside of glocalfile.c). Thanks to Chun-wei Fan <fanchunwei@src.gnome.org> for portions of this patch and for reviews. https://bugzilla.gnome.org/show_bug.cgi?id=707787
2013-09-12 11:00:29 +02:00
GDir * g_dir_open_with_errno (const gchar *path, guint flags);
GDir * g_dir_new_from_dirp (gpointer dirp);
Add glib__private__() API to share between glib,gio; port GWakeup to it Historically we've added random symbols to the public API with warnings that they're private; examples are: glib_gettext(), glib_pgettext() g_thread_functions_for_glib_use, g_thread_use_default_impl, etc. And we almost added "GWakeup" to public API just to share between glib and gio. This new glib__private__() API exports a hidden vtable, and adds a macro GLIB_PRIVATE_CALL() that makes it generally convenient to use. This adds an extremely tiny cost for the double indirection; but it has the benefit that we don't need to either: 1) compile the code into both glib and gio (like GWakeup), with the inefficiency that implies. 2) Export a "do not use this" symbol; the serious problem with this is that someone CAN use it pretty easily. Particularly if we document it. It's far, far harder to peek into a structure without a public header file. https://bugzilla.gnome.org/show_bug.cgi?id=657992
2011-09-01 20:32:11 +02:00
#define GLIB_PRIVATE_CALL(symbol) (glib__private__()->symbol)
typedef struct {
/* See gwakeup.c */
glib worker: move to glib-private framework Remove the private glib_get_worker_context() symbol and move it over to using the glib-private stuff like GWakeup is doing. https://bugzilla.gnome.org/show_bug.cgi?id=657992
2011-09-09 20:30:25 +02:00
GWakeup * (* g_wakeup_new) (void);
void (* g_wakeup_free) (GWakeup *wakeup);
void (* g_wakeup_get_pollfd) (GWakeup *wakeup,
GPollFD *poll_fd);
void (* g_wakeup_signal) (GWakeup *wakeup);
void (* g_wakeup_acknowledge) (GWakeup *wakeup);
/* See gmain.c */
GMainContext * (* g_get_worker_context) (void);
CVE-2012-3524: Hardening for being run in a setuid environment Some programs attempt to use libglib (or even libgio) when setuid. For a long time, GTK+ simply aborted if launched in this configuration, but we never had a real policy for GLib. I'm not sure whether we should advertise such support. However, given that there are real-world programs that do this currently, we can make them safer with not too much effort. Better to fix a problem caused by an interaction between two components in *both* places if possible. This patch adds a private function g_check_setuid() which is used to first ensure we don't run an external dbus-launch binary if DBUS_SESSION_BUS_ADDRESS isn't set. Second, we also ensure the local VFS is used in this case. The gdaemonvfs extension point will end up talking to the session bus which is typically undesirable in a setuid context. Implementing g_check_setuid() is interesting - whether or not we're running in a privilege-escalated path is operating system specific. Note that GTK+'s code to check euid versus uid worked historically on Unix, more modern systems have filesystem capabilities and SELinux domain transitions, neither of which are captured by the uid comparison. On Linux/glibc, the way this works is that the kernel sets an AT_SECURE flag in the ELF auxiliary vector, and glibc looks for it on startup. If found, then glibc sets a public-but-undocumented __libc_enable_secure variable which we can use. Unfortunately, while it *previously* worked to check this variable, a combination of newer binutils and RPM break it: http://www.openwall.com/lists/owl-dev/2012/08/14/1 So for now on Linux/glibc, we fall back to the historical Unix version until we get glibc fixed. On some BSD variants, there is a issetugid() function. On other Unix variants, we fall back to what GTK+ has been doing. Reported-By: Sebastian Krahmer <krahmer@suse.de> Signed-off-by: Colin Walters <walters@verbum.org>
2012-08-22 20:26:11 +02:00
gboolean (* g_check_setuid) (void);
gmain: Handle case where source id overflows 0 is not a valid source id, but for long-lived programs that rapidly create/destroy sources, it's possible for the source id to overflow. We should handle this, because the documentation implies we will. https://bugzilla.gnome.org/show_bug.cgi?id=687098
2012-11-08 15:12:25 +01:00
GMainContext * (* g_main_context_new_with_next_id) (guint next_id);
GDir: add some glib-private APIs Add a simple UNIX-only API that is used to create a GDir object from a DIR* that is aquired using opendir() or fdopendir(). This makes it possible to use GDir with openat(), which in turn will allow use of GDir in the existing GLocalFile implementation of g_file_measure_disk_usage(), avoiding the current MSVC compatibility problems there. Also add an API similar to g_dir_open(), but without the GError handling (since we want to create a better error message from inside of glocalfile.c). Thanks to Chun-wei Fan <fanchunwei@src.gnome.org> for portions of this patch and for reviews. https://bugzilla.gnome.org/show_bug.cgi?id=707787
2013-09-12 11:00:29 +02:00
GDir * (* g_dir_open_with_errno) (const gchar *path,
guint flags);
GDir * (* g_dir_new_from_dirp) (gpointer dirp);
Export glib_init via GLIB_PRIVATE_CALL This will be used in the next commit to call glib_init from the gobject constructor, to ensure proper constructor ordering with non-GNU libc. https://bugzilla.gnome.org/show_bug.cgi?id=756139
2015-10-07 01:45:38 +02:00
/* See glib-init.c */
void (* glib_init) (void);
W32: Add a stat() implementation for private use This commit adds new W32-only functions to gstdio.c, and a new header file, gstdioprivate.h. These functions are: g_win32_stat_utf8() g_win32_lstat_utf8() g_win32_fstat() and they fill a private structure, GWin32PrivateStat, which has all the fields that normal stat has, as well as some extras. These functions are then used throughout glib and gio to get better data about the system. Specifically: * Full, 64-bit size, guaranteed (g_stat() is forced to use 32-bit st_size) * Full, 64-bit file identifier (st_ino is 0 when normal stat() is used, and still is) * W32 File attributes (which stat() doesn't report); in particular, this allows symlinks to be correctly identified * Full, 64-bit time, guaranteed (g_stat() uses 32-bit st_*time on 32-bit Windows) * Allocated file size (as a W32 replacement for the missing st_blocks) st_mode remains unchanged (thus, no S_ISLNK), so when these are given back to glib users (via g_stat(), for example, which is now implemented by calling g_win32_stat_utf8), this field does not contain anything unexpected. g_lstat() now calls g_win32_lstat_utf8(), which works on symlinks the way it's supposed to. Also adds the g_win32_readlink_utf8() function, which behaves like readlink() (including its inability to return 0-terminated strings and inability to say how large the output buffer should be; these limitations are purely for compatibility with existing glib code). Thus, symlink support should now be much better, although far from being complete. A new W32-only test in gio/tests/file.c highlights the following features: * allocated size * 64-bit time * unique file IDs https://bugzilla.gnome.org/show_bug.cgi?id=788180
2017-09-29 12:14:41 +02:00
/* See gstdio.c */
#ifdef G_OS_WIN32
int (* g_win32_stat_utf8) (const gchar *filename,
GWin32PrivateStat *buf);
int (* g_win32_lstat_utf8) (const gchar *filename,
GWin32PrivateStat *buf);
int (* g_win32_readlink_utf8) (const gchar *filename,
gchar *buf,
gsize buf_size);
int (* g_win32_fstat) (int fd,
GWin32PrivateStat *buf);
#endif
gmain: Handle case where source id overflows 0 is not a valid source id, but for long-lived programs that rapidly create/destroy sources, it's possible for the source id to overflow. We should handle this, because the documentation implies we will. https://bugzilla.gnome.org/show_bug.cgi?id=687098
2012-11-08 15:12:25 +01:00
/* Add other private functions here, initialize them in glib-private.c */
Add glib__private__() API to share between glib,gio; port GWakeup to it Historically we've added random symbols to the public API with warnings that they're private; examples are: glib_gettext(), glib_pgettext() g_thread_functions_for_glib_use, g_thread_use_default_impl, etc. And we almost added "GWakeup" to public API just to share between glib and gio. This new glib__private__() API exports a hidden vtable, and adds a macro GLIB_PRIVATE_CALL() that makes it generally convenient to use. This adds an extremely tiny cost for the double indirection; but it has the benefit that we don't need to either: 1) compile the code into both glib and gio (like GWakeup), with the inefficiency that implies. 2) Export a "do not use this" symbol; the serious problem with this is that someone CAN use it pretty easily. Particularly if we document it. It's far, far harder to peek into a structure without a public header file. https://bugzilla.gnome.org/show_bug.cgi?id=657992
2011-09-01 20:32:11 +02:00
} GLibPrivateVTable;
various: add GLIB_AVAILABLE_IN_ALL everywhere else Add the GLIB_AVAILABLE_IN_ALL annotation to all old functions (that haven't already been annotated with the GLIB_AVAILABLE_IN_* macros or a deprecation macro). If we discover in the future that we cannot use only one macro on Windows, it will be an easy sed patch to fix that. https://bugzilla.gnome.org/show_bug.cgi?id=688681
2012-12-06 20:04:59 +01:00
GLIB_AVAILABLE_IN_ALL
Add glib__private__() API to share between glib,gio; port GWakeup to it Historically we've added random symbols to the public API with warnings that they're private; examples are: glib_gettext(), glib_pgettext() g_thread_functions_for_glib_use, g_thread_use_default_impl, etc. And we almost added "GWakeup" to public API just to share between glib and gio. This new glib__private__() API exports a hidden vtable, and adds a macro GLIB_PRIVATE_CALL() that makes it generally convenient to use. This adds an extremely tiny cost for the double indirection; but it has the benefit that we don't need to either: 1) compile the code into both glib and gio (like GWakeup), with the inefficiency that implies. 2) Export a "do not use this" symbol; the serious problem with this is that someone CAN use it pretty easily. Particularly if we document it. It's far, far harder to peek into a structure without a public header file. https://bugzilla.gnome.org/show_bug.cgi?id=657992
2011-09-01 20:32:11 +02:00
GLibPrivateVTable *glib__private__ (void);
Trivial: fix a guard comment The conventional comment for the #endif at the bottom of the header was not matching the #ifdef at the top in glib-private.h. Fix that.
2014-05-21 13:40:09 +02:00
#endif /* __GLIB_PRIVATE_H__ */
Reference in New Issue Copy Permalink