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>
279 lines
15 KiB
C
279 lines
15 KiB
C
/* GIO - GLib Input, Output and Streaming Library
|
|
*
|
|
* Copyright (C) 2006-2008 Red Hat, Inc.
|
|
*
|
|
* 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/>.
|
|
*
|
|
* Author: Alexander Larsson <alexl@redhat.com>
|
|
* David Zeuthen <davidz@redhat.com>
|
|
*/
|
|
|
|
#ifndef __G_MOUNT_H__
|
|
#define __G_MOUNT_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_MOUNT (g_mount_get_type ())
|
|
#define G_MOUNT(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), G_TYPE_MOUNT, GMount))
|
|
#define G_IS_MOUNT(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), G_TYPE_MOUNT))
|
|
#define G_MOUNT_GET_IFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), G_TYPE_MOUNT, GMountIface))
|
|
|
|
typedef struct _GMountIface GMountIface;
|
|
|
|
/**
|
|
* GMountIface:
|
|
* @g_iface: The parent interface.
|
|
* @changed: Changed signal that is emitted when the mount's state has changed.
|
|
* @unmounted: The unmounted signal that is emitted when the #GMount have been unmounted. If the recipient is holding references to the object they should release them so the object can be finalized.
|
|
* @pre_unmount: The ::pre-unmount signal that is emitted when the #GMount will soon be emitted. If the recipient is somehow holding the mount open by keeping an open file on it it should close the file.
|
|
* @get_root: Gets a #GFile to the root directory of the #GMount.
|
|
* @get_name: Gets a string containing the name of the #GMount.
|
|
* @get_icon: Gets a #GIcon for the #GMount.
|
|
* @get_uuid: Gets the UUID for the #GMount. The reference is typically based on the file system UUID for the mount in question and should be considered an opaque string. Returns %NULL if there is no UUID available.
|
|
* @get_volume: Gets a #GVolume the mount is located on. Returns %NULL if the #GMount is not associated with a #GVolume.
|
|
* @get_drive: Gets a #GDrive the volume of the mount is located on. Returns %NULL if the #GMount is not associated with a #GDrive or a #GVolume. This is convenience method for getting the #GVolume and using that to get the #GDrive.
|
|
* @can_unmount: Checks if a #GMount can be unmounted.
|
|
* @can_eject: Checks if a #GMount can be ejected.
|
|
* @unmount: Starts unmounting a #GMount.
|
|
* @unmount_finish: Finishes an unmounting operation.
|
|
* @eject: Starts ejecting a #GMount.
|
|
* @eject_finish: Finishes an eject operation.
|
|
* @remount: Starts remounting a #GMount.
|
|
* @remount_finish: Finishes a remounting operation.
|
|
* @guess_content_type: Starts guessing the type of the content of a #GMount.
|
|
* See g_mount_guess_content_type() for more information on content
|
|
* type guessing. This operation was added in 2.18.
|
|
* @guess_content_type_finish: Finishes a content type guessing operation. Added in 2.18.
|
|
* @guess_content_type_sync: Synchronous variant of @guess_content_type. Added in 2.18
|
|
* @unmount_with_operation: Starts unmounting a #GMount using a #GMountOperation. Since 2.22.
|
|
* @unmount_with_operation_finish: Finishes an unmounting operation using a #GMountOperation. Since 2.22.
|
|
* @eject_with_operation: Starts ejecting a #GMount using a #GMountOperation. Since 2.22.
|
|
* @eject_with_operation_finish: Finishes an eject operation using a #GMountOperation. Since 2.22.
|
|
* @get_default_location: Gets a #GFile indication a start location that can be use as the entry point for this mount. Since 2.24.
|
|
* @get_sort_key: Gets a key used for sorting #GMount instance or %NULL if no such key exists. Since 2.32.
|
|
* @get_symbolic_icon: Gets a symbolic #GIcon for the #GMount. Since 2.34.
|
|
*
|
|
* Interface for implementing operations for mounts.
|
|
**/
|
|
struct _GMountIface
|
|
{
|
|
GTypeInterface g_iface;
|
|
|
|
/* signals */
|
|
|
|
void (* changed) (GMount *mount);
|
|
void (* unmounted) (GMount *mount);
|
|
|
|
/* Virtual Table */
|
|
|
|
GFile * (* get_root) (GMount *mount);
|
|
char * (* get_name) (GMount *mount);
|
|
GIcon * (* get_icon) (GMount *mount);
|
|
char * (* get_uuid) (GMount *mount);
|
|
GVolume * (* get_volume) (GMount *mount);
|
|
GDrive * (* get_drive) (GMount *mount);
|
|
gboolean (* can_unmount) (GMount *mount);
|
|
gboolean (* can_eject) (GMount *mount);
|
|
|
|
void (* unmount) (GMount *mount,
|
|
GMountUnmountFlags flags,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
gboolean (* unmount_finish) (GMount *mount,
|
|
GAsyncResult *result,
|
|
GError **error);
|
|
|
|
void (* eject) (GMount *mount,
|
|
GMountUnmountFlags flags,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
gboolean (* eject_finish) (GMount *mount,
|
|
GAsyncResult *result,
|
|
GError **error);
|
|
|
|
void (* remount) (GMount *mount,
|
|
GMountMountFlags flags,
|
|
GMountOperation *mount_operation,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
gboolean (* remount_finish) (GMount *mount,
|
|
GAsyncResult *result,
|
|
GError **error);
|
|
|
|
void (* guess_content_type) (GMount *mount,
|
|
gboolean force_rescan,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
gchar ** (* guess_content_type_finish) (GMount *mount,
|
|
GAsyncResult *result,
|
|
GError **error);
|
|
gchar ** (* guess_content_type_sync) (GMount *mount,
|
|
gboolean force_rescan,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
/* Signal, not VFunc */
|
|
void (* pre_unmount) (GMount *mount);
|
|
|
|
void (* unmount_with_operation) (GMount *mount,
|
|
GMountUnmountFlags flags,
|
|
GMountOperation *mount_operation,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
gboolean (* unmount_with_operation_finish) (GMount *mount,
|
|
GAsyncResult *result,
|
|
GError **error);
|
|
|
|
void (* eject_with_operation) (GMount *mount,
|
|
GMountUnmountFlags flags,
|
|
GMountOperation *mount_operation,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
gboolean (* eject_with_operation_finish) (GMount *mount,
|
|
GAsyncResult *result,
|
|
GError **error);
|
|
GFile * (* get_default_location) (GMount *mount);
|
|
|
|
const gchar * (* get_sort_key) (GMount *mount);
|
|
GIcon * (* get_symbolic_icon) (GMount *mount);
|
|
};
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
GType g_mount_get_type (void);
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
GFile * g_mount_get_root (GMount *mount);
|
|
GIO_AVAILABLE_IN_ALL
|
|
GFile * g_mount_get_default_location (GMount *mount);
|
|
GIO_AVAILABLE_IN_ALL
|
|
char * g_mount_get_name (GMount *mount);
|
|
GIO_AVAILABLE_IN_ALL
|
|
GIcon * g_mount_get_icon (GMount *mount);
|
|
GIO_AVAILABLE_IN_ALL
|
|
GIcon * g_mount_get_symbolic_icon (GMount *mount);
|
|
GIO_AVAILABLE_IN_ALL
|
|
char * g_mount_get_uuid (GMount *mount);
|
|
GIO_AVAILABLE_IN_ALL
|
|
GVolume * g_mount_get_volume (GMount *mount);
|
|
GIO_AVAILABLE_IN_ALL
|
|
GDrive * g_mount_get_drive (GMount *mount);
|
|
GIO_AVAILABLE_IN_ALL
|
|
gboolean g_mount_can_unmount (GMount *mount);
|
|
GIO_AVAILABLE_IN_ALL
|
|
gboolean g_mount_can_eject (GMount *mount);
|
|
|
|
GIO_DEPRECATED_FOR(g_mount_unmount_with_operation)
|
|
void g_mount_unmount (GMount *mount,
|
|
GMountUnmountFlags flags,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
|
|
GIO_DEPRECATED_FOR(g_mount_unmount_with_operation_finish)
|
|
gboolean g_mount_unmount_finish (GMount *mount,
|
|
GAsyncResult *result,
|
|
GError **error);
|
|
|
|
GIO_DEPRECATED_FOR(g_mount_eject_with_operation)
|
|
void g_mount_eject (GMount *mount,
|
|
GMountUnmountFlags flags,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
|
|
GIO_DEPRECATED_FOR(g_mount_eject_with_operation_finish)
|
|
gboolean g_mount_eject_finish (GMount *mount,
|
|
GAsyncResult *result,
|
|
GError **error);
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
void g_mount_remount (GMount *mount,
|
|
GMountMountFlags flags,
|
|
GMountOperation *mount_operation,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
GIO_AVAILABLE_IN_ALL
|
|
gboolean g_mount_remount_finish (GMount *mount,
|
|
GAsyncResult *result,
|
|
GError **error);
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
void g_mount_guess_content_type (GMount *mount,
|
|
gboolean force_rescan,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
GIO_AVAILABLE_IN_ALL
|
|
gchar ** g_mount_guess_content_type_finish (GMount *mount,
|
|
GAsyncResult *result,
|
|
GError **error);
|
|
GIO_AVAILABLE_IN_ALL
|
|
gchar ** g_mount_guess_content_type_sync (GMount *mount,
|
|
gboolean force_rescan,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
gboolean g_mount_is_shadowed (GMount *mount);
|
|
GIO_AVAILABLE_IN_ALL
|
|
void g_mount_shadow (GMount *mount);
|
|
GIO_AVAILABLE_IN_ALL
|
|
void g_mount_unshadow (GMount *mount);
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
void g_mount_unmount_with_operation (GMount *mount,
|
|
GMountUnmountFlags flags,
|
|
GMountOperation *mount_operation,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
GIO_AVAILABLE_IN_ALL
|
|
gboolean g_mount_unmount_with_operation_finish (GMount *mount,
|
|
GAsyncResult *result,
|
|
GError **error);
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
void g_mount_eject_with_operation (GMount *mount,
|
|
GMountUnmountFlags flags,
|
|
GMountOperation *mount_operation,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data);
|
|
GIO_AVAILABLE_IN_ALL
|
|
gboolean g_mount_eject_with_operation_finish (GMount *mount,
|
|
GAsyncResult *result,
|
|
GError **error);
|
|
|
|
GIO_AVAILABLE_IN_ALL
|
|
const gchar *g_mount_get_sort_key (GMount *mount);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __G_MOUNT_H__ */
|