/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */ /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2006-2007 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 . * * Author: Alexander Larsson */ #include "config.h" #ifdef __linux__ #include #include /* See linux.git/fs/btrfs/ioctl.h */ #define BTRFS_IOCTL_MAGIC 0x94 #define BTRFS_IOC_CLONE _IOW(BTRFS_IOCTL_MAGIC, 9, int) #endif #ifdef HAVE_SPLICE #include #include #include #include /* * We duplicate the following Linux kernel header defines here so we can still * run at full speed on modern kernels in cases where an old toolchain was used * to build GLib. This is often done deliberately to allow shipping binaries * that need to run on a wide range of systems. */ #ifndef F_SETPIPE_SZ #define F_SETPIPE_SZ 1031 #endif #ifndef F_GETPIPE_SZ #define F_GETPIPE_SZ 1032 #endif #endif #include #include #include "gfile.h" #include "glib/gstdio.h" #ifdef G_OS_UNIX #include "glib-unix.h" #endif #include "gvfs.h" #include "gtask.h" #include "gfileattribute-priv.h" #include "gfiledescriptorbased.h" #include "gpollfilemonitor.h" #include "gappinfo.h" #include "gfileinputstream.h" #include "gfileoutputstream.h" #include "glocalfileoutputstream.h" #include "glocalfileiostream.h" #include "glocalfile.h" #include "gcancellable.h" #include "gasyncresult.h" #include "gioerror.h" #include "glibintl.h" /* Linux defines loff_t as a way to simplify the offset types for calls like * splice() and copy_file_range(). BSD has copy_file_range() but doesn’t define * loff_t. Abstract that. */ #ifndef HAVE_LOFF_T typedef off_t loff_t; #endif /** * GFile: * * `GFile` is a high level abstraction for manipulating files on a * virtual file system. `GFile`s are lightweight, immutable objects * that do no I/O upon creation. It is necessary to understand that * `GFile` objects do not represent files, merely an identifier for a * file. All file content I/O is implemented as streaming operations * (see [class@Gio.InputStream] and [class@Gio.OutputStream]). * * To construct a `GFile`, you can use: * * - [func@Gio.File.new_for_path] if you have a path. * - [func@Gio.File.new_for_uri] if you have a URI. * - [func@Gio.File.new_for_commandline_arg] or * [func@Gio.File.new_for_commandline_arg_and_cwd] for a command line * argument. * - [func@Gio.File.new_tmp] to create a temporary file from a template. * - [func@Gio.File.new_tmp_async] to asynchronously create a temporary file. * - [func@Gio.File.new_tmp_dir_async] to asynchronously create a temporary * directory. * - [func@Gio.File.parse_name] from a UTF-8 string gotten from * [method@Gio.File.get_parse_name]. * - [func@Gio.File.new_build_filename] or [func@Gio.File.new_build_filenamev] * to create a file from path elements. * * One way to think of a `GFile` is as an abstraction of a pathname. For * normal files the system pathname is what is stored internally, but as * `GFile`s are extensible it could also be something else that corresponds * to a pathname in a userspace implementation of a filesystem. * * `GFile`s make up hierarchies of directories and files that correspond to * the files on a filesystem. You can move through the file system with * `GFile` using [method@Gio.File.get_parent] to get an identifier for the * parent directory, [method@Gio.File.get_child] to get a child within a * directory, and [method@Gio.File.resolve_relative_path] to resolve a relative * path between two `GFile`s. There can be multiple hierarchies, so you may not * end up at the same root if you repeatedly call [method@Gio.File.get_parent] * on two different files. * * All `GFile`s have a basename (get with [method@Gio.File.get_basename]). These * names are byte strings that are used to identify the file on the filesystem * (relative to its parent directory) and there is no guarantees that they * have any particular charset encoding or even make any sense at all. If * you want to use filenames in a user interface you should use the display * name that you can get by requesting the * `G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME` attribute with * [method@Gio.File.query_info]. This is guaranteed to be in UTF-8 and can be * used in a user interface. But always store the real basename or the `GFile` * to use to actually access the file, because there is no way to go from a * display name to the actual name. * * Using `GFile` as an identifier has the same weaknesses as using a path * in that there may be multiple aliases for the same file. For instance, * hard or soft links may cause two different `GFile`s to refer to the same * file. Other possible causes for aliases are: case insensitive filesystems, * short and long names on FAT/NTFS, or bind mounts in Linux. If you want to * check if two `GFile`s point to the same file you can query for the * `G_FILE_ATTRIBUTE_ID_FILE` attribute. Note that `GFile` does some trivial * canonicalization of pathnames passed in, so that trivial differences in * the path string used at creation (duplicated slashes, slash at end of * path, `.` or `..` path segments, etc) does not create different `GFile`s. * * Many `GFile` operations have both synchronous and asynchronous versions * to suit your application. Asynchronous versions of synchronous functions * simply have `_async()` appended to their function names. The asynchronous * I/O functions call a [callback@Gio.AsyncReadyCallback] which is then used to * finalize the operation, producing a [iface@Gio.AsyncResult] which is then * passed to the function’s matching `_finish()` operation. * * It is highly recommended to use asynchronous calls when running within a * shared main loop, such as in the main thread of an application. This avoids * I/O operations blocking other sources on the main loop from being dispatched. * Synchronous I/O operations should be performed from worker threads. See the * [introduction to asynchronous programming section](overview.html#asynchronous-programming) * for more. * * Some `GFile` operations almost always take a noticeable amount of time, and * so do not have synchronous analogs. Notable cases include: * * - [method@Gio.File.mount_mountable] to mount a mountable file. * - [method@Gio.File.unmount_mountable_with_operation] to unmount a mountable * file. * - [method@Gio.File.eject_mountable_with_operation] to eject a mountable file. * * ## Entity Tags * * One notable feature of `GFile`s are entity tags, or ‘etags’ for * short. Entity tags are somewhat like a more abstract version of the * traditional mtime, and can be used to quickly determine if the file * has been modified from the version on the file system. See the * HTTP 1.1 * [specification](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html) * for HTTP `ETag` headers, which are a very similar concept. */ static void g_file_real_query_info_async (GFile *file, const char *attributes, GFileQueryInfoFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); static GFileInfo * g_file_real_query_info_finish (GFile *file, GAsyncResult *res, GError **error); static void g_file_real_query_filesystem_info_async (GFile *file, const char *attributes, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); static GFileInfo * g_file_real_query_filesystem_info_finish (GFile *file, GAsyncResult *res, GError **error); static void g_file_real_enumerate_children_async (GFile *file, const char *attributes, GFileQueryInfoFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); static GFileEnumerator * g_file_real_enumerate_children_finish (GFile *file, GAsyncResult *res, GError **error); static void g_file_real_read_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); static GFileInputStream * g_file_real_read_finish (GFile *file, GAsyncResult *res, GError **error); static void g_file_real_append_to_async (GFile *file, GFileCreateFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); static GFileOutputStream *g_file_real_append_to_finish (GFile *file, GAsyncResult *res, GError **error); static void g_file_real_create_async (GFile *file, GFileCreateFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); static GFileOutputStream *g_file_real_create_finish (GFile *file, GAsyncResult *res, GError **error); static void g_file_real_replace_async (GFile *file, const char *etag, gboolean make_backup, GFileCreateFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); static GFileOutputStream *g_file_real_replace_finish (GFile *file, GAsyncResult *res, GError **error); static void g_file_real_delete_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); static gboolean g_file_real_delete_finish (GFile *file, GAsyncResult *res, GError **error); static void g_file_real_trash_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); static gboolean g_file_real_trash_finish (GFile *file, GAsyncResult *res, GError **error); static void g_file_real_move_async (GFile *source, GFile *destination, GFileCopyFlags flags, int io_priority, GCancellable *cancellable, GFileProgressCallback progress_callback, gpointer progress_callback_data, GAsyncReadyCallback callback, gpointer user_data); static gboolean g_file_real_move_finish (GFile *file, GAsyncResult *result, GError **error); static void g_file_real_make_directory_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); static gboolean g_file_real_make_directory_finish (GFile *file, GAsyncResult *res, GError **error); static void g_file_real_make_symbolic_link_async (GFile *file, const char *symlink_value, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); static gboolean g_file_real_make_symbolic_link_finish (GFile *file, GAsyncResult *result, GError **error); static void g_file_real_open_readwrite_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); static GFileIOStream * g_file_real_open_readwrite_finish (GFile *file, GAsyncResult *res, GError **error); static void g_file_real_create_readwrite_async (GFile *file, GFileCreateFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); static GFileIOStream * g_file_real_create_readwrite_finish (GFile *file, GAsyncResult *res, GError **error); static void g_file_real_replace_readwrite_async (GFile *file, const char *etag, gboolean make_backup, GFileCreateFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); static GFileIOStream * g_file_real_replace_readwrite_finish (GFile *file, GAsyncResult *res, GError **error); static gboolean g_file_real_set_attributes_from_info (GFile *file, GFileInfo *info, GFileQueryInfoFlags flags, GCancellable *cancellable, GError **error); static void g_file_real_set_display_name_async (GFile *file, const char *display_name, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); static GFile * g_file_real_set_display_name_finish (GFile *file, GAsyncResult *res, GError **error); static void g_file_real_set_attributes_async (GFile *file, GFileInfo *info, GFileQueryInfoFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); static gboolean g_file_real_set_attributes_finish (GFile *file, GAsyncResult *res, GFileInfo **info, GError **error); static void g_file_real_find_enclosing_mount_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); static GMount * g_file_real_find_enclosing_mount_finish (GFile *file, GAsyncResult *res, GError **error); static void g_file_real_copy_async (GFile *source, GFile *destination, GFileCopyFlags flags, int io_priority, GCancellable *cancellable, GFileProgressCallback progress_callback, gpointer progress_callback_data, GAsyncReadyCallback callback, gpointer user_data); static gboolean g_file_real_copy_finish (GFile *file, GAsyncResult *res, GError **error); static gboolean g_file_real_measure_disk_usage (GFile *file, GFileMeasureFlags flags, GCancellable *cancellable, GFileMeasureProgressCallback progress_callback, gpointer progress_data, guint64 *disk_usage, guint64 *num_dirs, guint64 *num_files, GError **error); static void g_file_real_measure_disk_usage_async (GFile *file, GFileMeasureFlags flags, gint io_priority, GCancellable *cancellable, GFileMeasureProgressCallback progress_callback, gpointer progress_data, GAsyncReadyCallback callback, gpointer user_data); static gboolean g_file_real_measure_disk_usage_finish (GFile *file, GAsyncResult *result, guint64 *disk_usage, guint64 *num_dirs, guint64 *num_files, GError **error); typedef GFileIface GFileInterface; G_DEFINE_INTERFACE (GFile, g_file, G_TYPE_OBJECT) static void g_file_default_init (GFileIface *iface) { iface->enumerate_children_async = g_file_real_enumerate_children_async; iface->enumerate_children_finish = g_file_real_enumerate_children_finish; iface->set_display_name_async = g_file_real_set_display_name_async; iface->set_display_name_finish = g_file_real_set_display_name_finish; iface->query_info_async = g_file_real_query_info_async; iface->query_info_finish = g_file_real_query_info_finish; iface->query_filesystem_info_async = g_file_real_query_filesystem_info_async; iface->query_filesystem_info_finish = g_file_real_query_filesystem_info_finish; iface->set_attributes_async = g_file_real_set_attributes_async; iface->set_attributes_finish = g_file_real_set_attributes_finish; iface->read_async = g_file_real_read_async; iface->read_finish = g_file_real_read_finish; iface->append_to_async = g_file_real_append_to_async; iface->append_to_finish = g_file_real_append_to_finish; iface->create_async = g_file_real_create_async; iface->create_finish = g_file_real_create_finish; iface->replace_async = g_file_real_replace_async; iface->replace_finish = g_file_real_replace_finish; iface->delete_file_async = g_file_real_delete_async; iface->delete_file_finish = g_file_real_delete_finish; iface->trash_async = g_file_real_trash_async; iface->trash_finish = g_file_real_trash_finish; iface->move_async = g_file_real_move_async; iface->move_finish = g_file_real_move_finish; iface->make_directory_async = g_file_real_make_directory_async; iface->make_directory_finish = g_file_real_make_directory_finish; iface->make_symbolic_link_async = g_file_real_make_symbolic_link_async; iface->make_symbolic_link_finish = g_file_real_make_symbolic_link_finish; iface->open_readwrite_async = g_file_real_open_readwrite_async; iface->open_readwrite_finish = g_file_real_open_readwrite_finish; iface->create_readwrite_async = g_file_real_create_readwrite_async; iface->create_readwrite_finish = g_file_real_create_readwrite_finish; iface->replace_readwrite_async = g_file_real_replace_readwrite_async; iface->replace_readwrite_finish = g_file_real_replace_readwrite_finish; iface->find_enclosing_mount_async = g_file_real_find_enclosing_mount_async; iface->find_enclosing_mount_finish = g_file_real_find_enclosing_mount_finish; iface->set_attributes_from_info = g_file_real_set_attributes_from_info; iface->copy_async = g_file_real_copy_async; iface->copy_finish = g_file_real_copy_finish; iface->measure_disk_usage = g_file_real_measure_disk_usage; iface->measure_disk_usage_async = g_file_real_measure_disk_usage_async; iface->measure_disk_usage_finish = g_file_real_measure_disk_usage_finish; } /** * g_file_is_native: * @file: input #GFile * * Checks to see if a file is native to the platform. * * A native file is one expressed in the platform-native filename format, * e.g. "C:\Windows" or "/usr/bin/". This does not mean the file is local, * as it might be on a locally mounted remote filesystem. * * On some systems non-native files may be available using the native * filesystem via a userspace filesystem (FUSE), in these cases this call * will return %FALSE, but g_file_get_path() will still return a native path. * * This call does no blocking I/O. * * Returns: %TRUE if @file is native */ gboolean g_file_is_native (GFile *file) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); iface = G_FILE_GET_IFACE (file); return (* iface->is_native) (file); } /** * g_file_has_uri_scheme: * @file: input #GFile * @uri_scheme: a string containing a URI scheme * * Checks to see if a #GFile has a given URI scheme. * * This call does no blocking I/O. * * Returns: %TRUE if #GFile's backend supports the * given URI scheme, %FALSE if URI scheme is %NULL, * not supported, or #GFile is invalid. */ gboolean g_file_has_uri_scheme (GFile *file, const char *uri_scheme) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (uri_scheme != NULL, FALSE); iface = G_FILE_GET_IFACE (file); return (* iface->has_uri_scheme) (file, uri_scheme); } /** * g_file_get_uri_scheme: * @file: input #GFile * * Gets the URI scheme for a #GFile. * RFC 3986 decodes the scheme as: * |[ * URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ] * ]| * Common schemes include "file", "http", "ftp", etc. * * The scheme can be different from the one used to construct the #GFile, * in that it might be replaced with one that is logically equivalent to the #GFile. * * This call does no blocking I/O. * * Returns: (nullable): a string containing the URI scheme for the given * #GFile or %NULL if the #GFile was constructed with an invalid URI. The * returned string should be freed with g_free() when no longer needed. */ char * g_file_get_uri_scheme (GFile *file) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); iface = G_FILE_GET_IFACE (file); return (* iface->get_uri_scheme) (file); } /** * g_file_get_basename: (virtual get_basename) * @file: input #GFile * * Gets the base name (the last component of the path) for a given #GFile. * * If called for the top level of a system (such as the filesystem root * or a uri like sftp://host/) it will return a single directory separator * (and on Windows, possibly a drive letter). * * The base name is a byte string (not UTF-8). It has no defined encoding * or rules other than it may not contain zero bytes. If you want to use * filenames in a user interface you should use the display name that you * can get by requesting the %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME * attribute with g_file_query_info(). * * This call does no blocking I/O. * * Returns: (type filename) (nullable): string containing the #GFile's * base name, or %NULL if given #GFile is invalid. The returned string * should be freed with g_free() when no longer needed. */ char * g_file_get_basename (GFile *file) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); iface = G_FILE_GET_IFACE (file); return (* iface->get_basename) (file); } /** * g_file_get_path: (virtual get_path) * @file: input #GFile * * Gets the local pathname for #GFile, if one exists. If non-%NULL, this is * guaranteed to be an absolute, canonical path. It might contain symlinks. * * This call does no blocking I/O. * * Returns: (type filename) (nullable): string containing the #GFile's path, * or %NULL if no such path exists. The returned string should be freed * with g_free() when no longer needed. */ char * g_file_get_path (GFile *file) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); iface = G_FILE_GET_IFACE (file); return (* iface->get_path) (file); } static const char * file_peek_path_generic (GFile *file) { const char *path; static GQuark _file_path_quark = 0; if (G_UNLIKELY (_file_path_quark) == 0) _file_path_quark = g_quark_from_static_string ("gio-file-path"); /* We need to be careful about threading, as two threads calling * g_file_peek_path() on the same file could race: both would see * (g_object_get_qdata(…) == NULL) to begin with, both would generate and add * the path, but the second thread to add it would end up freeing the path * set by the first thread. The first thread would still return the pointer * to that freed path, though, resulting an a read-after-free. Handle that * with a compare-and-swap loop. The g_object_*_qdata() functions are atomic. */ while (TRUE) { gchar *new_path = NULL; path = g_object_get_qdata ((GObject*)file, _file_path_quark); if (path != NULL) break; new_path = g_file_get_path (file); if (new_path == NULL) return NULL; /* By passing NULL here, we ensure we never replace existing data: */ if (g_object_replace_qdata ((GObject *) file, _file_path_quark, NULL, (gpointer) new_path, (GDestroyNotify) g_free, NULL)) { path = new_path; break; } else g_free (new_path); } return path; } /** * g_file_peek_path: * @file: input #GFile * * Exactly like g_file_get_path(), but caches the result via * g_object_set_qdata_full(). This is useful for example in C * applications which mix `g_file_*` APIs with native ones. It * also avoids an extra duplicated string when possible, so will be * generally more efficient. * * This call does no blocking I/O. * * Returns: (type filename) (nullable): string containing the #GFile's path, * or %NULL if no such path exists. The returned string is owned by @file. * Since: 2.56 */ const char * g_file_peek_path (GFile *file) { if (G_IS_LOCAL_FILE (file)) return _g_local_file_get_filename ((GLocalFile *) file); return file_peek_path_generic (file); } /** * g_file_get_uri: * @file: input #GFile * * Gets the URI for the @file. * * This call does no blocking I/O. * * Returns: a string containing the #GFile's URI. If the #GFile was constructed * with an invalid URI, an invalid URI is returned. * The returned string should be freed with g_free() * when no longer needed. */ char * g_file_get_uri (GFile *file) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); iface = G_FILE_GET_IFACE (file); return (* iface->get_uri) (file); } /** * g_file_get_parse_name: * @file: input #GFile * * Gets the parse name of the @file. * A parse name is a UTF-8 string that describes the * file such that one can get the #GFile back using * g_file_parse_name(). * * This is generally used to show the #GFile as a nice * full-pathname kind of string in a user interface, * like in a location entry. * * For local files with names that can safely be converted * to UTF-8 the pathname is used, otherwise the IRI is used * (a form of URI that allows UTF-8 characters unescaped). * * This call does no blocking I/O. * * Returns: a string containing the #GFile's parse name. * The returned string should be freed with g_free() * when no longer needed. */ char * g_file_get_parse_name (GFile *file) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); iface = G_FILE_GET_IFACE (file); return (* iface->get_parse_name) (file); } /** * g_file_dup: * @file: input #GFile * * Duplicates a #GFile handle. This operation does not duplicate * the actual file or directory represented by the #GFile; see * g_file_copy() if attempting to copy a file. * * g_file_dup() is useful when a second handle is needed to the same underlying * file, for use in a separate thread (#GFile is not thread-safe). For use * within the same thread, use g_object_ref() to increment the existing object’s * reference count. * * This call does no blocking I/O. * * Returns: (transfer full): a new #GFile that is a duplicate * of the given #GFile. */ GFile * g_file_dup (GFile *file) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); iface = G_FILE_GET_IFACE (file); return (* iface->dup) (file); } /** * g_file_hash: (virtual hash) * @file: (type GFile): #gconstpointer to a #GFile * * Creates a hash value for a #GFile. * * This call does no blocking I/O. * * Returns: 0 if @file is not a valid #GFile, otherwise an * integer that can be used as hash value for the #GFile. * This function is intended for easily hashing a #GFile to * add to a #GHashTable or similar data structure. */ guint g_file_hash (gconstpointer file) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), 0); iface = G_FILE_GET_IFACE (file); return (* iface->hash) ((GFile *)file); } /** * g_file_equal: * @file1: the first #GFile * @file2: the second #GFile * * Checks if the two given #GFiles refer to the same file. * * Note that two #GFiles that differ can still refer to the same * file on the filesystem due to various forms of filename * aliasing. * * This call does no blocking I/O. * * Returns: %TRUE if @file1 and @file2 are equal. */ gboolean g_file_equal (GFile *file1, GFile *file2) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file1), FALSE); g_return_val_if_fail (G_IS_FILE (file2), FALSE); if (file1 == file2) return TRUE; if (G_TYPE_FROM_INSTANCE (file1) != G_TYPE_FROM_INSTANCE (file2)) return FALSE; iface = G_FILE_GET_IFACE (file1); return (* iface->equal) (file1, file2); } /** * g_file_get_parent: * @file: input #GFile * * Gets the parent directory for the @file. * If the @file represents the root directory of the * file system, then %NULL will be returned. * * This call does no blocking I/O. * * Returns: (nullable) (transfer full): a #GFile structure to the * parent of the given #GFile or %NULL if there is no parent. Free * the returned object with g_object_unref(). */ GFile * g_file_get_parent (GFile *file) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); iface = G_FILE_GET_IFACE (file); return (* iface->get_parent) (file); } /** * g_file_has_parent: * @file: input #GFile * @parent: (nullable): the parent to check for, or %NULL * * Checks if @file has a parent, and optionally, if it is @parent. * * If @parent is %NULL then this function returns %TRUE if @file has any * parent at all. If @parent is non-%NULL then %TRUE is only returned * if @file is an immediate child of @parent. * * Returns: %TRUE if @file is an immediate child of @parent (or any parent in * the case that @parent is %NULL). * * Since: 2.24 */ gboolean g_file_has_parent (GFile *file, GFile *parent) { GFile *actual_parent; gboolean result; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (parent == NULL || G_IS_FILE (parent), FALSE); actual_parent = g_file_get_parent (file); if (actual_parent != NULL) { if (parent != NULL) result = g_file_equal (parent, actual_parent); else result = TRUE; g_object_unref (actual_parent); } else result = FALSE; return result; } /** * g_file_get_child: * @file: input #GFile * @name: (type filename): string containing the child's basename * * Gets a child of @file with basename equal to @name. * * Note that the file with that specific name might not exist, but * you can still have a #GFile that points to it. You can use this * for instance to create that file. * * This call does no blocking I/O. * * Returns: (transfer full): a #GFile to a child specified by @name. * Free the returned object with g_object_unref(). */ GFile * g_file_get_child (GFile *file, const char *name) { g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (name != NULL, NULL); g_return_val_if_fail (!g_path_is_absolute (name), NULL); return g_file_resolve_relative_path (file, name); } /** * g_file_get_child_for_display_name: * @file: input #GFile * @display_name: string to a possible child * @error: return location for an error * * Gets the child of @file for a given @display_name (i.e. a UTF-8 * version of the name). If this function fails, it returns %NULL * and @error will be set. This is very useful when constructing a * #GFile for a new file and the user entered the filename in the * user interface, for instance when you select a directory and * type a filename in the file selector. * * This call does no blocking I/O. * * Returns: (transfer full): a #GFile to the specified child, or * %NULL if the display name couldn't be converted. * Free the returned object with g_object_unref(). */ GFile * g_file_get_child_for_display_name (GFile *file, const char *display_name, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (display_name != NULL, NULL); iface = G_FILE_GET_IFACE (file); return (* iface->get_child_for_display_name) (file, display_name, error); } /** * g_file_has_prefix: (virtual prefix_matches) * @file: input #GFile * @prefix: input #GFile * * Checks whether @file has the prefix specified by @prefix. * * In other words, if the names of initial elements of @file's * pathname match @prefix. Only full pathname elements are matched, * so a path like /foo is not considered a prefix of /foobar, only * of /foo/bar. * * A #GFile is not a prefix of itself. If you want to check for * equality, use g_file_equal(). * * This call does no I/O, as it works purely on names. As such it can * sometimes return %FALSE even if @file is inside a @prefix (from a * filesystem point of view), because the prefix of @file is an alias * of @prefix. * * Returns: %TRUE if the @file's parent, grandparent, etc is @prefix, * %FALSE otherwise. */ gboolean g_file_has_prefix (GFile *file, GFile *prefix) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (G_IS_FILE (prefix), FALSE); if (G_TYPE_FROM_INSTANCE (file) != G_TYPE_FROM_INSTANCE (prefix)) return FALSE; iface = G_FILE_GET_IFACE (file); /* The vtable function differs in arg order since * we're using the old contains_file call */ return (* iface->prefix_matches) (prefix, file); } /** * g_file_get_relative_path: (virtual get_relative_path) * @parent: input #GFile * @descendant: input #GFile * * Gets the path for @descendant relative to @parent. * * This call does no blocking I/O. * * Returns: (type filename) (nullable): string with the relative path from * @descendant to @parent, or %NULL if @descendant doesn't have @parent as * prefix. The returned string should be freed with g_free() when * no longer needed. */ char * g_file_get_relative_path (GFile *parent, GFile *descendant) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (parent), NULL); g_return_val_if_fail (G_IS_FILE (descendant), NULL); if (G_TYPE_FROM_INSTANCE (parent) != G_TYPE_FROM_INSTANCE (descendant)) return NULL; iface = G_FILE_GET_IFACE (parent); return (* iface->get_relative_path) (parent, descendant); } /** * g_file_resolve_relative_path: * @file: input #GFile * @relative_path: (type filename): a given relative path string * * Resolves a relative path for @file to an absolute path. * * This call does no blocking I/O. * * If the @relative_path is an absolute path name, the resolution * is done absolutely (without taking @file path as base). * * Returns: (transfer full): a #GFile for the resolved path. */ GFile * g_file_resolve_relative_path (GFile *file, const char *relative_path) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (relative_path != NULL, NULL); iface = G_FILE_GET_IFACE (file); return (* iface->resolve_relative_path) (file, relative_path); } /** * g_file_enumerate_children: * @file: input #GFile * @attributes: an attribute query string * @flags: a set of #GFileQueryInfoFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: #GError for error reporting * * Gets the requested information about the files in a directory. * The result is a #GFileEnumerator object that will give out * #GFileInfo objects for all the files in the directory. * * The @attributes value is a string that specifies the file * attributes that should be gathered. It is not an error if * it's not possible to read a particular requested attribute * from a file - it just won't be set. @attributes should * be a comma-separated list of attributes or attribute wildcards. * The wildcard "*" means all attributes, and a wildcard like * "standard::*" means all attributes in the standard namespace. * An example attribute query be "standard::*,owner::user". * The standard attributes are available as defines, like * %G_FILE_ATTRIBUTE_STANDARD_NAME. %G_FILE_ATTRIBUTE_STANDARD_NAME should * always be specified if you plan to call g_file_enumerator_get_child() or * g_file_enumerator_iterate() on the returned enumerator. * * If @cancellable is not %NULL, then the operation can be cancelled * by triggering the cancellable object from another thread. If the * operation was cancelled, the error %G_IO_ERROR_CANCELLED will be * returned. * * If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will * be returned. If the file is not a directory, the %G_IO_ERROR_NOT_DIRECTORY * error will be returned. Other errors are possible too. * * Returns: (transfer full): A #GFileEnumerator if successful, * %NULL on error. Free the returned object with g_object_unref(). */ GFileEnumerator * g_file_enumerate_children (GFile *file, const char *attributes, GFileQueryInfoFlags flags, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return NULL; iface = G_FILE_GET_IFACE (file); if (iface->enumerate_children == NULL) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return NULL; } return (* iface->enumerate_children) (file, attributes, flags, cancellable, error); } /** * g_file_enumerate_children_async: * @file: input #GFile * @attributes: an attribute query string * @flags: a set of #GFileQueryInfoFlags * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously gets the requested information about the files * in a directory. The result is a #GFileEnumerator object that will * give out #GFileInfo objects for all the files in the directory. * * For more details, see g_file_enumerate_children() which is * the synchronous version of this call. * * When the operation is finished, @callback will be called. You can * then call g_file_enumerate_children_finish() to get the result of * the operation. */ void g_file_enumerate_children_async (GFile *file, const char *attributes, GFileQueryInfoFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); (* iface->enumerate_children_async) (file, attributes, flags, io_priority, cancellable, callback, user_data); } /** * g_file_enumerate_children_finish: * @file: input #GFile * @res: a #GAsyncResult * @error: a #GError * * Finishes an async enumerate children operation. * See g_file_enumerate_children_async(). * * Returns: (transfer full): a #GFileEnumerator or %NULL * if an error occurred. * Free the returned object with g_object_unref(). */ GFileEnumerator * g_file_enumerate_children_finish (GFile *file, GAsyncResult *res, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (G_IS_ASYNC_RESULT (res), NULL); if (g_async_result_legacy_propagate_error (res, error)) return NULL; iface = G_FILE_GET_IFACE (file); return (* iface->enumerate_children_finish) (file, res, error); } /** * g_file_query_exists: * @file: input #GFile * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * * Utility function to check if a particular file exists. This is * implemented using g_file_query_info() and as such does blocking I/O. * * Note that in many cases it is [racy to first check for file existence](https://en.wikipedia.org/wiki/Time_of_check_to_time_of_use) * and then execute something based on the outcome of that, because the * file might have been created or removed in between the operations. The * general approach to handling that is to not check, but just do the * operation and handle the errors as they come. * * As an example of race-free checking, take the case of reading a file, * and if it doesn't exist, creating it. There are two racy versions: read * it, and on error create it; and: check if it exists, if not create it. * These can both result in two processes creating the file (with perhaps * a partially written file as the result). The correct approach is to * always try to create the file with g_file_create() which will either * atomically create the file or fail with a %G_IO_ERROR_EXISTS error. * * However, in many cases an existence check is useful in a user interface, * for instance to make a menu item sensitive/insensitive, so that you don't * have to fool users that something is possible and then just show an error * dialog. If you do this, you should make sure to also handle the errors * that can happen due to races when you execute the operation. * * Returns: %TRUE if the file exists (and can be detected without error), * %FALSE otherwise (or if cancelled). */ gboolean g_file_query_exists (GFile *file, GCancellable *cancellable) { GFileInfo *info; g_return_val_if_fail (G_IS_FILE(file), FALSE); info = g_file_query_info (file, G_FILE_ATTRIBUTE_STANDARD_TYPE, G_FILE_QUERY_INFO_NONE, cancellable, NULL); if (info != NULL) { g_object_unref (info); return TRUE; } return FALSE; } /** * g_file_query_file_type: * @file: input #GFile * @flags: a set of #GFileQueryInfoFlags passed to g_file_query_info() * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * * Utility function to inspect the #GFileType of a file. This is * implemented using g_file_query_info() and as such does blocking I/O. * * The primary use case of this method is to check if a file is * a regular file, directory, or symlink. * * Returns: The #GFileType of the file and %G_FILE_TYPE_UNKNOWN * if the file does not exist * * Since: 2.18 */ GFileType g_file_query_file_type (GFile *file, GFileQueryInfoFlags flags, GCancellable *cancellable) { GFileInfo *info; GFileType file_type; g_return_val_if_fail (G_IS_FILE(file), G_FILE_TYPE_UNKNOWN); info = g_file_query_info (file, G_FILE_ATTRIBUTE_STANDARD_TYPE, flags, cancellable, NULL); if (info != NULL) { file_type = g_file_info_get_file_type (info); g_object_unref (info); } else file_type = G_FILE_TYPE_UNKNOWN; return file_type; } /** * g_file_query_info: * @file: input #GFile * @attributes: an attribute query string * @flags: a set of #GFileQueryInfoFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError * * Gets the requested information about specified @file. * The result is a #GFileInfo object that contains key-value * attributes (such as the type or size of the file). * * The @attributes value is a string that specifies the file * attributes that should be gathered. It is not an error if * it's not possible to read a particular requested attribute * from a file - it just won't be set. @attributes should be a * comma-separated list of attributes or attribute wildcards. * The wildcard "*" means all attributes, and a wildcard like * "standard::*" means all attributes in the standard namespace. * An example attribute query be "standard::*,owner::user". * The standard attributes are available as defines, like * %G_FILE_ATTRIBUTE_STANDARD_NAME. * * If @cancellable is not %NULL, then the operation can be cancelled * by triggering the cancellable object from another thread. If the * operation was cancelled, the error %G_IO_ERROR_CANCELLED will be * returned. * * For symlinks, normally the information about the target of the * symlink is returned, rather than information about the symlink * itself. However if you pass %G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS * in @flags the information about the symlink itself will be returned. * Also, for symlinks that point to non-existing files the information * about the symlink itself will be returned. * * If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be * returned. Other errors are possible too, and depend on what kind of * filesystem the file is on. * * Returns: (transfer full): a #GFileInfo for the given @file, or %NULL * on error. Free the returned object with g_object_unref(). */ GFileInfo * g_file_query_info (GFile *file, const char *attributes, GFileQueryInfoFlags flags, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return NULL; iface = G_FILE_GET_IFACE (file); if (iface->query_info == NULL) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return NULL; } return (* iface->query_info) (file, attributes, flags, cancellable, error); } /** * g_file_query_info_async: * @file: input #GFile * @attributes: an attribute query string * @flags: a set of #GFileQueryInfoFlags * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously gets the requested information about specified @file. * The result is a #GFileInfo object that contains key-value attributes * (such as type or size for the file). * * For more details, see g_file_query_info() which is the synchronous * version of this call. * * When the operation is finished, @callback will be called. You can * then call g_file_query_info_finish() to get the result of the operation. */ void g_file_query_info_async (GFile *file, const char *attributes, GFileQueryInfoFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); (* iface->query_info_async) (file, attributes, flags, io_priority, cancellable, callback, user_data); } /** * g_file_query_info_finish: * @file: input #GFile * @res: a #GAsyncResult * @error: a #GError * * Finishes an asynchronous file info query. * See g_file_query_info_async(). * * Returns: (transfer full): #GFileInfo for given @file * or %NULL on error. Free the returned object with * g_object_unref(). */ GFileInfo * g_file_query_info_finish (GFile *file, GAsyncResult *res, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (G_IS_ASYNC_RESULT (res), NULL); if (g_async_result_legacy_propagate_error (res, error)) return NULL; iface = G_FILE_GET_IFACE (file); return (* iface->query_info_finish) (file, res, error); } /** * g_file_query_filesystem_info: * @file: input #GFile * @attributes: an attribute query string * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError * * Similar to g_file_query_info(), but obtains information * about the filesystem the @file is on, rather than the file itself. * For instance the amount of space available and the type of * the filesystem. * * The @attributes value is a string that specifies the attributes * that should be gathered. It is not an error if it's not possible * to read a particular requested attribute from a file - it just * won't be set. @attributes should be a comma-separated list of * attributes or attribute wildcards. The wildcard "*" means all * attributes, and a wildcard like "filesystem::*" means all attributes * in the filesystem namespace. The standard namespace for filesystem * attributes is "filesystem". Common attributes of interest are * %G_FILE_ATTRIBUTE_FILESYSTEM_SIZE (the total size of the filesystem * in bytes), %G_FILE_ATTRIBUTE_FILESYSTEM_FREE (number of bytes available), * and %G_FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem). * * If @cancellable is not %NULL, then the operation can be cancelled * by triggering the cancellable object from another thread. If the * operation was cancelled, the error %G_IO_ERROR_CANCELLED will be * returned. * * If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will * be returned. Other errors are possible too, and depend on what * kind of filesystem the file is on. * * Returns: (transfer full): a #GFileInfo or %NULL if there was an error. * Free the returned object with g_object_unref(). */ GFileInfo * g_file_query_filesystem_info (GFile *file, const char *attributes, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return NULL; iface = G_FILE_GET_IFACE (file); if (iface->query_filesystem_info == NULL) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return NULL; } return (* iface->query_filesystem_info) (file, attributes, cancellable, error); } /** * g_file_query_filesystem_info_async: * @file: input #GFile * @attributes: an attribute query string * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously gets the requested information about the filesystem * that the specified @file is on. The result is a #GFileInfo object * that contains key-value attributes (such as type or size for the * file). * * For more details, see g_file_query_filesystem_info() which is the * synchronous version of this call. * * When the operation is finished, @callback will be called. You can * then call g_file_query_info_finish() to get the result of the * operation. */ void g_file_query_filesystem_info_async (GFile *file, const char *attributes, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); (* iface->query_filesystem_info_async) (file, attributes, io_priority, cancellable, callback, user_data); } /** * g_file_query_filesystem_info_finish: * @file: input #GFile * @res: a #GAsyncResult * @error: a #GError * * Finishes an asynchronous filesystem info query. * See g_file_query_filesystem_info_async(). * * Returns: (transfer full): #GFileInfo for given @file * or %NULL on error. * Free the returned object with g_object_unref(). */ GFileInfo * g_file_query_filesystem_info_finish (GFile *file, GAsyncResult *res, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (G_IS_ASYNC_RESULT (res), NULL); if (g_async_result_legacy_propagate_error (res, error)) return NULL; iface = G_FILE_GET_IFACE (file); return (* iface->query_filesystem_info_finish) (file, res, error); } /** * g_file_find_enclosing_mount: * @file: input #GFile * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError * * Gets a #GMount for the #GFile. * * #GMount is returned only for user interesting locations, see * #GVolumeMonitor. If the #GFileIface for @file does not have a #mount, * @error will be set to %G_IO_ERROR_NOT_FOUND and %NULL #will be returned. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: (transfer full): a #GMount where the @file is located * or %NULL on error. * Free the returned object with g_object_unref(). */ GMount * g_file_find_enclosing_mount (GFile *file, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return NULL; iface = G_FILE_GET_IFACE (file); if (iface->find_enclosing_mount == NULL) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_FOUND, /* Translators: This is an error message when * trying to find the enclosing (user visible) * mount of a file, but none exists. */ _("Containing mount does not exist")); return NULL; } return (* iface->find_enclosing_mount) (file, cancellable, error); } /** * g_file_find_enclosing_mount_async: * @file: a #GFile * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously gets the mount for the file. * * For more details, see g_file_find_enclosing_mount() which is * the synchronous version of this call. * * When the operation is finished, @callback will be called. * You can then call g_file_find_enclosing_mount_finish() to * get the result of the operation. */ void g_file_find_enclosing_mount_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); (* iface->find_enclosing_mount_async) (file, io_priority, cancellable, callback, user_data); } /** * g_file_find_enclosing_mount_finish: * @file: a #GFile * @res: a #GAsyncResult * @error: a #GError * * Finishes an asynchronous find mount request. * See g_file_find_enclosing_mount_async(). * * Returns: (transfer full): #GMount for given @file or %NULL on error. * Free the returned object with g_object_unref(). */ GMount * g_file_find_enclosing_mount_finish (GFile *file, GAsyncResult *res, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (G_IS_ASYNC_RESULT (res), NULL); if (g_async_result_legacy_propagate_error (res, error)) return NULL; iface = G_FILE_GET_IFACE (file); return (* iface->find_enclosing_mount_finish) (file, res, error); } /** * g_file_read: (virtual read_fn) * @file: #GFile to read * @cancellable: (nullable): a #GCancellable * @error: a #GError, or %NULL * * Opens a file for reading. The result is a #GFileInputStream that * can be used to read the contents of the file. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be * returned. If the file is a directory, the %G_IO_ERROR_IS_DIRECTORY * error will be returned. Other errors are possible too, and depend * on what kind of filesystem the file is on. * * Returns: (transfer full): #GFileInputStream or %NULL on error. * Free the returned object with g_object_unref(). */ GFileInputStream * g_file_read (GFile *file, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return NULL; iface = G_FILE_GET_IFACE (file); if (iface->read_fn == NULL) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return NULL; } return (* iface->read_fn) (file, cancellable, error); } /** * g_file_append_to: * @file: input #GFile * @flags: a set of #GFileCreateFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Gets an output stream for appending data to the file. * If the file doesn't already exist it is created. * * By default files created are generally readable by everyone, * but if you pass %G_FILE_CREATE_PRIVATE in @flags the file * will be made readable only to the current user, to the level that * is supported on the target filesystem. * * If @cancellable is not %NULL, then the operation can be cancelled * by triggering the cancellable object from another thread. If the * operation was cancelled, the error %G_IO_ERROR_CANCELLED will be * returned. * * Some file systems don't allow all file names, and may return an * %G_IO_ERROR_INVALID_FILENAME error. If the file is a directory the * %G_IO_ERROR_IS_DIRECTORY error will be returned. Other errors are * possible too, and depend on what kind of filesystem the file is on. * * Returns: (transfer full): a #GFileOutputStream, or %NULL on error. * Free the returned object with g_object_unref(). */ GFileOutputStream * g_file_append_to (GFile *file, GFileCreateFlags flags, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return NULL; iface = G_FILE_GET_IFACE (file); if (iface->append_to == NULL) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return NULL; } return (* iface->append_to) (file, flags, cancellable, error); } /** * g_file_create: * @file: input #GFile * @flags: a set of #GFileCreateFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Creates a new file and returns an output stream for writing to it. * The file must not already exist. * * By default files created are generally readable by everyone, * but if you pass %G_FILE_CREATE_PRIVATE in @flags the file * will be made readable only to the current user, to the level * that is supported on the target filesystem. * * If @cancellable is not %NULL, then the operation can be cancelled * by triggering the cancellable object from another thread. If the * operation was cancelled, the error %G_IO_ERROR_CANCELLED will be * returned. * * If a file or directory with this name already exists the * %G_IO_ERROR_EXISTS error will be returned. Some file systems don't * allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME * error, and if the name is to long %G_IO_ERROR_FILENAME_TOO_LONG will * be returned. Other errors are possible too, and depend on what kind * of filesystem the file is on. * * Returns: (transfer full): a #GFileOutputStream for the newly created * file, or %NULL on error. * Free the returned object with g_object_unref(). */ GFileOutputStream * g_file_create (GFile *file, GFileCreateFlags flags, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return NULL; iface = G_FILE_GET_IFACE (file); if (iface->create == NULL) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return NULL; } return (* iface->create) (file, flags, cancellable, error); } /** * g_file_replace: * @file: input #GFile * @etag: (nullable): an optional [entity tag](#entity-tags) * for the current #GFile, or #NULL to ignore * @make_backup: %TRUE if a backup should be created * @flags: a set of #GFileCreateFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Returns an output stream for overwriting the file, possibly * creating a backup copy of the file first. If the file doesn't exist, * it will be created. * * This will try to replace the file in the safest way possible so * that any errors during the writing will not affect an already * existing copy of the file. For instance, for local files it * may write to a temporary file and then atomically rename over * the destination when the stream is closed. * * By default files created are generally readable by everyone, * but if you pass %G_FILE_CREATE_PRIVATE in @flags the file * will be made readable only to the current user, to the level that * is supported on the target filesystem. * * If @cancellable is not %NULL, then the operation can be cancelled * by triggering the cancellable object from another thread. If the * operation was cancelled, the error %G_IO_ERROR_CANCELLED will be * returned. * * If you pass in a non-%NULL @etag value and @file already exists, then * this value is compared to the current entity tag of the file, and if * they differ an %G_IO_ERROR_WRONG_ETAG error is returned. This * generally means that the file has been changed since you last read * it. You can get the new etag from g_file_output_stream_get_etag() * after you've finished writing and closed the #GFileOutputStream. When * you load a new file you can use g_file_input_stream_query_info() to * get the etag of the file. * * If @make_backup is %TRUE, this function will attempt to make a * backup of the current file before overwriting it. If this fails * a %G_IO_ERROR_CANT_CREATE_BACKUP error will be returned. If you * want to replace anyway, try again with @make_backup set to %FALSE. * * If the file is a directory the %G_IO_ERROR_IS_DIRECTORY error will * be returned, and if the file is some other form of non-regular file * then a %G_IO_ERROR_NOT_REGULAR_FILE error will be returned. Some * file systems don't allow all file names, and may return an * %G_IO_ERROR_INVALID_FILENAME error, and if the name is to long * %G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors are * possible too, and depend on what kind of filesystem the file is on. * * Returns: (transfer full): a #GFileOutputStream or %NULL on error. * Free the returned object with g_object_unref(). */ GFileOutputStream * g_file_replace (GFile *file, const char *etag, gboolean make_backup, GFileCreateFlags flags, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return NULL; iface = G_FILE_GET_IFACE (file); if (iface->replace == NULL) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return NULL; } /* Handle empty tag string as NULL in consistent way. */ if (etag && *etag == 0) etag = NULL; return (* iface->replace) (file, etag, make_backup, flags, cancellable, error); } /** * g_file_open_readwrite: * @file: #GFile to open * @cancellable: (nullable): a #GCancellable * @error: a #GError, or %NULL * * Opens an existing file for reading and writing. The result is * a #GFileIOStream that can be used to read and write the contents * of the file. * * If @cancellable is not %NULL, then the operation can be cancelled * by triggering the cancellable object from another thread. If the * operation was cancelled, the error %G_IO_ERROR_CANCELLED will be * returned. * * If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will * be returned. If the file is a directory, the %G_IO_ERROR_IS_DIRECTORY * error will be returned. Other errors are possible too, and depend on * what kind of filesystem the file is on. Note that in many non-local * file cases read and write streams are not supported, so make sure you * really need to do read and write streaming, rather than just opening * for reading or writing. * * Returns: (transfer full): #GFileIOStream or %NULL on error. * Free the returned object with g_object_unref(). * * Since: 2.22 */ GFileIOStream * g_file_open_readwrite (GFile *file, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return NULL; iface = G_FILE_GET_IFACE (file); if (iface->open_readwrite == NULL) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return NULL; } return (* iface->open_readwrite) (file, cancellable, error); } /** * g_file_create_readwrite: * @file: a #GFile * @flags: a set of #GFileCreateFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: return location for a #GError, or %NULL * * Creates a new file and returns a stream for reading and * writing to it. The file must not already exist. * * By default files created are generally readable by everyone, * but if you pass %G_FILE_CREATE_PRIVATE in @flags the file * will be made readable only to the current user, to the level * that is supported on the target filesystem. * * If @cancellable is not %NULL, then the operation can be cancelled * by triggering the cancellable object from another thread. If the * operation was cancelled, the error %G_IO_ERROR_CANCELLED will be * returned. * * If a file or directory with this name already exists, the * %G_IO_ERROR_EXISTS error will be returned. Some file systems don't * allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME * error, and if the name is too long, %G_IO_ERROR_FILENAME_TOO_LONG * will be returned. Other errors are possible too, and depend on what * kind of filesystem the file is on. * * Note that in many non-local file cases read and write streams are * not supported, so make sure you really need to do read and write * streaming, rather than just opening for reading or writing. * * Returns: (transfer full): a #GFileIOStream for the newly created * file, or %NULL on error. * Free the returned object with g_object_unref(). * * Since: 2.22 */ GFileIOStream * g_file_create_readwrite (GFile *file, GFileCreateFlags flags, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return NULL; iface = G_FILE_GET_IFACE (file); if (iface->create_readwrite == NULL) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return NULL; } return (* iface->create_readwrite) (file, flags, cancellable, error); } /** * g_file_replace_readwrite: * @file: a #GFile * @etag: (nullable): an optional [entity tag](#entity-tags) * for the current #GFile, or #NULL to ignore * @make_backup: %TRUE if a backup should be created * @flags: a set of #GFileCreateFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: return location for a #GError, or %NULL * * Returns an output stream for overwriting the file in readwrite mode, * possibly creating a backup copy of the file first. If the file doesn't * exist, it will be created. * * For details about the behaviour, see g_file_replace() which does the * same thing but returns an output stream only. * * Note that in many non-local file cases read and write streams are not * supported, so make sure you really need to do read and write streaming, * rather than just opening for reading or writing. * * Returns: (transfer full): a #GFileIOStream or %NULL on error. * Free the returned object with g_object_unref(). * * Since: 2.22 */ GFileIOStream * g_file_replace_readwrite (GFile *file, const char *etag, gboolean make_backup, GFileCreateFlags flags, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return NULL; iface = G_FILE_GET_IFACE (file); if (iface->replace_readwrite == NULL) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return NULL; } return (* iface->replace_readwrite) (file, etag, make_backup, flags, cancellable, error); } /** * g_file_read_async: * @file: input #GFile * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously opens @file for reading. * * For more details, see g_file_read() which is * the synchronous version of this call. * * When the operation is finished, @callback will be called. * You can then call g_file_read_finish() to get the result * of the operation. */ void g_file_read_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); (* iface->read_async) (file, io_priority, cancellable, callback, user_data); } /** * g_file_read_finish: * @file: input #GFile * @res: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes an asynchronous file read operation started with * g_file_read_async(). * * Returns: (transfer full): a #GFileInputStream or %NULL on error. * Free the returned object with g_object_unref(). */ GFileInputStream * g_file_read_finish (GFile *file, GAsyncResult *res, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (G_IS_ASYNC_RESULT (res), NULL); if (g_async_result_legacy_propagate_error (res, error)) return NULL; iface = G_FILE_GET_IFACE (file); return (* iface->read_finish) (file, res, error); } /** * g_file_append_to_async: * @file: input #GFile * @flags: a set of #GFileCreateFlags * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously opens @file for appending. * * For more details, see g_file_append_to() which is * the synchronous version of this call. * * When the operation is finished, @callback will be called. * You can then call g_file_append_to_finish() to get the result * of the operation. */ void g_file_append_to_async (GFile *file, GFileCreateFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); (* iface->append_to_async) (file, flags, io_priority, cancellable, callback, user_data); } /** * g_file_append_to_finish: * @file: input #GFile * @res: #GAsyncResult * @error: a #GError, or %NULL * * Finishes an asynchronous file append operation started with * g_file_append_to_async(). * * Returns: (transfer full): a valid #GFileOutputStream * or %NULL on error. * Free the returned object with g_object_unref(). */ GFileOutputStream * g_file_append_to_finish (GFile *file, GAsyncResult *res, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (G_IS_ASYNC_RESULT (res), NULL); if (g_async_result_legacy_propagate_error (res, error)) return NULL; iface = G_FILE_GET_IFACE (file); return (* iface->append_to_finish) (file, res, error); } /** * g_file_create_async: * @file: input #GFile * @flags: a set of #GFileCreateFlags * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously creates a new file and returns an output stream * for writing to it. The file must not already exist. * * For more details, see g_file_create() which is * the synchronous version of this call. * * When the operation is finished, @callback will be called. * You can then call g_file_create_finish() to get the result * of the operation. */ void g_file_create_async (GFile *file, GFileCreateFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); (* iface->create_async) (file, flags, io_priority, cancellable, callback, user_data); } /** * g_file_create_finish: * @file: input #GFile * @res: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes an asynchronous file create operation started with * g_file_create_async(). * * Returns: (transfer full): a #GFileOutputStream or %NULL on error. * Free the returned object with g_object_unref(). */ GFileOutputStream * g_file_create_finish (GFile *file, GAsyncResult *res, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (G_IS_ASYNC_RESULT (res), NULL); if (g_async_result_legacy_propagate_error (res, error)) return NULL; iface = G_FILE_GET_IFACE (file); return (* iface->create_finish) (file, res, error); } /** * g_file_replace_async: * @file: input #GFile * @etag: (nullable): an [entity tag](#entity-tags) for the current #GFile, * or %NULL to ignore * @make_backup: %TRUE if a backup should be created * @flags: a set of #GFileCreateFlags * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously overwrites the file, replacing the contents, * possibly creating a backup copy of the file first. * * For more details, see g_file_replace() which is * the synchronous version of this call. * * When the operation is finished, @callback will be called. * You can then call g_file_replace_finish() to get the result * of the operation. */ void g_file_replace_async (GFile *file, const char *etag, gboolean make_backup, GFileCreateFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); (* iface->replace_async) (file, etag, make_backup, flags, io_priority, cancellable, callback, user_data); } /** * g_file_replace_finish: * @file: input #GFile * @res: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes an asynchronous file replace operation started with * g_file_replace_async(). * * Returns: (transfer full): a #GFileOutputStream, or %NULL on error. * Free the returned object with g_object_unref(). */ GFileOutputStream * g_file_replace_finish (GFile *file, GAsyncResult *res, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (G_IS_ASYNC_RESULT (res), NULL); if (g_async_result_legacy_propagate_error (res, error)) return NULL; iface = G_FILE_GET_IFACE (file); return (* iface->replace_finish) (file, res, error); } /** * g_file_open_readwrite_async * @file: input #GFile * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously opens @file for reading and writing. * * For more details, see g_file_open_readwrite() which is * the synchronous version of this call. * * When the operation is finished, @callback will be called. * You can then call g_file_open_readwrite_finish() to get * the result of the operation. * * Since: 2.22 */ void g_file_open_readwrite_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); (* iface->open_readwrite_async) (file, io_priority, cancellable, callback, user_data); } /** * g_file_open_readwrite_finish: * @file: input #GFile * @res: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes an asynchronous file read operation started with * g_file_open_readwrite_async(). * * Returns: (transfer full): a #GFileIOStream or %NULL on error. * Free the returned object with g_object_unref(). * * Since: 2.22 */ GFileIOStream * g_file_open_readwrite_finish (GFile *file, GAsyncResult *res, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (G_IS_ASYNC_RESULT (res), NULL); if (g_async_result_legacy_propagate_error (res, error)) return NULL; iface = G_FILE_GET_IFACE (file); return (* iface->open_readwrite_finish) (file, res, error); } /** * g_file_create_readwrite_async: * @file: input #GFile * @flags: a set of #GFileCreateFlags * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously creates a new file and returns a stream * for reading and writing to it. The file must not already exist. * * For more details, see g_file_create_readwrite() which is * the synchronous version of this call. * * When the operation is finished, @callback will be called. * You can then call g_file_create_readwrite_finish() to get * the result of the operation. * * Since: 2.22 */ void g_file_create_readwrite_async (GFile *file, GFileCreateFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); (* iface->create_readwrite_async) (file, flags, io_priority, cancellable, callback, user_data); } /** * g_file_create_readwrite_finish: * @file: input #GFile * @res: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes an asynchronous file create operation started with * g_file_create_readwrite_async(). * * Returns: (transfer full): a #GFileIOStream or %NULL on error. * Free the returned object with g_object_unref(). * * Since: 2.22 */ GFileIOStream * g_file_create_readwrite_finish (GFile *file, GAsyncResult *res, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (G_IS_ASYNC_RESULT (res), NULL); if (g_async_result_legacy_propagate_error (res, error)) return NULL; iface = G_FILE_GET_IFACE (file); return (* iface->create_readwrite_finish) (file, res, error); } /** * g_file_replace_readwrite_async: * @file: input #GFile * @etag: (nullable): an [entity tag](#entity-tags) for the current #GFile, * or %NULL to ignore * @make_backup: %TRUE if a backup should be created * @flags: a set of #GFileCreateFlags * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously overwrites the file in read-write mode, * replacing the contents, possibly creating a backup copy * of the file first. * * For more details, see g_file_replace_readwrite() which is * the synchronous version of this call. * * When the operation is finished, @callback will be called. * You can then call g_file_replace_readwrite_finish() to get * the result of the operation. * * Since: 2.22 */ void g_file_replace_readwrite_async (GFile *file, const char *etag, gboolean make_backup, GFileCreateFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); (* iface->replace_readwrite_async) (file, etag, make_backup, flags, io_priority, cancellable, callback, user_data); } /** * g_file_replace_readwrite_finish: * @file: input #GFile * @res: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes an asynchronous file replace operation started with * g_file_replace_readwrite_async(). * * Returns: (transfer full): a #GFileIOStream, or %NULL on error. * Free the returned object with g_object_unref(). * * Since: 2.22 */ GFileIOStream * g_file_replace_readwrite_finish (GFile *file, GAsyncResult *res, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (G_IS_ASYNC_RESULT (res), NULL); if (g_async_result_legacy_propagate_error (res, error)) return NULL; iface = G_FILE_GET_IFACE (file); return (* iface->replace_readwrite_finish) (file, res, error); } static gboolean copy_symlink (GFile *destination, GFileCopyFlags flags, GCancellable *cancellable, const char *target, GError **error) { GError *my_error; gboolean tried_delete; GFileInfo *info; GFileType file_type; tried_delete = FALSE; retry: my_error = NULL; if (!g_file_make_symbolic_link (destination, target, cancellable, &my_error)) { /* Maybe it already existed, and we want to overwrite? */ if (!tried_delete && (flags & G_FILE_COPY_OVERWRITE) && my_error->domain == G_IO_ERROR && my_error->code == G_IO_ERROR_EXISTS) { g_clear_error (&my_error); /* Don't overwrite if the destination is a directory */ info = g_file_query_info (destination, G_FILE_ATTRIBUTE_STANDARD_TYPE, G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS, cancellable, &my_error); if (info != NULL) { file_type = g_file_info_get_file_type (info); g_object_unref (info); if (file_type == G_FILE_TYPE_DIRECTORY) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_IS_DIRECTORY, _("Can’t copy over directory")); return FALSE; } } if (!g_file_delete (destination, cancellable, error)) return FALSE; tried_delete = TRUE; goto retry; } /* Nah, fail */ g_propagate_error (error, my_error); return FALSE; } return TRUE; } static GFileInputStream * open_source_for_copy (GFile *source, GFile *destination, GFileCopyFlags flags, GCancellable *cancellable, GError **error) { GError *my_error; GFileInputStream *ret; GFileInfo *info; GFileType file_type; my_error = NULL; ret = g_file_read (source, cancellable, &my_error); if (ret != NULL) return ret; /* There was an error opening the source, try to set a good error for it: */ if (my_error->domain == G_IO_ERROR && my_error->code == G_IO_ERROR_IS_DIRECTORY) { /* The source is a directory, don't fail with WOULD_RECURSE immediately, * as that is less useful to the app. Better check for errors on the * target instead. */ g_error_free (my_error); my_error = NULL; info = g_file_query_info (destination, G_FILE_ATTRIBUTE_STANDARD_TYPE, G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS, cancellable, &my_error); if (info != NULL && g_file_info_has_attribute (info, G_FILE_ATTRIBUTE_STANDARD_TYPE)) { file_type = g_file_info_get_file_type (info); g_object_unref (info); if (flags & G_FILE_COPY_OVERWRITE) { if (file_type == G_FILE_TYPE_DIRECTORY) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_WOULD_MERGE, _("Can’t copy directory over directory")); return NULL; } /* continue to would_recurse error */ } else { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_EXISTS, _("Target file exists")); return NULL; } } else { /* Error getting info from target, return that error * (except for NOT_FOUND, which is no error here) */ g_clear_object (&info); if (my_error != NULL && !g_error_matches (my_error, G_IO_ERROR, G_IO_ERROR_NOT_FOUND)) { g_propagate_error (error, my_error); return NULL; } g_clear_error (&my_error); } g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_WOULD_RECURSE, _("Can’t recursively copy directory")); return NULL; } g_propagate_error (error, my_error); return NULL; } static gboolean should_copy (GFileAttributeInfo *info, gboolean copy_all_attributes, gboolean skip_perms, gboolean skip_modified_time) { if ((skip_perms && strcmp(info->name, "unix::mode") == 0) || (skip_modified_time && strncmp(info->name, "time::modified", 14) == 0)) return FALSE; if (copy_all_attributes) return info->flags & G_FILE_ATTRIBUTE_INFO_COPY_WHEN_MOVED; return info->flags & G_FILE_ATTRIBUTE_INFO_COPY_WITH_FILE; } /** * g_file_build_attribute_list_for_copy: * @file: a #GFile to copy attributes to * @flags: a set of #GFileCopyFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, %NULL to ignore * * Prepares the file attribute query string for copying to @file. * * This function prepares an attribute query string to be * passed to g_file_query_info() to get a list of attributes * normally copied with the file (see g_file_copy_attributes() * for the detailed description). This function is used by the * implementation of g_file_copy_attributes() and is useful * when one needs to query and set the attributes in two * stages (e.g., for recursive move of a directory). * * Returns: an attribute query string for g_file_query_info(), * or %NULL if an error occurs. * * Since: 2.68 */ char * g_file_build_attribute_list_for_copy (GFile *file, GFileCopyFlags flags, GCancellable *cancellable, GError **error) { char *ret = NULL; GFileAttributeInfoList *attributes = NULL, *namespaces = NULL; GString *s = NULL; gboolean first; int i; gboolean copy_all_attributes; gboolean skip_perms; gboolean skip_modified_time; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (cancellable == NULL || G_IS_CANCELLABLE (cancellable), NULL); g_return_val_if_fail (error == NULL || *error == NULL, NULL); copy_all_attributes = flags & G_FILE_COPY_ALL_METADATA; skip_perms = (flags & G_FILE_COPY_TARGET_DEFAULT_PERMS) != 0; skip_modified_time = (flags & G_FILE_COPY_TARGET_DEFAULT_MODIFIED_TIME) != 0; /* Ignore errors here, if the target supports no attributes there is * nothing to copy. We still honor the cancellable though. */ attributes = g_file_query_settable_attributes (file, cancellable, NULL); if (g_cancellable_set_error_if_cancelled (cancellable, error)) goto out; namespaces = g_file_query_writable_namespaces (file, cancellable, NULL); if (g_cancellable_set_error_if_cancelled (cancellable, error)) goto out; if (attributes == NULL && namespaces == NULL) goto out; first = TRUE; s = g_string_new (""); /* Always query the source file size, even though we can’t set that on the * destination. This is useful for the copy functions. */ first = FALSE; g_string_append (s, G_FILE_ATTRIBUTE_STANDARD_SIZE); if (attributes) { for (i = 0; i < attributes->n_infos; i++) { if (should_copy (&attributes->infos[i], copy_all_attributes, skip_perms, skip_modified_time)) { if (first) first = FALSE; else g_string_append_c (s, ','); g_string_append (s, attributes->infos[i].name); } } } if (namespaces) { for (i = 0; i < namespaces->n_infos; i++) { if (should_copy (&namespaces->infos[i], copy_all_attributes, FALSE, FALSE)) { if (first) first = FALSE; else g_string_append_c (s, ','); g_string_append (s, namespaces->infos[i].name); g_string_append (s, "::*"); } } } ret = g_string_free (s, FALSE); s = NULL; out: if (s) g_string_free (s, TRUE); if (attributes) g_file_attribute_info_list_unref (attributes); if (namespaces) g_file_attribute_info_list_unref (namespaces); return ret; } /** * g_file_copy_attributes: * @source: a #GFile with attributes * @destination: a #GFile to copy attributes to * @flags: a set of #GFileCopyFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, %NULL to ignore * * Copies the file attributes from @source to @destination. * * Normally only a subset of the file attributes are copied, * those that are copies in a normal file copy operation * (which for instance does not include e.g. owner). However * if %G_FILE_COPY_ALL_METADATA is specified in @flags, then * all the metadata that is possible to copy is copied. This * is useful when implementing move by copy + delete source. * * Returns: %TRUE if the attributes were copied successfully, * %FALSE otherwise. */ gboolean g_file_copy_attributes (GFile *source, GFile *destination, GFileCopyFlags flags, GCancellable *cancellable, GError **error) { char *attrs_to_read; gboolean res; GFileInfo *info; gboolean source_nofollow_symlinks; attrs_to_read = g_file_build_attribute_list_for_copy (destination, flags, cancellable, error); if (!attrs_to_read) return FALSE; source_nofollow_symlinks = flags & G_FILE_COPY_NOFOLLOW_SYMLINKS; /* Ignore errors here, if we can't read some info (e.g. if it doesn't exist) * we just don't copy it. */ info = g_file_query_info (source, attrs_to_read, source_nofollow_symlinks ? G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS:0, cancellable, NULL); g_free (attrs_to_read); res = TRUE; if (info) { res = g_file_set_attributes_from_info (destination, info, G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS, cancellable, error); g_object_unref (info); } return res; } /* 256k minus malloc overhead */ #define STREAM_BUFFER_SIZE (1024*256 - 2 *sizeof(gpointer)) static gboolean copy_stream_with_progress (GInputStream *in, GOutputStream *out, GFile *source, GCancellable *cancellable, GFileProgressCallback progress_callback, gpointer progress_callback_data, GError **error) { gssize n_read; gsize n_written; goffset current_size; char *buffer; gboolean res; goffset total_size; GFileInfo *info; total_size = -1; /* avoid performance impact of querying total size when it's not needed */ if (progress_callback) { info = g_file_input_stream_query_info (G_FILE_INPUT_STREAM (in), G_FILE_ATTRIBUTE_STANDARD_SIZE, cancellable, NULL); if (info) { if (g_file_info_has_attribute (info, G_FILE_ATTRIBUTE_STANDARD_SIZE)) total_size = g_file_info_get_size (info); g_object_unref (info); } if (total_size == -1) { info = g_file_query_info (source, G_FILE_ATTRIBUTE_STANDARD_SIZE, G_FILE_QUERY_INFO_NONE, cancellable, NULL); if (info) { if (g_file_info_has_attribute (info, G_FILE_ATTRIBUTE_STANDARD_SIZE)) total_size = g_file_info_get_size (info); g_object_unref (info); } } } if (total_size == -1) total_size = 0; buffer = g_malloc0 (STREAM_BUFFER_SIZE); current_size = 0; res = TRUE; while (TRUE) { n_read = g_input_stream_read (in, buffer, STREAM_BUFFER_SIZE, cancellable, error); if (n_read == -1) { res = FALSE; break; } if (n_read == 0) break; current_size += n_read; res = g_output_stream_write_all (out, buffer, n_read, &n_written, cancellable, error); if (!res) break; if (progress_callback) progress_callback (current_size, total_size, progress_callback_data); } g_free (buffer); /* Make sure we send full copied size */ if (progress_callback) progress_callback (current_size, total_size, progress_callback_data); return res; } #ifdef HAVE_COPY_FILE_RANGE static gboolean do_copy_file_range (int fd_in, loff_t *off_in, int fd_out, loff_t *off_out, size_t len, size_t *bytes_transferred, GError **error) { ssize_t result; do { result = copy_file_range (fd_in, off_in, fd_out, off_out, len, 0); if (result == -1) { int errsv = errno; if (errsv == EINTR) { continue; } else if (errsv == ENOSYS || errsv == EINVAL || errsv == EOPNOTSUPP || errsv == EXDEV) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Copy file range not supported")); } else { g_set_error (error, G_IO_ERROR, g_io_error_from_errno (errsv), _("Error splicing file: %s"), g_strerror (errsv)); } return FALSE; } } while (result == -1); g_assert (result >= 0); *bytes_transferred = result; return TRUE; } static gboolean copy_file_range_with_progress (GInputStream *in, GFileInfo *in_info, GOutputStream *out, GCancellable *cancellable, GFileProgressCallback progress_callback, gpointer progress_callback_data, GError **error) { goffset total_size, last_notified_size; size_t copy_len; loff_t offset_in; loff_t offset_out; int fd_in, fd_out; fd_in = g_file_descriptor_based_get_fd (G_FILE_DESCRIPTOR_BASED (in)); fd_out = g_file_descriptor_based_get_fd (G_FILE_DESCRIPTOR_BASED (out)); g_assert (g_file_info_has_attribute (in_info, G_FILE_ATTRIBUTE_STANDARD_SIZE)); total_size = g_file_info_get_size (in_info); /* Bail out if the reported size of the file is zero. It might be zero, but it * might also just be a kernel file in /proc. They report their file size as * zero, but then have data when you start reading. Go to the fallback code * path for those. */ if (total_size == 0) { g_set_error (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Copy file range not supported")); return FALSE; } offset_in = offset_out = 0; copy_len = total_size; last_notified_size = 0; /* Call copy_file_range() in a loop until the whole contents are copied. For * smaller files, this loop will iterate only once. For larger files, the * kernel (at least, kernel 6.1.6) will return after 2GB anyway, so that gives * us more loop iterations and more progress reporting. */ while (copy_len > 0) { size_t n_copied; if (g_cancellable_set_error_if_cancelled (cancellable, error) || !do_copy_file_range (fd_in, &offset_in, fd_out, &offset_out, copy_len, &n_copied, error)) return FALSE; if (n_copied == 0) break; g_assert (n_copied <= copy_len); copy_len -= n_copied; if (progress_callback) { progress_callback (offset_in, total_size, progress_callback_data); last_notified_size = total_size; } } /* Make sure we send full copied size */ if (progress_callback && last_notified_size != total_size) progress_callback (offset_in, total_size, progress_callback_data); return TRUE; } #endif /* HAVE_COPY_FILE_RANGE */ #ifdef HAVE_SPLICE static gboolean do_splice (int fd_in, loff_t *off_in, int fd_out, loff_t *off_out, size_t len, long *bytes_transferd, GError **error) { long result; retry: result = splice (fd_in, off_in, fd_out, off_out, len, SPLICE_F_MORE); if (result == -1) { int errsv = errno; if (errsv == EINTR) goto retry; else if (errsv == ENOSYS || errsv == EINVAL || errsv == EOPNOTSUPP) g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Splice not supported")); else g_set_error (error, G_IO_ERROR, g_io_error_from_errno (errsv), _("Error splicing file: %s"), g_strerror (errsv)); return FALSE; } *bytes_transferd = result; return TRUE; } static gboolean splice_stream_with_progress (GInputStream *in, GFileInfo *in_info, GOutputStream *out, GCancellable *cancellable, GFileProgressCallback progress_callback, gpointer progress_callback_data, GError **error) { int buffer[2] = { -1, -1 }; int buffer_size; gboolean res; goffset total_size; loff_t offset_in; loff_t offset_out; int fd_in, fd_out; fd_in = g_file_descriptor_based_get_fd (G_FILE_DESCRIPTOR_BASED (in)); fd_out = g_file_descriptor_based_get_fd (G_FILE_DESCRIPTOR_BASED (out)); if (!g_unix_open_pipe (buffer, O_CLOEXEC, error)) return FALSE; /* Try a 1MiB buffer for improved throughput. If that fails, use the default * pipe size. See: https://bugzilla.gnome.org/791457 */ buffer_size = fcntl (buffer[1], F_SETPIPE_SZ, 1024 * 1024); if (buffer_size <= 0) { buffer_size = fcntl (buffer[1], F_GETPIPE_SZ); if (buffer_size <= 0) { /* If #F_GETPIPE_SZ isn’t available, assume we’re on Linux < 2.6.35, * but ≥ 2.6.11, meaning the pipe capacity is 64KiB. Ignore the * possibility of running on Linux < 2.6.11 (where the capacity was * the system page size, typically 4KiB) because it’s ancient. * See pipe(7). */ buffer_size = 1024 * 64; } } g_assert (buffer_size > 0); total_size = -1; /* avoid performance impact of querying total size when it's not needed */ if (progress_callback) { g_assert (g_file_info_has_attribute (in_info, G_FILE_ATTRIBUTE_STANDARD_SIZE)); total_size = g_file_info_get_size (in_info); } if (total_size == -1) total_size = 0; offset_in = offset_out = 0; res = FALSE; while (TRUE) { long n_read; long n_written; if (g_cancellable_set_error_if_cancelled (cancellable, error)) break; if (!do_splice (fd_in, &offset_in, buffer[1], NULL, buffer_size, &n_read, error)) break; if (n_read == 0) { res = TRUE; break; } while (n_read > 0) { if (g_cancellable_set_error_if_cancelled (cancellable, error)) goto out; if (!do_splice (buffer[0], NULL, fd_out, &offset_out, n_read, &n_written, error)) goto out; n_read -= n_written; } if (progress_callback) progress_callback (offset_in, total_size, progress_callback_data); } /* Make sure we send full copied size */ if (progress_callback) progress_callback (offset_in, total_size, progress_callback_data); if (!g_close (buffer[0], error)) goto out; buffer[0] = -1; if (!g_close (buffer[1], error)) goto out; buffer[1] = -1; out: if (buffer[0] != -1) (void) g_close (buffer[0], NULL); if (buffer[1] != -1) (void) g_close (buffer[1], NULL); return res; } #endif #ifdef __linux__ static gboolean btrfs_reflink_with_progress (GInputStream *in, GFileInfo *in_info, GOutputStream *out, GFileInfo *info, GCancellable *cancellable, GFileProgressCallback progress_callback, gpointer progress_callback_data, GError **error) { goffset total_size; int fd_in, fd_out; int ret, errsv; fd_in = g_file_descriptor_based_get_fd (G_FILE_DESCRIPTOR_BASED (in)); fd_out = g_file_descriptor_based_get_fd (G_FILE_DESCRIPTOR_BASED (out)); total_size = -1; /* avoid performance impact of querying total size when it's not needed */ if (progress_callback) { g_assert (g_file_info_has_attribute (in_info, G_FILE_ATTRIBUTE_STANDARD_SIZE)); total_size = g_file_info_get_size (in_info); } if (total_size == -1) total_size = 0; /* Btrfs clone ioctl properties: * - Works at the inode level * - Doesn't work with directories * - Always follows symlinks (source and destination) * * By the time we get here, *in and *out are both regular files */ ret = ioctl (fd_out, BTRFS_IOC_CLONE, fd_in); errsv = errno; if (ret < 0) { if (errsv == EXDEV) g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Copy (reflink/clone) between mounts is not supported")); else if (errsv == EINVAL) g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Copy (reflink/clone) is not supported or invalid")); else /* Most probably something odd happened; retry with fallback */ g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Copy (reflink/clone) is not supported or didn’t work")); /* We retry with fallback for all error cases because Btrfs is currently * unstable, and so we can't trust it to do clone properly. * In addition, any hard errors here would cause the same failure in the * fallback manual copy as well. */ return FALSE; } /* Make sure we send full copied size */ if (progress_callback) progress_callback (total_size, total_size, progress_callback_data); return TRUE; } #endif static gboolean file_copy_fallback (GFile *source, GFile *destination, GFileCopyFlags flags, GCancellable *cancellable, GFileProgressCallback progress_callback, gpointer progress_callback_data, GError **error) { gboolean ret = FALSE; GFileInputStream *file_in = NULL; GInputStream *in = NULL; GOutputStream *out = NULL; GFileInfo *info = NULL; const char *target; char *attrs_to_read; gboolean do_set_attributes = FALSE; GFileCreateFlags create_flags; GError *tmp_error = NULL; /* need to know the file type */ info = g_file_query_info (source, G_FILE_ATTRIBUTE_STANDARD_TYPE "," G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET, G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS, cancellable, error); if (!info) goto out; if (!g_file_info_has_attribute (info, G_FILE_ATTRIBUTE_STANDARD_TYPE)) { g_set_error (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Cannot retrieve attribute %s"), G_FILE_ATTRIBUTE_STANDARD_TYPE); goto out; } /* Maybe copy the symlink? */ if ((flags & G_FILE_COPY_NOFOLLOW_SYMLINKS) && g_file_info_get_file_type (info) == G_FILE_TYPE_SYMBOLIC_LINK) { if (!g_file_info_has_attribute (info, G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET)) { g_set_error (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Cannot retrieve attribute %s"), G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET); goto out; } target = g_file_info_get_symlink_target (info); if (target) { if (!copy_symlink (destination, flags, cancellable, target, error)) goto out; ret = TRUE; goto out; } /* ... else fall back on a regular file copy */ } /* Handle "special" files (pipes, device nodes, ...)? */ else if (g_file_info_get_file_type (info) == G_FILE_TYPE_SPECIAL) { /* FIXME: could try to recreate device nodes and others? */ g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Can’t copy special file")); goto out; } /* Everything else should just fall back on a regular copy. */ file_in = open_source_for_copy (source, destination, flags, cancellable, error); if (!file_in) goto out; in = G_INPUT_STREAM (file_in); attrs_to_read = g_file_build_attribute_list_for_copy (destination, flags, cancellable, error); if (!attrs_to_read) goto out; /* Ok, ditch the previous lightweight info (on Unix we just * called lstat()); at this point we gather all the information * we need about the source from the opened file descriptor. */ g_object_unref (info); info = g_file_input_stream_query_info (file_in, attrs_to_read, cancellable, &tmp_error); if (!info) { /* Not all gvfs backends implement query_info_on_read(), we * can just fall back to the pathname again. * https://bugzilla.gnome.org/706254 */ if (g_error_matches (tmp_error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED)) { g_clear_error (&tmp_error); info = g_file_query_info (source, attrs_to_read, G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS, cancellable, error); } else { g_free (attrs_to_read); g_propagate_error (error, tmp_error); goto out; } } g_free (attrs_to_read); if (!info) goto out; do_set_attributes = TRUE; /* In the local file path, we pass down the source info which * includes things like unix::mode, to ensure that the target file * is not created with different permissions from the source file. * * If a future API like g_file_replace_with_info() is added, switch * this code to use that. * * Use %G_FILE_CREATE_PRIVATE unless * - we were told to create the file with default permissions (i.e. the * process’ umask), * - or if the source file is on a file system which doesn’t support * `unix::mode` (in which case it probably also makes sense to create the * destination with default permissions because the source cannot be * private), * - or if the destination file is a `GLocalFile`, in which case we can * directly open() it with the permissions from the source file. */ create_flags = G_FILE_CREATE_NONE; if (!(flags & G_FILE_COPY_TARGET_DEFAULT_PERMS) && g_file_info_has_attribute (info, G_FILE_ATTRIBUTE_UNIX_MODE) && !G_IS_LOCAL_FILE (destination)) create_flags |= G_FILE_CREATE_PRIVATE; if (flags & G_FILE_COPY_OVERWRITE) create_flags |= G_FILE_CREATE_REPLACE_DESTINATION; if (G_IS_LOCAL_FILE (destination)) { if (flags & G_FILE_COPY_OVERWRITE) out = (GOutputStream*)_g_local_file_output_stream_replace (_g_local_file_get_filename (G_LOCAL_FILE (destination)), FALSE, NULL, flags & G_FILE_COPY_BACKUP, create_flags, (flags & G_FILE_COPY_TARGET_DEFAULT_PERMS) ? NULL : info, cancellable, error); else out = (GOutputStream*)_g_local_file_output_stream_create (_g_local_file_get_filename (G_LOCAL_FILE (destination)), FALSE, create_flags, (flags & G_FILE_COPY_TARGET_DEFAULT_PERMS) ? NULL : info, cancellable, error); } else if (flags & G_FILE_COPY_OVERWRITE) { out = (GOutputStream *)g_file_replace (destination, NULL, flags & G_FILE_COPY_BACKUP, create_flags, cancellable, error); } else { out = (GOutputStream *)g_file_create (destination, create_flags, cancellable, error); } if (!out) goto out; #ifdef __linux__ if (G_IS_FILE_DESCRIPTOR_BASED (in) && G_IS_FILE_DESCRIPTOR_BASED (out)) { GError *reflink_err = NULL; if (!btrfs_reflink_with_progress (in, info, out, info, cancellable, progress_callback, progress_callback_data, &reflink_err)) { if (g_error_matches (reflink_err, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED)) { g_clear_error (&reflink_err); } else { g_propagate_error (error, reflink_err); goto out; } } else { ret = TRUE; goto out; } } #endif #ifdef HAVE_COPY_FILE_RANGE if (G_IS_FILE_DESCRIPTOR_BASED (in) && G_IS_FILE_DESCRIPTOR_BASED (out)) { GError *copy_file_range_error = NULL; if (copy_file_range_with_progress (in, info, out, cancellable, progress_callback, progress_callback_data, ©_file_range_error)) { ret = TRUE; goto out; } else if (!g_error_matches (copy_file_range_error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED)) { g_propagate_error (error, g_steal_pointer (©_file_range_error)); goto out; } else { g_clear_error (©_file_range_error); } } #endif /* HAVE_COPY_FILE_RANGE */ #ifdef HAVE_SPLICE if (G_IS_FILE_DESCRIPTOR_BASED (in) && G_IS_FILE_DESCRIPTOR_BASED (out)) { GError *splice_err = NULL; if (!splice_stream_with_progress (in, info, out, cancellable, progress_callback, progress_callback_data, &splice_err)) { if (g_error_matches (splice_err, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED)) { g_clear_error (&splice_err); } else { g_propagate_error (error, splice_err); goto out; } } else { ret = TRUE; goto out; } } #endif /* A plain read/write loop */ if (!copy_stream_with_progress (in, out, source, cancellable, progress_callback, progress_callback_data, error)) goto out; ret = TRUE; out: if (in) { /* Don't care about errors in source here */ (void) g_input_stream_close (in, cancellable, NULL); g_object_unref (in); } if (out) { /* But write errors on close are bad! */ if (!g_output_stream_close (out, cancellable, ret ? error : NULL)) ret = FALSE; g_object_unref (out); } /* Ignore errors here. Failure to copy metadata is not a hard error */ /* TODO: set these attributes /before/ we do the rename() on Unix */ if (ret && do_set_attributes) { g_file_set_attributes_from_info (destination, info, G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS, cancellable, NULL); } g_clear_object (&info); return ret; } /** * g_file_copy: * @source: input #GFile * @destination: destination #GFile * @flags: set of #GFileCopyFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @progress_callback: (nullable) (scope call) (closure progress_callback_data): function to callback with * progress information, or %NULL if progress information is not needed * @progress_callback_data: user data to pass to @progress_callback * @error: #GError to set on error, or %NULL * * Copies the file @source to the location specified by @destination. * Can not handle recursive copies of directories. * * If the flag %G_FILE_COPY_OVERWRITE is specified an already * existing @destination file is overwritten. * * If the flag %G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks * will be copied as symlinks, otherwise the target of the * @source symlink will be copied. * * If the flag %G_FILE_COPY_ALL_METADATA is specified then all the metadata * that is possible to copy is copied, not just the default subset (which, * for instance, does not include the owner, see #GFileInfo). * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * If @progress_callback is not %NULL, then the operation can be monitored * by setting this to a #GFileProgressCallback function. * @progress_callback_data will be passed to this function. It is guaranteed * that this callback will be called after all data has been transferred with * the total number of bytes copied during the operation. * * If the @source file does not exist, then the %G_IO_ERROR_NOT_FOUND error * is returned, independent on the status of the @destination. * * If %G_FILE_COPY_OVERWRITE is not specified and the target exists, then * the error %G_IO_ERROR_EXISTS is returned. * * If trying to overwrite a file over a directory, the %G_IO_ERROR_IS_DIRECTORY * error is returned. If trying to overwrite a directory with a directory the * %G_IO_ERROR_WOULD_MERGE error is returned. * * If the source is a directory and the target does not exist, or * %G_FILE_COPY_OVERWRITE is specified and the target is a file, then the * %G_IO_ERROR_WOULD_RECURSE error is returned. * * If you are interested in copying the #GFile object itself (not the on-disk * file), see g_file_dup(). * * Returns: %TRUE on success, %FALSE otherwise. */ gboolean g_file_copy (GFile *source, GFile *destination, GFileCopyFlags flags, GCancellable *cancellable, GFileProgressCallback progress_callback, gpointer progress_callback_data, GError **error) { GFileIface *iface; GError *my_error; gboolean res; g_return_val_if_fail (G_IS_FILE (source), FALSE); g_return_val_if_fail (G_IS_FILE (destination), FALSE); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return FALSE; iface = G_FILE_GET_IFACE (destination); if (iface->copy) { my_error = NULL; res = (* iface->copy) (source, destination, flags, cancellable, progress_callback, progress_callback_data, &my_error); if (res) return TRUE; if (my_error->domain != G_IO_ERROR || my_error->code != G_IO_ERROR_NOT_SUPPORTED) { g_propagate_error (error, my_error); return FALSE; } else g_clear_error (&my_error); } /* If the types are different, and the destination method failed * also try the source method */ if (G_OBJECT_TYPE (source) != G_OBJECT_TYPE (destination)) { iface = G_FILE_GET_IFACE (source); if (iface->copy) { my_error = NULL; res = (* iface->copy) (source, destination, flags, cancellable, progress_callback, progress_callback_data, &my_error); if (res) return TRUE; if (my_error->domain != G_IO_ERROR || my_error->code != G_IO_ERROR_NOT_SUPPORTED) { g_propagate_error (error, my_error); return FALSE; } else g_clear_error (&my_error); } } return file_copy_fallback (source, destination, flags, cancellable, progress_callback, progress_callback_data, error); } /** * g_file_copy_async: * @source: input #GFile * @destination: destination #GFile * @flags: set of #GFileCopyFlags * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @progress_callback: (nullable) (scope notified) (closure progress_callback_data): * function to callback with progress information, or %NULL if * progress information is not needed * @progress_callback_data: user data to pass to @progress_callback * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback * * Copies the file @source to the location specified by @destination * asynchronously. For details of the behaviour, see g_file_copy(). * * If @progress_callback is not %NULL, then that function that will be called * just like in g_file_copy(). The callback will run in the default main context * of the thread calling g_file_copy_async() — the same context as @callback is * run in. * * When the operation is finished, @callback will be called. You can then call * g_file_copy_finish() to get the result of the operation. */ void g_file_copy_async (GFile *source, GFile *destination, GFileCopyFlags flags, int io_priority, GCancellable *cancellable, GFileProgressCallback progress_callback, gpointer progress_callback_data, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (source)); g_return_if_fail (G_IS_FILE (destination)); iface = G_FILE_GET_IFACE (source); (* iface->copy_async) (source, destination, flags, io_priority, cancellable, progress_callback, progress_callback_data, callback, user_data); } typedef struct _CopyAsyncClosuresData { GClosure *progress_callback_closure; GClosure *ready_callback_closure; } CopyAsyncClosuresData; static CopyAsyncClosuresData * copy_async_closures_data_new (GClosure *progress_callback_closure, GClosure *ready_callback_closure) { CopyAsyncClosuresData *data; data = g_new0 (CopyAsyncClosuresData, 1); if (progress_callback_closure != NULL) { data->progress_callback_closure = g_closure_ref (progress_callback_closure); g_closure_sink (progress_callback_closure); if (G_CLOSURE_NEEDS_MARSHAL (progress_callback_closure)) g_closure_set_marshal (progress_callback_closure, g_cclosure_marshal_generic); } data->ready_callback_closure = g_closure_ref (ready_callback_closure); g_closure_sink (ready_callback_closure); if (G_CLOSURE_NEEDS_MARSHAL (ready_callback_closure)) g_closure_set_marshal (ready_callback_closure, g_cclosure_marshal_generic); return data; } static void copy_async_closures_data_free (CopyAsyncClosuresData *data) { if (data->progress_callback_closure != NULL) g_closure_unref (data->progress_callback_closure); g_closure_unref (data->ready_callback_closure); g_free (data); } static void copy_async_invoke_progress (goffset current_num_bytes, goffset total_num_bytes, void *user_data) { CopyAsyncClosuresData *data = (CopyAsyncClosuresData *) user_data; GValue params[2] = { G_VALUE_INIT, G_VALUE_INIT }; /* goffset is 64-bits even on 32-bits platforms */ g_value_init (¶ms[0], G_TYPE_INT64); g_value_set_int64 (¶ms[0], current_num_bytes); g_value_init (¶ms[1], G_TYPE_INT64); g_value_set_int64 (¶ms[1], total_num_bytes); g_closure_invoke (data->progress_callback_closure, /* result = */ NULL, 2, params, /* hint = */ NULL); g_value_unset (¶ms[0]); g_value_unset (¶ms[1]); } static void copy_async_invoke_ready (GObject *file, GAsyncResult *result, void *user_data) { CopyAsyncClosuresData *data = (CopyAsyncClosuresData *) user_data; GValue params[2] = { G_VALUE_INIT, G_VALUE_INIT }; g_value_init (¶ms[0], G_TYPE_FILE); g_value_set_object (¶ms[0], file); g_value_init (¶ms[1], G_TYPE_ASYNC_RESULT); g_value_set_object (¶ms[1], result); g_closure_invoke (data->ready_callback_closure, /* result = */ NULL, 2, params, /* hint = */ NULL); copy_async_closures_data_free (data); g_value_unset (¶ms[0]); g_value_unset (¶ms[1]); } /** * g_file_copy_async_with_closures: (rename-to g_file_copy_async) (finish-func copy_finish): * @source: input [type@Gio.File] * @destination: destination [type@Gio.File] * @flags: set of [flags@Gio.FileCopyFlags] * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional [class@Gio.Cancellable] object, * `NULL` to ignore * @progress_callback_closure: (nullable): [type@GObject.Closure] to invoke with progress * information, or `NULL` if progress information is not needed * @ready_callback_closure: (not nullable): [type@GObject.Closure] to invoke when the request is satisfied * * Version of [method@Gio.File.copy_async] using closures instead of callbacks for * easier binding in other languages. * * Since: 2.82 */ void g_file_copy_async_with_closures (GFile *source, GFile *destination, GFileCopyFlags flags, int io_priority, GCancellable *cancellable, GClosure *progress_callback_closure, GClosure *ready_callback_closure) { CopyAsyncClosuresData *data; /* freed in copy_async_invoke_ready */ data = copy_async_closures_data_new (progress_callback_closure, ready_callback_closure); g_file_copy_async (source, destination, flags, io_priority, cancellable, progress_callback_closure == NULL ? NULL : copy_async_invoke_progress, data, copy_async_invoke_ready, data); } /** * g_file_copy_finish: * @file: input #GFile * @res: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes copying the file started with g_file_copy_async(). * * Returns: a %TRUE on success, %FALSE on error. */ gboolean g_file_copy_finish (GFile *file, GAsyncResult *res, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (G_IS_ASYNC_RESULT (res), FALSE); if (g_async_result_legacy_propagate_error (res, error)) return FALSE; iface = G_FILE_GET_IFACE (file); return (* iface->copy_finish) (file, res, error); } /** * g_file_move: * @source: #GFile pointing to the source location * @destination: #GFile pointing to the destination location * @flags: set of #GFileCopyFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @progress_callback: (nullable) (scope call) (closure progress_callback_data): #GFileProgressCallback * function for updates * @progress_callback_data: gpointer to user data for * the callback function * @error: #GError for returning error conditions, or %NULL * * Tries to move the file or directory @source to the location specified * by @destination. If native move operations are supported then this is * used, otherwise a copy + delete fallback is used. The native * implementation may support moving directories (for instance on moves * inside the same filesystem), but the fallback code does not. * * If the flag %G_FILE_COPY_OVERWRITE is specified an already * existing @destination file is overwritten. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * If @progress_callback is not %NULL, then the operation can be monitored * by setting this to a #GFileProgressCallback function. * @progress_callback_data will be passed to this function. It is * guaranteed that this callback will be called after all data has been * transferred with the total number of bytes copied during the operation. * * If the @source file does not exist, then the %G_IO_ERROR_NOT_FOUND * error is returned, independent on the status of the @destination. * * If %G_FILE_COPY_OVERWRITE is not specified and the target exists, * then the error %G_IO_ERROR_EXISTS is returned. * * If trying to overwrite a file over a directory, the %G_IO_ERROR_IS_DIRECTORY * error is returned. If trying to overwrite a directory with a directory the * %G_IO_ERROR_WOULD_MERGE error is returned. * * If the source is a directory and the target does not exist, or * %G_FILE_COPY_OVERWRITE is specified and the target is a file, then * the %G_IO_ERROR_WOULD_RECURSE error may be returned (if the native * move operation isn't available). * * Returns: %TRUE on successful move, %FALSE otherwise. */ gboolean g_file_move (GFile *source, GFile *destination, GFileCopyFlags flags, GCancellable *cancellable, GFileProgressCallback progress_callback, gpointer progress_callback_data, GError **error) { GFileIface *iface; GError *my_error; gboolean res; g_return_val_if_fail (G_IS_FILE (source), FALSE); g_return_val_if_fail (G_IS_FILE (destination), FALSE); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return FALSE; iface = G_FILE_GET_IFACE (destination); if (iface->move) { my_error = NULL; res = (* iface->move) (source, destination, flags, cancellable, progress_callback, progress_callback_data, &my_error); if (res) return TRUE; if (my_error->domain != G_IO_ERROR || my_error->code != G_IO_ERROR_NOT_SUPPORTED) { g_propagate_error (error, my_error); return FALSE; } else g_clear_error (&my_error); } /* If the types are different, and the destination method failed * also try the source method */ if (G_OBJECT_TYPE (source) != G_OBJECT_TYPE (destination)) { iface = G_FILE_GET_IFACE (source); if (iface->move) { my_error = NULL; res = (* iface->move) (source, destination, flags, cancellable, progress_callback, progress_callback_data, &my_error); if (res) return TRUE; if (my_error->domain != G_IO_ERROR || my_error->code != G_IO_ERROR_NOT_SUPPORTED) { g_propagate_error (error, my_error); return FALSE; } else g_clear_error (&my_error); } } if (flags & G_FILE_COPY_NO_FALLBACK_FOR_MOVE) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return FALSE; } flags |= G_FILE_COPY_ALL_METADATA | G_FILE_COPY_NOFOLLOW_SYMLINKS; if (!g_file_copy (source, destination, flags, cancellable, progress_callback, progress_callback_data, error)) return FALSE; return g_file_delete (source, cancellable, error); } /** * g_file_move_async: * @source: #GFile pointing to the source location * @destination: #GFile pointing to the destination location * @flags: set of #GFileCopyFlags * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @progress_callback: (nullable) (scope call) (closure progress_callback_data): * #GFileProgressCallback function for updates * @progress_callback_data: gpointer to user data for the callback function * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously moves a file @source to the location of @destination. For details of the behaviour, see g_file_move(). * * If @progress_callback is not %NULL, then that function that will be called * just like in g_file_move(). The callback will run in the default main context * of the thread calling g_file_move_async() — the same context as @callback is * run in. * * When the operation is finished, @callback will be called. You can then call * g_file_move_finish() to get the result of the operation. * * Since: 2.72 */ void g_file_move_async (GFile *source, GFile *destination, GFileCopyFlags flags, int io_priority, GCancellable *cancellable, GFileProgressCallback progress_callback, gpointer progress_callback_data, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (source)); g_return_if_fail (G_IS_FILE (destination)); g_return_if_fail (cancellable == NULL || G_IS_CANCELLABLE (cancellable)); iface = G_FILE_GET_IFACE (source); (* iface->move_async) (source, destination, flags, io_priority, cancellable, progress_callback, progress_callback_data, callback, user_data); } /** * g_file_move_async_with_closures: (rename-to g_file_move_async) (finish-func move_finish): * @source: input [type@Gio.File] * @destination: destination [type@Gio.File] * @flags: set of [flags@Gio.FileCopyFlags] * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional [class@Gio.Cancellable] object, * `NULL` to ignore * @progress_callback_closure: (nullable): [type@GObject.Closure] to invoke with progress * information, or `NULL` if progress information is not needed * @ready_callback_closure: (not nullable): [type@GObject.Closure] to invoke when the request is satisfied * * Version of [method@Gio.File.move_async] using closures instead of callbacks for * easier binding in other languages. * * Since: 2.82 */ void g_file_move_async_with_closures (GFile *source, GFile *destination, GFileCopyFlags flags, int io_priority, GCancellable *cancellable, GClosure *progress_callback_closure, GClosure *ready_callback_closure) { CopyAsyncClosuresData *data; /* freed in copy_async_invoke_ready */ data = copy_async_closures_data_new (progress_callback_closure, ready_callback_closure); g_file_move_async (source, destination, flags, io_priority, cancellable, progress_callback_closure == NULL ? NULL : copy_async_invoke_progress, data, copy_async_invoke_ready, data); } /** * g_file_move_finish: * @file: input source #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes an asynchronous file movement, started with * g_file_move_async(). * * Returns: %TRUE on successful file move, %FALSE otherwise. * * Since: 2.72 */ gboolean g_file_move_finish (GFile *file, GAsyncResult *result, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE); g_return_val_if_fail (error == NULL || *error == NULL, FALSE); iface = G_FILE_GET_IFACE (file); return (* iface->move_finish) (file, result, error); } /** * g_file_make_directory: * @file: input #GFile * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Creates a directory. Note that this will only create a child directory * of the immediate parent directory of the path or URI given by the #GFile. * To recursively create directories, see g_file_make_directory_with_parents(). * This function will fail if the parent directory does not exist, setting * @error to %G_IO_ERROR_NOT_FOUND. If the file system doesn't support * creating directories, this function will fail, setting @error to * %G_IO_ERROR_NOT_SUPPORTED. * * For a local #GFile the newly created directory will have the default * (current) ownership and permissions of the current process. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: %TRUE on successful creation, %FALSE otherwise. */ gboolean g_file_make_directory (GFile *file, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return FALSE; iface = G_FILE_GET_IFACE (file); if (iface->make_directory == NULL) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return FALSE; } return (* iface->make_directory) (file, cancellable, error); } /** * g_file_make_directory_async: (virtual make_directory_async) * @file: input #GFile * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: a #GAsyncReadyCallback to call * when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously creates a directory. * * Since: 2.38 */ void g_file_make_directory_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); (* iface->make_directory_async) (file, io_priority, cancellable, callback, user_data); } /** * g_file_make_directory_finish: (virtual make_directory_finish) * @file: input #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes an asynchronous directory creation, started with * g_file_make_directory_async(). * * Returns: %TRUE on successful directory creation, %FALSE otherwise. * Since: 2.38 */ gboolean g_file_make_directory_finish (GFile *file, GAsyncResult *result, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE); iface = G_FILE_GET_IFACE (file); return (* iface->make_directory_finish) (file, result, error); } /** * g_file_make_directory_with_parents: * @file: input #GFile * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Creates a directory and any parent directories that may not * exist similar to 'mkdir -p'. If the file system does not support * creating directories, this function will fail, setting @error to * %G_IO_ERROR_NOT_SUPPORTED. If the directory itself already exists, * this function will fail setting @error to %G_IO_ERROR_EXISTS, unlike * the similar g_mkdir_with_parents(). * * For a local #GFile the newly created directories will have the default * (current) ownership and permissions of the current process. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: %TRUE if all directories have been successfully created, %FALSE * otherwise. * * Since: 2.18 */ gboolean g_file_make_directory_with_parents (GFile *file, GCancellable *cancellable, GError **error) { GFile *work_file = NULL; GList *list = NULL, *l; GError *my_error = NULL; g_return_val_if_fail (G_IS_FILE (file), FALSE); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return FALSE; /* Try for the simple case of not having to create any parent * directories. If any parent directory needs to be created, this * call will fail with NOT_FOUND. If that happens, then that value of * my_error persists into the while loop below. */ g_file_make_directory (file, cancellable, &my_error); if (!g_error_matches (my_error, G_IO_ERROR, G_IO_ERROR_NOT_FOUND)) { if (my_error) g_propagate_error (error, my_error); return my_error == NULL; } work_file = g_object_ref (file); /* Creates the parent directories as needed. In case any particular * creation operation fails for lack of other parent directories * (NOT_FOUND), the directory is added to a list of directories to * create later, and the value of my_error is retained until the next * iteration of the loop. After the loop my_error should either be * empty or contain a real failure condition. */ while (g_error_matches (my_error, G_IO_ERROR, G_IO_ERROR_NOT_FOUND)) { GFile *parent_file; parent_file = g_file_get_parent (work_file); if (parent_file == NULL) break; g_clear_error (&my_error); g_file_make_directory (parent_file, cancellable, &my_error); /* Another process may have created the directory in between the * G_IO_ERROR_NOT_FOUND and now */ if (g_error_matches (my_error, G_IO_ERROR, G_IO_ERROR_EXISTS)) g_clear_error (&my_error); g_object_unref (work_file); work_file = g_object_ref (parent_file); if (g_error_matches (my_error, G_IO_ERROR, G_IO_ERROR_NOT_FOUND)) list = g_list_prepend (list, parent_file); /* Transfer ownership of ref */ else g_object_unref (parent_file); } /* All directories should be able to be created now, so an error at * this point means the whole operation must fail -- except an EXISTS * error, which means that another process already created the * directory in between the previous failure and now. */ for (l = list; my_error == NULL && l; l = l->next) { g_file_make_directory ((GFile *) l->data, cancellable, &my_error); if (g_error_matches (my_error, G_IO_ERROR, G_IO_ERROR_EXISTS)) g_clear_error (&my_error); } if (work_file) g_object_unref (work_file); /* Clean up */ while (list != NULL) { g_object_unref ((GFile *) list->data); list = g_list_remove (list, list->data); } /* At this point an error in my_error means a that something * unexpected failed in either of the loops above, so the whole * operation must fail. */ if (my_error != NULL) { g_propagate_error (error, my_error); return FALSE; } return g_file_make_directory (file, cancellable, error); } /** * g_file_make_symbolic_link: * @file: a #GFile with the name of the symlink to create * @symlink_value: (type filename): a string with the path for the target * of the new symlink * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError * * Creates a symbolic link named @file which contains the string * @symlink_value. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: %TRUE on the creation of a new symlink, %FALSE otherwise. */ gboolean g_file_make_symbolic_link (GFile *file, const char *symlink_value, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (symlink_value != NULL, FALSE); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return FALSE; if (*symlink_value == '\0') { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_INVALID_ARGUMENT, _("Invalid symlink value given")); return FALSE; } iface = G_FILE_GET_IFACE (file); if (iface->make_symbolic_link == NULL) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Symbolic links not supported")); return FALSE; } return (* iface->make_symbolic_link) (file, symlink_value, cancellable, error); } static void make_symbolic_link_async_thread (GTask *task, gpointer object, gpointer task_data, GCancellable *cancellable) { const char *symlink_value = task_data; GError *error = NULL; if (g_file_make_symbolic_link (G_FILE (object), symlink_value, cancellable, &error)) g_task_return_boolean (task, TRUE); else g_task_return_error (task, g_steal_pointer (&error)); } static void g_file_real_make_symbolic_link_async (GFile *file, const char *symlink_value, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; g_return_if_fail (G_IS_FILE (file)); g_return_if_fail (symlink_value != NULL); g_return_if_fail (cancellable == NULL || G_IS_CANCELLABLE (cancellable)); task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_make_symbolic_link_async); g_task_set_task_data (task, g_strdup (symlink_value), g_free); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, make_symbolic_link_async_thread); g_object_unref (task); } /** * g_file_make_symbolic_link_async: (virtual make_symbolic_link_async) * @file: a #GFile with the name of the symlink to create * @symlink_value: (type filename): a string with the path for the target * of the new symlink * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: a #GAsyncReadyCallback to call * when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously creates a symbolic link named @file which contains the * string @symlink_value. * * Since: 2.74 */ void g_file_make_symbolic_link_async (GFile *file, const char *symlink_value, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); g_return_if_fail (symlink_value != NULL); g_return_if_fail (cancellable == NULL || G_IS_CANCELLABLE (cancellable)); iface = G_FILE_GET_IFACE (file); /* Default implementation should always be provided by GFileIface */ g_assert (iface->make_symbolic_link_async != NULL); (* iface->make_symbolic_link_async) (file, symlink_value, io_priority, cancellable, callback, user_data); } static gboolean g_file_real_make_symbolic_link_finish (GFile *file, GAsyncResult *result, GError **error) { g_return_val_if_fail (g_task_is_valid (result, file), FALSE); return g_task_propagate_boolean (G_TASK (result), error); } /** * g_file_make_symbolic_link_finish: (virtual make_symbolic_link_finish) * @file: input #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes an asynchronous symbolic link creation, started with * g_file_make_symbolic_link_async(). * * Returns: %TRUE on successful directory creation, %FALSE otherwise. * Since: 2.74 */ gboolean g_file_make_symbolic_link_finish (GFile *file, GAsyncResult *result, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (error == NULL || *error == NULL, FALSE); iface = G_FILE_GET_IFACE (file); /* Default implementation should always be provided by GFileIface */ g_assert (iface->make_symbolic_link_finish != NULL); return (* iface->make_symbolic_link_finish) (file, result, error); } /** * g_file_delete: (virtual delete_file) * @file: input #GFile * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Deletes a file. If the @file is a directory, it will only be * deleted if it is empty. This has the same semantics as g_unlink(). * * If @file doesn’t exist, %G_IO_ERROR_NOT_FOUND will be returned. This allows * for deletion to be implemented avoiding * [time-of-check to time-of-use races](https://en.wikipedia.org/wiki/Time-of-check_to_time-of-use): * |[ * g_autoptr(GError) local_error = NULL; * if (!g_file_delete (my_file, my_cancellable, &local_error) && * !g_error_matches (local_error, G_IO_ERROR, G_IO_ERROR_NOT_FOUND)) * { * // deletion failed for some reason other than the file not existing: * // so report the error * g_warning ("Failed to delete %s: %s", * g_file_peek_path (my_file), local_error->message); * } * ]| * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: %TRUE if the file was deleted. %FALSE otherwise. */ gboolean g_file_delete (GFile *file, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return FALSE; iface = G_FILE_GET_IFACE (file); if (iface->delete_file == NULL) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return FALSE; } return (* iface->delete_file) (file, cancellable, error); } /** * g_file_delete_async: (virtual delete_file_async) * @file: input #GFile * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: a #GAsyncReadyCallback to call * when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously delete a file. If the @file is a directory, it will * only be deleted if it is empty. This has the same semantics as * g_unlink(). * * Since: 2.34 */ void g_file_delete_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); (* iface->delete_file_async) (file, io_priority, cancellable, callback, user_data); } /** * g_file_delete_finish: (virtual delete_file_finish) * @file: input #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes deleting a file started with g_file_delete_async(). * * Returns: %TRUE if the file was deleted. %FALSE otherwise. * Since: 2.34 **/ gboolean g_file_delete_finish (GFile *file, GAsyncResult *result, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE); if (g_async_result_legacy_propagate_error (result, error)) return FALSE; iface = G_FILE_GET_IFACE (file); return (* iface->delete_file_finish) (file, result, error); } /** * g_file_trash: (virtual trash) * @file: #GFile to send to trash * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Sends @file to the "Trashcan", if possible. This is similar to * deleting it, but the user can recover it before emptying the trashcan. * Trashing is disabled for system mounts by default (see * g_unix_mount_is_system_internal()), so this call can return the * %G_IO_ERROR_NOT_SUPPORTED error. Since GLib 2.66, the `x-gvfs-notrash` unix * mount option can be used to disable g_file_trash() support for particular * mounts, the %G_IO_ERROR_NOT_SUPPORTED error will be returned in that case. * Since 2.82, the `x-gvfs-trash` unix mount option can be used to enable * g_file_trash() support for particular system mounts. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: %TRUE on successful trash, %FALSE otherwise. */ gboolean g_file_trash (GFile *file, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return FALSE; iface = G_FILE_GET_IFACE (file); if (iface->trash == NULL) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Trash not supported")); return FALSE; } return (* iface->trash) (file, cancellable, error); } /** * g_file_trash_async: (virtual trash_async) * @file: input #GFile * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: a #GAsyncReadyCallback to call * when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously sends @file to the Trash location, if possible. * * Since: 2.38 */ void g_file_trash_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); (* iface->trash_async) (file, io_priority, cancellable, callback, user_data); } /** * g_file_trash_finish: (virtual trash_finish) * @file: input #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes an asynchronous file trashing operation, started with * g_file_trash_async(). * * Returns: %TRUE on successful trash, %FALSE otherwise. * Since: 2.38 */ gboolean g_file_trash_finish (GFile *file, GAsyncResult *result, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE); iface = G_FILE_GET_IFACE (file); return (* iface->trash_finish) (file, result, error); } /** * g_file_set_display_name: * @file: input #GFile * @display_name: a string * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Renames @file to the specified display name. * * The display name is converted from UTF-8 to the correct encoding * for the target filesystem if possible and the @file is renamed to this. * * If you want to implement a rename operation in the user interface the * edit name (%G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME) should be used as the * initial value in the rename widget, and then the result after editing * should be passed to g_file_set_display_name(). * * On success the resulting converted filename is returned. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: (transfer full): a #GFile specifying what @file was renamed to, * or %NULL if there was an error. * Free the returned object with g_object_unref(). */ GFile * g_file_set_display_name (GFile *file, const gchar *display_name, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (display_name != NULL, NULL); if (strchr (display_name, G_DIR_SEPARATOR) != NULL) { g_set_error (error, G_IO_ERROR, G_IO_ERROR_INVALID_ARGUMENT, _("File names cannot contain “%c”"), G_DIR_SEPARATOR); return NULL; } if (g_cancellable_set_error_if_cancelled (cancellable, error)) return NULL; iface = G_FILE_GET_IFACE (file); return (* iface->set_display_name) (file, display_name, cancellable, error); } /** * g_file_set_display_name_async: * @file: input #GFile * @display_name: a string * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously sets the display name for a given #GFile. * * For more details, see g_file_set_display_name() which is * the synchronous version of this call. * * When the operation is finished, @callback will be called. * You can then call g_file_set_display_name_finish() to get * the result of the operation. */ void g_file_set_display_name_async (GFile *file, const gchar *display_name, gint io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); g_return_if_fail (display_name != NULL); iface = G_FILE_GET_IFACE (file); (* iface->set_display_name_async) (file, display_name, io_priority, cancellable, callback, user_data); } /** * g_file_set_display_name_finish: * @file: input #GFile * @res: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes setting a display name started with * g_file_set_display_name_async(). * * Returns: (transfer full): a #GFile or %NULL on error. * Free the returned object with g_object_unref(). */ GFile * g_file_set_display_name_finish (GFile *file, GAsyncResult *res, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (G_IS_ASYNC_RESULT (res), NULL); if (g_async_result_legacy_propagate_error (res, error)) return NULL; iface = G_FILE_GET_IFACE (file); return (* iface->set_display_name_finish) (file, res, error); } /** * g_file_query_settable_attributes: * @file: input #GFile * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Obtain the list of settable attributes for the file. * * Returns the type and full attribute name of all the attributes * that can be set on this file. This doesn't mean setting it will * always succeed though, you might get an access failure, or some * specific file may not support a specific attribute. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: (transfer full): a #GFileAttributeInfoList describing the settable attributes. * When you are done with it, release it with * g_file_attribute_info_list_unref() */ GFileAttributeInfoList * g_file_query_settable_attributes (GFile *file, GCancellable *cancellable, GError **error) { GFileIface *iface; GError *my_error; GFileAttributeInfoList *list; g_return_val_if_fail (G_IS_FILE (file), NULL); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return NULL; iface = G_FILE_GET_IFACE (file); if (iface->query_settable_attributes == NULL) return g_file_attribute_info_list_new (); my_error = NULL; list = (* iface->query_settable_attributes) (file, cancellable, &my_error); if (list == NULL) { if (my_error->domain == G_IO_ERROR && my_error->code == G_IO_ERROR_NOT_SUPPORTED) { list = g_file_attribute_info_list_new (); g_error_free (my_error); } else g_propagate_error (error, my_error); } return list; } /** * g_file_query_writable_namespaces: * @file: input #GFile * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Obtain the list of attribute namespaces where new attributes * can be created by a user. An example of this is extended * attributes (in the "xattr" namespace). * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: (transfer full): a #GFileAttributeInfoList describing the writable namespaces. * When you are done with it, release it with * g_file_attribute_info_list_unref() */ GFileAttributeInfoList * g_file_query_writable_namespaces (GFile *file, GCancellable *cancellable, GError **error) { GFileIface *iface; GError *my_error; GFileAttributeInfoList *list; g_return_val_if_fail (G_IS_FILE (file), NULL); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return NULL; iface = G_FILE_GET_IFACE (file); if (iface->query_writable_namespaces == NULL) return g_file_attribute_info_list_new (); my_error = NULL; list = (* iface->query_writable_namespaces) (file, cancellable, &my_error); if (list == NULL) { g_warn_if_reached(); list = g_file_attribute_info_list_new (); } if (my_error != NULL) { if (my_error->domain == G_IO_ERROR && my_error->code == G_IO_ERROR_NOT_SUPPORTED) { g_error_free (my_error); } else g_propagate_error (error, my_error); } return list; } /** * g_file_set_attribute: * @file: input #GFile * @attribute: a string containing the attribute's name * @type: The type of the attribute * @value_p: (nullable): a pointer to the value (or the pointer * itself if the type is a pointer type) * @flags: a set of #GFileQueryInfoFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Sets an attribute in the file with attribute name @attribute to @value_p. * * Some attributes can be unset by setting @type to * %G_FILE_ATTRIBUTE_TYPE_INVALID and @value_p to %NULL. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: %TRUE if the attribute was set, %FALSE otherwise. */ gboolean g_file_set_attribute (GFile *file, const gchar *attribute, GFileAttributeType type, gpointer value_p, GFileQueryInfoFlags flags, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (attribute != NULL && *attribute != '\0', FALSE); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return FALSE; iface = G_FILE_GET_IFACE (file); if (iface->set_attribute == NULL) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return FALSE; } return (* iface->set_attribute) (file, attribute, type, value_p, flags, cancellable, error); } /** * g_file_set_attributes_from_info: * @file: input #GFile * @info: a #GFileInfo * @flags: #GFileQueryInfoFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Tries to set all attributes in the #GFileInfo on the target * values, not stopping on the first error. * * If there is any error during this operation then @error will * be set to the first error. Error on particular fields are flagged * by setting the "status" field in the attribute value to * %G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING, which means you can * also detect further errors. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: %FALSE if there was any error, %TRUE otherwise. */ gboolean g_file_set_attributes_from_info (GFile *file, GFileInfo *info, GFileQueryInfoFlags flags, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (G_IS_FILE_INFO (info), FALSE); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return FALSE; g_file_info_clear_status (info); iface = G_FILE_GET_IFACE (file); return (* iface->set_attributes_from_info) (file, info, flags, cancellable, error); } static gboolean g_file_real_set_attributes_from_info (GFile *file, GFileInfo *info, GFileQueryInfoFlags flags, GCancellable *cancellable, GError **error) { char **attributes; int i; gboolean res; GFileAttributeValue *value; res = TRUE; attributes = g_file_info_list_attributes (info, NULL); for (i = 0; attributes[i] != NULL; i++) { value = _g_file_info_get_attribute_value (info, attributes[i]); if (value->status != G_FILE_ATTRIBUTE_STATUS_UNSET) continue; if (!g_file_set_attribute (file, attributes[i], value->type, _g_file_attribute_value_peek_as_pointer (value), flags, cancellable, error)) { value->status = G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING; res = FALSE; /* Don't set error multiple times */ error = NULL; } else value->status = G_FILE_ATTRIBUTE_STATUS_SET; } g_strfreev (attributes); return res; } /** * g_file_set_attributes_async: * @file: input #GFile * @info: a #GFileInfo * @flags: a #GFileQueryInfoFlags * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously sets the attributes of @file with @info. * * For more details, see g_file_set_attributes_from_info(), * which is the synchronous version of this call. * * When the operation is finished, @callback will be called. * You can then call g_file_set_attributes_finish() to get * the result of the operation. */ void g_file_set_attributes_async (GFile *file, GFileInfo *info, GFileQueryInfoFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); g_return_if_fail (G_IS_FILE_INFO (info)); iface = G_FILE_GET_IFACE (file); (* iface->set_attributes_async) (file, info, flags, io_priority, cancellable, callback, user_data); } /** * g_file_set_attributes_finish: * @file: input #GFile * @result: a #GAsyncResult * @info: (out) (transfer full): a #GFileInfo * @error: a #GError, or %NULL * * Finishes setting an attribute started in g_file_set_attributes_async(). * * Returns: %TRUE if the attributes were set correctly, %FALSE otherwise. */ gboolean g_file_set_attributes_finish (GFile *file, GAsyncResult *result, GFileInfo **info, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE); /* No standard handling of errors here, as we must set info even * on errors */ iface = G_FILE_GET_IFACE (file); return (* iface->set_attributes_finish) (file, result, info, error); } /** * g_file_set_attribute_string: * @file: input #GFile * @attribute: a string containing the attribute's name * @value: a string containing the attribute's value * @flags: #GFileQueryInfoFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_STRING to @value. * If @attribute is of a different type, this operation will fail. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: %TRUE if the @attribute was successfully set, %FALSE otherwise. */ gboolean g_file_set_attribute_string (GFile *file, const char *attribute, const char *value, GFileQueryInfoFlags flags, GCancellable *cancellable, GError **error) { return g_file_set_attribute (file, attribute, G_FILE_ATTRIBUTE_TYPE_STRING, (gpointer)value, flags, cancellable, error); } /** * g_file_set_attribute_byte_string: * @file: input #GFile * @attribute: a string containing the attribute's name * @value: a string containing the attribute's new value * @flags: a #GFileQueryInfoFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING to @value. * If @attribute is of a different type, this operation will fail, * returning %FALSE. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: %TRUE if the @attribute was successfully set to @value * in the @file, %FALSE otherwise. */ gboolean g_file_set_attribute_byte_string (GFile *file, const gchar *attribute, const gchar *value, GFileQueryInfoFlags flags, GCancellable *cancellable, GError **error) { return g_file_set_attribute (file, attribute, G_FILE_ATTRIBUTE_TYPE_BYTE_STRING, (gpointer)value, flags, cancellable, error); } /** * g_file_set_attribute_uint32: * @file: input #GFile * @attribute: a string containing the attribute's name * @value: a #guint32 containing the attribute's new value * @flags: a #GFileQueryInfoFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_UINT32 to @value. * If @attribute is of a different type, this operation will fail. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: %TRUE if the @attribute was successfully set to @value * in the @file, %FALSE otherwise. */ gboolean g_file_set_attribute_uint32 (GFile *file, const gchar *attribute, guint32 value, GFileQueryInfoFlags flags, GCancellable *cancellable, GError **error) { return g_file_set_attribute (file, attribute, G_FILE_ATTRIBUTE_TYPE_UINT32, &value, flags, cancellable, error); } /** * g_file_set_attribute_int32: * @file: input #GFile * @attribute: a string containing the attribute's name * @value: a #gint32 containing the attribute's new value * @flags: a #GFileQueryInfoFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT32 to @value. * If @attribute is of a different type, this operation will fail. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: %TRUE if the @attribute was successfully set to @value * in the @file, %FALSE otherwise. */ gboolean g_file_set_attribute_int32 (GFile *file, const gchar *attribute, gint32 value, GFileQueryInfoFlags flags, GCancellable *cancellable, GError **error) { return g_file_set_attribute (file, attribute, G_FILE_ATTRIBUTE_TYPE_INT32, &value, flags, cancellable, error); } /** * g_file_set_attribute_uint64: * @file: input #GFile * @attribute: a string containing the attribute's name * @value: a #guint64 containing the attribute's new value * @flags: a #GFileQueryInfoFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_UINT64 to @value. * If @attribute is of a different type, this operation will fail. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: %TRUE if the @attribute was successfully set to @value * in the @file, %FALSE otherwise. */ gboolean g_file_set_attribute_uint64 (GFile *file, const gchar *attribute, guint64 value, GFileQueryInfoFlags flags, GCancellable *cancellable, GError **error) { return g_file_set_attribute (file, attribute, G_FILE_ATTRIBUTE_TYPE_UINT64, &value, flags, cancellable, error); } /** * g_file_set_attribute_int64: * @file: input #GFile * @attribute: a string containing the attribute's name * @value: a #guint64 containing the attribute's new value * @flags: a #GFileQueryInfoFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT64 to @value. * If @attribute is of a different type, this operation will fail. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: %TRUE if the @attribute was successfully set, %FALSE otherwise. */ gboolean g_file_set_attribute_int64 (GFile *file, const gchar *attribute, gint64 value, GFileQueryInfoFlags flags, GCancellable *cancellable, GError **error) { return g_file_set_attribute (file, attribute, G_FILE_ATTRIBUTE_TYPE_INT64, &value, flags, cancellable, error); } /** * g_file_mount_mountable: * @file: input #GFile * @flags: flags affecting the operation * @mount_operation: (nullable): a #GMountOperation, * or %NULL to avoid user interaction * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Mounts a file of type G_FILE_TYPE_MOUNTABLE. * Using @mount_operation, you can request callbacks when, for instance, * passwords are needed during authentication. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * When the operation is finished, @callback will be called. * You can then call g_file_mount_mountable_finish() to get * the result of the operation. */ void g_file_mount_mountable (GFile *file, GMountMountFlags flags, GMountOperation *mount_operation, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); if (iface->mount_mountable == NULL) { g_task_report_new_error (file, callback, user_data, g_file_mount_mountable, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return; } (* iface->mount_mountable) (file, flags, mount_operation, cancellable, callback, user_data); } /** * g_file_mount_mountable_finish: * @file: input #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes a mount operation. See g_file_mount_mountable() for details. * * Finish an asynchronous mount operation that was started * with g_file_mount_mountable(). * * Returns: (transfer full): a #GFile or %NULL on error. * Free the returned object with g_object_unref(). */ GFile * g_file_mount_mountable_finish (GFile *file, GAsyncResult *result, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (G_IS_ASYNC_RESULT (result), NULL); if (g_async_result_legacy_propagate_error (result, error)) return NULL; else if (g_async_result_is_tagged (result, g_file_mount_mountable)) return g_task_propagate_pointer (G_TASK (result), error); iface = G_FILE_GET_IFACE (file); return (* iface->mount_mountable_finish) (file, result, error); } /** * g_file_unmount_mountable: * @file: input #GFile * @flags: flags affecting the operation * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (nullable) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Unmounts a file of type G_FILE_TYPE_MOUNTABLE. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * When the operation is finished, @callback will be called. * You can then call g_file_unmount_mountable_finish() to get * the result of the operation. * * Deprecated: 2.22: Use g_file_unmount_mountable_with_operation() instead. */ void g_file_unmount_mountable (GFile *file, GMountUnmountFlags flags, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); if (iface->unmount_mountable == NULL) { g_task_report_new_error (file, callback, user_data, g_file_unmount_mountable_with_operation, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return; } (* iface->unmount_mountable) (file, flags, cancellable, callback, user_data); } /** * g_file_unmount_mountable_finish: * @file: input #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes an unmount operation, see g_file_unmount_mountable() for details. * * Finish an asynchronous unmount operation that was started * with g_file_unmount_mountable(). * * Returns: %TRUE if the operation finished successfully. * %FALSE otherwise. * * Deprecated: 2.22: Use g_file_unmount_mountable_with_operation_finish() * instead. */ gboolean g_file_unmount_mountable_finish (GFile *file, GAsyncResult *result, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE); if (g_async_result_legacy_propagate_error (result, error)) return FALSE; else if (g_async_result_is_tagged (result, g_file_unmount_mountable_with_operation)) return g_task_propagate_boolean (G_TASK (result), error); iface = G_FILE_GET_IFACE (file); return (* iface->unmount_mountable_finish) (file, result, error); } /** * g_file_unmount_mountable_with_operation: * @file: input #GFile * @flags: flags affecting the operation * @mount_operation: (nullable): a #GMountOperation, * or %NULL to avoid user interaction * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (nullable) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Unmounts a file of type %G_FILE_TYPE_MOUNTABLE. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * When the operation is finished, @callback will be called. * You can then call g_file_unmount_mountable_finish() to get * the result of the operation. * * Since: 2.22 */ void g_file_unmount_mountable_with_operation (GFile *file, GMountUnmountFlags flags, GMountOperation *mount_operation, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); if (iface->unmount_mountable == NULL && iface->unmount_mountable_with_operation == NULL) { g_task_report_new_error (file, callback, user_data, g_file_unmount_mountable_with_operation, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return; } if (iface->unmount_mountable_with_operation != NULL) (* iface->unmount_mountable_with_operation) (file, flags, mount_operation, cancellable, callback, user_data); else (* iface->unmount_mountable) (file, flags, cancellable, callback, user_data); } /** * g_file_unmount_mountable_with_operation_finish: * @file: input #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes an unmount operation, * see g_file_unmount_mountable_with_operation() for details. * * Finish an asynchronous unmount operation that was started * with g_file_unmount_mountable_with_operation(). * * Returns: %TRUE if the operation finished successfully. * %FALSE otherwise. * * Since: 2.22 */ gboolean g_file_unmount_mountable_with_operation_finish (GFile *file, GAsyncResult *result, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE); if (g_async_result_legacy_propagate_error (result, error)) return FALSE; else if (g_async_result_is_tagged (result, g_file_unmount_mountable_with_operation)) return g_task_propagate_boolean (G_TASK (result), error); iface = G_FILE_GET_IFACE (file); if (iface->unmount_mountable_with_operation_finish != NULL) return (* iface->unmount_mountable_with_operation_finish) (file, result, error); else return (* iface->unmount_mountable_finish) (file, result, error); } /** * g_file_eject_mountable: * @file: input #GFile * @flags: flags affecting the operation * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (nullable) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Starts an asynchronous eject on a mountable. * When this operation has completed, @callback will be called with * @user_user data, and the operation can be finalized with * g_file_eject_mountable_finish(). * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Deprecated: 2.22: Use g_file_eject_mountable_with_operation() instead. */ void g_file_eject_mountable (GFile *file, GMountUnmountFlags flags, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); if (iface->eject_mountable == NULL) { g_task_report_new_error (file, callback, user_data, g_file_eject_mountable_with_operation, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return; } (* iface->eject_mountable) (file, flags, cancellable, callback, user_data); } /** * g_file_eject_mountable_finish: * @file: input #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes an asynchronous eject operation started by * g_file_eject_mountable(). * * Returns: %TRUE if the @file was ejected successfully. * %FALSE otherwise. * * Deprecated: 2.22: Use g_file_eject_mountable_with_operation_finish() * instead. */ gboolean g_file_eject_mountable_finish (GFile *file, GAsyncResult *result, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE); if (g_async_result_legacy_propagate_error (result, error)) return FALSE; else if (g_async_result_is_tagged (result, g_file_eject_mountable_with_operation)) return g_task_propagate_boolean (G_TASK (result), error); iface = G_FILE_GET_IFACE (file); return (* iface->eject_mountable_finish) (file, result, error); } /** * g_file_eject_mountable_with_operation: * @file: input #GFile * @flags: flags affecting the operation * @mount_operation: (nullable): a #GMountOperation, * or %NULL to avoid user interaction * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async) (nullable) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Starts an asynchronous eject on a mountable. * When this operation has completed, @callback will be called with * @user_user data, and the operation can be finalized with * g_file_eject_mountable_with_operation_finish(). * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Since: 2.22 */ void g_file_eject_mountable_with_operation (GFile *file, GMountUnmountFlags flags, GMountOperation *mount_operation, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); if (iface->eject_mountable == NULL && iface->eject_mountable_with_operation == NULL) { g_task_report_new_error (file, callback, user_data, g_file_eject_mountable_with_operation, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return; } if (iface->eject_mountable_with_operation != NULL) (* iface->eject_mountable_with_operation) (file, flags, mount_operation, cancellable, callback, user_data); else (* iface->eject_mountable) (file, flags, cancellable, callback, user_data); } /** * g_file_eject_mountable_with_operation_finish: * @file: input #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes an asynchronous eject operation started by * g_file_eject_mountable_with_operation(). * * Returns: %TRUE if the @file was ejected successfully. * %FALSE otherwise. * * Since: 2.22 */ gboolean g_file_eject_mountable_with_operation_finish (GFile *file, GAsyncResult *result, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE); if (g_async_result_legacy_propagate_error (result, error)) return FALSE; else if (g_async_result_is_tagged (result, g_file_eject_mountable_with_operation)) return g_task_propagate_boolean (G_TASK (result), error); iface = G_FILE_GET_IFACE (file); if (iface->eject_mountable_with_operation_finish != NULL) return (* iface->eject_mountable_with_operation_finish) (file, result, error); else return (* iface->eject_mountable_finish) (file, result, error); } /** * g_file_monitor_directory: (virtual monitor_dir) * @file: input #GFile * @flags: a set of #GFileMonitorFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Obtains a directory monitor for the given file. * This may fail if directory monitoring is not supported. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * It does not make sense for @flags to contain * %G_FILE_MONITOR_WATCH_HARD_LINKS, since hard links can not be made to * directories. It is not possible to monitor all the files in a * directory for changes made via hard links; if you want to do this then * you must register individual watches with g_file_monitor(). * * Returns: (transfer full): a #GFileMonitor for the given @file, * or %NULL on error. Free the returned object with g_object_unref(). */ GFileMonitor * g_file_monitor_directory (GFile *file, GFileMonitorFlags flags, GCancellable *cancellable, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (~flags & G_FILE_MONITOR_WATCH_HARD_LINKS, NULL); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return NULL; iface = G_FILE_GET_IFACE (file); if (iface->monitor_dir == NULL) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return NULL; } return (* iface->monitor_dir) (file, flags, cancellable, error); } /** * g_file_monitor_file: * @file: input #GFile * @flags: a set of #GFileMonitorFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Obtains a file monitor for the given file. If no file notification * mechanism exists, then regular polling of the file is used. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * If @flags contains %G_FILE_MONITOR_WATCH_HARD_LINKS then the monitor * will also attempt to report changes made to the file via another * filename (ie, a hard link). Without this flag, you can only rely on * changes made through the filename contained in @file to be * reported. Using this flag may result in an increase in resource * usage, and may not have any effect depending on the #GFileMonitor * backend and/or filesystem type. * * Returns: (transfer full): a #GFileMonitor for the given @file, * or %NULL on error. * Free the returned object with g_object_unref(). */ GFileMonitor * g_file_monitor_file (GFile *file, GFileMonitorFlags flags, GCancellable *cancellable, GError **error) { GFileIface *iface; GFileMonitor *monitor; g_return_val_if_fail (G_IS_FILE (file), NULL); if (g_cancellable_set_error_if_cancelled (cancellable, error)) return NULL; iface = G_FILE_GET_IFACE (file); monitor = NULL; if (iface->monitor_file) monitor = (* iface->monitor_file) (file, flags, cancellable, NULL); /* Fallback to polling */ if (monitor == NULL) monitor = _g_poll_file_monitor_new (file); return monitor; } /** * g_file_monitor: * @file: input #GFile * @flags: a set of #GFileMonitorFlags * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * * Obtains a file or directory monitor for the given file, * depending on the type of the file. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: (transfer full): a #GFileMonitor for the given @file, * or %NULL on error. * Free the returned object with g_object_unref(). * * Since: 2.18 */ GFileMonitor * g_file_monitor (GFile *file, GFileMonitorFlags flags, GCancellable *cancellable, GError **error) { if (g_file_query_file_type (file, 0, cancellable) == G_FILE_TYPE_DIRECTORY) return g_file_monitor_directory (file, flags & ~G_FILE_MONITOR_WATCH_HARD_LINKS, cancellable, error); else return g_file_monitor_file (file, flags, cancellable, error); } /******************************************** * Default implementation of async ops * ********************************************/ typedef struct { char *attributes; GFileQueryInfoFlags flags; } QueryInfoAsyncData; static void query_info_data_free (QueryInfoAsyncData *data) { g_free (data->attributes); g_free (data); } static void query_info_async_thread (GTask *task, gpointer object, gpointer task_data, GCancellable *cancellable) { QueryInfoAsyncData *data = task_data; GFileInfo *info; GError *error = NULL; info = g_file_query_info (G_FILE (object), data->attributes, data->flags, cancellable, &error); if (info) g_task_return_pointer (task, info, g_object_unref); else g_task_return_error (task, error); } static void g_file_real_query_info_async (GFile *file, const char *attributes, GFileQueryInfoFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; QueryInfoAsyncData *data; data = g_new0 (QueryInfoAsyncData, 1); data->attributes = g_strdup (attributes); data->flags = flags; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_query_info_async); g_task_set_task_data (task, data, (GDestroyNotify)query_info_data_free); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, query_info_async_thread); g_object_unref (task); } static GFileInfo * g_file_real_query_info_finish (GFile *file, GAsyncResult *res, GError **error) { g_return_val_if_fail (g_task_is_valid (res, file), NULL); return g_task_propagate_pointer (G_TASK (res), error); } static void query_filesystem_info_async_thread (GTask *task, gpointer object, gpointer task_data, GCancellable *cancellable) { const char *attributes = task_data; GFileInfo *info; GError *error = NULL; info = g_file_query_filesystem_info (G_FILE (object), attributes, cancellable, &error); if (info) g_task_return_pointer (task, info, g_object_unref); else g_task_return_error (task, error); } static void g_file_real_query_filesystem_info_async (GFile *file, const char *attributes, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_query_filesystem_info_async); g_task_set_task_data (task, g_strdup (attributes), g_free); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, query_filesystem_info_async_thread); g_object_unref (task); } static GFileInfo * g_file_real_query_filesystem_info_finish (GFile *file, GAsyncResult *res, GError **error) { g_return_val_if_fail (g_task_is_valid (res, file), NULL); return g_task_propagate_pointer (G_TASK (res), error); } static void enumerate_children_async_thread (GTask *task, gpointer object, gpointer task_data, GCancellable *cancellable) { QueryInfoAsyncData *data = task_data; GFileEnumerator *enumerator; GError *error = NULL; enumerator = g_file_enumerate_children (G_FILE (object), data->attributes, data->flags, cancellable, &error); if (error) g_task_return_error (task, error); else g_task_return_pointer (task, enumerator, g_object_unref); } static void g_file_real_enumerate_children_async (GFile *file, const char *attributes, GFileQueryInfoFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; QueryInfoAsyncData *data; data = g_new0 (QueryInfoAsyncData, 1); data->attributes = g_strdup (attributes); data->flags = flags; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_enumerate_children_async); g_task_set_task_data (task, data, (GDestroyNotify)query_info_data_free); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, enumerate_children_async_thread); g_object_unref (task); } static GFileEnumerator * g_file_real_enumerate_children_finish (GFile *file, GAsyncResult *res, GError **error) { g_return_val_if_fail (g_task_is_valid (res, file), NULL); return g_task_propagate_pointer (G_TASK (res), error); } static void open_read_async_thread (GTask *task, gpointer object, gpointer task_data, GCancellable *cancellable) { GFileInputStream *stream; GError *error = NULL; stream = g_file_read (G_FILE (object), cancellable, &error); if (stream) g_task_return_pointer (task, stream, g_object_unref); else g_task_return_error (task, error); } static void g_file_real_read_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_read_async); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, open_read_async_thread); g_object_unref (task); } static GFileInputStream * g_file_real_read_finish (GFile *file, GAsyncResult *res, GError **error) { g_return_val_if_fail (g_task_is_valid (res, file), NULL); return g_task_propagate_pointer (G_TASK (res), error); } static void append_to_async_thread (GTask *task, gpointer source_object, gpointer task_data, GCancellable *cancellable) { GFileCreateFlags *data = task_data; GFileOutputStream *stream; GError *error = NULL; stream = g_file_append_to (G_FILE (source_object), *data, cancellable, &error); if (stream) g_task_return_pointer (task, stream, g_object_unref); else g_task_return_error (task, error); } static void g_file_real_append_to_async (GFile *file, GFileCreateFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileCreateFlags *data; GTask *task; data = g_new0 (GFileCreateFlags, 1); *data = flags; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_append_to_async); g_task_set_task_data (task, data, g_free); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, append_to_async_thread); g_object_unref (task); } static GFileOutputStream * g_file_real_append_to_finish (GFile *file, GAsyncResult *res, GError **error) { g_return_val_if_fail (g_task_is_valid (res, file), NULL); return g_task_propagate_pointer (G_TASK (res), error); } static void create_async_thread (GTask *task, gpointer source_object, gpointer task_data, GCancellable *cancellable) { GFileCreateFlags *data = task_data; GFileOutputStream *stream; GError *error = NULL; stream = g_file_create (G_FILE (source_object), *data, cancellable, &error); if (stream) g_task_return_pointer (task, stream, g_object_unref); else g_task_return_error (task, error); } static void g_file_real_create_async (GFile *file, GFileCreateFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileCreateFlags *data; GTask *task; data = g_new0 (GFileCreateFlags, 1); *data = flags; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_create_async); g_task_set_task_data (task, data, g_free); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, create_async_thread); g_object_unref (task); } static GFileOutputStream * g_file_real_create_finish (GFile *file, GAsyncResult *res, GError **error) { g_return_val_if_fail (g_task_is_valid (res, file), NULL); return g_task_propagate_pointer (G_TASK (res), error); } typedef struct { GFileOutputStream *stream; char *etag; gboolean make_backup; GFileCreateFlags flags; } ReplaceAsyncData; static void replace_async_data_free (ReplaceAsyncData *data) { if (data->stream) g_object_unref (data->stream); g_free (data->etag); g_free (data); } static void replace_async_thread (GTask *task, gpointer source_object, gpointer task_data, GCancellable *cancellable) { GFileOutputStream *stream; ReplaceAsyncData *data = task_data; GError *error = NULL; stream = g_file_replace (G_FILE (source_object), data->etag, data->make_backup, data->flags, cancellable, &error); if (stream) g_task_return_pointer (task, stream, g_object_unref); else g_task_return_error (task, error); } static void g_file_real_replace_async (GFile *file, const char *etag, gboolean make_backup, GFileCreateFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; ReplaceAsyncData *data; data = g_new0 (ReplaceAsyncData, 1); data->etag = g_strdup (etag); data->make_backup = make_backup; data->flags = flags; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_replace_async); g_task_set_task_data (task, data, (GDestroyNotify)replace_async_data_free); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, replace_async_thread); g_object_unref (task); } static GFileOutputStream * g_file_real_replace_finish (GFile *file, GAsyncResult *res, GError **error) { g_return_val_if_fail (g_task_is_valid (res, file), NULL); return g_task_propagate_pointer (G_TASK (res), error); } static void delete_async_thread (GTask *task, gpointer object, gpointer task_data, GCancellable *cancellable) { GError *error = NULL; if (g_file_delete (G_FILE (object), cancellable, &error)) g_task_return_boolean (task, TRUE); else g_task_return_error (task, error); } static void g_file_real_delete_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_delete_async); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, delete_async_thread); g_object_unref (task); } static gboolean g_file_real_delete_finish (GFile *file, GAsyncResult *res, GError **error) { g_return_val_if_fail (g_task_is_valid (res, file), FALSE); return g_task_propagate_boolean (G_TASK (res), error); } static void trash_async_thread (GTask *task, gpointer object, gpointer task_data, GCancellable *cancellable) { GError *error = NULL; if (g_file_trash (G_FILE (object), cancellable, &error)) g_task_return_boolean (task, TRUE); else g_task_return_error (task, error); } static void g_file_real_trash_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_trash_async); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, trash_async_thread); g_object_unref (task); } static gboolean g_file_real_trash_finish (GFile *file, GAsyncResult *res, GError **error) { g_return_val_if_fail (g_task_is_valid (res, file), FALSE); return g_task_propagate_boolean (G_TASK (res), error); } typedef struct { GFile *source; /* (owned) */ GFile *destination; /* (owned) */ GFileCopyFlags flags; GFileProgressCallback progress_cb; gpointer progress_cb_data; } MoveAsyncData; static void move_async_data_free (MoveAsyncData *data) { g_object_unref (data->source); g_object_unref (data->destination); g_slice_free (MoveAsyncData, data); } typedef struct { MoveAsyncData *data; /* (unowned) */ goffset current_num_bytes; goffset total_num_bytes; } MoveProgressData; static gboolean move_async_progress_in_main (gpointer user_data) { MoveProgressData *progress = user_data; MoveAsyncData *data = progress->data; data->progress_cb (progress->current_num_bytes, progress->total_num_bytes, data->progress_cb_data); return G_SOURCE_REMOVE; } static void move_async_progress_callback (goffset current_num_bytes, goffset total_num_bytes, gpointer user_data) { GTask *task = user_data; MoveAsyncData *data = g_task_get_task_data (task); MoveProgressData *progress; progress = g_new0 (MoveProgressData, 1); progress->data = data; progress->current_num_bytes = current_num_bytes; progress->total_num_bytes = total_num_bytes; g_main_context_invoke_full (g_task_get_context (task), g_task_get_priority (task), move_async_progress_in_main, g_steal_pointer (&progress), g_free); } static void move_async_thread (GTask *task, gpointer source, gpointer task_data, GCancellable *cancellable) { MoveAsyncData *data = task_data; gboolean result; GError *error = NULL; result = g_file_move (data->source, data->destination, data->flags, cancellable, (data->progress_cb != NULL) ? move_async_progress_callback : NULL, task, &error); if (result) g_task_return_boolean (task, TRUE); else g_task_return_error (task, g_steal_pointer (&error)); } static void g_file_real_move_async (GFile *source, GFile *destination, GFileCopyFlags flags, int io_priority, GCancellable *cancellable, GFileProgressCallback progress_callback, gpointer progress_callback_data, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; MoveAsyncData *data; data = g_slice_new0 (MoveAsyncData); data->source = g_object_ref (source); data->destination = g_object_ref (destination); data->flags = flags; data->progress_cb = progress_callback; data->progress_cb_data = progress_callback_data; task = g_task_new (source, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_move_async); g_task_set_task_data (task, g_steal_pointer (&data), (GDestroyNotify) move_async_data_free); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, move_async_thread); g_object_unref (task); } static gboolean g_file_real_move_finish (GFile *file, GAsyncResult *result, GError **error) { g_return_val_if_fail (g_task_is_valid (result, file), FALSE); return g_task_propagate_boolean (G_TASK (result), error); } static void make_directory_async_thread (GTask *task, gpointer object, gpointer task_data, GCancellable *cancellable) { GError *error = NULL; if (g_file_make_directory (G_FILE (object), cancellable, &error)) g_task_return_boolean (task, TRUE); else g_task_return_error (task, error); } static void g_file_real_make_directory_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_make_directory_async); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, make_directory_async_thread); g_object_unref (task); } static gboolean g_file_real_make_directory_finish (GFile *file, GAsyncResult *res, GError **error) { g_return_val_if_fail (g_task_is_valid (res, file), FALSE); return g_task_propagate_boolean (G_TASK (res), error); } static void open_readwrite_async_thread (GTask *task, gpointer object, gpointer task_data, GCancellable *cancellable) { GFileIOStream *stream; GError *error = NULL; stream = g_file_open_readwrite (G_FILE (object), cancellable, &error); if (stream == NULL) g_task_return_error (task, error); else g_task_return_pointer (task, stream, g_object_unref); } static void g_file_real_open_readwrite_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_open_readwrite_async); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, open_readwrite_async_thread); g_object_unref (task); } static GFileIOStream * g_file_real_open_readwrite_finish (GFile *file, GAsyncResult *res, GError **error) { g_return_val_if_fail (g_task_is_valid (res, file), NULL); return g_task_propagate_pointer (G_TASK (res), error); } static void create_readwrite_async_thread (GTask *task, gpointer object, gpointer task_data, GCancellable *cancellable) { GFileCreateFlags *data = task_data; GFileIOStream *stream; GError *error = NULL; stream = g_file_create_readwrite (G_FILE (object), *data, cancellable, &error); if (stream == NULL) g_task_return_error (task, error); else g_task_return_pointer (task, stream, g_object_unref); } static void g_file_real_create_readwrite_async (GFile *file, GFileCreateFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileCreateFlags *data; GTask *task; data = g_new0 (GFileCreateFlags, 1); *data = flags; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_create_readwrite_async); g_task_set_task_data (task, data, g_free); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, create_readwrite_async_thread); g_object_unref (task); } static GFileIOStream * g_file_real_create_readwrite_finish (GFile *file, GAsyncResult *res, GError **error) { g_return_val_if_fail (g_task_is_valid (res, file), NULL); return g_task_propagate_pointer (G_TASK (res), error); } typedef struct { char *etag; gboolean make_backup; GFileCreateFlags flags; } ReplaceRWAsyncData; static void replace_rw_async_data_free (ReplaceRWAsyncData *data) { g_free (data->etag); g_free (data); } static void replace_readwrite_async_thread (GTask *task, gpointer object, gpointer task_data, GCancellable *cancellable) { GFileIOStream *stream; GError *error = NULL; ReplaceRWAsyncData *data = task_data; stream = g_file_replace_readwrite (G_FILE (object), data->etag, data->make_backup, data->flags, cancellable, &error); if (stream == NULL) g_task_return_error (task, error); else g_task_return_pointer (task, stream, g_object_unref); } static void g_file_real_replace_readwrite_async (GFile *file, const char *etag, gboolean make_backup, GFileCreateFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; ReplaceRWAsyncData *data; data = g_new0 (ReplaceRWAsyncData, 1); data->etag = g_strdup (etag); data->make_backup = make_backup; data->flags = flags; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_replace_readwrite_async); g_task_set_task_data (task, data, (GDestroyNotify)replace_rw_async_data_free); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, replace_readwrite_async_thread); g_object_unref (task); } static GFileIOStream * g_file_real_replace_readwrite_finish (GFile *file, GAsyncResult *res, GError **error) { g_return_val_if_fail (g_task_is_valid (res, file), NULL); return g_task_propagate_pointer (G_TASK (res), error); } static void set_display_name_async_thread (GTask *task, gpointer object, gpointer task_data, GCancellable *cancellable) { GError *error = NULL; char *name = task_data; GFile *file; file = g_file_set_display_name (G_FILE (object), name, cancellable, &error); if (file == NULL) g_task_return_error (task, error); else g_task_return_pointer (task, file, g_object_unref); } static void g_file_real_set_display_name_async (GFile *file, const char *display_name, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_set_display_name_async); g_task_set_task_data (task, g_strdup (display_name), g_free); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, set_display_name_async_thread); g_object_unref (task); } static GFile * g_file_real_set_display_name_finish (GFile *file, GAsyncResult *res, GError **error) { g_return_val_if_fail (g_task_is_valid (res, file), NULL); return g_task_propagate_pointer (G_TASK (res), error); } typedef struct { GFileQueryInfoFlags flags; GFileInfo *info; } SetInfoAsyncData; static void set_info_data_free (SetInfoAsyncData *data) { if (data->info) g_object_unref (data->info); g_free (data); } static void set_info_async_thread (GTask *task, gpointer object, gpointer task_data, GCancellable *cancellable) { SetInfoAsyncData *data = task_data; GError *error = NULL; if (g_file_set_attributes_from_info (G_FILE (object), data->info, data->flags, cancellable, &error)) g_task_return_boolean (task, TRUE); else g_task_return_error (task, error); } static void g_file_real_set_attributes_async (GFile *file, GFileInfo *info, GFileQueryInfoFlags flags, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; SetInfoAsyncData *data; data = g_new0 (SetInfoAsyncData, 1); data->info = g_file_info_dup (info); data->flags = flags; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_set_attributes_async); g_task_set_task_data (task, data, (GDestroyNotify)set_info_data_free); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, set_info_async_thread); g_object_unref (task); } static gboolean g_file_real_set_attributes_finish (GFile *file, GAsyncResult *res, GFileInfo **info, GError **error) { SetInfoAsyncData *data; g_return_val_if_fail (g_task_is_valid (res, file), FALSE); data = g_task_get_task_data (G_TASK (res)); if (info) *info = g_object_ref (data->info); return g_task_propagate_boolean (G_TASK (res), error); } static void find_enclosing_mount_async_thread (GTask *task, gpointer object, gpointer task_data, GCancellable *cancellable) { GError *error = NULL; GMount *mount; mount = g_file_find_enclosing_mount (G_FILE (object), cancellable, &error); if (mount == NULL) g_task_return_error (task, error); else g_task_return_pointer (task, mount, g_object_unref); } static void g_file_real_find_enclosing_mount_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_find_enclosing_mount_async); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, find_enclosing_mount_async_thread); g_object_unref (task); } static GMount * g_file_real_find_enclosing_mount_finish (GFile *file, GAsyncResult *res, GError **error) { g_return_val_if_fail (g_task_is_valid (res, file), NULL); return g_task_propagate_pointer (G_TASK (res), error); } typedef struct { GFile *source; GFile *destination; GFileCopyFlags flags; GFileProgressCallback progress_cb; gpointer progress_cb_data; } CopyAsyncData; static void copy_async_data_free (CopyAsyncData *data) { g_object_unref (data->source); g_object_unref (data->destination); g_slice_free (CopyAsyncData, data); } typedef struct { CopyAsyncData *data; goffset current_num_bytes; goffset total_num_bytes; } CopyProgressData; static gboolean copy_async_progress_in_main (gpointer user_data) { CopyProgressData *progress = user_data; CopyAsyncData *data = progress->data; data->progress_cb (progress->current_num_bytes, progress->total_num_bytes, data->progress_cb_data); return FALSE; } static void copy_async_progress_callback (goffset current_num_bytes, goffset total_num_bytes, gpointer user_data) { GTask *task = user_data; CopyAsyncData *data = g_task_get_task_data (task); CopyProgressData *progress; progress = g_new (CopyProgressData, 1); progress->data = data; progress->current_num_bytes = current_num_bytes; progress->total_num_bytes = total_num_bytes; g_main_context_invoke_full (g_task_get_context (task), g_task_get_priority (task), copy_async_progress_in_main, progress, g_free); } static void copy_async_thread (GTask *task, gpointer source, gpointer task_data, GCancellable *cancellable) { CopyAsyncData *data = task_data; gboolean result; GError *error = NULL; result = g_file_copy (data->source, data->destination, data->flags, cancellable, (data->progress_cb != NULL) ? copy_async_progress_callback : NULL, task, &error); if (result) g_task_return_boolean (task, TRUE); else g_task_return_error (task, error); } static void g_file_real_copy_async (GFile *source, GFile *destination, GFileCopyFlags flags, int io_priority, GCancellable *cancellable, GFileProgressCallback progress_callback, gpointer progress_callback_data, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; CopyAsyncData *data; data = g_slice_new (CopyAsyncData); data->source = g_object_ref (source); data->destination = g_object_ref (destination); data->flags = flags; data->progress_cb = progress_callback; data->progress_cb_data = progress_callback_data; task = g_task_new (source, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_copy_async); g_task_set_task_data (task, data, (GDestroyNotify)copy_async_data_free); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, copy_async_thread); g_object_unref (task); } static gboolean g_file_real_copy_finish (GFile *file, GAsyncResult *res, GError **error) { g_return_val_if_fail (g_task_is_valid (res, file), FALSE); return g_task_propagate_boolean (G_TASK (res), error); } /******************************************** * Default VFS operations * ********************************************/ /** * g_file_new_for_path: * @path: (type filename): a string containing a relative or absolute path. * The string must be encoded in the glib filename encoding. * * Constructs a #GFile for a given path. This operation never * fails, but the returned object might not support any I/O * operation if @path is malformed. * * Returns: (transfer full): a new #GFile for the given @path. * Free the returned object with g_object_unref(). */ GFile * g_file_new_for_path (const char *path) { g_return_val_if_fail (path != NULL, NULL); return g_vfs_get_file_for_path (g_vfs_get_default (), path); } /** * g_file_new_for_uri: * @uri: a UTF-8 string containing a URI * * Constructs a #GFile for a given URI. This operation never * fails, but the returned object might not support any I/O * operation if @uri is malformed or if the uri type is * not supported. * * Returns: (transfer full): a new #GFile for the given @uri. * Free the returned object with g_object_unref(). */ GFile * g_file_new_for_uri (const char *uri) { g_return_val_if_fail (uri != NULL, NULL); return g_vfs_get_file_for_uri (g_vfs_get_default (), uri); } /** * g_file_new_tmp: * @tmpl: (type filename) (nullable): Template for the file * name, as in g_file_open_tmp(), or %NULL for a default template * @iostream: (out): on return, a #GFileIOStream for the created file * @error: a #GError, or %NULL * * Opens a file in the preferred directory for temporary files (as * returned by g_get_tmp_dir()) and returns a #GFile and * #GFileIOStream pointing to it. * * @tmpl should be a string in the GLib file name encoding * containing a sequence of six 'X' characters, and containing no * directory components. If it is %NULL, a default template is used. * * Unlike the other #GFile constructors, this will return %NULL if * a temporary file could not be created. * * Returns: (transfer full): a new #GFile. * Free the returned object with g_object_unref(). * * Since: 2.32 */ GFile * g_file_new_tmp (const char *tmpl, GFileIOStream **iostream, GError **error) { gint fd; gchar *path; GFile *file; GFileOutputStream *output; g_return_val_if_fail (iostream != NULL, NULL); fd = g_file_open_tmp (tmpl, &path, error); if (fd == -1) return NULL; file = g_file_new_for_path (path); output = _g_local_file_output_stream_new (fd); *iostream = _g_local_file_io_stream_new (G_LOCAL_FILE_OUTPUT_STREAM (output)); g_object_unref (output); g_free (path); return file; } typedef struct { GFile *file; GFileIOStream *iostream; } NewTmpAsyncData; static void new_tmp_data_free (NewTmpAsyncData *data) { g_clear_object (&data->file); g_clear_object (&data->iostream); g_free (data); } static void new_tmp_async_thread (GTask *task, gpointer object, gpointer task_data, GCancellable *cancellable) { GFile *file; const char *tmpl = task_data; GFileIOStream *iostream = NULL; GError *error = NULL; NewTmpAsyncData *return_data; if (g_task_return_error_if_cancelled (task)) return; file = g_file_new_tmp (tmpl, &iostream, &error); if (!file) { int error_code = G_IO_ERROR_FAILED; if (error->domain == G_IO_ERROR) { g_task_return_error (task, g_steal_pointer (&error)); return; } if (error->domain == G_FILE_ERROR) error_code = g_io_error_from_file_error (error->code); g_task_return_new_error (task, G_IO_ERROR, error_code, _("Failed to create a temporary directory for " "template “%s”: %s"), tmpl, error->message); g_clear_error (&error); return; } return_data = g_new0 (NewTmpAsyncData, 1); return_data->file = g_steal_pointer (&file); return_data->iostream = g_steal_pointer (&iostream); g_task_return_pointer (task, g_steal_pointer (&return_data), (GDestroyNotify) new_tmp_data_free); } /** * g_file_new_tmp_async: * @tmpl: (type filename) (nullable): Template for the file * name, as in g_file_open_tmp(), or %NULL for a default template * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: optional #GCancellable object, %NULL to ignore * @callback: (nullable): a #GAsyncReadyCallback to call when the request is done * @user_data: (nullable): data to pass to @callback * * Asynchronously opens a file in the preferred directory for temporary files * (as returned by g_get_tmp_dir()) as g_file_new_tmp(). * * @tmpl should be a string in the GLib file name encoding * containing a sequence of six 'X' characters, and containing no * directory components. If it is %NULL, a default template is used. * * Since: 2.74 */ void g_file_new_tmp_async (const char *tmpl, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; g_return_if_fail (cancellable == NULL || G_IS_CANCELLABLE (cancellable)); task = g_task_new (NULL, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_new_tmp_async); g_task_set_task_data (task, g_strdup (tmpl), g_free); g_task_set_priority (task, io_priority); g_task_set_check_cancellable (task, TRUE); g_task_run_in_thread (task, new_tmp_async_thread); g_object_unref (task); } /** * g_file_new_tmp_finish: * @result: a #GAsyncResult * @iostream: (out) (not optional) (not nullable) (transfer full): on return, a #GFileIOStream for the created file * @error: a #GError, or %NULL * * Finishes a temporary file creation started by g_file_new_tmp_async(). * * Returns: (transfer full): a new #GFile. * Free the returned object with g_object_unref(). * * Since: 2.74 */ GFile * g_file_new_tmp_finish (GAsyncResult *result, GFileIOStream **iostream, GError **error) { GFile *file; NewTmpAsyncData *data; g_return_val_if_fail (g_task_is_valid (result, NULL), NULL); g_return_val_if_fail (g_task_get_source_tag (G_TASK (result)) == g_file_new_tmp_async, NULL); g_return_val_if_fail (iostream != NULL, NULL); g_return_val_if_fail (error == NULL || *error == NULL, NULL); data = g_task_propagate_pointer (G_TASK (result), error); if (!data) { *iostream = NULL; return NULL; } file = g_steal_pointer (&data->file); *iostream = g_steal_pointer (&data->iostream); new_tmp_data_free (data); return file; } static void new_tmp_dir_async_thread (GTask *task, gpointer object, gpointer task_data, GCancellable *cancellable) { gchar *path; const char *tmpl = task_data; GError *error = NULL; if (g_task_return_error_if_cancelled (task)) return; path = g_dir_make_tmp (tmpl, &error); if (!path) { int error_code = G_IO_ERROR_FAILED; if (error->domain == G_IO_ERROR) { g_task_return_error (task, g_steal_pointer (&error)); return; } if (error->domain == G_FILE_ERROR) error_code = g_io_error_from_file_error (error->code); g_task_return_new_error (task, G_IO_ERROR, error_code, _("Failed to create a temporary directory for " "template “%s”: %s"), tmpl, error->message); g_clear_error (&error); return; } g_task_return_pointer (task, g_file_new_for_path (path), g_object_unref); g_free (path); } /** * g_file_new_tmp_dir_async: * @tmpl: (type filename) (nullable): Template for the file * name, as in g_dir_make_tmp(), or %NULL for a default template * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: optional #GCancellable object, %NULL to ignore * @callback: (nullable): a #GAsyncReadyCallback to call when the request is done * @user_data: (nullable): data to pass to @callback * * Asynchronously creates a directory in the preferred directory for * temporary files (as returned by g_get_tmp_dir()) as g_dir_make_tmp(). * * @tmpl should be a string in the GLib file name encoding * containing a sequence of six 'X' characters, and containing no * directory components. If it is %NULL, a default template is used. * * Since: 2.74 */ void g_file_new_tmp_dir_async (const char *tmpl, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; g_return_if_fail (cancellable == NULL || G_IS_CANCELLABLE (cancellable)); task = g_task_new (NULL, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_new_tmp_dir_async); g_task_set_task_data (task, g_strdup (tmpl), g_free); g_task_set_priority (task, io_priority); g_task_set_check_cancellable (task, TRUE); g_task_run_in_thread (task, new_tmp_dir_async_thread); g_object_unref (task); } /** * g_file_new_tmp_dir_finish: * @result: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes a temporary directory creation started by * g_file_new_tmp_dir_async(). * * Returns: (transfer full): a new #GFile. * Free the returned object with g_object_unref(). * * Since: 2.74 */ GFile * g_file_new_tmp_dir_finish (GAsyncResult *result, GError **error) { g_return_val_if_fail (g_task_is_valid (result, NULL), NULL); g_return_val_if_fail (g_task_get_source_tag (G_TASK (result)) == g_file_new_tmp_dir_async, NULL); g_return_val_if_fail (error == NULL || *error == NULL, NULL); return g_task_propagate_pointer (G_TASK (result), error); } /** * g_file_parse_name: * @parse_name: a file name or path to be parsed * * Constructs a #GFile with the given @parse_name (i.e. something * given by g_file_get_parse_name()). This operation never fails, * but the returned object might not support any I/O operation if * the @parse_name cannot be parsed. * * Returns: (transfer full): a new #GFile. */ GFile * g_file_parse_name (const char *parse_name) { g_return_val_if_fail (parse_name != NULL, NULL); return g_vfs_parse_name (g_vfs_get_default (), parse_name); } /** * g_file_new_build_filename: * @first_element: (type filename): the first element in the path * @...: remaining elements in path, terminated by %NULL * * Constructs a #GFile from a series of elements using the correct * separator for filenames. * * Using this function is equivalent to calling g_build_filename(), * followed by g_file_new_for_path() on the result. * * Returns: (transfer full): a new #GFile * * Since: 2.56 */ GFile * g_file_new_build_filename (const gchar *first_element, ...) { gchar *str; GFile *file; va_list args; g_return_val_if_fail (first_element != NULL, NULL); va_start (args, first_element); str = g_build_filename_valist (first_element, &args); va_end (args); file = g_file_new_for_path (str); g_free (str); return file; } /** * g_file_new_build_filenamev: * @args: (array zero-terminated=1) (element-type filename): %NULL-terminated * array of strings containing the path elements. * * Constructs a #GFile from a vector of elements using the correct * separator for filenames. * * Using this function is equivalent to calling g_build_filenamev(), * followed by g_file_new_for_path() on the result. * * Returns: (transfer full): a new #GFile * * Since: 2.78 */ GFile * g_file_new_build_filenamev (const gchar * const *args) { gchar *str; GFile *file; str = g_build_filenamev ((gchar **) args); file = g_file_new_for_path (str); g_free (str); return file; } static gboolean is_valid_scheme_character (char c) { return g_ascii_isalnum (c) || c == '+' || c == '-' || c == '.'; } /* Following RFC 2396, valid schemes are built like: * scheme = alpha *( alpha | digit | "+" | "-" | "." ) */ static gboolean has_valid_scheme (const char *uri) { const char *p; p = uri; if (!g_ascii_isalpha (*p)) return FALSE; do { p++; } while (is_valid_scheme_character (*p)); return *p == ':'; } static GFile * new_for_cmdline_arg (const gchar *arg, const gchar *cwd) { GFile *file; char *filename; if (g_path_is_absolute (arg)) return g_file_new_for_path (arg); if (has_valid_scheme (arg)) return g_file_new_for_uri (arg); if (cwd == NULL) { char *current_dir; current_dir = g_get_current_dir (); filename = g_build_filename (current_dir, arg, NULL); g_free (current_dir); } else filename = g_build_filename (cwd, arg, NULL); file = g_file_new_for_path (filename); g_free (filename); return file; } /** * g_file_new_for_commandline_arg: * @arg: (type filename): a command line string * * Creates a #GFile with the given argument from the command line. * The value of @arg can be either a URI, an absolute path or a * relative path resolved relative to the current working directory. * This operation never fails, but the returned object might not * support any I/O operation if @arg points to a malformed path. * * Note that on Windows, this function expects its argument to be in * UTF-8 -- not the system code page. This means that you * should not use this function with string from argv as it is passed * to main(). g_win32_get_command_line() will return a UTF-8 version of * the commandline. #GApplication also uses UTF-8 but * g_application_command_line_create_file_for_arg() may be more useful * for you there. It is also always possible to use this function with * #GOptionContext arguments of type %G_OPTION_ARG_FILENAME. * * Returns: (transfer full): a new #GFile. * Free the returned object with g_object_unref(). */ GFile * g_file_new_for_commandline_arg (const char *arg) { g_return_val_if_fail (arg != NULL, NULL); return new_for_cmdline_arg (arg, NULL); } /** * g_file_new_for_commandline_arg_and_cwd: * @arg: (type filename): a command line string * @cwd: (type filename): the current working directory of the commandline * * Creates a #GFile with the given argument from the command line. * * This function is similar to g_file_new_for_commandline_arg() except * that it allows for passing the current working directory as an * argument instead of using the current working directory of the * process. * * This is useful if the commandline argument was given in a context * other than the invocation of the current process. * * See also g_application_command_line_create_file_for_arg(). * * Returns: (transfer full): a new #GFile * * Since: 2.36 **/ GFile * g_file_new_for_commandline_arg_and_cwd (const gchar *arg, const gchar *cwd) { g_return_val_if_fail (arg != NULL, NULL); g_return_val_if_fail (cwd != NULL, NULL); return new_for_cmdline_arg (arg, cwd); } /** * g_file_mount_enclosing_volume: * @location: input #GFile * @flags: flags affecting the operation * @mount_operation: (nullable): a #GMountOperation * or %NULL to avoid user interaction * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (nullable): a #GAsyncReadyCallback to call * when the request is satisfied, or %NULL * @user_data: the data to pass to callback function * * Starts a @mount_operation, mounting the volume that contains * the file @location. * * When this operation has completed, @callback will be called with * @user_user data, and the operation can be finalized with * g_file_mount_enclosing_volume_finish(). * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. */ void g_file_mount_enclosing_volume (GFile *location, GMountMountFlags flags, GMountOperation *mount_operation, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (location)); iface = G_FILE_GET_IFACE (location); if (iface->mount_enclosing_volume == NULL) { g_task_report_new_error (location, callback, user_data, g_file_mount_enclosing_volume, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("volume doesn’t implement mount")); return; } (* iface->mount_enclosing_volume) (location, flags, mount_operation, cancellable, callback, user_data); } /** * g_file_mount_enclosing_volume_finish: * @location: input #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes a mount operation started by g_file_mount_enclosing_volume(). * * Returns: %TRUE if successful. If an error has occurred, * this function will return %FALSE and set @error * appropriately if present. */ gboolean g_file_mount_enclosing_volume_finish (GFile *location, GAsyncResult *result, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (location), FALSE); g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE); if (g_async_result_legacy_propagate_error (result, error)) return FALSE; else if (g_async_result_is_tagged (result, g_file_mount_enclosing_volume)) return g_task_propagate_boolean (G_TASK (result), error); iface = G_FILE_GET_IFACE (location); return (* iface->mount_enclosing_volume_finish) (location, result, error); } /******************************************** * Utility functions * ********************************************/ /** * g_file_query_default_handler: * @file: a #GFile to open * @cancellable: optional #GCancellable object, %NULL to ignore * @error: a #GError, or %NULL * * Returns the #GAppInfo that is registered as the default * application to handle the file specified by @file. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: (transfer full): a #GAppInfo if the handle was found, * %NULL if there were errors. * When you are done with it, release it with g_object_unref() */ GAppInfo * g_file_query_default_handler (GFile *file, GCancellable *cancellable, GError **error) { char *uri_scheme; const char *content_type; GAppInfo *appinfo; GFileInfo *info; char *path; uri_scheme = g_file_get_uri_scheme (file); if (uri_scheme && uri_scheme[0] != '\0') { appinfo = g_app_info_get_default_for_uri_scheme (uri_scheme); g_free (uri_scheme); if (appinfo != NULL) return appinfo; } else g_free (uri_scheme); info = g_file_query_info (file, G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE "," G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE, 0, cancellable, error); if (info == NULL) return NULL; appinfo = NULL; content_type = g_file_info_get_content_type (info); if (content_type == NULL) content_type = g_file_info_get_attribute_string (info, G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE); if (content_type) { /* Don't use is_native(), as we want to support fuse paths if available */ path = g_file_get_path (file); appinfo = g_app_info_get_default_for_type (content_type, path == NULL); g_free (path); } g_object_unref (info); if (appinfo != NULL) return appinfo; g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("No application is registered as handling this file")); return NULL; } static void query_default_handler_query_app_info_for_type_cb (GObject *object, GAsyncResult *result, gpointer user_data) { GTask *task = G_TASK (user_data); GAppInfo *appinfo; GError *error = NULL; appinfo = g_app_info_get_default_for_type_finish (result, &error); if (appinfo != NULL) { g_task_return_pointer (task, g_steal_pointer (&appinfo), g_object_unref); } else if (g_error_matches (error, G_IO_ERROR, G_IO_ERROR_NOT_FOUND)) { g_task_return_new_error_literal (task, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, error->message); } else { g_task_return_error (task, g_steal_pointer (&error)); } g_clear_error (&error); g_object_unref (task); } static void query_default_handler_query_info_cb (GObject *object, GAsyncResult *result, gpointer user_data) { GFile *file = G_FILE (object); GTask *task = G_TASK (user_data); GError *error = NULL; GFileInfo *info; const char *content_type; info = g_file_query_info_finish (file, result, &error); if (info == NULL) { g_task_return_error (task, g_steal_pointer (&error)); g_object_unref (task); return; } content_type = g_file_info_get_content_type (info); if (content_type == NULL) content_type = g_file_info_get_attribute_string (info, G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE); if (content_type) { GCancellable *cancellable = g_task_get_cancellable (task); char *path; /* Don't use is_native(), as we want to support fuse paths if available */ path = g_file_get_path (file); g_app_info_get_default_for_type_async (content_type, path == NULL, cancellable, query_default_handler_query_app_info_for_type_cb, g_steal_pointer (&task)); g_free (path); } else { g_task_return_new_error_literal (task, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("No application is registered as handling this file")); } g_object_unref (info); g_clear_object (&task); } static void on_query_default_handler_for_uri_cb (GObject *object, GAsyncResult *result, gpointer user_data) { GTask *task = user_data; GAppInfo *app_info; app_info = g_app_info_get_default_for_uri_scheme_finish (result, NULL); if (app_info) { g_task_return_pointer (task, g_steal_pointer (&app_info), g_object_unref); g_object_unref (task); } else { g_file_query_info_async (g_task_get_source_object (task), G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE "," G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE, 0, g_task_get_priority (task), g_task_get_cancellable (task), query_default_handler_query_info_cb, task); } } /** * g_file_query_default_handler_async: * @file: a #GFile to open * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: optional #GCancellable object, %NULL to ignore * @callback: (nullable): a #GAsyncReadyCallback to call when the request is done * @user_data: (nullable): data to pass to @callback * * Async version of g_file_query_default_handler(). * * Since: 2.60 */ void g_file_query_default_handler_async (GFile *file, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GTask *task; char *uri_scheme; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_query_default_handler_async); uri_scheme = g_file_get_uri_scheme (file); if (uri_scheme && uri_scheme[0] != '\0') { g_app_info_get_default_for_uri_scheme_async (uri_scheme, cancellable, on_query_default_handler_for_uri_cb, g_steal_pointer (&task)); g_free (uri_scheme); return; } g_file_query_info_async (file, G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE "," G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE, 0, io_priority, cancellable, query_default_handler_query_info_cb, g_steal_pointer (&task)); g_free (uri_scheme); } /** * g_file_query_default_handler_finish: * @file: a #GFile to open * @result: a #GAsyncResult * @error: (nullable): a #GError * * Finishes a g_file_query_default_handler_async() operation. * * Returns: (transfer full): a #GAppInfo if the handle was found, * %NULL if there were errors. * When you are done with it, release it with g_object_unref() * * Since: 2.60 */ GAppInfo * g_file_query_default_handler_finish (GFile *file, GAsyncResult *result, GError **error) { g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (g_task_is_valid (result, file), NULL); return g_task_propagate_pointer (G_TASK (result), error); } #define GET_CONTENT_BLOCK_SIZE 8192 /** * g_file_load_contents: * @file: input #GFile * @cancellable: optional #GCancellable object, %NULL to ignore * @contents: (out) (transfer full) (element-type guint8) (array length=length): a location to place the contents of the file * @length: (out) (optional): a location to place the length of the contents of the file, * or %NULL if the length is not needed * @etag_out: (out) (optional) (nullable): a location to place the current entity tag for the file, * or %NULL if the entity tag is not needed * @error: a #GError, or %NULL * * Loads the content of the file into memory. The data is always * zero-terminated, but this is not included in the resultant @length. * The returned @contents should be freed with g_free() when no longer * needed. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * Returns: %TRUE if the @file's contents were successfully loaded. * %FALSE if there were errors. */ gboolean g_file_load_contents (GFile *file, GCancellable *cancellable, char **contents, gsize *length, char **etag_out, GError **error) { GFileInputStream *in; char *data; gsize size; gsize pos; gssize res; GFileInfo *info; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (contents != NULL, FALSE); in = g_file_read (file, cancellable, error); if (in == NULL) return FALSE; size = GET_CONTENT_BLOCK_SIZE; data = g_malloc (GET_CONTENT_BLOCK_SIZE); pos = 0; while ((res = g_input_stream_read (G_INPUT_STREAM (in), data + pos, GET_CONTENT_BLOCK_SIZE, cancellable, error)) > 0) { pos += res; if (size - pos < GET_CONTENT_BLOCK_SIZE) { g_assert (size <= G_MAXSIZE / 2); size *= 2; data = g_realloc (data, size); } } if (etag_out) { *etag_out = NULL; info = g_file_input_stream_query_info (in, G_FILE_ATTRIBUTE_ETAG_VALUE, cancellable, NULL); if (info) { *etag_out = g_file_info_has_attribute (info, G_FILE_ATTRIBUTE_ETAG_VALUE) ? g_strdup (g_file_info_get_etag (info)) : NULL; g_object_unref (info); } } /* Ignore errors on close */ g_input_stream_close (G_INPUT_STREAM (in), cancellable, NULL); g_object_unref (in); if (res < 0) { /* error is set already */ g_free (data); return FALSE; } if (length) *length = pos; /* Zero terminate (allocating extra bytes if needed) */ if (pos >= size) data = g_realloc (data, pos + 1); data[pos] = 0; *contents = g_steal_pointer (&data); return TRUE; } typedef struct { GTask *task; GFileReadMoreCallback read_more_callback; char *data; gsize size; gsize pos; char *etag; } LoadContentsData; static void load_contents_data_free (LoadContentsData *data) { g_clear_pointer (&data->data, g_free); g_free (data->etag); g_free (data); } static void load_contents_data_ensure_space (LoadContentsData *data, gsize space) { if (data->size - data->pos < space) { if (data->data == NULL) { data->size = space; data->data = g_malloc (space); } else { g_assert (data->size <= G_MAXSIZE / 2); data->size *= 2; data->data = g_realloc (data->data, data->size); } } } static void load_contents_close_callback (GObject *obj, GAsyncResult *close_res, gpointer user_data) { GInputStream *stream = G_INPUT_STREAM (obj); LoadContentsData *data = user_data; /* Ignore errors here, we're only reading anyway */ g_input_stream_close_finish (stream, close_res, NULL); g_object_unref (stream); g_task_return_boolean (data->task, TRUE); g_object_unref (data->task); } static void load_contents_fstat_callback (GObject *obj, GAsyncResult *stat_res, gpointer user_data) { GInputStream *stream = G_INPUT_STREAM (obj); LoadContentsData *data = user_data; GFileInfo *info; info = g_file_input_stream_query_info_finish (G_FILE_INPUT_STREAM (stream), stat_res, NULL); if (info) { data->etag = g_file_info_has_attribute (info, G_FILE_ATTRIBUTE_ETAG_VALUE) ? g_strdup (g_file_info_get_etag (info)) : NULL; g_object_unref (info); } g_input_stream_close_async (stream, 0, g_task_get_cancellable (data->task), load_contents_close_callback, data); } static void load_contents_read_callback (GObject *obj, GAsyncResult *read_res, gpointer user_data) { GInputStream *stream = G_INPUT_STREAM (obj); LoadContentsData *data = user_data; GError *error = NULL; gssize read_size; read_size = g_input_stream_read_finish (stream, read_res, &error); if (read_size < 0) { g_task_return_error (data->task, error); g_object_unref (data->task); /* Close the file ignoring any error */ g_input_stream_close_async (stream, 0, NULL, NULL, NULL); g_object_unref (stream); } else if (read_size == 0) { g_file_input_stream_query_info_async (G_FILE_INPUT_STREAM (stream), G_FILE_ATTRIBUTE_ETAG_VALUE, 0, g_task_get_cancellable (data->task), load_contents_fstat_callback, data); } else if (read_size > 0) { data->pos += read_size; load_contents_data_ensure_space (data, GET_CONTENT_BLOCK_SIZE); if (data->read_more_callback && !data->read_more_callback (data->data, data->pos, g_async_result_get_user_data (G_ASYNC_RESULT (data->task)))) g_file_input_stream_query_info_async (G_FILE_INPUT_STREAM (stream), G_FILE_ATTRIBUTE_ETAG_VALUE, 0, g_task_get_cancellable (data->task), load_contents_fstat_callback, data); else g_input_stream_read_async (stream, data->data + data->pos, GET_CONTENT_BLOCK_SIZE, 0, g_task_get_cancellable (data->task), load_contents_read_callback, data); } } static void load_contents_open_callback (GObject *obj, GAsyncResult *open_res, gpointer user_data) { GFile *file = G_FILE (obj); GFileInputStream *stream; LoadContentsData *data = user_data; GError *error = NULL; stream = g_file_read_finish (file, open_res, &error); if (stream) { load_contents_data_ensure_space (data, GET_CONTENT_BLOCK_SIZE); g_input_stream_read_async (G_INPUT_STREAM (stream), data->data + data->pos, GET_CONTENT_BLOCK_SIZE, 0, g_task_get_cancellable (data->task), load_contents_read_callback, data); } else { g_task_return_error (data->task, error); g_object_unref (data->task); } } /** * g_file_load_partial_contents_async: (skip) * @file: input #GFile * @cancellable: optional #GCancellable object, %NULL to ignore * @read_more_callback: (scope call) (closure user_data): a * #GFileReadMoreCallback to receive partial data * and to specify whether further data should be read * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback to call * when the request is satisfied * @user_data: the data to pass to the callback functions * * Reads the partial contents of a file. A #GFileReadMoreCallback should * be used to stop reading from the file when appropriate, else this * function will behave exactly as g_file_load_contents_async(). This * operation can be finished by g_file_load_partial_contents_finish(). * * Users of this function should be aware that @user_data is passed to * both the @read_more_callback and the @callback. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. */ void g_file_load_partial_contents_async (GFile *file, GCancellable *cancellable, GFileReadMoreCallback read_more_callback, GAsyncReadyCallback callback, gpointer user_data) { LoadContentsData *data; g_return_if_fail (G_IS_FILE (file)); data = g_new0 (LoadContentsData, 1); data->read_more_callback = read_more_callback; data->task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (data->task, g_file_load_partial_contents_async); g_task_set_task_data (data->task, data, (GDestroyNotify)load_contents_data_free); g_file_read_async (file, 0, g_task_get_cancellable (data->task), load_contents_open_callback, data); } /** * g_file_load_partial_contents_finish: * @file: input #GFile * @res: a #GAsyncResult * @contents: (out) (transfer full) (element-type guint8) (array length=length): a location to place the contents of the file * @length: (out) (optional): a location to place the length of the contents of the file, * or %NULL if the length is not needed * @etag_out: (out) (optional) (nullable): a location to place the current entity tag for the file, * or %NULL if the entity tag is not needed * @error: a #GError, or %NULL * * Finishes an asynchronous partial load operation that was started * with g_file_load_partial_contents_async(). The data is always * zero-terminated, but this is not included in the resultant @length. * The returned @contents should be freed with g_free() when no longer * needed. * * Returns: %TRUE if the load was successful. If %FALSE and @error is * present, it will be set appropriately. */ gboolean g_file_load_partial_contents_finish (GFile *file, GAsyncResult *res, char **contents, gsize *length, char **etag_out, GError **error) { GTask *task; LoadContentsData *data; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (g_task_is_valid (res, file), FALSE); g_return_val_if_fail (contents != NULL, FALSE); task = G_TASK (res); if (!g_task_propagate_boolean (task, error)) { if (length) *length = 0; return FALSE; } data = g_task_get_task_data (task); if (length) *length = data->pos; if (etag_out) { *etag_out = data->etag; data->etag = NULL; } /* Zero terminate */ load_contents_data_ensure_space (data, 1); data->data[data->pos] = 0; *contents = g_steal_pointer (&data->data); return TRUE; } /** * g_file_load_contents_async: * @file: input #GFile * @cancellable: optional #GCancellable object, %NULL to ignore * @callback: a #GAsyncReadyCallback to call when the request is satisfied * @user_data: the data to pass to callback function * * Starts an asynchronous load of the @file's contents. * * For more details, see g_file_load_contents() which is * the synchronous version of this call. * * When the load operation has completed, @callback will be called * with @user data. To finish the operation, call * g_file_load_contents_finish() with the #GAsyncResult returned by * the @callback. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. */ void g_file_load_contents_async (GFile *file, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { g_file_load_partial_contents_async (file, cancellable, NULL, callback, user_data); } /** * g_file_load_contents_finish: * @file: input #GFile * @res: a #GAsyncResult * @contents: (out) (transfer full) (element-type guint8) (array length=length): a location to place the contents of the file * @length: (out) (optional): a location to place the length of the contents of the file, * or %NULL if the length is not needed * @etag_out: (out) (optional) (nullable): a location to place the current entity tag for the file, * or %NULL if the entity tag is not needed * @error: a #GError, or %NULL * * Finishes an asynchronous load of the @file's contents. * The contents are placed in @contents, and @length is set to the * size of the @contents string. The @contents should be freed with * g_free() when no longer needed. If @etag_out is present, it will be * set to the new entity tag for the @file. * * Returns: %TRUE if the load was successful. If %FALSE and @error is * present, it will be set appropriately. */ gboolean g_file_load_contents_finish (GFile *file, GAsyncResult *res, char **contents, gsize *length, char **etag_out, GError **error) { return g_file_load_partial_contents_finish (file, res, contents, length, etag_out, error); } /** * g_file_replace_contents: * @file: input #GFile * @contents: (element-type guint8) (array length=length): a string containing the new contents for @file * @length: the length of @contents in bytes * @etag: (nullable): the old [entity-tag](#entity-tags) for the document, * or %NULL * @make_backup: %TRUE if a backup should be created * @flags: a set of #GFileCreateFlags * @new_etag: (out) (optional) (nullable): a location to a new [entity tag](#entity-tags) * for the document. This should be freed with g_free() when no longer * needed, or %NULL * @cancellable: optional #GCancellable object, %NULL to ignore * @error: a #GError, or %NULL * * Replaces the contents of @file with @contents of @length bytes. * * If @etag is specified (not %NULL), any existing file must have that etag, * or the error %G_IO_ERROR_WRONG_ETAG will be returned. * * If @make_backup is %TRUE, this function will attempt to make a backup * of @file. Internally, it uses g_file_replace(), so will try to replace the * file contents in the safest way possible. For example, atomic renames are * used when replacing local files’ contents. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * The returned @new_etag can be used to verify that the file hasn't * changed the next time it is saved over. * * Returns: %TRUE if successful. If an error has occurred, this function * will return %FALSE and set @error appropriately if present. */ gboolean g_file_replace_contents (GFile *file, const char *contents, gsize length, const char *etag, gboolean make_backup, GFileCreateFlags flags, char **new_etag, GCancellable *cancellable, GError **error) { GFileOutputStream *out; gsize pos, remainder; gssize res = -1; gboolean ret; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (contents != NULL, FALSE); out = g_file_replace (file, etag, make_backup, flags, cancellable, error); if (out == NULL) return FALSE; pos = 0; remainder = length; while (remainder > 0 && (res = g_output_stream_write (G_OUTPUT_STREAM (out), contents + pos, MIN (remainder, GET_CONTENT_BLOCK_SIZE), cancellable, error)) > 0) { pos += res; remainder -= res; } if (remainder > 0 && res < 0) { /* Ignore errors on close */ g_output_stream_close (G_OUTPUT_STREAM (out), cancellable, NULL); g_object_unref (out); /* error is set already */ return FALSE; } ret = g_output_stream_close (G_OUTPUT_STREAM (out), cancellable, error); if (new_etag) *new_etag = g_file_output_stream_get_etag (out); g_object_unref (out); return ret; } typedef struct { GTask *task; GBytes *content; gsize pos; char *etag; gboolean failed; } ReplaceContentsData; static void replace_contents_data_free (ReplaceContentsData *data) { g_bytes_unref (data->content); g_free (data->etag); g_free (data); } static void replace_contents_close_callback (GObject *obj, GAsyncResult *close_res, gpointer user_data) { GOutputStream *stream = G_OUTPUT_STREAM (obj); ReplaceContentsData *data = user_data; /* Ignore errors here, we're only reading anyway */ g_output_stream_close_finish (stream, close_res, NULL); if (!data->failed) { data->etag = g_file_output_stream_get_etag (G_FILE_OUTPUT_STREAM (stream)); g_task_return_boolean (data->task, TRUE); } g_object_unref (data->task); } static void replace_contents_write_callback (GObject *obj, GAsyncResult *read_res, gpointer user_data) { GOutputStream *stream = G_OUTPUT_STREAM (obj); ReplaceContentsData *data = user_data; GError *error = NULL; gssize write_size; write_size = g_output_stream_write_finish (stream, read_res, &error); if (write_size <= 0) { /* Error or EOF, close the file */ if (write_size < 0) { data->failed = TRUE; g_task_return_error (data->task, error); } g_output_stream_close_async (stream, 0, g_task_get_cancellable (data->task), replace_contents_close_callback, data); } else if (write_size > 0) { const gchar *content; gsize length; content = g_bytes_get_data (data->content, &length); data->pos += write_size; if (data->pos >= length) g_output_stream_close_async (stream, 0, g_task_get_cancellable (data->task), replace_contents_close_callback, data); else g_output_stream_write_async (stream, content + data->pos, length - data->pos, 0, g_task_get_cancellable (data->task), replace_contents_write_callback, data); } } static void replace_contents_open_callback (GObject *obj, GAsyncResult *open_res, gpointer user_data) { GFile *file = G_FILE (obj); GFileOutputStream *stream; ReplaceContentsData *data = user_data; GError *error = NULL; stream = g_file_replace_finish (file, open_res, &error); if (stream) { const gchar *content; gsize length; content = g_bytes_get_data (data->content, &length); g_output_stream_write_async (G_OUTPUT_STREAM (stream), content + data->pos, length - data->pos, 0, g_task_get_cancellable (data->task), replace_contents_write_callback, data); g_object_unref (stream); /* ownership is transferred to the write_async() call above */ } else { g_task_return_error (data->task, error); g_object_unref (data->task); } } /** * g_file_replace_contents_async: * @file: input #GFile * @contents: (element-type guint8) (array length=length): string of contents to replace the file with * @length: the length of @contents in bytes * @etag: (nullable): a new [entity tag](#entity-tags) for the @file, or %NULL * @make_backup: %TRUE if a backup should be created * @flags: a set of #GFileCreateFlags * @cancellable: optional #GCancellable object, %NULL to ignore * @callback: a #GAsyncReadyCallback to call when the request is satisfied * @user_data: the data to pass to callback function * * Starts an asynchronous replacement of @file with the given * @contents of @length bytes. @etag will replace the document's * current entity tag. * * When this operation has completed, @callback will be called with * @user_user data, and the operation can be finalized with * g_file_replace_contents_finish(). * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * If @make_backup is %TRUE, this function will attempt to * make a backup of @file. * * Note that no copy of @contents will be made, so it must stay valid * until @callback is called. See g_file_replace_contents_bytes_async() * for a #GBytes version that will automatically hold a reference to the * contents (without copying) for the duration of the call. */ void g_file_replace_contents_async (GFile *file, const char *contents, gsize length, const char *etag, gboolean make_backup, GFileCreateFlags flags, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GBytes *bytes; bytes = g_bytes_new_static (contents, length); g_file_replace_contents_bytes_async (file, bytes, etag, make_backup, flags, cancellable, callback, user_data); g_bytes_unref (bytes); } /** * g_file_replace_contents_bytes_async: * @file: input #GFile * @contents: a #GBytes * @etag: (nullable): a new [entity tag](#entity-tags) for the @file, or %NULL * @make_backup: %TRUE if a backup should be created * @flags: a set of #GFileCreateFlags * @cancellable: optional #GCancellable object, %NULL to ignore * @callback: a #GAsyncReadyCallback to call when the request is satisfied * @user_data: the data to pass to callback function * * Same as g_file_replace_contents_async() but takes a #GBytes input instead. * This function will keep a ref on @contents until the operation is done. * Unlike g_file_replace_contents_async() this allows forgetting about the * content without waiting for the callback. * * When this operation has completed, @callback will be called with * @user_user data, and the operation can be finalized with * g_file_replace_contents_finish(). * * Since: 2.40 */ void g_file_replace_contents_bytes_async (GFile *file, GBytes *contents, const char *etag, gboolean make_backup, GFileCreateFlags flags, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { ReplaceContentsData *data; g_return_if_fail (G_IS_FILE (file)); g_return_if_fail (contents != NULL); data = g_new0 (ReplaceContentsData, 1); data->content = g_bytes_ref (contents); data->task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (data->task, g_file_replace_contents_bytes_async); g_task_set_task_data (data->task, data, (GDestroyNotify)replace_contents_data_free); g_file_replace_async (file, etag, make_backup, flags, 0, g_task_get_cancellable (data->task), replace_contents_open_callback, data); } /** * g_file_replace_contents_finish: * @file: input #GFile * @res: a #GAsyncResult * @new_etag: (out) (optional) (nullable): a location of a new [entity tag](#entity-tags) * for the document. This should be freed with g_free() when it is no * longer needed, or %NULL * @error: a #GError, or %NULL * * Finishes an asynchronous replace of the given @file. See * g_file_replace_contents_async(). Sets @new_etag to the new entity * tag for the document, if present. * * Returns: %TRUE on success, %FALSE on failure. */ gboolean g_file_replace_contents_finish (GFile *file, GAsyncResult *res, char **new_etag, GError **error) { GTask *task; ReplaceContentsData *data; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (g_task_is_valid (res, file), FALSE); task = G_TASK (res); if (!g_task_propagate_boolean (task, error)) return FALSE; data = g_task_get_task_data (task); if (new_etag) { *new_etag = data->etag; data->etag = NULL; /* Take ownership */ } return TRUE; } gboolean g_file_real_measure_disk_usage (GFile *file, GFileMeasureFlags flags, GCancellable *cancellable, GFileMeasureProgressCallback progress_callback, gpointer progress_data, guint64 *disk_usage, guint64 *num_dirs, guint64 *num_files, GError **error) { g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, "Operation not supported for the current backend."); return FALSE; } typedef struct { GFileMeasureFlags flags; GFileMeasureProgressCallback progress_callback; gpointer progress_data; } MeasureTaskData; typedef struct { guint64 disk_usage; guint64 num_dirs; guint64 num_files; } MeasureResult; typedef struct { GFileMeasureProgressCallback callback; gpointer user_data; gboolean reporting; guint64 current_size; guint64 num_dirs; guint64 num_files; } MeasureProgress; static gboolean measure_disk_usage_invoke_progress (gpointer user_data) { MeasureProgress *progress = user_data; (* progress->callback) (progress->reporting, progress->current_size, progress->num_dirs, progress->num_files, progress->user_data); return FALSE; } static void measure_disk_usage_progress (gboolean reporting, guint64 current_size, guint64 num_dirs, guint64 num_files, gpointer user_data) { MeasureProgress progress; GTask *task = user_data; MeasureTaskData *data; data = g_task_get_task_data (task); progress.callback = data->progress_callback; progress.user_data = data->progress_data; progress.reporting = reporting; progress.current_size = current_size; progress.num_dirs = num_dirs; progress.num_files = num_files; g_main_context_invoke_full (g_task_get_context (task), g_task_get_priority (task), measure_disk_usage_invoke_progress, g_memdup2 (&progress, sizeof progress), g_free); } static void measure_disk_usage_thread (GTask *task, gpointer source_object, gpointer task_data, GCancellable *cancellable) { MeasureTaskData *data = task_data; GError *error = NULL; MeasureResult result = { 0, }; if (g_file_measure_disk_usage (source_object, data->flags, cancellable, data->progress_callback ? measure_disk_usage_progress : NULL, task, &result.disk_usage, &result.num_dirs, &result.num_files, &error)) g_task_return_pointer (task, g_memdup2 (&result, sizeof result), g_free); else g_task_return_error (task, error); } static void g_file_real_measure_disk_usage_async (GFile *file, GFileMeasureFlags flags, gint io_priority, GCancellable *cancellable, GFileMeasureProgressCallback progress_callback, gpointer progress_data, GAsyncReadyCallback callback, gpointer user_data) { MeasureTaskData data; GTask *task; data.flags = flags; data.progress_callback = progress_callback; data.progress_data = progress_data; task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_real_measure_disk_usage_async); g_task_set_task_data (task, g_memdup2 (&data, sizeof data), g_free); g_task_set_priority (task, io_priority); g_task_run_in_thread (task, measure_disk_usage_thread); g_object_unref (task); } static gboolean g_file_real_measure_disk_usage_finish (GFile *file, GAsyncResult *result, guint64 *disk_usage, guint64 *num_dirs, guint64 *num_files, GError **error) { MeasureResult *measure_result; g_return_val_if_fail (g_task_is_valid (result, file), FALSE); measure_result = g_task_propagate_pointer (G_TASK (result), error); if (measure_result == NULL) return FALSE; if (disk_usage) *disk_usage = measure_result->disk_usage; if (num_dirs) *num_dirs = measure_result->num_dirs; if (num_files) *num_files = measure_result->num_files; g_free (measure_result); return TRUE; } /** * g_file_measure_disk_usage: * @file: a #GFile * @flags: #GFileMeasureFlags * @cancellable: (nullable): optional #GCancellable * @progress_callback: (nullable) (scope call): a #GFileMeasureProgressCallback * @progress_data: user_data for @progress_callback * @disk_usage: (out) (optional): the number of bytes of disk space used * @num_dirs: (out) (optional): the number of directories encountered * @num_files: (out) (optional): the number of non-directories encountered * @error: (nullable): %NULL, or a pointer to a %NULL #GError pointer * * Recursively measures the disk usage of @file. * * This is essentially an analog of the 'du' command, but it also * reports the number of directories and non-directory files encountered * (including things like symbolic links). * * By default, errors are only reported against the toplevel file * itself. Errors found while recursing are silently ignored, unless * %G_FILE_MEASURE_REPORT_ANY_ERROR is given in @flags. * * The returned size, @disk_usage, is in bytes and should be formatted * with g_format_size() in order to get something reasonable for showing * in a user interface. * * @progress_callback and @progress_data can be given to request * periodic progress updates while scanning. See the documentation for * #GFileMeasureProgressCallback for information about when and how the * callback will be invoked. * * Returns: %TRUE if successful, with the out parameters set. * %FALSE otherwise, with @error set. * * Since: 2.38 **/ gboolean g_file_measure_disk_usage (GFile *file, GFileMeasureFlags flags, GCancellable *cancellable, GFileMeasureProgressCallback progress_callback, gpointer progress_data, guint64 *disk_usage, guint64 *num_dirs, guint64 *num_files, GError **error) { g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (cancellable == NULL || G_IS_CANCELLABLE (cancellable), FALSE); g_return_val_if_fail (error == NULL || *error == NULL, FALSE); return G_FILE_GET_IFACE (file)->measure_disk_usage (file, flags, cancellable, progress_callback, progress_data, disk_usage, num_dirs, num_files, error); } /** * g_file_measure_disk_usage_async: * @file: a #GFile * @flags: #GFileMeasureFlags * @io_priority: the [I/O priority](iface.AsyncResult.html#io-priority) of the request * @cancellable: (nullable): optional #GCancellable * @progress_callback: (nullable): a #GFileMeasureProgressCallback * @progress_data: user_data for @progress_callback * @callback: (nullable): a #GAsyncReadyCallback to call when complete * @user_data: the data to pass to callback function * * Recursively measures the disk usage of @file. * * This is the asynchronous version of g_file_measure_disk_usage(). See * there for more information. * * Since: 2.38 **/ void g_file_measure_disk_usage_async (GFile *file, GFileMeasureFlags flags, gint io_priority, GCancellable *cancellable, GFileMeasureProgressCallback progress_callback, gpointer progress_data, GAsyncReadyCallback callback, gpointer user_data) { g_return_if_fail (G_IS_FILE (file)); g_return_if_fail (cancellable == NULL || G_IS_CANCELLABLE (cancellable)); G_FILE_GET_IFACE (file)->measure_disk_usage_async (file, flags, io_priority, cancellable, progress_callback, progress_data, callback, user_data); } /** * g_file_measure_disk_usage_finish: * @file: a #GFile * @result: the #GAsyncResult passed to your #GAsyncReadyCallback * @disk_usage: (out) (optional): the number of bytes of disk space used * @num_dirs: (out) (optional): the number of directories encountered * @num_files: (out) (optional): the number of non-directories encountered * @error: (nullable): %NULL, or a pointer to a %NULL #GError pointer * * Collects the results from an earlier call to * g_file_measure_disk_usage_async(). See g_file_measure_disk_usage() for * more information. * * Returns: %TRUE if successful, with the out parameters set. * %FALSE otherwise, with @error set. * * Since: 2.38 **/ gboolean g_file_measure_disk_usage_finish (GFile *file, GAsyncResult *result, guint64 *disk_usage, guint64 *num_dirs, guint64 *num_files, GError **error) { g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (error == NULL || *error == NULL, FALSE); return G_FILE_GET_IFACE (file)->measure_disk_usage_finish (file, result, disk_usage, num_dirs, num_files, error); } /** * g_file_start_mountable: * @file: input #GFile * @flags: flags affecting the operation * @start_operation: (nullable): a #GMountOperation, or %NULL to avoid user interaction * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore * @callback: (nullable): a #GAsyncReadyCallback to call when the request is satisfied, or %NULL * @user_data: the data to pass to callback function * * Starts a file of type %G_FILE_TYPE_MOUNTABLE. * Using @start_operation, you can request callbacks when, for instance, * passwords are needed during authentication. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * When the operation is finished, @callback will be called. * You can then call g_file_mount_mountable_finish() to get * the result of the operation. * * Since: 2.22 */ void g_file_start_mountable (GFile *file, GDriveStartFlags flags, GMountOperation *start_operation, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); if (iface->start_mountable == NULL) { g_task_report_new_error (file, callback, user_data, g_file_start_mountable, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return; } (* iface->start_mountable) (file, flags, start_operation, cancellable, callback, user_data); } /** * g_file_start_mountable_finish: * @file: input #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes a start operation. See g_file_start_mountable() for details. * * Finish an asynchronous start operation that was started * with g_file_start_mountable(). * * Returns: %TRUE if the operation finished successfully. %FALSE * otherwise. * * Since: 2.22 */ gboolean g_file_start_mountable_finish (GFile *file, GAsyncResult *result, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE); if (g_async_result_legacy_propagate_error (result, error)) return FALSE; else if (g_async_result_is_tagged (result, g_file_start_mountable)) return g_task_propagate_boolean (G_TASK (result), error); iface = G_FILE_GET_IFACE (file); return (* iface->start_mountable_finish) (file, result, error); } /** * g_file_stop_mountable: * @file: input #GFile * @flags: flags affecting the operation * @mount_operation: (nullable): a #GMountOperation, * or %NULL to avoid user interaction. * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (nullable): a #GAsyncReadyCallback to call * when the request is satisfied, or %NULL * @user_data: the data to pass to callback function * * Stops a file of type %G_FILE_TYPE_MOUNTABLE. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * When the operation is finished, @callback will be called. * You can then call g_file_stop_mountable_finish() to get * the result of the operation. * * Since: 2.22 */ void g_file_stop_mountable (GFile *file, GMountUnmountFlags flags, GMountOperation *mount_operation, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); if (iface->stop_mountable == NULL) { g_task_report_new_error (file, callback, user_data, g_file_stop_mountable, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return; } (* iface->stop_mountable) (file, flags, mount_operation, cancellable, callback, user_data); } /** * g_file_stop_mountable_finish: * @file: input #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes a stop operation, see g_file_stop_mountable() for details. * * Finish an asynchronous stop operation that was started * with g_file_stop_mountable(). * * Returns: %TRUE if the operation finished successfully. * %FALSE otherwise. * * Since: 2.22 */ gboolean g_file_stop_mountable_finish (GFile *file, GAsyncResult *result, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE); if (g_async_result_legacy_propagate_error (result, error)) return FALSE; else if (g_async_result_is_tagged (result, g_file_stop_mountable)) return g_task_propagate_boolean (G_TASK (result), error); iface = G_FILE_GET_IFACE (file); return (* iface->stop_mountable_finish) (file, result, error); } /** * g_file_poll_mountable: * @file: input #GFile * @cancellable: optional #GCancellable object, %NULL to ignore * @callback: (nullable): a #GAsyncReadyCallback to call * when the request is satisfied, or %NULL * @user_data: the data to pass to callback function * * Polls a file of type %G_FILE_TYPE_MOUNTABLE. * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * * When the operation is finished, @callback will be called. * You can then call g_file_mount_mountable_finish() to get * the result of the operation. * * Since: 2.22 */ void g_file_poll_mountable (GFile *file, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GFileIface *iface; g_return_if_fail (G_IS_FILE (file)); iface = G_FILE_GET_IFACE (file); if (iface->poll_mountable == NULL) { g_task_report_new_error (file, callback, user_data, g_file_poll_mountable, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, _("Operation not supported")); return; } (* iface->poll_mountable) (file, cancellable, callback, user_data); } /** * g_file_poll_mountable_finish: * @file: input #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes a poll operation. See g_file_poll_mountable() for details. * * Finish an asynchronous poll operation that was polled * with g_file_poll_mountable(). * * Returns: %TRUE if the operation finished successfully. %FALSE * otherwise. * * Since: 2.22 */ gboolean g_file_poll_mountable_finish (GFile *file, GAsyncResult *result, GError **error) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE); if (g_async_result_legacy_propagate_error (result, error)) return FALSE; else if (g_async_result_is_tagged (result, g_file_poll_mountable)) return g_task_propagate_boolean (G_TASK (result), error); iface = G_FILE_GET_IFACE (file); return (* iface->poll_mountable_finish) (file, result, error); } /** * g_file_supports_thread_contexts: * @file: a #GFile * * Checks if @file supports * [thread-default contexts][g-main-context-push-thread-default-context]. * If this returns %FALSE, you cannot perform asynchronous operations on * @file in a thread that has a thread-default context. * * Returns: Whether or not @file supports thread-default contexts. * * Since: 2.22 */ gboolean g_file_supports_thread_contexts (GFile *file) { GFileIface *iface; g_return_val_if_fail (G_IS_FILE (file), FALSE); iface = G_FILE_GET_IFACE (file); return iface->supports_thread_contexts; } /** * g_file_load_bytes: * @file: a #GFile * @cancellable: (nullable): a #GCancellable or %NULL * @etag_out: (out) (nullable) (optional): a location to place the current * entity tag for the file, or %NULL if the entity tag is not needed * @error: a location for a #GError or %NULL * * Loads the contents of @file and returns it as #GBytes. * * If @file is a resource:// based URI, the resulting bytes will reference the * embedded resource instead of a copy. Otherwise, this is equivalent to calling * g_file_load_contents() and g_bytes_new_take(). * * For resources, @etag_out will be set to %NULL. * * The data contained in the resulting #GBytes is always zero-terminated, but * this is not included in the #GBytes length. The resulting #GBytes should be * freed with g_bytes_unref() when no longer in use. * * Returns: (transfer full): a #GBytes or %NULL and @error is set * * Since: 2.56 */ GBytes * g_file_load_bytes (GFile *file, GCancellable *cancellable, gchar **etag_out, GError **error) { gchar *contents; gsize len; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (cancellable == NULL || G_IS_CANCELLABLE (cancellable), NULL); g_return_val_if_fail (error == NULL || *error == NULL, NULL); if (etag_out != NULL) *etag_out = NULL; if (g_file_has_uri_scheme (file, "resource")) { GBytes *bytes; gchar *uri, *unescaped; uri = g_file_get_uri (file); unescaped = g_uri_unescape_string (uri + strlen ("resource://"), NULL); g_free (uri); bytes = g_resources_lookup_data (unescaped, G_RESOURCE_LOOKUP_FLAGS_NONE, error); g_free (unescaped); return bytes; } /* contents is guaranteed to be \0 terminated */ if (g_file_load_contents (file, cancellable, &contents, &len, etag_out, error)) return g_bytes_new_take (g_steal_pointer (&contents), len); return NULL; } static void g_file_load_bytes_cb (GObject *object, GAsyncResult *result, gpointer user_data) { GFile *file = G_FILE (object); GTask *task = user_data; GError *error = NULL; gchar *etag = NULL; gchar *contents = NULL; gsize len = 0; g_file_load_contents_finish (file, result, &contents, &len, &etag, &error); g_task_set_task_data (task, g_steal_pointer (&etag), g_free); if (error != NULL) g_task_return_error (task, g_steal_pointer (&error)); else g_task_return_pointer (task, g_bytes_new_take (g_steal_pointer (&contents), len), (GDestroyNotify)g_bytes_unref); g_object_unref (task); } /** * g_file_load_bytes_async: * @file: a #GFile * @cancellable: (nullable): a #GCancellable or %NULL * @callback: (scope async) (closure user_data): a #GAsyncReadyCallback * to call when the request is satisfied * @user_data: the data to pass to callback function * * Asynchronously loads the contents of @file as #GBytes. * * If @file is a resource:// based URI, the resulting bytes will reference the * embedded resource instead of a copy. Otherwise, this is equivalent to calling * g_file_load_contents_async() and g_bytes_new_take(). * * @callback should call g_file_load_bytes_finish() to get the result of this * asynchronous operation. * * See g_file_load_bytes() for more information. * * Since: 2.56 */ void g_file_load_bytes_async (GFile *file, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { GError *error = NULL; GBytes *bytes; GTask *task; g_return_if_fail (G_IS_FILE (file)); g_return_if_fail (cancellable == NULL || G_IS_CANCELLABLE (cancellable)); task = g_task_new (file, cancellable, callback, user_data); g_task_set_source_tag (task, g_file_load_bytes_async); if (!g_file_has_uri_scheme (file, "resource")) { g_file_load_contents_async (file, cancellable, g_file_load_bytes_cb, g_steal_pointer (&task)); return; } bytes = g_file_load_bytes (file, cancellable, NULL, &error); if (bytes == NULL) g_task_return_error (task, g_steal_pointer (&error)); else g_task_return_pointer (task, g_steal_pointer (&bytes), (GDestroyNotify)g_bytes_unref); g_object_unref (task); } /** * g_file_load_bytes_finish: * @file: a #GFile * @result: a #GAsyncResult provided to the callback * @etag_out: (out) (nullable) (optional): a location to place the current * entity tag for the file, or %NULL if the entity tag is not needed * @error: a location for a #GError, or %NULL * * Completes an asynchronous request to g_file_load_bytes_async(). * * For resources, @etag_out will be set to %NULL. * * The data contained in the resulting #GBytes is always zero-terminated, but * this is not included in the #GBytes length. The resulting #GBytes should be * freed with g_bytes_unref() when no longer in use. * * See g_file_load_bytes() for more information. * * Returns: (transfer full): a #GBytes or %NULL and @error is set * * Since: 2.56 */ GBytes * g_file_load_bytes_finish (GFile *file, GAsyncResult *result, gchar **etag_out, GError **error) { GBytes *bytes; g_return_val_if_fail (G_IS_FILE (file), NULL); g_return_val_if_fail (G_IS_TASK (result), NULL); g_return_val_if_fail (g_task_is_valid (G_TASK (result), file), NULL); g_return_val_if_fail (error == NULL || *error == NULL, NULL); bytes = g_task_propagate_pointer (G_TASK (result), error); if (etag_out != NULL) *etag_out = g_strdup (g_task_get_task_data (G_TASK (result))); return bytes; }