mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2026-10-24 00:49:00 +03:00
016829559e
g_type_ensure has a large comment saying _get_type shouldn't be marked with G_GNUC_CONST because it has side-effects on the first run, but it's OK if you consistently call g_type_ensure first. Unfortunately, this isn't accurate. GCC trunk (observed at r17-1725-ge259a182e1f100) now analyses points-to information more effectively and propagates its findings, so it sees the function modifies some global state, concludes that can't be possible (because of the const attribute), and deletes the stores. pure unfortunately is unsuitable for *_get_type too as it has a side-effect (writes to global memory). Mesa had a similar issue which I fixed recently [0]. glib and glibmm likely want the (not-yet-implemented) 'idempotent' attribute instead [1]. In fact, this exact problem is what motivated that request! :) ebassi mentions an alternative to the current setup as well, using atomics [2]. This problem has gone back many years but the compiler has finally fully outsmarted us here, so give in. [0] https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/42361 [1] https://gcc.gnu.org/PR32911 [2] https://gitlab.gnome.org/GNOME/glib/-/merge_requests/4249#note_2583110 Fixes: https://gitlab.gnome.org/GNOME/glib/-/work_items/3984 Signed-off-by: Sam James <sam@gentoo.org>
264 lines
15 KiB
C
264 lines
15 KiB
C
/*
|
|
* Copyright © 2010 Codethink Limited
|
|
*
|
|
* 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/>.
|
|
*
|
|
* Authors: Ryan Lortie <desrt@desrt.ca>
|
|
*/
|
|
|
|
#ifndef __G_APPLICATION_H__
|
|
#define __G_APPLICATION_H__
|
|
|
|
#if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
|
|
#error "Only <gio/gio.h> can be included directly."
|
|
#endif
|
|
|
|
#include <gio/giotypes.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define G_TYPE_APPLICATION (g_application_get_type ())
|
|
#define G_APPLICATION(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \
|
|
G_TYPE_APPLICATION, GApplication))
|
|
#define G_APPLICATION_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), \
|
|
G_TYPE_APPLICATION, GApplicationClass))
|
|
#define G_IS_APPLICATION(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), G_TYPE_APPLICATION))
|
|
#define G_IS_APPLICATION_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_APPLICATION))
|
|
#define G_APPLICATION_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_CLASS ((inst), \
|
|
G_TYPE_APPLICATION, GApplicationClass))
|
|
|
|
typedef struct _GApplicationPrivate GApplicationPrivate;
|
|
typedef struct _GApplicationClass GApplicationClass;
|
|
|
|
struct _GApplication
|
|
{
|
|
/*< private >*/
|
|
GObject parent_instance;
|
|
|
|
GApplicationPrivate *priv;
|
|
};
|
|
|
|
struct _GApplicationClass
|
|
{
|
|
/*< private >*/
|
|
GObjectClass parent_class;
|
|
|
|
/*< public >*/
|
|
/* signals */
|
|
void (* startup) (GApplication *application);
|
|
|
|
void (* activate) (GApplication *application);
|
|
|
|
void (* open) (GApplication *application,
|
|
GFile **files,
|
|
gint n_files,
|
|
const gchar *hint);
|
|
|
|
int (* command_line) (GApplication *application,
|
|
GApplicationCommandLine *command_line);
|
|
|
|
/* vfuncs */
|
|
|
|
/**
|
|
* GApplicationClass::local_command_line:
|
|
* @application: a #GApplication
|
|
* @arguments: (inout) (array zero-terminated=1): array of command line arguments
|
|
* @exit_status: (out): exit status to fill after processing the command line.
|
|
*
|
|
* This virtual function is always invoked in the local instance. It
|
|
* gets passed a pointer to a %NULL-terminated copy of @argv and is
|
|
* expected to remove arguments that it handled (shifting up remaining
|
|
* arguments).
|
|
*
|
|
* The last argument to local_command_line() is a pointer to the @status
|
|
* variable which can used to set the exit status that is returned from
|
|
* g_application_run().
|
|
*
|
|
* See g_application_run() for more details on #GApplication startup.
|
|
*
|
|
* Returns: %TRUE if the commandline has been completely handled
|
|
*/
|
|
gboolean (* local_command_line) (GApplication *application,
|
|
gchar ***arguments,
|
|
int *exit_status);
|
|
|
|
/* @platform_data comes from an external process and is untrusted. All value types
|
|
* must be validated before being used. */
|
|
void (* before_emit) (GApplication *application,
|
|
GVariant *platform_data);
|
|
/* Same as for @before_emit. */
|
|
void (* after_emit) (GApplication *application,
|
|
GVariant *platform_data);
|
|
void (* add_platform_data) (GApplication *application,
|
|
GVariantBuilder *builder);
|
|
void (* quit_mainloop) (GApplication *application);
|
|
void (* run_mainloop) (GApplication *application);
|
|
void (* shutdown) (GApplication *application);
|
|
|
|
gboolean (* dbus_register) (GApplication *application,
|
|
GDBusConnection *connection,
|
|
const gchar *object_path,
|
|
GError **error);
|
|
void (* dbus_unregister) (GApplication *application,
|
|
GDBusConnection *connection,
|
|
const gchar *object_path);
|
|
gint (* handle_local_options)(GApplication *application,
|
|
GVariantDict *options);
|
|
gboolean (* name_lost) (GApplication *application);
|
|
|
|
/*< private >*/
|
|
gpointer padding[7];
|
|
};
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
GType g_application_get_type (void);
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
gboolean g_application_id_is_valid (const gchar *application_id);
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
GApplication * g_application_new (const gchar *application_id,
|
|
GApplicationFlags flags);
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
const gchar * g_application_get_application_id (GApplication *application);
|
|
GIO_AVAILABLE_IN_ALL
|
|
void g_application_set_application_id (GApplication *application,
|
|
const gchar *application_id);
|
|
|
|
GIO_AVAILABLE_IN_2_80
|
|
const gchar * g_application_get_version (GApplication *application);
|
|
GIO_AVAILABLE_IN_2_80
|
|
void g_application_set_version (GApplication *application,
|
|
const gchar *version);
|
|
|
|
GIO_AVAILABLE_IN_2_34
|
|
GDBusConnection * g_application_get_dbus_connection (GApplication *application);
|
|
GIO_AVAILABLE_IN_2_34
|
|
const gchar * g_application_get_dbus_object_path (GApplication *application);
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
guint g_application_get_inactivity_timeout (GApplication *application);
|
|
GIO_AVAILABLE_IN_ALL
|
|
void g_application_set_inactivity_timeout (GApplication *application,
|
|
guint inactivity_timeout);
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
GApplicationFlags g_application_get_flags (GApplication *application);
|
|
GIO_AVAILABLE_IN_ALL
|
|
void g_application_set_flags (GApplication *application,
|
|
GApplicationFlags flags);
|
|
|
|
GIO_AVAILABLE_IN_2_42
|
|
const gchar * g_application_get_resource_base_path (GApplication *application);
|
|
GIO_AVAILABLE_IN_2_42
|
|
void g_application_set_resource_base_path (GApplication *application,
|
|
const gchar *resource_path);
|
|
|
|
GIO_DEPRECATED
|
|
void g_application_set_action_group (GApplication *application,
|
|
GActionGroup *action_group);
|
|
|
|
GIO_AVAILABLE_IN_2_40
|
|
void g_application_add_main_option_entries (GApplication *application,
|
|
const GOptionEntry *entries);
|
|
|
|
GIO_AVAILABLE_IN_2_42
|
|
void g_application_add_main_option (GApplication *application,
|
|
const char *long_name,
|
|
char short_name,
|
|
GOptionFlags flags,
|
|
GOptionArg arg,
|
|
const char *description,
|
|
const char *arg_description);
|
|
GIO_AVAILABLE_IN_2_40
|
|
void g_application_add_option_group (GApplication *application,
|
|
GOptionGroup *group);
|
|
GIO_AVAILABLE_IN_2_56
|
|
void g_application_set_option_context_parameter_string (GApplication *application,
|
|
const gchar *parameter_string);
|
|
GIO_AVAILABLE_IN_2_56
|
|
void g_application_set_option_context_summary (GApplication *application,
|
|
const gchar *summary);
|
|
GIO_AVAILABLE_IN_2_56
|
|
void g_application_set_option_context_description (GApplication *application,
|
|
const gchar *description);
|
|
GIO_AVAILABLE_IN_ALL
|
|
gboolean g_application_get_is_registered (GApplication *application);
|
|
GIO_AVAILABLE_IN_ALL
|
|
gboolean g_application_get_is_remote (GApplication *application);
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
gboolean g_application_register (GApplication *application,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
void g_application_hold (GApplication *application);
|
|
GIO_AVAILABLE_IN_ALL
|
|
void g_application_release (GApplication *application);
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
void g_application_activate (GApplication *application);
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
void g_application_open (GApplication *application,
|
|
GFile **files,
|
|
gint n_files,
|
|
const gchar *hint);
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
int g_application_run (GApplication *application,
|
|
int argc,
|
|
char **argv);
|
|
|
|
GIO_AVAILABLE_IN_2_32
|
|
void g_application_quit (GApplication *application);
|
|
|
|
GIO_AVAILABLE_IN_2_32
|
|
GApplication * g_application_get_default (void);
|
|
GIO_AVAILABLE_IN_2_32
|
|
void g_application_set_default (GApplication *application);
|
|
|
|
GIO_AVAILABLE_IN_2_38
|
|
void g_application_mark_busy (GApplication *application);
|
|
GIO_AVAILABLE_IN_2_38
|
|
void g_application_unmark_busy (GApplication *application);
|
|
GIO_AVAILABLE_IN_2_44
|
|
gboolean g_application_get_is_busy (GApplication *application);
|
|
|
|
GIO_AVAILABLE_IN_2_40
|
|
void g_application_send_notification (GApplication *application,
|
|
const gchar *id,
|
|
GNotification *notification);
|
|
GIO_AVAILABLE_IN_2_40
|
|
void g_application_withdraw_notification (GApplication *application,
|
|
const gchar *id);
|
|
|
|
GIO_AVAILABLE_IN_2_44
|
|
void g_application_bind_busy_property (GApplication *application,
|
|
gpointer object,
|
|
const gchar *property);
|
|
|
|
GIO_AVAILABLE_IN_2_44
|
|
void g_application_unbind_busy_property (GApplication *application,
|
|
gpointer object,
|
|
const gchar *property);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __G_APPLICATION_H__ */
|