1 /* GIO - GLib Input, Output and Streaming Library
3 * Copyright (C) 2006-2007 Red Hat, Inc.
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General
16 * Public License along with this library; if not, write to the
17 * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
18 * Boston, MA 02111-1307, USA.
20 * Author: Alexander Larsson <alexl@redhat.com>
26 #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
27 #error "Only <gio/gio.h> can be included directly."
30 #include <gio/giotypes.h>
34 #define G_TYPE_FILE (g_file_get_type ())
35 #define G_FILE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), G_TYPE_FILE, GFile))
36 #define G_IS_FILE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), G_TYPE_FILE))
37 #define G_FILE_GET_IFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), G_TYPE_FILE, GFileIface))
43 * A handle to an object implementing the #GFileIface interface.
44 * Generally stores a location within the file system. Handles do not
45 * necessarily represent files or directories that currently exist.
47 typedef struct _GFile GFile; /* Dummy typedef */
49 typedef struct _GFileIface GFileIface;
54 * @g_iface: The parent interface.
55 * @dup: Duplicates a #GFile.
56 * @hash: Creates a hash of a #GFile.
57 * @equal: Checks equality of two given #GFile<!-- -->s.
58 * @is_native: Checks to see if a file is native to the system.
59 * @has_uri_scheme: Checks to see if a #GFile has a given URI scheme.
60 * @get_uri_scheme: Gets the URI scheme for a #GFile.
61 * @get_basename: Gets the basename for a given #GFile.
62 * @get_path: Gets the current path within a #GFile.
63 * @get_uri: Gets a URI for the path within a #GFile.
64 * @get_parse_name: Gets the parsed name for the #GFile.
65 * @get_parent: Gets the parent directory for the #GFile.
66 * @prefix_matches: Checks whether a #GFile contains a specified file.
67 * @get_relative_path: Gets the path for a #GFile relative to a given path.
68 * @resolve_relative_path: Resolves a relative path for a #GFile to an absolute path.
69 * @get_child_for_display_name: Gets the child #GFile for a given display name.
70 * @enumerate_children: Gets a #GFileEnumerator with the children of a #GFile.
71 * @enumerate_children_async: Asynchronously gets a #GFileEnumerator with the children of a #GFile.
72 * @enumerate_children_finish: Finishes asynchronously enumerating the children.
73 * @query_info: Gets the #GFileInfo for a #GFile.
74 * @query_info_async: Asynchronously gets the #GFileInfo for a #GFile.
75 * @query_info_finish: Finishes an asynchronous query info operation.
76 * @query_filesystem_info: Gets a #GFileInfo for the file system #GFile is on.
77 * @query_filesystem_info_async: Asynchronously gets a #GFileInfo for the file system #GFile is on.
78 * @query_filesystem_info_finish: Finishes asynchronously getting the file system info.
79 * @find_enclosing_mount: Gets a #GMount for the #GFile.
80 * @find_enclosing_mount_async: Asynchronously gets the #GMount for a #GFile.
81 * @find_enclosing_mount_finish: Finishes asynchronously getting the volume.
82 * @set_display_name: Sets the display name for a #GFile.
83 * @set_display_name_async: Asynchronously sets a #GFile's display name.
84 * @set_display_name_finish: Finishes asynchronously setting a #GFile's display name.
85 * @query_settable_attributes: Returns a list of #GFileAttribute<!-- -->s that can be set.
86 * @_query_settable_attributes_async: Asynchronously gets a list of #GFileAttribute<!-- -->s that can be set.
87 * @_query_settable_attributes_finish: Finishes asynchronously querying settable attributes.
88 * @query_writable_namespaces: Returns a list of #GFileAttribute namespaces that are writable.
89 * @_query_writable_namespaces_async: Asynchronously gets a list of #GFileAttribute namespaces that are writable.
90 * @_query_writable_namespaces_finish: Finishes asynchronously querying the writable namespaces.
91 * @set_attribute: Sets a #GFileAttribute.
92 * @set_attributes_from_info: Sets a #GFileAttribute with information from a #GFileInfo.
93 * @set_attributes_async: Asynchronously sets a file's attributes.
94 * @set_attributes_finish: Finishes setting a file's attributes asynchronously.
95 * @read_fn: Reads a file asynchronously.
96 * @read_async: Asynchronously reads a file.
97 * @read_finish: Finishes asynchronously reading a file.
98 * @append_to: Writes to the end of a file.
99 * @append_to_async: Asynchronously writes to the end of a file.
100 * @append_to_finish: Finishes an asynchronous file append operation.
101 * @create: Creates a new file.
102 * @create_async: Asynchronously creates a file.
103 * @create_finish: Finishes asynchronously creating a file.
104 * @replace: Replaces the contents of a file.
105 * @replace_async: Asynchronously replaces the contents of a file.
106 * @replace_finish: Finishes asynchronously replacing a file.
107 * @delete_file: Deletes a file.
108 * @delete_file_async: Asynchronously deletes a file.
109 * @delete_file_finish: Finishes an asynchronous delete.
110 * @trash: Sends a #GFile to the Trash location.
111 * @trash_async: Asynchronously sends a #GFile to the Trash location.
112 * @trash_finish: Finishes an asynchronous file trashing operation.
113 * @make_directory: Makes a directory.
114 * @make_directory_async: Asynchronously makes a directory.
115 * @make_directory_finish: Finishes making a directory asynchronously.
116 * @make_symbolic_link: Makes a symbolic link.
117 * @_make_symbolic_link_async: Asynchronously makes a symbolic link
118 * @_make_symbolic_link_finish: Finishes making a symbolic link asynchronously.
119 * @copy: Copies a file.
120 * @copy_async: Asynchronously copies a file.
121 * @copy_finish: Finishes an asynchronous copy operation.
122 * @move: Moves a file.
123 * @_move_async: Asynchronously moves a file.
124 * @_move_finish: Finishes an asynchronous move operation.
125 * @mount_mountable: Mounts a mountable object.
126 * @mount_mountable_finish: Finishes a mounting operation.
127 * @unmount_mountable: Unmounts a mountable object.
128 * @unmount_mountable_finish: Finishes an unmount operation.
129 * @eject_mountable: Ejects a mountable.
130 * @eject_mountable_finish: Finishes an eject operation.
131 * @mount_enclosing_volume: Mounts a specified location.
132 * @mount_enclosing_volume_finish: Finishes mounting a specified location.
133 * @monitor_dir: Creates a #GFileMonitor for the location.
134 * @monitor_file: Creates a #GFileMonitor for the location.
135 * @open_readwrite: Open file read/write. Since 2.22.
136 * @open_readwrite_async: Asynchronously opens file read/write. Since 2.22.
137 * @open_readwrite_finish: Finishes an asynchronous open read/write. Since 2.22.
138 * @create_readwrite: Creates file read/write. Since 2.22.
139 * @create_readwrite_async: Asynchronously creates file read/write. Since 2.22.
140 * @create_readwrite_finish: Finishes an asynchronous creates read/write. Since 2.22.
141 * @replace_readwrite: Replaces file read/write. Since 2.22.
142 * @replace_readwrite_async: Asynchronously replaces file read/write. Since 2.22.
143 * @replace_readwrite_finish: Finishes an asynchronous replace read/write. Since 2.22.
144 * @start_mountable: Starts a mountable object. Since 2.22.
145 * @start_mountable_finish: Finishes an start operation. Since 2.22.
146 * @stop_mountable: Stops a mountable. Since 2.22.
147 * @stop_mountable_finish: Finishes an stop operation. Since 2.22.
148 * @supports_thread_contexts: a boolean that indicates whether the #GFile implementation supports thread-default contexts. Since 2.22.
149 * @unmount_mountable_with_operation: Unmounts a mountable object using a #GMountOperation. Since 2.22.
150 * @unmount_mountable_with_operation_finish: Finishes an unmount operation using a #GMountOperation. Since 2.22.
151 * @eject_mountable_with_operation: Ejects a mountable object using a #GMountOperation. Since 2.22.
152 * @eject_mountable_with_operation_finish: Finishes an eject operation using a #GMountOperation. Since 2.22.
153 * @poll_mountable: Polls a mountable object for media changes. Since 2.22.
154 * @poll_mountable_finish: Finishes an poll operation for media changes. Since 2.22.
156 * An interface for writing VFS file handles.
160 GTypeInterface g_iface;
164 GFile * (* dup) (GFile *file);
165 guint (* hash) (GFile *file);
166 gboolean (* equal) (GFile *file1,
168 gboolean (* is_native) (GFile *file);
169 gboolean (* has_uri_scheme) (GFile *file,
170 const char *uri_scheme);
171 char * (* get_uri_scheme) (GFile *file);
172 char * (* get_basename) (GFile *file);
173 char * (* get_path) (GFile *file);
174 char * (* get_uri) (GFile *file);
175 char * (* get_parse_name) (GFile *file);
176 GFile * (* get_parent) (GFile *file);
177 gboolean (* prefix_matches) (GFile *prefix,
179 char * (* get_relative_path) (GFile *parent,
181 GFile * (* resolve_relative_path) (GFile *file,
182 const char *relative_path);
183 GFile * (* get_child_for_display_name) (GFile *file,
184 const char *display_name,
187 GFileEnumerator * (* enumerate_children) (GFile *file,
188 const char *attributes,
189 GFileQueryInfoFlags flags,
190 GCancellable *cancellable,
192 void (* enumerate_children_async) (GFile *file,
193 const char *attributes,
194 GFileQueryInfoFlags flags,
196 GCancellable *cancellable,
197 GAsyncReadyCallback callback,
199 GFileEnumerator * (* enumerate_children_finish) (GFile *file,
203 GFileInfo * (* query_info) (GFile *file,
204 const char *attributes,
205 GFileQueryInfoFlags flags,
206 GCancellable *cancellable,
208 void (* query_info_async) (GFile *file,
209 const char *attributes,
210 GFileQueryInfoFlags flags,
212 GCancellable *cancellable,
213 GAsyncReadyCallback callback,
215 GFileInfo * (* query_info_finish) (GFile *file,
219 GFileInfo * (* query_filesystem_info) (GFile *file,
220 const char *attributes,
221 GCancellable *cancellable,
223 void (* query_filesystem_info_async) (GFile *file,
224 const char *attributes,
226 GCancellable *cancellable,
227 GAsyncReadyCallback callback,
229 GFileInfo * (* query_filesystem_info_finish)(GFile *file,
233 GMount * (* find_enclosing_mount) (GFile *file,
234 GCancellable *cancellable,
236 void (* find_enclosing_mount_async) (GFile *file,
238 GCancellable *cancellable,
239 GAsyncReadyCallback callback,
241 GMount * (* find_enclosing_mount_finish) (GFile *file,
245 GFile * (* set_display_name) (GFile *file,
246 const char *display_name,
247 GCancellable *cancellable,
249 void (* set_display_name_async) (GFile *file,
250 const char *display_name,
252 GCancellable *cancellable,
253 GAsyncReadyCallback callback,
255 GFile * (* set_display_name_finish) (GFile *file,
259 GFileAttributeInfoList * (* query_settable_attributes) (GFile *file,
260 GCancellable *cancellable,
262 void (* _query_settable_attributes_async) (void);
263 void (* _query_settable_attributes_finish) (void);
265 GFileAttributeInfoList * (* query_writable_namespaces) (GFile *file,
266 GCancellable *cancellable,
268 void (* _query_writable_namespaces_async) (void);
269 void (* _query_writable_namespaces_finish) (void);
271 gboolean (* set_attribute) (GFile *file,
272 const char *attribute,
273 GFileAttributeType type,
275 GFileQueryInfoFlags flags,
276 GCancellable *cancellable,
278 gboolean (* set_attributes_from_info) (GFile *file,
280 GFileQueryInfoFlags flags,
281 GCancellable *cancellable,
283 void (* set_attributes_async) (GFile *file,
285 GFileQueryInfoFlags flags,
287 GCancellable *cancellable,
288 GAsyncReadyCallback callback,
290 gboolean (* set_attributes_finish) (GFile *file,
291 GAsyncResult *result,
295 GFileInputStream * (* read_fn) (GFile *file,
296 GCancellable *cancellable,
298 void (* read_async) (GFile *file,
300 GCancellable *cancellable,
301 GAsyncReadyCallback callback,
303 GFileInputStream * (* read_finish) (GFile *file,
307 GFileOutputStream * (* append_to) (GFile *file,
308 GFileCreateFlags flags,
309 GCancellable *cancellable,
311 void (* append_to_async) (GFile *file,
312 GFileCreateFlags flags,
314 GCancellable *cancellable,
315 GAsyncReadyCallback callback,
317 GFileOutputStream * (* append_to_finish) (GFile *file,
321 GFileOutputStream * (* create) (GFile *file,
322 GFileCreateFlags flags,
323 GCancellable *cancellable,
325 void (* create_async) (GFile *file,
326 GFileCreateFlags flags,
328 GCancellable *cancellable,
329 GAsyncReadyCallback callback,
331 GFileOutputStream * (* create_finish) (GFile *file,
335 GFileOutputStream * (* replace) (GFile *file,
337 gboolean make_backup,
338 GFileCreateFlags flags,
339 GCancellable *cancellable,
341 void (* replace_async) (GFile *file,
343 gboolean make_backup,
344 GFileCreateFlags flags,
346 GCancellable *cancellable,
347 GAsyncReadyCallback callback,
349 GFileOutputStream * (* replace_finish) (GFile *file,
353 gboolean (* delete_file) (GFile *file,
354 GCancellable *cancellable,
356 void (* delete_file_async) (GFile *file,
358 GCancellable *cancellable,
359 GAsyncReadyCallback callback,
361 gboolean (* delete_file_finish) (GFile *file,
362 GAsyncResult *result,
365 gboolean (* trash) (GFile *file,
366 GCancellable *cancellable,
368 void (* trash_async) (GFile *file,
370 GCancellable *cancellable,
371 GAsyncReadyCallback callback,
373 gboolean (* trash_finish) (GFile *file,
374 GAsyncResult *result,
377 gboolean (* make_directory) (GFile *file,
378 GCancellable *cancellable,
380 void (* make_directory_async) (GFile *file,
382 GCancellable *cancellable,
383 GAsyncReadyCallback callback,
385 gboolean (* make_directory_finish) (GFile *file,
386 GAsyncResult *result,
389 gboolean (* make_symbolic_link) (GFile *file,
390 const char *symlink_value,
391 GCancellable *cancellable,
393 void (* _make_symbolic_link_async) (void);
394 void (* _make_symbolic_link_finish) (void);
396 gboolean (* copy) (GFile *source,
398 GFileCopyFlags flags,
399 GCancellable *cancellable,
400 GFileProgressCallback progress_callback,
401 gpointer progress_callback_data,
403 void (* copy_async) (GFile *source,
405 GFileCopyFlags flags,
407 GCancellable *cancellable,
408 GFileProgressCallback progress_callback,
409 gpointer progress_callback_data,
410 GAsyncReadyCallback callback,
412 gboolean (* copy_finish) (GFile *file,
416 gboolean (* move) (GFile *source,
418 GFileCopyFlags flags,
419 GCancellable *cancellable,
420 GFileProgressCallback progress_callback,
421 gpointer progress_callback_data,
423 void (* _move_async) (void);
424 void (* _move_finish) (void);
426 void (* mount_mountable) (GFile *file,
427 GMountMountFlags flags,
428 GMountOperation *mount_operation,
429 GCancellable *cancellable,
430 GAsyncReadyCallback callback,
432 GFile * (* mount_mountable_finish) (GFile *file,
433 GAsyncResult *result,
436 void (* unmount_mountable) (GFile *file,
437 GMountUnmountFlags flags,
438 GCancellable *cancellable,
439 GAsyncReadyCallback callback,
441 gboolean (* unmount_mountable_finish) (GFile *file,
442 GAsyncResult *result,
445 void (* eject_mountable) (GFile *file,
446 GMountUnmountFlags flags,
447 GCancellable *cancellable,
448 GAsyncReadyCallback callback,
450 gboolean (* eject_mountable_finish) (GFile *file,
451 GAsyncResult *result,
454 void (* mount_enclosing_volume) (GFile *location,
455 GMountMountFlags flags,
456 GMountOperation *mount_operation,
457 GCancellable *cancellable,
458 GAsyncReadyCallback callback,
460 gboolean (* mount_enclosing_volume_finish) (GFile *location,
461 GAsyncResult *result,
464 GFileMonitor * (* monitor_dir) (GFile *file,
465 GFileMonitorFlags flags,
466 GCancellable *cancellable,
468 GFileMonitor * (* monitor_file) (GFile *file,
469 GFileMonitorFlags flags,
470 GCancellable *cancellable,
473 GFileIOStream * (* open_readwrite) (GFile *file,
474 GCancellable *cancellable,
476 void (* open_readwrite_async) (GFile *file,
478 GCancellable *cancellable,
479 GAsyncReadyCallback callback,
481 GFileIOStream * (* open_readwrite_finish) (GFile *file,
484 GFileIOStream * (* create_readwrite) (GFile *file,
485 GFileCreateFlags flags,
486 GCancellable *cancellable,
488 void (* create_readwrite_async) (GFile *file,
489 GFileCreateFlags flags,
491 GCancellable *cancellable,
492 GAsyncReadyCallback callback,
494 GFileIOStream * (* create_readwrite_finish) (GFile *file,
497 GFileIOStream * (* replace_readwrite) (GFile *file,
499 gboolean make_backup,
500 GFileCreateFlags flags,
501 GCancellable *cancellable,
503 void (* replace_readwrite_async) (GFile *file,
505 gboolean make_backup,
506 GFileCreateFlags flags,
508 GCancellable *cancellable,
509 GAsyncReadyCallback callback,
511 GFileIOStream * (* replace_readwrite_finish) (GFile *file,
515 void (* start_mountable) (GFile *file,
516 GDriveStartFlags flags,
517 GMountOperation *start_operation,
518 GCancellable *cancellable,
519 GAsyncReadyCallback callback,
521 gboolean (* start_mountable_finish) (GFile *file,
522 GAsyncResult *result,
525 void (* stop_mountable) (GFile *file,
526 GMountUnmountFlags flags,
527 GMountOperation *mount_operation,
528 GCancellable *cancellable,
529 GAsyncReadyCallback callback,
531 gboolean (* stop_mountable_finish) (GFile *file,
532 GAsyncResult *result,
535 gboolean supports_thread_contexts;
537 void (* unmount_mountable_with_operation) (GFile *file,
538 GMountUnmountFlags flags,
539 GMountOperation *mount_operation,
540 GCancellable *cancellable,
541 GAsyncReadyCallback callback,
543 gboolean (* unmount_mountable_with_operation_finish) (GFile *file,
544 GAsyncResult *result,
547 void (* eject_mountable_with_operation) (GFile *file,
548 GMountUnmountFlags flags,
549 GMountOperation *mount_operation,
550 GCancellable *cancellable,
551 GAsyncReadyCallback callback,
553 gboolean (* eject_mountable_with_operation_finish) (GFile *file,
554 GAsyncResult *result,
557 void (* poll_mountable) (GFile *file,
558 GCancellable *cancellable,
559 GAsyncReadyCallback callback,
561 gboolean (* poll_mountable_finish) (GFile *file,
562 GAsyncResult *result,
565 gboolean (* measure_disk_usage) (GFile *file,
566 GFileMeasureFlags flags,
567 GCancellable *cancellable,
568 GFileMeasureProgressCallback progress_callback,
569 gpointer progress_data,
574 void (* measure_disk_usage_async) (GFile *file,
575 GFileMeasureFlags flags,
577 GCancellable *cancellable,
578 GFileMeasureProgressCallback progress_callback,
579 gpointer progress_data,
580 GAsyncReadyCallback callback,
582 gboolean (* measure_disk_usage_finish) (GFile *file,
583 GAsyncResult *result,
590 GLIB_AVAILABLE_IN_ALL
591 GType g_file_get_type (void) G_GNUC_CONST;
593 GLIB_AVAILABLE_IN_ALL
594 GFile * g_file_new_for_path (const char *path);
595 GLIB_AVAILABLE_IN_ALL
596 GFile * g_file_new_for_uri (const char *uri);
597 GLIB_AVAILABLE_IN_ALL
598 GFile * g_file_new_for_commandline_arg (const char *arg);
599 GLIB_AVAILABLE_IN_2_36
600 GFile * g_file_new_for_commandline_arg_and_cwd (const gchar *arg,
602 GLIB_AVAILABLE_IN_2_32
603 GFile * g_file_new_tmp (const char *tmpl,
604 GFileIOStream **iostream,
606 GLIB_AVAILABLE_IN_ALL
607 GFile * g_file_parse_name (const char *parse_name);
608 GLIB_AVAILABLE_IN_ALL
609 GFile * g_file_dup (GFile *file);
610 GLIB_AVAILABLE_IN_ALL
611 guint g_file_hash (gconstpointer file);
612 GLIB_AVAILABLE_IN_ALL
613 gboolean g_file_equal (GFile *file1,
615 GLIB_AVAILABLE_IN_ALL
616 char * g_file_get_basename (GFile *file);
617 GLIB_AVAILABLE_IN_ALL
618 char * g_file_get_path (GFile *file);
619 GLIB_AVAILABLE_IN_ALL
620 char * g_file_get_uri (GFile *file);
621 GLIB_AVAILABLE_IN_ALL
622 char * g_file_get_parse_name (GFile *file);
623 GLIB_AVAILABLE_IN_ALL
624 GFile * g_file_get_parent (GFile *file);
625 GLIB_AVAILABLE_IN_ALL
626 gboolean g_file_has_parent (GFile *file,
628 GLIB_AVAILABLE_IN_ALL
629 GFile * g_file_get_child (GFile *file,
631 GLIB_AVAILABLE_IN_ALL
632 GFile * g_file_get_child_for_display_name (GFile *file,
633 const char *display_name,
635 GLIB_AVAILABLE_IN_ALL
636 gboolean g_file_has_prefix (GFile *file,
638 GLIB_AVAILABLE_IN_ALL
639 char * g_file_get_relative_path (GFile *parent,
641 GLIB_AVAILABLE_IN_ALL
642 GFile * g_file_resolve_relative_path (GFile *file,
643 const char *relative_path);
644 GLIB_AVAILABLE_IN_ALL
645 gboolean g_file_is_native (GFile *file);
646 GLIB_AVAILABLE_IN_ALL
647 gboolean g_file_has_uri_scheme (GFile *file,
648 const char *uri_scheme);
649 GLIB_AVAILABLE_IN_ALL
650 char * g_file_get_uri_scheme (GFile *file);
651 GLIB_AVAILABLE_IN_ALL
652 GFileInputStream * g_file_read (GFile *file,
653 GCancellable *cancellable,
655 GLIB_AVAILABLE_IN_ALL
656 void g_file_read_async (GFile *file,
658 GCancellable *cancellable,
659 GAsyncReadyCallback callback,
661 GLIB_AVAILABLE_IN_ALL
662 GFileInputStream * g_file_read_finish (GFile *file,
665 GLIB_AVAILABLE_IN_ALL
666 GFileOutputStream * g_file_append_to (GFile *file,
667 GFileCreateFlags flags,
668 GCancellable *cancellable,
670 GLIB_AVAILABLE_IN_ALL
671 GFileOutputStream * g_file_create (GFile *file,
672 GFileCreateFlags flags,
673 GCancellable *cancellable,
675 GLIB_AVAILABLE_IN_ALL
676 GFileOutputStream * g_file_replace (GFile *file,
678 gboolean make_backup,
679 GFileCreateFlags flags,
680 GCancellable *cancellable,
682 GLIB_AVAILABLE_IN_ALL
683 void g_file_append_to_async (GFile *file,
684 GFileCreateFlags flags,
686 GCancellable *cancellable,
687 GAsyncReadyCallback callback,
689 GLIB_AVAILABLE_IN_ALL
690 GFileOutputStream * g_file_append_to_finish (GFile *file,
693 GLIB_AVAILABLE_IN_ALL
694 void g_file_create_async (GFile *file,
695 GFileCreateFlags flags,
697 GCancellable *cancellable,
698 GAsyncReadyCallback callback,
700 GLIB_AVAILABLE_IN_ALL
701 GFileOutputStream * g_file_create_finish (GFile *file,
704 GLIB_AVAILABLE_IN_ALL
705 void g_file_replace_async (GFile *file,
707 gboolean make_backup,
708 GFileCreateFlags flags,
710 GCancellable *cancellable,
711 GAsyncReadyCallback callback,
713 GLIB_AVAILABLE_IN_ALL
714 GFileOutputStream * g_file_replace_finish (GFile *file,
717 GLIB_AVAILABLE_IN_ALL
718 GFileIOStream * g_file_open_readwrite (GFile *file,
719 GCancellable *cancellable,
721 GLIB_AVAILABLE_IN_ALL
722 void g_file_open_readwrite_async (GFile *file,
724 GCancellable *cancellable,
725 GAsyncReadyCallback callback,
727 GLIB_AVAILABLE_IN_ALL
728 GFileIOStream * g_file_open_readwrite_finish (GFile *file,
731 GLIB_AVAILABLE_IN_ALL
732 GFileIOStream * g_file_create_readwrite (GFile *file,
733 GFileCreateFlags flags,
734 GCancellable *cancellable,
736 GLIB_AVAILABLE_IN_ALL
737 void g_file_create_readwrite_async (GFile *file,
738 GFileCreateFlags flags,
740 GCancellable *cancellable,
741 GAsyncReadyCallback callback,
743 GLIB_AVAILABLE_IN_ALL
744 GFileIOStream * g_file_create_readwrite_finish (GFile *file,
747 GLIB_AVAILABLE_IN_ALL
748 GFileIOStream * g_file_replace_readwrite (GFile *file,
750 gboolean make_backup,
751 GFileCreateFlags flags,
752 GCancellable *cancellable,
754 GLIB_AVAILABLE_IN_ALL
755 void g_file_replace_readwrite_async (GFile *file,
757 gboolean make_backup,
758 GFileCreateFlags flags,
760 GCancellable *cancellable,
761 GAsyncReadyCallback callback,
763 GLIB_AVAILABLE_IN_ALL
764 GFileIOStream * g_file_replace_readwrite_finish (GFile *file,
767 GLIB_AVAILABLE_IN_ALL
768 gboolean g_file_query_exists (GFile *file,
769 GCancellable *cancellable);
770 GLIB_AVAILABLE_IN_ALL
771 GFileType g_file_query_file_type (GFile *file,
772 GFileQueryInfoFlags flags,
773 GCancellable *cancellable);
774 GLIB_AVAILABLE_IN_ALL
775 GFileInfo * g_file_query_info (GFile *file,
776 const char *attributes,
777 GFileQueryInfoFlags flags,
778 GCancellable *cancellable,
780 GLIB_AVAILABLE_IN_ALL
781 void g_file_query_info_async (GFile *file,
782 const char *attributes,
783 GFileQueryInfoFlags flags,
785 GCancellable *cancellable,
786 GAsyncReadyCallback callback,
788 GLIB_AVAILABLE_IN_ALL
789 GFileInfo * g_file_query_info_finish (GFile *file,
792 GLIB_AVAILABLE_IN_ALL
793 GFileInfo * g_file_query_filesystem_info (GFile *file,
794 const char *attributes,
795 GCancellable *cancellable,
797 GLIB_AVAILABLE_IN_ALL
798 void g_file_query_filesystem_info_async (GFile *file,
799 const char *attributes,
801 GCancellable *cancellable,
802 GAsyncReadyCallback callback,
804 GLIB_AVAILABLE_IN_ALL
805 GFileInfo * g_file_query_filesystem_info_finish (GFile *file,
808 GLIB_AVAILABLE_IN_ALL
809 GMount * g_file_find_enclosing_mount (GFile *file,
810 GCancellable *cancellable,
812 GLIB_AVAILABLE_IN_ALL
813 void g_file_find_enclosing_mount_async (GFile *file,
815 GCancellable *cancellable,
816 GAsyncReadyCallback callback,
818 GLIB_AVAILABLE_IN_ALL
819 GMount * g_file_find_enclosing_mount_finish (GFile *file,
822 GLIB_AVAILABLE_IN_ALL
823 GFileEnumerator * g_file_enumerate_children (GFile *file,
824 const char *attributes,
825 GFileQueryInfoFlags flags,
826 GCancellable *cancellable,
828 GLIB_AVAILABLE_IN_ALL
829 void g_file_enumerate_children_async (GFile *file,
830 const char *attributes,
831 GFileQueryInfoFlags flags,
833 GCancellable *cancellable,
834 GAsyncReadyCallback callback,
836 GLIB_AVAILABLE_IN_ALL
837 GFileEnumerator * g_file_enumerate_children_finish (GFile *file,
840 GLIB_AVAILABLE_IN_ALL
841 GFile * g_file_set_display_name (GFile *file,
842 const char *display_name,
843 GCancellable *cancellable,
845 GLIB_AVAILABLE_IN_ALL
846 void g_file_set_display_name_async (GFile *file,
847 const char *display_name,
849 GCancellable *cancellable,
850 GAsyncReadyCallback callback,
852 GLIB_AVAILABLE_IN_ALL
853 GFile * g_file_set_display_name_finish (GFile *file,
856 GLIB_AVAILABLE_IN_ALL
857 gboolean g_file_delete (GFile *file,
858 GCancellable *cancellable,
861 GLIB_AVAILABLE_IN_2_34
862 void g_file_delete_async (GFile *file,
864 GCancellable *cancellable,
865 GAsyncReadyCallback callback,
868 GLIB_AVAILABLE_IN_2_34
869 gboolean g_file_delete_finish (GFile *file,
870 GAsyncResult *result,
873 GLIB_AVAILABLE_IN_ALL
874 gboolean g_file_trash (GFile *file,
875 GCancellable *cancellable,
878 GLIB_AVAILABLE_IN_2_38
879 void g_file_trash_async (GFile *file,
881 GCancellable *cancellable,
882 GAsyncReadyCallback callback,
885 GLIB_AVAILABLE_IN_2_38
886 gboolean g_file_trash_finish (GFile *file,
887 GAsyncResult *result,
890 GLIB_AVAILABLE_IN_ALL
891 gboolean g_file_copy (GFile *source,
893 GFileCopyFlags flags,
894 GCancellable *cancellable,
895 GFileProgressCallback progress_callback,
896 gpointer progress_callback_data,
898 GLIB_AVAILABLE_IN_ALL
899 void g_file_copy_async (GFile *source,
901 GFileCopyFlags flags,
903 GCancellable *cancellable,
904 GFileProgressCallback progress_callback,
905 gpointer progress_callback_data,
906 GAsyncReadyCallback callback,
908 GLIB_AVAILABLE_IN_ALL
909 gboolean g_file_copy_finish (GFile *file,
912 GLIB_AVAILABLE_IN_ALL
913 gboolean g_file_move (GFile *source,
915 GFileCopyFlags flags,
916 GCancellable *cancellable,
917 GFileProgressCallback progress_callback,
918 gpointer progress_callback_data,
920 GLIB_AVAILABLE_IN_ALL
921 gboolean g_file_make_directory (GFile *file,
922 GCancellable *cancellable,
924 GLIB_AVAILABLE_IN_2_38
925 void g_file_make_directory_async (GFile *file,
927 GCancellable *cancellable,
928 GAsyncReadyCallback callback,
930 GLIB_AVAILABLE_IN_2_38
931 gboolean g_file_make_directory_finish (GFile *file,
932 GAsyncResult *result,
935 GLIB_AVAILABLE_IN_ALL
936 gboolean g_file_make_directory_with_parents (GFile *file,
937 GCancellable *cancellable,
939 GLIB_AVAILABLE_IN_ALL
940 gboolean g_file_make_symbolic_link (GFile *file,
941 const char *symlink_value,
942 GCancellable *cancellable,
944 GLIB_AVAILABLE_IN_ALL
945 GFileAttributeInfoList *g_file_query_settable_attributes (GFile *file,
946 GCancellable *cancellable,
948 GLIB_AVAILABLE_IN_ALL
949 GFileAttributeInfoList *g_file_query_writable_namespaces (GFile *file,
950 GCancellable *cancellable,
952 GLIB_AVAILABLE_IN_ALL
953 gboolean g_file_set_attribute (GFile *file,
954 const char *attribute,
955 GFileAttributeType type,
957 GFileQueryInfoFlags flags,
958 GCancellable *cancellable,
960 GLIB_AVAILABLE_IN_ALL
961 gboolean g_file_set_attributes_from_info (GFile *file,
963 GFileQueryInfoFlags flags,
964 GCancellable *cancellable,
966 GLIB_AVAILABLE_IN_ALL
967 void g_file_set_attributes_async (GFile *file,
969 GFileQueryInfoFlags flags,
971 GCancellable *cancellable,
972 GAsyncReadyCallback callback,
974 GLIB_AVAILABLE_IN_ALL
975 gboolean g_file_set_attributes_finish (GFile *file,
976 GAsyncResult *result,
979 GLIB_AVAILABLE_IN_ALL
980 gboolean g_file_set_attribute_string (GFile *file,
981 const char *attribute,
983 GFileQueryInfoFlags flags,
984 GCancellable *cancellable,
986 GLIB_AVAILABLE_IN_ALL
987 gboolean g_file_set_attribute_byte_string (GFile *file,
988 const char *attribute,
990 GFileQueryInfoFlags flags,
991 GCancellable *cancellable,
993 GLIB_AVAILABLE_IN_ALL
994 gboolean g_file_set_attribute_uint32 (GFile *file,
995 const char *attribute,
997 GFileQueryInfoFlags flags,
998 GCancellable *cancellable,
1000 GLIB_AVAILABLE_IN_ALL
1001 gboolean g_file_set_attribute_int32 (GFile *file,
1002 const char *attribute,
1004 GFileQueryInfoFlags flags,
1005 GCancellable *cancellable,
1007 GLIB_AVAILABLE_IN_ALL
1008 gboolean g_file_set_attribute_uint64 (GFile *file,
1009 const char *attribute,
1011 GFileQueryInfoFlags flags,
1012 GCancellable *cancellable,
1014 GLIB_AVAILABLE_IN_ALL
1015 gboolean g_file_set_attribute_int64 (GFile *file,
1016 const char *attribute,
1018 GFileQueryInfoFlags flags,
1019 GCancellable *cancellable,
1021 GLIB_AVAILABLE_IN_ALL
1022 void g_file_mount_enclosing_volume (GFile *location,
1023 GMountMountFlags flags,
1024 GMountOperation *mount_operation,
1025 GCancellable *cancellable,
1026 GAsyncReadyCallback callback,
1027 gpointer user_data);
1028 GLIB_AVAILABLE_IN_ALL
1029 gboolean g_file_mount_enclosing_volume_finish (GFile *location,
1030 GAsyncResult *result,
1032 GLIB_AVAILABLE_IN_ALL
1033 void g_file_mount_mountable (GFile *file,
1034 GMountMountFlags flags,
1035 GMountOperation *mount_operation,
1036 GCancellable *cancellable,
1037 GAsyncReadyCallback callback,
1038 gpointer user_data);
1039 GLIB_AVAILABLE_IN_ALL
1040 GFile * g_file_mount_mountable_finish (GFile *file,
1041 GAsyncResult *result,
1043 GLIB_DEPRECATED_FOR(g_file_unmount_mountable_with_operation)
1044 void g_file_unmount_mountable (GFile *file,
1045 GMountUnmountFlags flags,
1046 GCancellable *cancellable,
1047 GAsyncReadyCallback callback,
1048 gpointer user_data);
1050 GLIB_DEPRECATED_FOR(g_file_unmount_mountable_with_operation_finish)
1051 gboolean g_file_unmount_mountable_finish (GFile *file,
1052 GAsyncResult *result,
1054 GLIB_AVAILABLE_IN_ALL
1055 void g_file_unmount_mountable_with_operation (GFile *file,
1056 GMountUnmountFlags flags,
1057 GMountOperation *mount_operation,
1058 GCancellable *cancellable,
1059 GAsyncReadyCallback callback,
1060 gpointer user_data);
1061 GLIB_AVAILABLE_IN_ALL
1062 gboolean g_file_unmount_mountable_with_operation_finish (GFile *file,
1063 GAsyncResult *result,
1065 GLIB_DEPRECATED_FOR(g_file_eject_mountable_with_operation)
1066 void g_file_eject_mountable (GFile *file,
1067 GMountUnmountFlags flags,
1068 GCancellable *cancellable,
1069 GAsyncReadyCallback callback,
1070 gpointer user_data);
1072 GLIB_DEPRECATED_FOR(g_file_eject_mountable_with_operation_finish)
1073 gboolean g_file_eject_mountable_finish (GFile *file,
1074 GAsyncResult *result,
1076 GLIB_AVAILABLE_IN_ALL
1077 void g_file_eject_mountable_with_operation (GFile *file,
1078 GMountUnmountFlags flags,
1079 GMountOperation *mount_operation,
1080 GCancellable *cancellable,
1081 GAsyncReadyCallback callback,
1082 gpointer user_data);
1083 GLIB_AVAILABLE_IN_ALL
1084 gboolean g_file_eject_mountable_with_operation_finish (GFile *file,
1085 GAsyncResult *result,
1088 GLIB_AVAILABLE_IN_ALL
1089 gboolean g_file_copy_attributes (GFile *source,
1091 GFileCopyFlags flags,
1092 GCancellable *cancellable,
1096 GLIB_AVAILABLE_IN_ALL
1097 GFileMonitor* g_file_monitor_directory (GFile *file,
1098 GFileMonitorFlags flags,
1099 GCancellable *cancellable,
1101 GLIB_AVAILABLE_IN_ALL
1102 GFileMonitor* g_file_monitor_file (GFile *file,
1103 GFileMonitorFlags flags,
1104 GCancellable *cancellable,
1106 GLIB_AVAILABLE_IN_ALL
1107 GFileMonitor* g_file_monitor (GFile *file,
1108 GFileMonitorFlags flags,
1109 GCancellable *cancellable,
1112 GLIB_AVAILABLE_IN_2_38
1113 gboolean g_file_measure_disk_usage (GFile *file,
1114 GFileMeasureFlags flags,
1115 GCancellable *cancellable,
1116 GFileMeasureProgressCallback progress_callback,
1117 gpointer progress_data,
1118 guint64 *disk_usage,
1123 GLIB_AVAILABLE_IN_2_38
1124 void g_file_measure_disk_usage_async (GFile *file,
1125 GFileMeasureFlags flags,
1127 GCancellable *cancellable,
1128 GFileMeasureProgressCallback progress_callback,
1129 gpointer progress_data,
1130 GAsyncReadyCallback callback,
1131 gpointer user_data);
1133 GLIB_AVAILABLE_IN_2_38
1134 gboolean g_file_measure_disk_usage_finish (GFile *file,
1135 GAsyncResult *result,
1136 guint64 *disk_usage,
1141 GLIB_AVAILABLE_IN_ALL
1142 void g_file_start_mountable (GFile *file,
1143 GDriveStartFlags flags,
1144 GMountOperation *start_operation,
1145 GCancellable *cancellable,
1146 GAsyncReadyCallback callback,
1147 gpointer user_data);
1148 GLIB_AVAILABLE_IN_ALL
1149 gboolean g_file_start_mountable_finish (GFile *file,
1150 GAsyncResult *result,
1152 GLIB_AVAILABLE_IN_ALL
1153 void g_file_stop_mountable (GFile *file,
1154 GMountUnmountFlags flags,
1155 GMountOperation *mount_operation,
1156 GCancellable *cancellable,
1157 GAsyncReadyCallback callback,
1158 gpointer user_data);
1159 GLIB_AVAILABLE_IN_ALL
1160 gboolean g_file_stop_mountable_finish (GFile *file,
1161 GAsyncResult *result,
1164 GLIB_AVAILABLE_IN_ALL
1165 void g_file_poll_mountable (GFile *file,
1166 GCancellable *cancellable,
1167 GAsyncReadyCallback callback,
1168 gpointer user_data);
1169 GLIB_AVAILABLE_IN_ALL
1170 gboolean g_file_poll_mountable_finish (GFile *file,
1171 GAsyncResult *result,
1176 GLIB_AVAILABLE_IN_ALL
1177 GAppInfo *g_file_query_default_handler (GFile *file,
1178 GCancellable *cancellable,
1180 GLIB_AVAILABLE_IN_ALL
1181 gboolean g_file_load_contents (GFile *file,
1182 GCancellable *cancellable,
1187 GLIB_AVAILABLE_IN_ALL
1188 void g_file_load_contents_async (GFile *file,
1189 GCancellable *cancellable,
1190 GAsyncReadyCallback callback,
1191 gpointer user_data);
1192 GLIB_AVAILABLE_IN_ALL
1193 gboolean g_file_load_contents_finish (GFile *file,
1199 GLIB_AVAILABLE_IN_ALL
1200 void g_file_load_partial_contents_async (GFile *file,
1201 GCancellable *cancellable,
1202 GFileReadMoreCallback read_more_callback,
1203 GAsyncReadyCallback callback,
1204 gpointer user_data);
1205 GLIB_AVAILABLE_IN_ALL
1206 gboolean g_file_load_partial_contents_finish (GFile *file,
1212 GLIB_AVAILABLE_IN_ALL
1213 gboolean g_file_replace_contents (GFile *file,
1214 const char *contents,
1217 gboolean make_backup,
1218 GFileCreateFlags flags,
1220 GCancellable *cancellable,
1222 GLIB_AVAILABLE_IN_ALL
1223 void g_file_replace_contents_async (GFile *file,
1224 const char *contents,
1227 gboolean make_backup,
1228 GFileCreateFlags flags,
1229 GCancellable *cancellable,
1230 GAsyncReadyCallback callback,
1231 gpointer user_data);
1232 GLIB_AVAILABLE_IN_2_40
1233 void g_file_replace_contents_bytes_async (GFile *file,
1236 gboolean make_backup,
1237 GFileCreateFlags flags,
1238 GCancellable *cancellable,
1239 GAsyncReadyCallback callback,
1240 gpointer user_data);
1241 GLIB_AVAILABLE_IN_ALL
1242 gboolean g_file_replace_contents_finish (GFile *file,
1247 GLIB_AVAILABLE_IN_ALL
1248 gboolean g_file_supports_thread_contexts (GFile *file);
1252 #endif /* __G_FILE_H__ */