1/* GIO - GLib Input, Output and Streaming Library
2 *
3 * Copyright (C) 2006-2007 Red Hat, Inc.
4 *
5 * SPDX-License-Identifier: LGPL-2.1-or-later
6 *
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
11 *
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General
18 * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
19 *
20 * Author: Alexander Larsson <alexl@redhat.com>
21 */
22
23#ifndef __G_FILE_H__
24#define __G_FILE_H__
25
26#if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
27#error "Only <gio/gio.h> can be included directly."
28#endif
29
30#include <gio/giotypes.h>
31
32G_BEGIN_DECLS
33
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))
38
39typedef struct _GFileIface GFileIface;
40
41
42/**
43 * GFileIface:
44 * @g_iface: The parent interface.
45 * @dup: Duplicates a #GFile.
46 * @hash: Creates a hash of a #GFile.
47 * @equal: Checks equality of two given #GFiles.
48 * @is_native: Checks to see if a file is native to the system.
49 * @has_uri_scheme: Checks to see if a #GFile has a given URI scheme.
50 * @get_uri_scheme: Gets the URI scheme for a #GFile.
51 * @get_basename: Gets the basename for a given #GFile.
52 * @get_path: Gets the current path within a #GFile.
53 * @get_uri: Gets a URI for the path within a #GFile.
54 * @get_parse_name: Gets the parsed name for the #GFile.
55 * @get_parent: Gets the parent directory for the #GFile.
56 * @prefix_matches: Checks whether a #GFile contains a specified file.
57 * @get_relative_path: Gets the path for a #GFile relative to a given path.
58 * @resolve_relative_path: Resolves a relative path for a #GFile to an absolute path.
59 * @get_child_for_display_name: Gets the child #GFile for a given display name.
60 * @enumerate_children: Gets a #GFileEnumerator with the children of a #GFile.
61 * @enumerate_children_async: Asynchronously gets a #GFileEnumerator with the children of a #GFile.
62 * @enumerate_children_finish: Finishes asynchronously enumerating the children.
63 * @query_info: Gets the #GFileInfo for a #GFile.
64 * @query_info_async: Asynchronously gets the #GFileInfo for a #GFile.
65 * @query_info_finish: Finishes an asynchronous query info operation.
66 * @query_filesystem_info: Gets a #GFileInfo for the file system #GFile is on.
67 * @query_filesystem_info_async: Asynchronously gets a #GFileInfo for the file system #GFile is on.
68 * @query_filesystem_info_finish: Finishes asynchronously getting the file system info.
69 * @find_enclosing_mount: Gets a #GMount for the #GFile.
70 * @find_enclosing_mount_async: Asynchronously gets the #GMount for a #GFile.
71 * @find_enclosing_mount_finish: Finishes asynchronously getting the volume.
72 * @set_display_name: Sets the display name for a #GFile.
73 * @set_display_name_async: Asynchronously sets a #GFile's display name.
74 * @set_display_name_finish: Finishes asynchronously setting a #GFile's display name.
75 * @query_settable_attributes: Returns a list of #GFileAttributeInfos that can be set.
76 * @_query_settable_attributes_async: Asynchronously gets a list of #GFileAttributeInfos that can be set.
77 * @_query_settable_attributes_finish: Finishes asynchronously querying settable attributes.
78 * @query_writable_namespaces: Returns a list of #GFileAttributeInfo namespaces that are writable.
79 * @_query_writable_namespaces_async: Asynchronously gets a list of #GFileAttributeInfo namespaces that are writable.
80 * @_query_writable_namespaces_finish: Finishes asynchronously querying the writable namespaces.
81 * @set_attribute: Sets a #GFileAttributeInfo.
82 * @set_attributes_from_info: Sets a #GFileAttributeInfo with information from a #GFileInfo.
83 * @set_attributes_async: Asynchronously sets a file's attributes.
84 * @set_attributes_finish: Finishes setting a file's attributes asynchronously.
85 * @read_fn: Reads a file asynchronously.
86 * @read_async: Asynchronously reads a file.
87 * @read_finish: Finishes asynchronously reading a file.
88 * @append_to: Writes to the end of a file.
89 * @append_to_async: Asynchronously writes to the end of a file.
90 * @append_to_finish: Finishes an asynchronous file append operation.
91 * @create: Creates a new file.
92 * @create_async: Asynchronously creates a file.
93 * @create_finish: Finishes asynchronously creating a file.
94 * @replace: Replaces the contents of a file.
95 * @replace_async: Asynchronously replaces the contents of a file.
96 * @replace_finish: Finishes asynchronously replacing a file.
97 * @delete_file: Deletes a file.
98 * @delete_file_async: Asynchronously deletes a file.
99 * @delete_file_finish: Finishes an asynchronous delete.
100 * @trash: Sends a #GFile to the Trash location.
101 * @trash_async: Asynchronously sends a #GFile to the Trash location.
102 * @trash_finish: Finishes an asynchronous file trashing operation.
103 * @make_directory: Makes a directory.
104 * @make_directory_async: Asynchronously makes a directory.
105 * @make_directory_finish: Finishes making a directory asynchronously.
106 * @make_symbolic_link: (nullable): Makes a symbolic link. %NULL if symbolic
107 * links are unsupported.
108 * @make_symbolic_link_async: Asynchronously makes a symbolic link
109 * @make_symbolic_link_finish: Finishes making a symbolic link asynchronously.
110 * @copy: (nullable): Copies a file. %NULL if copying is unsupported, which will
111 * cause `GFile` to use a fallback copy method where it reads from the
112 * source and writes to the destination.
113 * @copy_async: Asynchronously copies a file.
114 * @copy_finish: Finishes an asynchronous copy operation.
115 * @move: Moves a file.
116 * @move_async: Asynchronously moves a file. Since: 2.72
117 * @move_finish: Finishes an asynchronous move operation. Since: 2.72
118 * @mount_mountable: Mounts a mountable object.
119 * @mount_mountable_finish: Finishes a mounting operation.
120 * @unmount_mountable: Unmounts a mountable object.
121 * @unmount_mountable_finish: Finishes an unmount operation.
122 * @eject_mountable: Ejects a mountable.
123 * @eject_mountable_finish: Finishes an eject operation.
124 * @mount_enclosing_volume: Mounts a specified location.
125 * @mount_enclosing_volume_finish: Finishes mounting a specified location.
126 * @monitor_dir: Creates a #GFileMonitor for the location.
127 * @monitor_file: Creates a #GFileMonitor for the location.
128 * @open_readwrite: Open file read/write. Since 2.22.
129 * @open_readwrite_async: Asynchronously opens file read/write. Since 2.22.
130 * @open_readwrite_finish: Finishes an asynchronous open read/write. Since 2.22.
131 * @create_readwrite: Creates file read/write. Since 2.22.
132 * @create_readwrite_async: Asynchronously creates file read/write. Since 2.22.
133 * @create_readwrite_finish: Finishes an asynchronous creates read/write. Since 2.22.
134 * @replace_readwrite: Replaces file read/write. Since 2.22.
135 * @replace_readwrite_async: Asynchronously replaces file read/write. Since 2.22.
136 * @replace_readwrite_finish: Finishes an asynchronous replace read/write. Since 2.22.
137 * @start_mountable: Starts a mountable object. Since 2.22.
138 * @start_mountable_finish: Finishes a start operation. Since 2.22.
139 * @stop_mountable: Stops a mountable. Since 2.22.
140 * @stop_mountable_finish: Finishes a stop operation. Since 2.22.
141 * @supports_thread_contexts: a boolean that indicates whether the #GFile implementation supports thread-default contexts. Since 2.22.
142 * @unmount_mountable_with_operation: Unmounts a mountable object using a #GMountOperation. Since 2.22.
143 * @unmount_mountable_with_operation_finish: Finishes an unmount operation using a #GMountOperation. Since 2.22.
144 * @eject_mountable_with_operation: Ejects a mountable object using a #GMountOperation. Since 2.22.
145 * @eject_mountable_with_operation_finish: Finishes an eject operation using a #GMountOperation. Since 2.22.
146 * @poll_mountable: Polls a mountable object for media changes. Since 2.22.
147 * @poll_mountable_finish: Finishes a poll operation for media changes. Since 2.22.
148 * @measure_disk_usage: Recursively measures the disk usage of @file. Since 2.38
149 * @measure_disk_usage_async: Asynchronously recursively measures the disk usage of @file. Since 2.38
150 * @measure_disk_usage_finish: Finishes an asynchronous recursive measurement of the disk usage of @file. Since 2.38
151 *
152 * An interface for writing VFS file handles.
153 **/
154struct _GFileIface
155{
156 GTypeInterface g_iface;
157
158 /* Virtual Table */
159
160 GFile * (* dup) (GFile *file);
161 guint (* hash) (GFile *file);
162 gboolean (* equal) (GFile *file1,
163 GFile *file2);
164 gboolean (* is_native) (GFile *file);
165 gboolean (* has_uri_scheme) (GFile *file,
166 const char *uri_scheme);
167 char * (* get_uri_scheme) (GFile *file);
168 char * (* get_basename) (GFile *file);
169 char * (* get_path) (GFile *file);
170 char * (* get_uri) (GFile *file);
171 char * (* get_parse_name) (GFile *file);
172 GFile * (* get_parent) (GFile *file);
173 gboolean (* prefix_matches) (GFile *prefix,
174 GFile *file);
175 char * (* get_relative_path) (GFile *parent,
176 GFile *descendant);
177 GFile * (* resolve_relative_path) (GFile *file,
178 const char *relative_path);
179 GFile * (* get_child_for_display_name) (GFile *file,
180 const char *display_name,
181 GError **error);
182
183 GFileEnumerator * (* enumerate_children) (GFile *file,
184 const char *attributes,
185 GFileQueryInfoFlags flags,
186 GCancellable *cancellable,
187 GError **error);
188 void (* enumerate_children_async) (GFile *file,
189 const char *attributes,
190 GFileQueryInfoFlags flags,
191 int io_priority,
192 GCancellable *cancellable,
193 GAsyncReadyCallback callback,
194 gpointer user_data);
195 GFileEnumerator * (* enumerate_children_finish) (GFile *file,
196 GAsyncResult *res,
197 GError **error);
198
199 GFileInfo * (* query_info) (GFile *file,
200 const char *attributes,
201 GFileQueryInfoFlags flags,
202 GCancellable *cancellable,
203 GError **error);
204 void (* query_info_async) (GFile *file,
205 const char *attributes,
206 GFileQueryInfoFlags flags,
207 int io_priority,
208 GCancellable *cancellable,
209 GAsyncReadyCallback callback,
210 gpointer user_data);
211 GFileInfo * (* query_info_finish) (GFile *file,
212 GAsyncResult *res,
213 GError **error);
214
215 GFileInfo * (* query_filesystem_info) (GFile *file,
216 const char *attributes,
217 GCancellable *cancellable,
218 GError **error);
219 void (* query_filesystem_info_async) (GFile *file,
220 const char *attributes,
221 int io_priority,
222 GCancellable *cancellable,
223 GAsyncReadyCallback callback,
224 gpointer user_data);
225 GFileInfo * (* query_filesystem_info_finish)(GFile *file,
226 GAsyncResult *res,
227 GError **error);
228
229 GMount * (* find_enclosing_mount) (GFile *file,
230 GCancellable *cancellable,
231 GError **error);
232 void (* find_enclosing_mount_async) (GFile *file,
233 int io_priority,
234 GCancellable *cancellable,
235 GAsyncReadyCallback callback,
236 gpointer user_data);
237 GMount * (* find_enclosing_mount_finish) (GFile *file,
238 GAsyncResult *res,
239 GError **error);
240
241 GFile * (* set_display_name) (GFile *file,
242 const char *display_name,
243 GCancellable *cancellable,
244 GError **error);
245 void (* set_display_name_async) (GFile *file,
246 const char *display_name,
247 int io_priority,
248 GCancellable *cancellable,
249 GAsyncReadyCallback callback,
250 gpointer user_data);
251 GFile * (* set_display_name_finish) (GFile *file,
252 GAsyncResult *res,
253 GError **error);
254
255 GFileAttributeInfoList * (* query_settable_attributes) (GFile *file,
256 GCancellable *cancellable,
257 GError **error);
258 void (* _query_settable_attributes_async) (void);
259 void (* _query_settable_attributes_finish) (void);
260
261 GFileAttributeInfoList * (* query_writable_namespaces) (GFile *file,
262 GCancellable *cancellable,
263 GError **error);
264 void (* _query_writable_namespaces_async) (void);
265 void (* _query_writable_namespaces_finish) (void);
266
267 gboolean (* set_attribute) (GFile *file,
268 const char *attribute,
269 GFileAttributeType type,
270 gpointer value_p,
271 GFileQueryInfoFlags flags,
272 GCancellable *cancellable,
273 GError **error);
274 gboolean (* set_attributes_from_info) (GFile *file,
275 GFileInfo *info,
276 GFileQueryInfoFlags flags,
277 GCancellable *cancellable,
278 GError **error);
279 void (* set_attributes_async) (GFile *file,
280 GFileInfo *info,
281 GFileQueryInfoFlags flags,
282 int io_priority,
283 GCancellable *cancellable,
284 GAsyncReadyCallback callback,
285 gpointer user_data);
286 gboolean (* set_attributes_finish) (GFile *file,
287 GAsyncResult *result,
288 GFileInfo **info,
289 GError **error);
290
291 GFileInputStream * (* read_fn) (GFile *file,
292 GCancellable *cancellable,
293 GError **error);
294 void (* read_async) (GFile *file,
295 int io_priority,
296 GCancellable *cancellable,
297 GAsyncReadyCallback callback,
298 gpointer user_data);
299 GFileInputStream * (* read_finish) (GFile *file,
300 GAsyncResult *res,
301 GError **error);
302
303 GFileOutputStream * (* append_to) (GFile *file,
304 GFileCreateFlags flags,
305 GCancellable *cancellable,
306 GError **error);
307 void (* append_to_async) (GFile *file,
308 GFileCreateFlags flags,
309 int io_priority,
310 GCancellable *cancellable,
311 GAsyncReadyCallback callback,
312 gpointer user_data);
313 GFileOutputStream * (* append_to_finish) (GFile *file,
314 GAsyncResult *res,
315 GError **error);
316
317 GFileOutputStream * (* create) (GFile *file,
318 GFileCreateFlags flags,
319 GCancellable *cancellable,
320 GError **error);
321 void (* create_async) (GFile *file,
322 GFileCreateFlags flags,
323 int io_priority,
324 GCancellable *cancellable,
325 GAsyncReadyCallback callback,
326 gpointer user_data);
327 GFileOutputStream * (* create_finish) (GFile *file,
328 GAsyncResult *res,
329 GError **error);
330
331 GFileOutputStream * (* replace) (GFile *file,
332 const char *etag,
333 gboolean make_backup,
334 GFileCreateFlags flags,
335 GCancellable *cancellable,
336 GError **error);
337 void (* replace_async) (GFile *file,
338 const char *etag,
339 gboolean make_backup,
340 GFileCreateFlags flags,
341 int io_priority,
342 GCancellable *cancellable,
343 GAsyncReadyCallback callback,
344 gpointer user_data);
345 GFileOutputStream * (* replace_finish) (GFile *file,
346 GAsyncResult *res,
347 GError **error);
348
349 gboolean (* delete_file) (GFile *file,
350 GCancellable *cancellable,
351 GError **error);
352 void (* delete_file_async) (GFile *file,
353 int io_priority,
354 GCancellable *cancellable,
355 GAsyncReadyCallback callback,
356 gpointer user_data);
357 gboolean (* delete_file_finish) (GFile *file,
358 GAsyncResult *result,
359 GError **error);
360
361 gboolean (* trash) (GFile *file,
362 GCancellable *cancellable,
363 GError **error);
364 void (* trash_async) (GFile *file,
365 int io_priority,
366 GCancellable *cancellable,
367 GAsyncReadyCallback callback,
368 gpointer user_data);
369 gboolean (* trash_finish) (GFile *file,
370 GAsyncResult *result,
371 GError **error);
372
373 gboolean (* make_directory) (GFile *file,
374 GCancellable *cancellable,
375 GError **error);
376 void (* make_directory_async) (GFile *file,
377 int io_priority,
378 GCancellable *cancellable,
379 GAsyncReadyCallback callback,
380 gpointer user_data);
381 gboolean (* make_directory_finish) (GFile *file,
382 GAsyncResult *result,
383 GError **error);
384
385 gboolean (* make_symbolic_link) (GFile *file,
386 const char *symlink_value,
387 GCancellable *cancellable,
388 GError **error);
389 void (* make_symbolic_link_async) (GFile *file,
390 const char *symlink_value,
391 int io_priority,
392 GCancellable *cancellable,
393 GAsyncReadyCallback callback,
394 gpointer user_data);
395 gboolean (* make_symbolic_link_finish) (GFile *file,
396 GAsyncResult *result,
397 GError **error);
398
399 gboolean (* copy) (GFile *source,
400 GFile *destination,
401 GFileCopyFlags flags,
402 GCancellable *cancellable,
403 GFileProgressCallback progress_callback,
404 gpointer progress_callback_data,
405 GError **error);
406 void (* copy_async) (GFile *source,
407 GFile *destination,
408 GFileCopyFlags flags,
409 int io_priority,
410 GCancellable *cancellable,
411 GFileProgressCallback progress_callback,
412 gpointer progress_callback_data,
413 GAsyncReadyCallback callback,
414 gpointer user_data);
415 gboolean (* copy_finish) (GFile *file,
416 GAsyncResult *res,
417 GError **error);
418
419 gboolean (* move) (GFile *source,
420 GFile *destination,
421 GFileCopyFlags flags,
422 GCancellable *cancellable,
423 GFileProgressCallback progress_callback,
424 gpointer progress_callback_data,
425 GError **error);
426 void (* move_async) (GFile *source,
427 GFile *destination,
428 GFileCopyFlags flags,
429 int io_priority,
430 GCancellable *cancellable,
431 GFileProgressCallback progress_callback,
432 gpointer progress_callback_data,
433 GAsyncReadyCallback callback,
434 gpointer user_data);
435 gboolean (* move_finish) (GFile *file,
436 GAsyncResult *result,
437 GError **error);
438
439 void (* mount_mountable) (GFile *file,
440 GMountMountFlags flags,
441 GMountOperation *mount_operation,
442 GCancellable *cancellable,
443 GAsyncReadyCallback callback,
444 gpointer user_data);
445 GFile * (* mount_mountable_finish) (GFile *file,
446 GAsyncResult *result,
447 GError **error);
448
449 void (* unmount_mountable) (GFile *file,
450 GMountUnmountFlags flags,
451 GCancellable *cancellable,
452 GAsyncReadyCallback callback,
453 gpointer user_data);
454 gboolean (* unmount_mountable_finish) (GFile *file,
455 GAsyncResult *result,
456 GError **error);
457
458 void (* eject_mountable) (GFile *file,
459 GMountUnmountFlags flags,
460 GCancellable *cancellable,
461 GAsyncReadyCallback callback,
462 gpointer user_data);
463 gboolean (* eject_mountable_finish) (GFile *file,
464 GAsyncResult *result,
465 GError **error);
466
467 void (* mount_enclosing_volume) (GFile *location,
468 GMountMountFlags flags,
469 GMountOperation *mount_operation,
470 GCancellable *cancellable,
471 GAsyncReadyCallback callback,
472 gpointer user_data);
473 gboolean (* mount_enclosing_volume_finish) (GFile *location,
474 GAsyncResult *result,
475 GError **error);
476
477 GFileMonitor * (* monitor_dir) (GFile *file,
478 GFileMonitorFlags flags,
479 GCancellable *cancellable,
480 GError **error);
481 GFileMonitor * (* monitor_file) (GFile *file,
482 GFileMonitorFlags flags,
483 GCancellable *cancellable,
484 GError **error);
485
486 GFileIOStream * (* open_readwrite) (GFile *file,
487 GCancellable *cancellable,
488 GError **error);
489 void (* open_readwrite_async) (GFile *file,
490 int io_priority,
491 GCancellable *cancellable,
492 GAsyncReadyCallback callback,
493 gpointer user_data);
494 GFileIOStream * (* open_readwrite_finish) (GFile *file,
495 GAsyncResult *res,
496 GError **error);
497 GFileIOStream * (* create_readwrite) (GFile *file,
498 GFileCreateFlags flags,
499 GCancellable *cancellable,
500 GError **error);
501 void (* create_readwrite_async) (GFile *file,
502 GFileCreateFlags flags,
503 int io_priority,
504 GCancellable *cancellable,
505 GAsyncReadyCallback callback,
506 gpointer user_data);
507 GFileIOStream * (* create_readwrite_finish) (GFile *file,
508 GAsyncResult *res,
509 GError **error);
510 GFileIOStream * (* replace_readwrite) (GFile *file,
511 const char *etag,
512 gboolean make_backup,
513 GFileCreateFlags flags,
514 GCancellable *cancellable,
515 GError **error);
516 void (* replace_readwrite_async) (GFile *file,
517 const char *etag,
518 gboolean make_backup,
519 GFileCreateFlags flags,
520 int io_priority,
521 GCancellable *cancellable,
522 GAsyncReadyCallback callback,
523 gpointer user_data);
524 GFileIOStream * (* replace_readwrite_finish) (GFile *file,
525 GAsyncResult *res,
526 GError **error);
527
528 void (* start_mountable) (GFile *file,
529 GDriveStartFlags flags,
530 GMountOperation *start_operation,
531 GCancellable *cancellable,
532 GAsyncReadyCallback callback,
533 gpointer user_data);
534 gboolean (* start_mountable_finish) (GFile *file,
535 GAsyncResult *result,
536 GError **error);
537
538 void (* stop_mountable) (GFile *file,
539 GMountUnmountFlags flags,
540 GMountOperation *mount_operation,
541 GCancellable *cancellable,
542 GAsyncReadyCallback callback,
543 gpointer user_data);
544 gboolean (* stop_mountable_finish) (GFile *file,
545 GAsyncResult *result,
546 GError **error);
547
548 gboolean supports_thread_contexts;
549
550 void (* unmount_mountable_with_operation) (GFile *file,
551 GMountUnmountFlags flags,
552 GMountOperation *mount_operation,
553 GCancellable *cancellable,
554 GAsyncReadyCallback callback,
555 gpointer user_data);
556 gboolean (* unmount_mountable_with_operation_finish) (GFile *file,
557 GAsyncResult *result,
558 GError **error);
559
560 void (* eject_mountable_with_operation) (GFile *file,
561 GMountUnmountFlags flags,
562 GMountOperation *mount_operation,
563 GCancellable *cancellable,
564 GAsyncReadyCallback callback,
565 gpointer user_data);
566 gboolean (* eject_mountable_with_operation_finish) (GFile *file,
567 GAsyncResult *result,
568 GError **error);
569
570 void (* poll_mountable) (GFile *file,
571 GCancellable *cancellable,
572 GAsyncReadyCallback callback,
573 gpointer user_data);
574 gboolean (* poll_mountable_finish) (GFile *file,
575 GAsyncResult *result,
576 GError **error);
577
578 gboolean (* measure_disk_usage) (GFile *file,
579 GFileMeasureFlags flags,
580 GCancellable *cancellable,
581 GFileMeasureProgressCallback progress_callback,
582 gpointer progress_data,
583 guint64 *disk_usage,
584 guint64 *num_dirs,
585 guint64 *num_files,
586 GError **error);
587 void (* measure_disk_usage_async) (GFile *file,
588 GFileMeasureFlags flags,
589 gint io_priority,
590 GCancellable *cancellable,
591 GFileMeasureProgressCallback progress_callback,
592 gpointer progress_data,
593 GAsyncReadyCallback callback,
594 gpointer user_data);
595 gboolean (* measure_disk_usage_finish) (GFile *file,
596 GAsyncResult *result,
597 guint64 *disk_usage,
598 guint64 *num_dirs,
599 guint64 *num_files,
600 GError **error);
601};
602
603GIO_AVAILABLE_IN_ALL
604GType g_file_get_type (void) G_GNUC_CONST;
605
606GIO_AVAILABLE_IN_ALL
607GFile * g_file_new_for_path (const char *path);
608GIO_AVAILABLE_IN_ALL
609GFile * g_file_new_for_uri (const char *uri);
610GIO_AVAILABLE_IN_ALL
611GFile * g_file_new_for_commandline_arg (const char *arg);
612GIO_AVAILABLE_IN_2_36
613GFile * g_file_new_for_commandline_arg_and_cwd (const gchar *arg,
614 const gchar *cwd);
615GIO_AVAILABLE_IN_2_32
616GFile * g_file_new_tmp (const char *tmpl,
617 GFileIOStream **iostream,
618 GError **error);
619GIO_AVAILABLE_IN_2_74
620void g_file_new_tmp_async (const char *tmpl,
621 int io_priority,
622 GCancellable *cancellable,
623 GAsyncReadyCallback callback,
624 gpointer user_data);
625GIO_AVAILABLE_IN_2_74
626GFile * g_file_new_tmp_finish (GAsyncResult *result,
627 GFileIOStream **iostream,
628 GError **error);
629GIO_AVAILABLE_IN_2_74
630void g_file_new_tmp_dir_async (const char *tmpl,
631 int io_priority,
632 GCancellable *cancellable,
633 GAsyncReadyCallback callback,
634 gpointer user_data);
635GIO_AVAILABLE_IN_2_74
636GFile * g_file_new_tmp_dir_finish (GAsyncResult *result,
637 GError **error);
638GIO_AVAILABLE_IN_ALL
639GFile * g_file_parse_name (const char *parse_name);
640GIO_AVAILABLE_IN_2_56
641GFile * g_file_new_build_filename (const gchar *first_element,
642 ...) G_GNUC_NULL_TERMINATED;
643GIO_AVAILABLE_IN_2_78
644GFile * g_file_new_build_filenamev (const gchar * const *args);
645GIO_AVAILABLE_IN_ALL
646GFile * g_file_dup (GFile *file);
647GIO_AVAILABLE_IN_ALL
648guint g_file_hash (gconstpointer file);
649GIO_AVAILABLE_IN_ALL
650gboolean g_file_equal (GFile *file1,
651 GFile *file2);
652GIO_AVAILABLE_IN_ALL
653char * g_file_get_basename (GFile *file);
654GIO_AVAILABLE_IN_ALL
655char * g_file_get_path (GFile *file);
656GIO_AVAILABLE_IN_2_56
657const char * g_file_peek_path (GFile *file);
658GIO_AVAILABLE_IN_ALL
659char * g_file_get_uri (GFile *file);
660GIO_AVAILABLE_IN_ALL
661char * g_file_get_parse_name (GFile *file);
662GIO_AVAILABLE_IN_ALL
663GFile * g_file_get_parent (GFile *file);
664GIO_AVAILABLE_IN_ALL
665gboolean g_file_has_parent (GFile *file,
666 GFile *parent);
667GIO_AVAILABLE_IN_ALL
668GFile * g_file_get_child (GFile *file,
669 const char *name);
670GIO_AVAILABLE_IN_ALL
671GFile * g_file_get_child_for_display_name (GFile *file,
672 const char *display_name,
673 GError **error);
674GIO_AVAILABLE_IN_ALL
675gboolean g_file_has_prefix (GFile *file,
676 GFile *prefix);
677GIO_AVAILABLE_IN_ALL
678char * g_file_get_relative_path (GFile *parent,
679 GFile *descendant);
680GIO_AVAILABLE_IN_ALL
681GFile * g_file_resolve_relative_path (GFile *file,
682 const char *relative_path);
683GIO_AVAILABLE_IN_ALL
684gboolean g_file_is_native (GFile *file);
685GIO_AVAILABLE_IN_ALL
686gboolean g_file_has_uri_scheme (GFile *file,
687 const char *uri_scheme);
688GIO_AVAILABLE_IN_ALL
689char * g_file_get_uri_scheme (GFile *file);
690GIO_AVAILABLE_IN_ALL
691GFileInputStream * g_file_read (GFile *file,
692 GCancellable *cancellable,
693 GError **error);
694GIO_AVAILABLE_IN_ALL
695void g_file_read_async (GFile *file,
696 int io_priority,
697 GCancellable *cancellable,
698 GAsyncReadyCallback callback,
699 gpointer user_data);
700GIO_AVAILABLE_IN_ALL
701GFileInputStream * g_file_read_finish (GFile *file,
702 GAsyncResult *res,
703 GError **error);
704GIO_AVAILABLE_IN_ALL
705GFileOutputStream * g_file_append_to (GFile *file,
706 GFileCreateFlags flags,
707 GCancellable *cancellable,
708 GError **error);
709GIO_AVAILABLE_IN_ALL
710GFileOutputStream * g_file_create (GFile *file,
711 GFileCreateFlags flags,
712 GCancellable *cancellable,
713 GError **error);
714GIO_AVAILABLE_IN_ALL
715GFileOutputStream * g_file_replace (GFile *file,
716 const char *etag,
717 gboolean make_backup,
718 GFileCreateFlags flags,
719 GCancellable *cancellable,
720 GError **error);
721GIO_AVAILABLE_IN_ALL
722void g_file_append_to_async (GFile *file,
723 GFileCreateFlags flags,
724 int io_priority,
725 GCancellable *cancellable,
726 GAsyncReadyCallback callback,
727 gpointer user_data);
728GIO_AVAILABLE_IN_ALL
729GFileOutputStream * g_file_append_to_finish (GFile *file,
730 GAsyncResult *res,
731 GError **error);
732GIO_AVAILABLE_IN_ALL
733void g_file_create_async (GFile *file,
734 GFileCreateFlags flags,
735 int io_priority,
736 GCancellable *cancellable,
737 GAsyncReadyCallback callback,
738 gpointer user_data);
739GIO_AVAILABLE_IN_ALL
740GFileOutputStream * g_file_create_finish (GFile *file,
741 GAsyncResult *res,
742 GError **error);
743GIO_AVAILABLE_IN_ALL
744void g_file_replace_async (GFile *file,
745 const char *etag,
746 gboolean make_backup,
747 GFileCreateFlags flags,
748 int io_priority,
749 GCancellable *cancellable,
750 GAsyncReadyCallback callback,
751 gpointer user_data);
752GIO_AVAILABLE_IN_ALL
753GFileOutputStream * g_file_replace_finish (GFile *file,
754 GAsyncResult *res,
755 GError **error);
756GIO_AVAILABLE_IN_ALL
757GFileIOStream * g_file_open_readwrite (GFile *file,
758 GCancellable *cancellable,
759 GError **error);
760GIO_AVAILABLE_IN_ALL
761void g_file_open_readwrite_async (GFile *file,
762 int io_priority,
763 GCancellable *cancellable,
764 GAsyncReadyCallback callback,
765 gpointer user_data);
766GIO_AVAILABLE_IN_ALL
767GFileIOStream * g_file_open_readwrite_finish (GFile *file,
768 GAsyncResult *res,
769 GError **error);
770GIO_AVAILABLE_IN_ALL
771GFileIOStream * g_file_create_readwrite (GFile *file,
772 GFileCreateFlags flags,
773 GCancellable *cancellable,
774 GError **error);
775GIO_AVAILABLE_IN_ALL
776void g_file_create_readwrite_async (GFile *file,
777 GFileCreateFlags flags,
778 int io_priority,
779 GCancellable *cancellable,
780 GAsyncReadyCallback callback,
781 gpointer user_data);
782GIO_AVAILABLE_IN_ALL
783GFileIOStream * g_file_create_readwrite_finish (GFile *file,
784 GAsyncResult *res,
785 GError **error);
786GIO_AVAILABLE_IN_ALL
787GFileIOStream * g_file_replace_readwrite (GFile *file,
788 const char *etag,
789 gboolean make_backup,
790 GFileCreateFlags flags,
791 GCancellable *cancellable,
792 GError **error);
793GIO_AVAILABLE_IN_ALL
794void g_file_replace_readwrite_async (GFile *file,
795 const char *etag,
796 gboolean make_backup,
797 GFileCreateFlags flags,
798 int io_priority,
799 GCancellable *cancellable,
800 GAsyncReadyCallback callback,
801 gpointer user_data);
802GIO_AVAILABLE_IN_ALL
803GFileIOStream * g_file_replace_readwrite_finish (GFile *file,
804 GAsyncResult *res,
805 GError **error);
806GIO_AVAILABLE_IN_ALL
807gboolean g_file_query_exists (GFile *file,
808 GCancellable *cancellable);
809GIO_AVAILABLE_IN_ALL
810GFileType g_file_query_file_type (GFile *file,
811 GFileQueryInfoFlags flags,
812 GCancellable *cancellable);
813GIO_AVAILABLE_IN_ALL
814GFileInfo * g_file_query_info (GFile *file,
815 const char *attributes,
816 GFileQueryInfoFlags flags,
817 GCancellable *cancellable,
818 GError **error);
819GIO_AVAILABLE_IN_ALL
820void g_file_query_info_async (GFile *file,
821 const char *attributes,
822 GFileQueryInfoFlags flags,
823 int io_priority,
824 GCancellable *cancellable,
825 GAsyncReadyCallback callback,
826 gpointer user_data);
827GIO_AVAILABLE_IN_ALL
828GFileInfo * g_file_query_info_finish (GFile *file,
829 GAsyncResult *res,
830 GError **error);
831GIO_AVAILABLE_IN_ALL
832GFileInfo * g_file_query_filesystem_info (GFile *file,
833 const char *attributes,
834 GCancellable *cancellable,
835 GError **error);
836GIO_AVAILABLE_IN_ALL
837void g_file_query_filesystem_info_async (GFile *file,
838 const char *attributes,
839 int io_priority,
840 GCancellable *cancellable,
841 GAsyncReadyCallback callback,
842 gpointer user_data);
843GIO_AVAILABLE_IN_ALL
844GFileInfo * g_file_query_filesystem_info_finish (GFile *file,
845 GAsyncResult *res,
846 GError **error);
847GIO_AVAILABLE_IN_ALL
848GMount * g_file_find_enclosing_mount (GFile *file,
849 GCancellable *cancellable,
850 GError **error);
851GIO_AVAILABLE_IN_ALL
852void g_file_find_enclosing_mount_async (GFile *file,
853 int io_priority,
854 GCancellable *cancellable,
855 GAsyncReadyCallback callback,
856 gpointer user_data);
857GIO_AVAILABLE_IN_ALL
858GMount * g_file_find_enclosing_mount_finish (GFile *file,
859 GAsyncResult *res,
860 GError **error);
861GIO_AVAILABLE_IN_ALL
862GFileEnumerator * g_file_enumerate_children (GFile *file,
863 const char *attributes,
864 GFileQueryInfoFlags flags,
865 GCancellable *cancellable,
866 GError **error);
867GIO_AVAILABLE_IN_ALL
868void g_file_enumerate_children_async (GFile *file,
869 const char *attributes,
870 GFileQueryInfoFlags flags,
871 int io_priority,
872 GCancellable *cancellable,
873 GAsyncReadyCallback callback,
874 gpointer user_data);
875GIO_AVAILABLE_IN_ALL
876GFileEnumerator * g_file_enumerate_children_finish (GFile *file,
877 GAsyncResult *res,
878 GError **error);
879GIO_AVAILABLE_IN_ALL
880GFile * g_file_set_display_name (GFile *file,
881 const char *display_name,
882 GCancellable *cancellable,
883 GError **error);
884GIO_AVAILABLE_IN_ALL
885void g_file_set_display_name_async (GFile *file,
886 const char *display_name,
887 int io_priority,
888 GCancellable *cancellable,
889 GAsyncReadyCallback callback,
890 gpointer user_data);
891GIO_AVAILABLE_IN_ALL
892GFile * g_file_set_display_name_finish (GFile *file,
893 GAsyncResult *res,
894 GError **error);
895GIO_AVAILABLE_IN_ALL
896gboolean g_file_delete (GFile *file,
897 GCancellable *cancellable,
898 GError **error);
899
900GIO_AVAILABLE_IN_2_34
901void g_file_delete_async (GFile *file,
902 int io_priority,
903 GCancellable *cancellable,
904 GAsyncReadyCallback callback,
905 gpointer user_data);
906
907GIO_AVAILABLE_IN_2_34
908gboolean g_file_delete_finish (GFile *file,
909 GAsyncResult *result,
910 GError **error);
911
912GIO_AVAILABLE_IN_ALL
913gboolean g_file_trash (GFile *file,
914 GCancellable *cancellable,
915 GError **error);
916
917GIO_AVAILABLE_IN_2_38
918void g_file_trash_async (GFile *file,
919 int io_priority,
920 GCancellable *cancellable,
921 GAsyncReadyCallback callback,
922 gpointer user_data);
923
924GIO_AVAILABLE_IN_2_38
925gboolean g_file_trash_finish (GFile *file,
926 GAsyncResult *result,
927 GError **error);
928
929GIO_AVAILABLE_IN_ALL
930gboolean g_file_copy (GFile *source,
931 GFile *destination,
932 GFileCopyFlags flags,
933 GCancellable *cancellable,
934 GFileProgressCallback progress_callback,
935 gpointer progress_callback_data,
936 GError **error);
937GIO_AVAILABLE_IN_ALL
938void g_file_copy_async (GFile *source,
939 GFile *destination,
940 GFileCopyFlags flags,
941 int io_priority,
942 GCancellable *cancellable,
943 GFileProgressCallback progress_callback,
944 gpointer progress_callback_data,
945 GAsyncReadyCallback callback,
946 gpointer user_data);
947GIO_AVAILABLE_IN_2_82
948void g_file_copy_async_with_closures (GFile *source,
949 GFile *destination,
950 GFileCopyFlags flags,
951 int io_priority,
952 GCancellable *cancellable,
953 GClosure *progress_callback_closure,
954 GClosure *ready_callback_closure);
955GIO_AVAILABLE_IN_ALL
956gboolean g_file_copy_finish (GFile *file,
957 GAsyncResult *res,
958 GError **error);
959GIO_AVAILABLE_IN_ALL
960gboolean g_file_move (GFile *source,
961 GFile *destination,
962 GFileCopyFlags flags,
963 GCancellable *cancellable,
964 GFileProgressCallback progress_callback,
965 gpointer progress_callback_data,
966 GError **error);
967GIO_AVAILABLE_IN_2_72
968void g_file_move_async (GFile *source,
969 GFile *destination,
970 GFileCopyFlags flags,
971 int io_priority,
972 GCancellable *cancellable,
973 GFileProgressCallback progress_callback,
974 gpointer progress_callback_data,
975 GAsyncReadyCallback callback,
976 gpointer user_data);
977GIO_AVAILABLE_IN_2_82
978void g_file_move_async_with_closures (GFile *source,
979 GFile *destination,
980 GFileCopyFlags flags,
981 int io_priority,
982 GCancellable *cancellable,
983 GClosure *progress_callback_closure,
984 GClosure *ready_callback_closure);
985GIO_AVAILABLE_IN_2_72
986gboolean g_file_move_finish (GFile *file,
987 GAsyncResult *result,
988 GError **error);
989GIO_AVAILABLE_IN_ALL
990gboolean g_file_make_directory (GFile *file,
991 GCancellable *cancellable,
992 GError **error);
993GIO_AVAILABLE_IN_2_38
994void g_file_make_directory_async (GFile *file,
995 int io_priority,
996 GCancellable *cancellable,
997 GAsyncReadyCallback callback,
998 gpointer user_data);
999GIO_AVAILABLE_IN_2_38
1000gboolean g_file_make_directory_finish (GFile *file,
1001 GAsyncResult *result,
1002 GError **error);
1003
1004GIO_AVAILABLE_IN_ALL
1005gboolean g_file_make_directory_with_parents (GFile *file,
1006 GCancellable *cancellable,
1007 GError **error);
1008GIO_AVAILABLE_IN_ALL
1009gboolean g_file_make_symbolic_link (GFile *file,
1010 const char *symlink_value,
1011 GCancellable *cancellable,
1012 GError **error);
1013GIO_AVAILABLE_IN_2_74
1014void g_file_make_symbolic_link_async (GFile *file,
1015 const char *symlink_value,
1016 int io_priority,
1017 GCancellable *cancellable,
1018 GAsyncReadyCallback callback,
1019 gpointer user_data);
1020GIO_AVAILABLE_IN_2_74
1021gboolean g_file_make_symbolic_link_finish (GFile *file,
1022 GAsyncResult *result,
1023 GError **error);
1024GIO_AVAILABLE_IN_ALL
1025GFileAttributeInfoList *g_file_query_settable_attributes (GFile *file,
1026 GCancellable *cancellable,
1027 GError **error);
1028GIO_AVAILABLE_IN_ALL
1029GFileAttributeInfoList *g_file_query_writable_namespaces (GFile *file,
1030 GCancellable *cancellable,
1031 GError **error);
1032GIO_AVAILABLE_IN_ALL
1033gboolean g_file_set_attribute (GFile *file,
1034 const char *attribute,
1035 GFileAttributeType type,
1036 gpointer value_p,
1037 GFileQueryInfoFlags flags,
1038 GCancellable *cancellable,
1039 GError **error);
1040GIO_AVAILABLE_IN_ALL
1041gboolean g_file_set_attributes_from_info (GFile *file,
1042 GFileInfo *info,
1043 GFileQueryInfoFlags flags,
1044 GCancellable *cancellable,
1045 GError **error);
1046GIO_AVAILABLE_IN_ALL
1047void g_file_set_attributes_async (GFile *file,
1048 GFileInfo *info,
1049 GFileQueryInfoFlags flags,
1050 int io_priority,
1051 GCancellable *cancellable,
1052 GAsyncReadyCallback callback,
1053 gpointer user_data);
1054GIO_AVAILABLE_IN_ALL
1055gboolean g_file_set_attributes_finish (GFile *file,
1056 GAsyncResult *result,
1057 GFileInfo **info,
1058 GError **error);
1059GIO_AVAILABLE_IN_ALL
1060gboolean g_file_set_attribute_string (GFile *file,
1061 const char *attribute,
1062 const char *value,
1063 GFileQueryInfoFlags flags,
1064 GCancellable *cancellable,
1065 GError **error);
1066GIO_AVAILABLE_IN_ALL
1067gboolean g_file_set_attribute_byte_string (GFile *file,
1068 const char *attribute,
1069 const char *value,
1070 GFileQueryInfoFlags flags,
1071 GCancellable *cancellable,
1072 GError **error);
1073GIO_AVAILABLE_IN_ALL
1074gboolean g_file_set_attribute_uint32 (GFile *file,
1075 const char *attribute,
1076 guint32 value,
1077 GFileQueryInfoFlags flags,
1078 GCancellable *cancellable,
1079 GError **error);
1080GIO_AVAILABLE_IN_ALL
1081gboolean g_file_set_attribute_int32 (GFile *file,
1082 const char *attribute,
1083 gint32 value,
1084 GFileQueryInfoFlags flags,
1085 GCancellable *cancellable,
1086 GError **error);
1087GIO_AVAILABLE_IN_ALL
1088gboolean g_file_set_attribute_uint64 (GFile *file,
1089 const char *attribute,
1090 guint64 value,
1091 GFileQueryInfoFlags flags,
1092 GCancellable *cancellable,
1093 GError **error);
1094GIO_AVAILABLE_IN_ALL
1095gboolean g_file_set_attribute_int64 (GFile *file,
1096 const char *attribute,
1097 gint64 value,
1098 GFileQueryInfoFlags flags,
1099 GCancellable *cancellable,
1100 GError **error);
1101GIO_AVAILABLE_IN_ALL
1102void g_file_mount_enclosing_volume (GFile *location,
1103 GMountMountFlags flags,
1104 GMountOperation *mount_operation,
1105 GCancellable *cancellable,
1106 GAsyncReadyCallback callback,
1107 gpointer user_data);
1108GIO_AVAILABLE_IN_ALL
1109gboolean g_file_mount_enclosing_volume_finish (GFile *location,
1110 GAsyncResult *result,
1111 GError **error);
1112GIO_AVAILABLE_IN_ALL
1113void g_file_mount_mountable (GFile *file,
1114 GMountMountFlags flags,
1115 GMountOperation *mount_operation,
1116 GCancellable *cancellable,
1117 GAsyncReadyCallback callback,
1118 gpointer user_data);
1119GIO_AVAILABLE_IN_ALL
1120GFile * g_file_mount_mountable_finish (GFile *file,
1121 GAsyncResult *result,
1122 GError **error);
1123GIO_DEPRECATED_FOR(g_file_unmount_mountable_with_operation)
1124void g_file_unmount_mountable (GFile *file,
1125 GMountUnmountFlags flags,
1126 GCancellable *cancellable,
1127 GAsyncReadyCallback callback,
1128 gpointer user_data);
1129
1130GIO_DEPRECATED_FOR(g_file_unmount_mountable_with_operation_finish)
1131gboolean g_file_unmount_mountable_finish (GFile *file,
1132 GAsyncResult *result,
1133 GError **error);
1134GIO_AVAILABLE_IN_ALL
1135void g_file_unmount_mountable_with_operation (GFile *file,
1136 GMountUnmountFlags flags,
1137 GMountOperation *mount_operation,
1138 GCancellable *cancellable,
1139 GAsyncReadyCallback callback,
1140 gpointer user_data);
1141GIO_AVAILABLE_IN_ALL
1142gboolean g_file_unmount_mountable_with_operation_finish (GFile *file,
1143 GAsyncResult *result,
1144 GError **error);
1145GIO_DEPRECATED_FOR(g_file_eject_mountable_with_operation)
1146void g_file_eject_mountable (GFile *file,
1147 GMountUnmountFlags flags,
1148 GCancellable *cancellable,
1149 GAsyncReadyCallback callback,
1150 gpointer user_data);
1151
1152GIO_DEPRECATED_FOR(g_file_eject_mountable_with_operation_finish)
1153gboolean g_file_eject_mountable_finish (GFile *file,
1154 GAsyncResult *result,
1155 GError **error);
1156GIO_AVAILABLE_IN_ALL
1157void g_file_eject_mountable_with_operation (GFile *file,
1158 GMountUnmountFlags flags,
1159 GMountOperation *mount_operation,
1160 GCancellable *cancellable,
1161 GAsyncReadyCallback callback,
1162 gpointer user_data);
1163GIO_AVAILABLE_IN_ALL
1164gboolean g_file_eject_mountable_with_operation_finish (GFile *file,
1165 GAsyncResult *result,
1166 GError **error);
1167
1168GIO_AVAILABLE_IN_2_68
1169char * g_file_build_attribute_list_for_copy (GFile *file,
1170 GFileCopyFlags flags,
1171 GCancellable *cancellable,
1172 GError **error);
1173
1174GIO_AVAILABLE_IN_ALL
1175gboolean g_file_copy_attributes (GFile *source,
1176 GFile *destination,
1177 GFileCopyFlags flags,
1178 GCancellable *cancellable,
1179 GError **error);
1180
1181
1182GIO_AVAILABLE_IN_ALL
1183GFileMonitor* g_file_monitor_directory (GFile *file,
1184 GFileMonitorFlags flags,
1185 GCancellable *cancellable,
1186 GError **error);
1187GIO_AVAILABLE_IN_ALL
1188GFileMonitor* g_file_monitor_file (GFile *file,
1189 GFileMonitorFlags flags,
1190 GCancellable *cancellable,
1191 GError **error);
1192GIO_AVAILABLE_IN_ALL
1193GFileMonitor* g_file_monitor (GFile *file,
1194 GFileMonitorFlags flags,
1195 GCancellable *cancellable,
1196 GError **error);
1197
1198GIO_AVAILABLE_IN_2_38
1199gboolean g_file_measure_disk_usage (GFile *file,
1200 GFileMeasureFlags flags,
1201 GCancellable *cancellable,
1202 GFileMeasureProgressCallback progress_callback,
1203 gpointer progress_data,
1204 guint64 *disk_usage,
1205 guint64 *num_dirs,
1206 guint64 *num_files,
1207 GError **error);
1208
1209GIO_AVAILABLE_IN_2_38
1210void g_file_measure_disk_usage_async (GFile *file,
1211 GFileMeasureFlags flags,
1212 gint io_priority,
1213 GCancellable *cancellable,
1214 GFileMeasureProgressCallback progress_callback,
1215 gpointer progress_data,
1216 GAsyncReadyCallback callback,
1217 gpointer user_data);
1218
1219GIO_AVAILABLE_IN_2_38
1220gboolean g_file_measure_disk_usage_finish (GFile *file,
1221 GAsyncResult *result,
1222 guint64 *disk_usage,
1223 guint64 *num_dirs,
1224 guint64 *num_files,
1225 GError **error);
1226
1227GIO_AVAILABLE_IN_ALL
1228void g_file_start_mountable (GFile *file,
1229 GDriveStartFlags flags,
1230 GMountOperation *start_operation,
1231 GCancellable *cancellable,
1232 GAsyncReadyCallback callback,
1233 gpointer user_data);
1234GIO_AVAILABLE_IN_ALL
1235gboolean g_file_start_mountable_finish (GFile *file,
1236 GAsyncResult *result,
1237 GError **error);
1238GIO_AVAILABLE_IN_ALL
1239void g_file_stop_mountable (GFile *file,
1240 GMountUnmountFlags flags,
1241 GMountOperation *mount_operation,
1242 GCancellable *cancellable,
1243 GAsyncReadyCallback callback,
1244 gpointer user_data);
1245GIO_AVAILABLE_IN_ALL
1246gboolean g_file_stop_mountable_finish (GFile *file,
1247 GAsyncResult *result,
1248 GError **error);
1249
1250GIO_AVAILABLE_IN_ALL
1251void g_file_poll_mountable (GFile *file,
1252 GCancellable *cancellable,
1253 GAsyncReadyCallback callback,
1254 gpointer user_data);
1255GIO_AVAILABLE_IN_ALL
1256gboolean g_file_poll_mountable_finish (GFile *file,
1257 GAsyncResult *result,
1258 GError **error);
1259
1260/* Utilities */
1261
1262GIO_AVAILABLE_IN_ALL
1263GAppInfo *g_file_query_default_handler (GFile *file,
1264 GCancellable *cancellable,
1265 GError **error);
1266GIO_AVAILABLE_IN_2_60
1267void g_file_query_default_handler_async (GFile *file,
1268 int io_priority,
1269 GCancellable *cancellable,
1270 GAsyncReadyCallback callback,
1271 gpointer user_data);
1272GIO_AVAILABLE_IN_2_60
1273GAppInfo *g_file_query_default_handler_finish (GFile *file,
1274 GAsyncResult *result,
1275 GError **error);
1276
1277GIO_AVAILABLE_IN_ALL
1278gboolean g_file_load_contents (GFile *file,
1279 GCancellable *cancellable,
1280 char **contents,
1281 gsize *length,
1282 char **etag_out,
1283 GError **error);
1284GIO_AVAILABLE_IN_ALL
1285void g_file_load_contents_async (GFile *file,
1286 GCancellable *cancellable,
1287 GAsyncReadyCallback callback,
1288 gpointer user_data);
1289GIO_AVAILABLE_IN_ALL
1290gboolean g_file_load_contents_finish (GFile *file,
1291 GAsyncResult *res,
1292 char **contents,
1293 gsize *length,
1294 char **etag_out,
1295 GError **error);
1296GIO_AVAILABLE_IN_ALL
1297void g_file_load_partial_contents_async (GFile *file,
1298 GCancellable *cancellable,
1299 GFileReadMoreCallback read_more_callback,
1300 GAsyncReadyCallback callback,
1301 gpointer user_data);
1302GIO_AVAILABLE_IN_ALL
1303gboolean g_file_load_partial_contents_finish (GFile *file,
1304 GAsyncResult *res,
1305 char **contents,
1306 gsize *length,
1307 char **etag_out,
1308 GError **error);
1309GIO_AVAILABLE_IN_ALL
1310gboolean g_file_replace_contents (GFile *file,
1311 const char *contents,
1312 gsize length,
1313 const char *etag,
1314 gboolean make_backup,
1315 GFileCreateFlags flags,
1316 char **new_etag,
1317 GCancellable *cancellable,
1318 GError **error);
1319GIO_AVAILABLE_IN_ALL
1320void g_file_replace_contents_async (GFile *file,
1321 const char *contents,
1322 gsize length,
1323 const char *etag,
1324 gboolean make_backup,
1325 GFileCreateFlags flags,
1326 GCancellable *cancellable,
1327 GAsyncReadyCallback callback,
1328 gpointer user_data);
1329GIO_AVAILABLE_IN_2_40
1330void g_file_replace_contents_bytes_async (GFile *file,
1331 GBytes *contents,
1332 const char *etag,
1333 gboolean make_backup,
1334 GFileCreateFlags flags,
1335 GCancellable *cancellable,
1336 GAsyncReadyCallback callback,
1337 gpointer user_data);
1338GIO_AVAILABLE_IN_ALL
1339gboolean g_file_replace_contents_finish (GFile *file,
1340 GAsyncResult *res,
1341 char **new_etag,
1342 GError **error);
1343
1344GIO_AVAILABLE_IN_ALL
1345gboolean g_file_supports_thread_contexts (GFile *file);
1346
1347GIO_AVAILABLE_IN_2_56
1348GBytes *g_file_load_bytes (GFile *file,
1349 GCancellable *cancellable,
1350 gchar **etag_out,
1351 GError **error);
1352GIO_AVAILABLE_IN_2_56
1353void g_file_load_bytes_async (GFile *file,
1354 GCancellable *cancellable,
1355 GAsyncReadyCallback callback,
1356 gpointer user_data);
1357GIO_AVAILABLE_IN_2_56
1358GBytes *g_file_load_bytes_finish (GFile *file,
1359 GAsyncResult *result,
1360 gchar **etag_out,
1361 GError **error);
1362
1363G_END_DECLS
1364
1365#endif /* __G_FILE_H__ */
1366