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