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 <[email protected]>
19 */
20
21#ifndef __G_FILE_INFO_H__
22#define __G_FILE_INFO_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_INFO (g_file_info_get_type ())
33#define G_FILE_INFO(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_FILE_INFO, GFileInfo))
34#define G_FILE_INFO_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_FILE_INFO, GFileInfoClass))
35#define G_IS_FILE_INFO(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_FILE_INFO))
36#define G_IS_FILE_INFO_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_FILE_INFO))
37#define G_FILE_INFO_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_FILE_INFO, GFileInfoClass))
38
39/**
40 * GFileInfo:
41 *
42 * Stores information about a file system object referenced by a #GFile.
43 **/
44typedef struct _GFileInfoClass GFileInfoClass;
45
46
47/* Common Attributes: */
48/**
49 * G_FILE_ATTRIBUTE_STANDARD_TYPE:
50 *
51 * A key in the "standard" namespace for storing file types.
52 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
53 * The value for this key should contain a #GFileType.
54 **/
55#define G_FILE_ATTRIBUTE_STANDARD_TYPE "standard::type" /* uint32 (GFileType) */
56
57/**
58 * G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN:
59 *
60 * A key in the "standard" namespace for checking if a file is hidden.
61 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
62 **/
63#define G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN "standard::is-hidden" /* boolean */
64
65/**
66 * G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP:
67 *
68 * A key in the "standard" namespace for checking if a file is a backup file.
69 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
70 **/
71#define G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP "standard::is-backup" /* boolean */
72
73/**
74 * G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK:
75 *
76 * A key in the "standard" namespace for checking if the file is a symlink.
77 * Typically the actual type is something else, if we followed the symlink
78 * to get the type.
79 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
80 **/
81#define G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK "standard::is-symlink" /* boolean */
82
83/**
84 * G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL:
85 *
86 * A key in the "standard" namespace for checking if a file is virtual.
87 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
88 **/
89#define G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL "standard::is-virtual" /* boolean */
90
91/**
92 * G_FILE_ATTRIBUTE_STANDARD_IS_VOLATILE:
93 *
94 * A key in the "standard" namespace for checking if a file is
95 * volatile. This is meant for opaque, non-POSIX-like backends to
96 * indicate that the URI is not persistent. Applications should look
97 * at #G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET for the persistent URI.
98 *
99 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
100 *
101 * Since: 2.46
102 **/
103#define G_FILE_ATTRIBUTE_STANDARD_IS_VOLATILE "standard::is-volatile" /* boolean */
104
105/**
106 * G_FILE_ATTRIBUTE_STANDARD_NAME:
107 *
108 * A key in the "standard" namespace for getting the name of the file.
109 * The name is the on-disk filename which may not be in any known encoding,
110 * and can thus not be generally displayed as is.
111 * Use #G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME if you need to display the
112 * name in a user interface.
113 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
114 **/
115#define G_FILE_ATTRIBUTE_STANDARD_NAME "standard::name" /* byte string */
116
117/**
118 * G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME:
119 *
120 * A key in the "standard" namespace for getting the display name of the file.
121 * A display name is guaranteed to be in UTF8 and can thus be displayed in
122 * the UI.
123 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
124 **/
125#define G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME "standard::display-name" /* string */
126
127/**
128 * G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME:
129 *
130 * A key in the "standard" namespace for edit name of the file.
131 * An edit name is similar to the display name, but it is meant to be
132 * used when you want to rename the file in the UI. The display name
133 * might contain information you don't want in the new filename (such as
134 * "(invalid unicode)" if the filename was in an invalid encoding).
135 *
136 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
137 **/
138#define G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME "standard::edit-name" /* string */
139
140/**
141 * G_FILE_ATTRIBUTE_STANDARD_COPY_NAME:
142 *
143 * A key in the "standard" namespace for getting the copy name of the file.
144 * The copy name is an optional version of the name. If available it's always
145 * in UTF8, and corresponds directly to the original filename (only transcoded to
146 * UTF8). This is useful if you want to copy the file to another filesystem that
147 * might have a different encoding. If the filename is not a valid string in the
148 * encoding selected for the filesystem it is in then the copy name will not be set.
149 *
150 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
151 **/
152#define G_FILE_ATTRIBUTE_STANDARD_COPY_NAME "standard::copy-name" /* string */
153
154/**
155 * G_FILE_ATTRIBUTE_STANDARD_DESCRIPTION:
156 *
157 * A key in the "standard" namespace for getting the description of the file.
158 * The description is a utf8 string that describes the file, generally containing
159 * the filename, but can also contain furter information. Example descriptions
160 * could be "filename (on hostname)" for a remote file or "filename (in trash)"
161 * for a file in the trash. This is useful for instance as the window title
162 * when displaying a directory or for a bookmarks menu.
163 *
164 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
165 **/
166#define G_FILE_ATTRIBUTE_STANDARD_DESCRIPTION "standard::description" /* string */
167
168/**
169 * G_FILE_ATTRIBUTE_STANDARD_ICON:
170 *
171 * A key in the "standard" namespace for getting the icon for the file.
172 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT.
173 * The value for this key should contain a #GIcon.
174 **/
175#define G_FILE_ATTRIBUTE_STANDARD_ICON "standard::icon" /* object (GIcon) */
176
177/**
178 * G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON:
179 *
180 * A key in the "standard" namespace for getting the symbolic icon for the file.
181 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT.
182 * The value for this key should contain a #GIcon.
183 *
184 * Since: 2.34
185 **/
186#define G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON "standard::symbolic-icon" /* object (GIcon) */
187
188/**
189 * G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE:
190 *
191 * A key in the "standard" namespace for getting the content type of the file.
192 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
193 * The value for this key should contain a valid content type.
194 **/
195#define G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE "standard::content-type" /* string */
196
197/**
198 * G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE:
199 *
200 * A key in the "standard" namespace for getting the fast content type.
201 * The fast content type isn't as reliable as the regular one, as it
202 * only uses the filename to guess it, but it is faster to calculate than the
203 * regular content type.
204 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
205 *
206 **/
207#define G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE "standard::fast-content-type" /* string */
208
209/**
210 * G_FILE_ATTRIBUTE_STANDARD_SIZE:
211 *
212 * A key in the "standard" namespace for getting the file's size (in bytes).
213 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
214 **/
215#define G_FILE_ATTRIBUTE_STANDARD_SIZE "standard::size" /* uint64 */
216
217/**
218 * G_FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE:
219 *
220 * A key in the "standard" namespace for getting the amount of disk space
221 * that is consumed by the file (in bytes). This will generally be larger
222 * than the file size (due to block size overhead) but can occasionally be
223 * smaller (for example, for sparse files).
224 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
225 *
226 * Since: 2.20
227 **/
228#define G_FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE "standard::allocated-size" /* uint64 */
229
230/**
231 * G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET:
232 *
233 * A key in the "standard" namespace for getting the symlink target, if the file
234 * is a symlink. Corresponding #GFileAttributeType is
235 * %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
236 **/
237#define G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET "standard::symlink-target" /* byte string */
238
239/**
240 * G_FILE_ATTRIBUTE_STANDARD_TARGET_URI:
241 *
242 * A key in the "standard" namespace for getting the target URI for the file, in
243 * the case of %G_FILE_TYPE_SHORTCUT or %G_FILE_TYPE_MOUNTABLE files.
244 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
245 **/
246#define G_FILE_ATTRIBUTE_STANDARD_TARGET_URI "standard::target-uri" /* string */
247
248/**
249 * G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER:
250 *
251 * A key in the "standard" namespace for setting the sort order of a file.
252 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_INT32.
253 * An example use would be in file managers, which would use this key
254 * to set the order files are displayed. Files with smaller sort order
255 * should be sorted first, and files without sort order as if sort order
256 * was zero.
257 **/
258#define G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER "standard::sort-order" /* int32 */
259
260/* Entity tags, used to avoid missing updates on save */
261
262/**
263 * G_FILE_ATTRIBUTE_ETAG_VALUE:
264 *
265 * A key in the "etag" namespace for getting the value of the file's
266 * entity tag. Corresponding #GFileAttributeType is
267 * %G_FILE_ATTRIBUTE_TYPE_STRING.
268 **/
269#define G_FILE_ATTRIBUTE_ETAG_VALUE "etag::value" /* string */
270
271/* File identifier, for e.g. avoiding loops when doing recursive
272 * directory scanning
273 */
274
275/**
276 * G_FILE_ATTRIBUTE_ID_FILE:
277 *
278 * A key in the "id" namespace for getting a file identifier.
279 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
280 * An example use would be during listing files, to avoid recursive
281 * directory scanning.
282 **/
283#define G_FILE_ATTRIBUTE_ID_FILE "id::file" /* string */
284
285/**
286 * G_FILE_ATTRIBUTE_ID_FILESYSTEM:
287 *
288 * A key in the "id" namespace for getting the file system identifier.
289 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
290 * An example use would be during drag and drop to see if the source
291 * and target are on the same filesystem (default to move) or not (default
292 * to copy).
293 **/
294#define G_FILE_ATTRIBUTE_ID_FILESYSTEM "id::filesystem" /* string */
295
296/* Calculated Access Rights for current user */
297
298/**
299 * G_FILE_ATTRIBUTE_ACCESS_CAN_READ:
300 *
301 * A key in the "access" namespace for getting read privileges.
302 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
303 * This attribute will be %TRUE if the user is able to read the file.
304 **/
305#define G_FILE_ATTRIBUTE_ACCESS_CAN_READ "access::can-read" /* boolean */
306
307/**
308 * G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE:
309 *
310 * A key in the "access" namespace for getting write privileges.
311 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
312 * This attribute will be %TRUE if the user is able to write to the file.
313 **/
314#define G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE "access::can-write" /* boolean */
315
316/**
317 * G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE:
318 *
319 * A key in the "access" namespace for getting execution privileges.
320 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
321 * This attribute will be %TRUE if the user is able to execute the file.
322 **/
323#define G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE "access::can-execute" /* boolean */
324
325/**
326 * G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE:
327 *
328 * A key in the "access" namespace for checking deletion privileges.
329 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
330 * This attribute will be %TRUE if the user is able to delete the file.
331 **/
332#define G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE "access::can-delete" /* boolean */
333
334/**
335 * G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH:
336 *
337 * A key in the "access" namespace for checking trashing privileges.
338 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
339 * This attribute will be %TRUE if the user is able to move the file to
340 * the trash.
341 **/
342#define G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH "access::can-trash" /* boolean */
343
344/**
345 * G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME:
346 *
347 * A key in the "access" namespace for checking renaming privileges.
348 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
349 * This attribute will be %TRUE if the user is able to rename the file.
350 **/
351#define G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME "access::can-rename" /* boolean */
352
353/* TODO: Should we have special version for directories? can_enumerate, etc */
354
355/* Mountable attributes */
356
357/**
358 * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT:
359 *
360 * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is mountable.
361 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
362 **/
363#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT "mountable::can-mount" /* boolean */
364
365/**
366 * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT:
367 *
368 * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is unmountable.
369 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
370 **/
371#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT "mountable::can-unmount" /* boolean */
372
373/**
374 * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT:
375 *
376 * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be ejected.
377 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
378 **/
379#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT "mountable::can-eject" /* boolean */
380
381/**
382 * G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE:
383 *
384 * A key in the "mountable" namespace for getting the unix device.
385 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
386 **/
387#define G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE "mountable::unix-device" /* uint32 */
388
389/**
390 * G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE:
391 *
392 * A key in the "mountable" namespace for getting the unix device file.
393 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
394 *
395 * Since: 2.22
396 **/
397#define G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE "mountable::unix-device-file" /* string */
398
399/**
400 * G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI:
401 *
402 * A key in the "mountable" namespace for getting the HAL UDI for the mountable
403 * file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
404 **/
405#define G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI "mountable::hal-udi" /* string */
406
407/**
408 * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START:
409 *
410 * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started.
411 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
412 *
413 * Since: 2.22
414 */
415#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START "mountable::can-start" /* boolean */
416
417/**
418 * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED:
419 *
420 * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started
421 * degraded.
422 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
423 *
424 * Since: 2.22
425 */
426#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED "mountable::can-start-degraded" /* boolean */
427
428/**
429 * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP:
430 *
431 * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be stopped.
432 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
433 *
434 * Since: 2.22
435 */
436#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP "mountable::can-stop" /* boolean */
437
438/**
439 * G_FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE:
440 *
441 * A key in the "mountable" namespace for getting the #GDriveStartStopType.
442 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
443 *
444 * Since: 2.22
445 */
446#define G_FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE "mountable::start-stop-type" /* uint32 (GDriveStartStopType) */
447
448/**
449 * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL:
450 *
451 * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be polled.
452 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
453 *
454 * Since: 2.22
455 */
456#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL "mountable::can-poll" /* boolean */
457
458/**
459 * G_FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC:
460 *
461 * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE)
462 * is automatically polled for media.
463 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
464 *
465 * Since: 2.22
466 */
467#define G_FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC "mountable::is-media-check-automatic" /* boolean */
468
469/* Time attributes */
470
471/**
472 * G_FILE_ATTRIBUTE_TIME_MODIFIED:
473 *
474 * A key in the "time" namespace for getting the time the file was last
475 * modified. Corresponding #GFileAttributeType is
476 * %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the
477 * file was modified, in seconds since the UNIX epoch.
478 **/
479#define G_FILE_ATTRIBUTE_TIME_MODIFIED "time::modified" /* uint64 */
480
481/**
482 * G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC:
483 *
484 * A key in the "time" namespace for getting the microseconds of the time
485 * the file was last modified. This should be used in conjunction with
486 * #G_FILE_ATTRIBUTE_TIME_MODIFIED. Corresponding #GFileAttributeType is
487 * %G_FILE_ATTRIBUTE_TYPE_UINT32.
488 **/
489#define G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC "time::modified-usec" /* uint32 */
490
491/**
492 * G_FILE_ATTRIBUTE_TIME_ACCESS:
493 *
494 * A key in the "time" namespace for getting the time the file was last
495 * accessed. Corresponding #GFileAttributeType is
496 * %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the
497 * file was last accessed, in seconds since the UNIX epoch.
498 **/
499#define G_FILE_ATTRIBUTE_TIME_ACCESS "time::access" /* uint64 */
500
501/**
502 * G_FILE_ATTRIBUTE_TIME_ACCESS_USEC:
503 *
504 * A key in the "time" namespace for getting the microseconds of the time
505 * the file was last accessed. This should be used in conjunction with
506 * #G_FILE_ATTRIBUTE_TIME_ACCESS. Corresponding #GFileAttributeType is
507 * %G_FILE_ATTRIBUTE_TYPE_UINT32.
508 **/
509#define G_FILE_ATTRIBUTE_TIME_ACCESS_USEC "time::access-usec" /* uint32 */
510
511/**
512 * G_FILE_ATTRIBUTE_TIME_CHANGED:
513 *
514 * A key in the "time" namespace for getting the time the file was last
515 * changed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
516 * and contains the time since the file was last changed, in seconds since the
517 * UNIX epoch.
518 *
519 * This corresponds to the traditional UNIX ctime.
520 **/
521#define G_FILE_ATTRIBUTE_TIME_CHANGED "time::changed" /* uint64 */
522
523/**
524 * G_FILE_ATTRIBUTE_TIME_CHANGED_USEC:
525 *
526 * A key in the "time" namespace for getting the microseconds of the time
527 * the file was last changed. This should be used in conjunction with
528 * #G_FILE_ATTRIBUTE_TIME_CHANGED. Corresponding #GFileAttributeType is
529 * %G_FILE_ATTRIBUTE_TYPE_UINT32.
530 **/
531#define G_FILE_ATTRIBUTE_TIME_CHANGED_USEC "time::changed-usec" /* uint32 */
532
533/**
534 * G_FILE_ATTRIBUTE_TIME_CREATED:
535 *
536 * A key in the "time" namespace for getting the time the file was created.
537 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
538 * and contains the time since the file was created, in seconds since the UNIX
539 * epoch.
540 *
541 * This corresponds to the NTFS ctime.
542 **/
543#define G_FILE_ATTRIBUTE_TIME_CREATED "time::created" /* uint64 */
544
545/**
546 * G_FILE_ATTRIBUTE_TIME_CREATED_USEC:
547 *
548 * A key in the "time" namespace for getting the microseconds of the time
549 * the file was created. This should be used in conjunction with
550 * #G_FILE_ATTRIBUTE_TIME_CREATED. Corresponding #GFileAttributeType is
551 * %G_FILE_ATTRIBUTE_TYPE_UINT32.
552 **/
553#define G_FILE_ATTRIBUTE_TIME_CREATED_USEC "time::created-usec" /* uint32 */
554
555/* Unix specific attributes */
556
557/**
558 * G_FILE_ATTRIBUTE_UNIX_DEVICE:
559 *
560 * A key in the "unix" namespace for getting the device id of the device the
561 * file is located on (see stat() documentation). This attribute is only
562 * available for UNIX file systems. Corresponding #GFileAttributeType is
563 * %G_FILE_ATTRIBUTE_TYPE_UINT32.
564 **/
565#define G_FILE_ATTRIBUTE_UNIX_DEVICE "unix::device" /* uint32 */
566
567/**
568 * G_FILE_ATTRIBUTE_UNIX_INODE:
569 *
570 * A key in the "unix" namespace for getting the inode of the file.
571 * This attribute is only available for UNIX file systems. Corresponding
572 * #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
573 **/
574#define G_FILE_ATTRIBUTE_UNIX_INODE "unix::inode" /* uint64 */
575
576/**
577 * G_FILE_ATTRIBUTE_UNIX_MODE:
578 *
579 * A key in the "unix" namespace for getting the mode of the file
580 * (e.g. whether the file is a regular file, symlink, etc). See lstat()
581 * documentation. This attribute is only available for UNIX file systems.
582 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
583 **/
584#define G_FILE_ATTRIBUTE_UNIX_MODE "unix::mode" /* uint32 */
585
586/**
587 * G_FILE_ATTRIBUTE_UNIX_NLINK:
588 *
589 * A key in the "unix" namespace for getting the number of hard links
590 * for a file. See lstat() documentation. This attribute is only available
591 * for UNIX file systems. Corresponding #GFileAttributeType is
592 * %G_FILE_ATTRIBUTE_TYPE_UINT32.
593 **/
594#define G_FILE_ATTRIBUTE_UNIX_NLINK "unix::nlink" /* uint32 */
595
596/**
597 * G_FILE_ATTRIBUTE_UNIX_UID:
598 *
599 * A key in the "unix" namespace for getting the user ID for the file.
600 * This attribute is only available for UNIX file systems.
601 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
602 **/
603#define G_FILE_ATTRIBUTE_UNIX_UID "unix::uid" /* uint32 */
604
605/**
606 * G_FILE_ATTRIBUTE_UNIX_GID:
607 *
608 * A key in the "unix" namespace for getting the group ID for the file.
609 * This attribute is only available for UNIX file systems.
610 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
611 **/
612#define G_FILE_ATTRIBUTE_UNIX_GID "unix::gid" /* uint32 */
613
614/**
615 * G_FILE_ATTRIBUTE_UNIX_RDEV:
616 *
617 * A key in the "unix" namespace for getting the device ID for the file
618 * (if it is a special file). See lstat() documentation. This attribute
619 * is only available for UNIX file systems. Corresponding #GFileAttributeType
620 * is %G_FILE_ATTRIBUTE_TYPE_UINT32.
621 **/
622#define G_FILE_ATTRIBUTE_UNIX_RDEV "unix::rdev" /* uint32 */
623
624/**
625 * G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE:
626 *
627 * A key in the "unix" namespace for getting the block size for the file
628 * system. This attribute is only available for UNIX file systems.
629 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
630 **/
631#define G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE "unix::block-size" /* uint32 */
632
633/**
634 * G_FILE_ATTRIBUTE_UNIX_BLOCKS:
635 *
636 * A key in the "unix" namespace for getting the number of blocks allocated
637 * for the file. This attribute is only available for UNIX file systems.
638 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
639 **/
640#define G_FILE_ATTRIBUTE_UNIX_BLOCKS "unix::blocks" /* uint64 */
641
642/**
643 * G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT:
644 *
645 * A key in the "unix" namespace for checking if the file represents a
646 * UNIX mount point. This attribute is %TRUE if the file is a UNIX mount
647 * point. Since 2.58, `/` is considered to be a mount point.
648 * This attribute is only available for UNIX file systems.
649 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
650 **/
651#define G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT "unix::is-mountpoint" /* boolean */
652
653/* DOS specific attributes */
654
655/**
656 * G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE:
657 *
658 * A key in the "dos" namespace for checking if the file's archive flag
659 * is set. This attribute is %TRUE if the archive flag is set. This attribute
660 * is only available for DOS file systems. Corresponding #GFileAttributeType
661 * is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
662 **/
663#define G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE "dos::is-archive" /* boolean */
664
665/**
666 * G_FILE_ATTRIBUTE_DOS_IS_SYSTEM:
667 *
668 * A key in the "dos" namespace for checking if the file's backup flag
669 * is set. This attribute is %TRUE if the backup flag is set. This attribute
670 * is only available for DOS file systems. Corresponding #GFileAttributeType
671 * is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
672 **/
673#define G_FILE_ATTRIBUTE_DOS_IS_SYSTEM "dos::is-system" /* boolean */
674
675/**
676 * G_FILE_ATTRIBUTE_DOS_IS_MOUNTPOINT:
677 *
678 * A key in the "dos" namespace for checking if the file is a NTFS mount point
679 * (a volume mount or a junction point).
680 * This attribute is %TRUE if file is a reparse point of type
681 * [IO_REPARSE_TAG_MOUNT_POINT](https://msdn.microsoft.com/en-us/library/dd541667.aspx).
682 * This attribute is only available for DOS file systems.
683 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
684 *
685 * Since: 2.60
686 **/
687#define G_FILE_ATTRIBUTE_DOS_IS_MOUNTPOINT "dos::is-mountpoint" /* boolean */
688
689/**
690 * G_FILE_ATTRIBUTE_DOS_REPARSE_POINT_TAG:
691 *
692 * A key in the "dos" namespace for getting the file NTFS reparse tag.
693 * This value is 0 for files that are not reparse points.
694 * See the [Reparse Tags](https://msdn.microsoft.com/en-us/library/dd541667.aspx)
695 * page for possible reparse tag values. Corresponding #GFileAttributeType
696 * is %G_FILE_ATTRIBUTE_TYPE_UINT32.
697 *
698 * Since: 2.60
699 **/
700#define G_FILE_ATTRIBUTE_DOS_REPARSE_POINT_TAG "dos::reparse-point-tag" /* uint32 */
701
702/* Owner attributes */
703
704/**
705 * G_FILE_ATTRIBUTE_OWNER_USER:
706 *
707 * A key in the "owner" namespace for getting the user name of the
708 * file's owner. Corresponding #GFileAttributeType is
709 * %G_FILE_ATTRIBUTE_TYPE_STRING.
710 **/
711#define G_FILE_ATTRIBUTE_OWNER_USER "owner::user" /* string */
712
713/**
714 * G_FILE_ATTRIBUTE_OWNER_USER_REAL:
715 *
716 * A key in the "owner" namespace for getting the real name of the
717 * user that owns the file. Corresponding #GFileAttributeType is
718 * %G_FILE_ATTRIBUTE_TYPE_STRING.
719 **/
720#define G_FILE_ATTRIBUTE_OWNER_USER_REAL "owner::user-real" /* string */
721
722/**
723 * G_FILE_ATTRIBUTE_OWNER_GROUP:
724 *
725 * A key in the "owner" namespace for getting the file owner's group.
726 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
727 **/
728#define G_FILE_ATTRIBUTE_OWNER_GROUP "owner::group" /* string */
729
730/* Thumbnails */
731
732/**
733 * G_FILE_ATTRIBUTE_THUMBNAIL_PATH:
734 *
735 * A key in the "thumbnail" namespace for getting the path to the thumbnail
736 * image. Corresponding #GFileAttributeType is
737 * %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
738 **/
739#define G_FILE_ATTRIBUTE_THUMBNAIL_PATH "thumbnail::path" /* bytestring */
740/**
741 * G_FILE_ATTRIBUTE_THUMBNAILING_FAILED:
742 *
743 * A key in the "thumbnail" namespace for checking if thumbnailing failed.
744 * This attribute is %TRUE if thumbnailing failed. Corresponding
745 * #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
746 **/
747#define G_FILE_ATTRIBUTE_THUMBNAILING_FAILED "thumbnail::failed" /* boolean */
748/**
749 * G_FILE_ATTRIBUTE_THUMBNAIL_IS_VALID:
750 *
751 * A key in the "thumbnail" namespace for checking whether the thumbnail is outdated.
752 * This attribute is %TRUE if the thumbnail is up-to-date with the file it represents,
753 * and %FALSE if the file has been modified since the thumbnail was generated.
754 *
755 * If %G_FILE_ATTRIBUTE_THUMBNAILING_FAILED is %TRUE and this attribute is %FALSE,
756 * it indicates that thumbnailing may be attempted again and may succeed.
757 *
758 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
759 *
760 * Since: 2.40
761 */
762#define G_FILE_ATTRIBUTE_THUMBNAIL_IS_VALID "thumbnail::is-valid" /* boolean */
763
764/* Preview */
765
766/**
767 * G_FILE_ATTRIBUTE_PREVIEW_ICON:
768 *
769 * A key in the "preview" namespace for getting a #GIcon that can be
770 * used to get preview of the file. For example, it may be a low
771 * resolution thumbnail without metadata. Corresponding
772 * #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT. The value
773 * for this key should contain a #GIcon.
774 *
775 * Since: 2.20
776 **/
777#define G_FILE_ATTRIBUTE_PREVIEW_ICON "preview::icon" /* object (GIcon) */
778
779/* File system info (for g_file_get_filesystem_info) */
780
781/**
782 * G_FILE_ATTRIBUTE_FILESYSTEM_SIZE:
783 *
784 * A key in the "filesystem" namespace for getting the total size (in bytes) of the file system,
785 * used in g_file_query_filesystem_info(). Corresponding #GFileAttributeType
786 * is %G_FILE_ATTRIBUTE_TYPE_UINT64.
787 **/
788#define G_FILE_ATTRIBUTE_FILESYSTEM_SIZE "filesystem::size" /* uint64 */
789
790/**
791 * G_FILE_ATTRIBUTE_FILESYSTEM_FREE:
792 *
793 * A key in the "filesystem" namespace for getting the number of bytes of free space left on the
794 * file system. Corresponding #GFileAttributeType is
795 * %G_FILE_ATTRIBUTE_TYPE_UINT64.
796 **/
797#define G_FILE_ATTRIBUTE_FILESYSTEM_FREE "filesystem::free" /* uint64 */
798
799/**
800 * G_FILE_ATTRIBUTE_FILESYSTEM_USED:
801 *
802 * A key in the "filesystem" namespace for getting the number of bytes of used on the
803 * file system. Corresponding #GFileAttributeType is
804 * %G_FILE_ATTRIBUTE_TYPE_UINT64.
805 *
806 * Since: 2.32
807 */
808#define G_FILE_ATTRIBUTE_FILESYSTEM_USED "filesystem::used" /* uint64 */
809
810/**
811 * G_FILE_ATTRIBUTE_FILESYSTEM_TYPE:
812 *
813 * A key in the "filesystem" namespace for getting the file system's type.
814 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
815 **/
816#define G_FILE_ATTRIBUTE_FILESYSTEM_TYPE "filesystem::type" /* string */
817
818/**
819 * G_FILE_ATTRIBUTE_FILESYSTEM_READONLY:
820 *
821 * A key in the "filesystem" namespace for checking if the file system
822 * is read only. Is set to %TRUE if the file system is read only.
823 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
824 **/
825#define G_FILE_ATTRIBUTE_FILESYSTEM_READONLY "filesystem::readonly" /* boolean */
826
827/**
828 * G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW:
829 *
830 * A key in the "filesystem" namespace for hinting a file manager
831 * application whether it should preview (e.g. thumbnail) files on the
832 * file system. The value for this key contain a
833 * #GFilesystemPreviewType.
834 **/
835#define G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW "filesystem::use-preview" /* uint32 (GFilesystemPreviewType) */
836
837/**
838 * G_FILE_ATTRIBUTE_FILESYSTEM_REMOTE:
839 *
840 * A key in the "filesystem" namespace for checking if the file system
841 * is remote. Is set to %TRUE if the file system is remote.
842 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
843 **/
844#define G_FILE_ATTRIBUTE_FILESYSTEM_REMOTE "filesystem::remote" /* boolean */
845
846/**
847 * G_FILE_ATTRIBUTE_GVFS_BACKEND:
848 *
849 * A key in the "gvfs" namespace that gets the name of the current
850 * GVFS backend in use. Corresponding #GFileAttributeType is
851 * %G_FILE_ATTRIBUTE_TYPE_STRING.
852 **/
853#define G_FILE_ATTRIBUTE_GVFS_BACKEND "gvfs::backend" /* string */
854
855/**
856 * G_FILE_ATTRIBUTE_SELINUX_CONTEXT:
857 *
858 * A key in the "selinux" namespace for getting the file's SELinux
859 * context. Corresponding #GFileAttributeType is
860 * %G_FILE_ATTRIBUTE_TYPE_STRING. Note that this attribute is only
861 * available if GLib has been built with SELinux support.
862 **/
863#define G_FILE_ATTRIBUTE_SELINUX_CONTEXT "selinux::context" /* string */
864
865/**
866 * G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT:
867 *
868 * A key in the "trash" namespace. When requested against
869 * `trash:///` returns the number of (toplevel) items in the trash folder.
870 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
871 **/
872#define G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT "trash::item-count" /* uint32 */
873
874/**
875 * G_FILE_ATTRIBUTE_TRASH_ORIG_PATH:
876 *
877 * A key in the "trash" namespace. When requested against
878 * items in `trash:///`, will return the original path to the file before it
879 * was trashed. Corresponding #GFileAttributeType is
880 * %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
881 *
882 * Since: 2.24
883 **/
884#define G_FILE_ATTRIBUTE_TRASH_ORIG_PATH "trash::orig-path" /* byte string */
885
886/**
887 * G_FILE_ATTRIBUTE_TRASH_DELETION_DATE:
888 *
889 * A key in the "trash" namespace. When requested against
890 * items in `trash:///`, will return the date and time when the file
891 * was trashed. The format of the returned string is YYYY-MM-DDThh:mm:ss.
892 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
893 *
894 * Since: 2.24
895 **/
896#define G_FILE_ATTRIBUTE_TRASH_DELETION_DATE "trash::deletion-date" /* string */
897
898/**
899 * G_FILE_ATTRIBUTE_RECENT_MODIFIED:
900 *
901 * A key in the "recent" namespace for getting time, when the metadata for the
902 * file in `recent:///` was last changed. Corresponding #GFileAttributeType is
903 * %G_FILE_ATTRIBUTE_TYPE_INT64.
904 *
905 * Since: 2.52
906 **/
907#define G_FILE_ATTRIBUTE_RECENT_MODIFIED "recent::modified" /* int64 (time_t) */
908
909GLIB_AVAILABLE_IN_ALL
910GType g_file_info_get_type (void) G_GNUC_CONST;
911
912GLIB_AVAILABLE_IN_ALL
913GFileInfo * g_file_info_new (void);
914GLIB_AVAILABLE_IN_ALL
915GFileInfo * g_file_info_dup (GFileInfo *other);
916GLIB_AVAILABLE_IN_ALL
917void g_file_info_copy_into (GFileInfo *src_info,
918 GFileInfo *dest_info);
919GLIB_AVAILABLE_IN_ALL
920gboolean g_file_info_has_attribute (GFileInfo *info,
921 const char *attribute);
922GLIB_AVAILABLE_IN_ALL
923gboolean g_file_info_has_namespace (GFileInfo *info,
924 const char *name_space);
925GLIB_AVAILABLE_IN_ALL
926char ** g_file_info_list_attributes (GFileInfo *info,
927 const char *name_space);
928GLIB_AVAILABLE_IN_ALL
929gboolean g_file_info_get_attribute_data (GFileInfo *info,
930 const char *attribute,
931 GFileAttributeType *type,
932 gpointer *value_pp,
933 GFileAttributeStatus *status);
934GLIB_AVAILABLE_IN_ALL
935GFileAttributeType g_file_info_get_attribute_type (GFileInfo *info,
936 const char *attribute);
937GLIB_AVAILABLE_IN_ALL
938void g_file_info_remove_attribute (GFileInfo *info,
939 const char *attribute);
940GLIB_AVAILABLE_IN_ALL
941GFileAttributeStatus g_file_info_get_attribute_status (GFileInfo *info,
942 const char *attribute);
943GLIB_AVAILABLE_IN_ALL
944gboolean g_file_info_set_attribute_status (GFileInfo *info,
945 const char *attribute,
946 GFileAttributeStatus status);
947GLIB_AVAILABLE_IN_ALL
948char * g_file_info_get_attribute_as_string (GFileInfo *info,
949 const char *attribute);
950GLIB_AVAILABLE_IN_ALL
951const char * g_file_info_get_attribute_string (GFileInfo *info,
952 const char *attribute);
953GLIB_AVAILABLE_IN_ALL
954const char * g_file_info_get_attribute_byte_string (GFileInfo *info,
955 const char *attribute);
956GLIB_AVAILABLE_IN_ALL
957gboolean g_file_info_get_attribute_boolean (GFileInfo *info,
958 const char *attribute);
959GLIB_AVAILABLE_IN_ALL
960guint32 g_file_info_get_attribute_uint32 (GFileInfo *info,
961 const char *attribute);
962GLIB_AVAILABLE_IN_ALL
963gint32 g_file_info_get_attribute_int32 (GFileInfo *info,
964 const char *attribute);
965GLIB_AVAILABLE_IN_ALL
966guint64 g_file_info_get_attribute_uint64 (GFileInfo *info,
967 const char *attribute);
968GLIB_AVAILABLE_IN_ALL
969gint64 g_file_info_get_attribute_int64 (GFileInfo *info,
970 const char *attribute);
971GLIB_AVAILABLE_IN_ALL
972GObject * g_file_info_get_attribute_object (GFileInfo *info,
973 const char *attribute);
974GLIB_AVAILABLE_IN_ALL
975char ** g_file_info_get_attribute_stringv (GFileInfo *info,
976 const char *attribute);
977
978GLIB_AVAILABLE_IN_ALL
979void g_file_info_set_attribute (GFileInfo *info,
980 const char *attribute,
981 GFileAttributeType type,
982 gpointer value_p);
983GLIB_AVAILABLE_IN_ALL
984void g_file_info_set_attribute_string (GFileInfo *info,
985 const char *attribute,
986 const char *attr_value);
987GLIB_AVAILABLE_IN_ALL
988void g_file_info_set_attribute_byte_string (GFileInfo *info,
989 const char *attribute,
990 const char *attr_value);
991GLIB_AVAILABLE_IN_ALL
992void g_file_info_set_attribute_boolean (GFileInfo *info,
993 const char *attribute,
994 gboolean attr_value);
995GLIB_AVAILABLE_IN_ALL
996void g_file_info_set_attribute_uint32 (GFileInfo *info,
997 const char *attribute,
998 guint32 attr_value);
999GLIB_AVAILABLE_IN_ALL
1000void g_file_info_set_attribute_int32 (GFileInfo *info,
1001 const char *attribute,
1002 gint32 attr_value);
1003GLIB_AVAILABLE_IN_ALL
1004void g_file_info_set_attribute_uint64 (GFileInfo *info,
1005 const char *attribute,
1006 guint64 attr_value);
1007GLIB_AVAILABLE_IN_ALL
1008void g_file_info_set_attribute_int64 (GFileInfo *info,
1009 const char *attribute,
1010 gint64 attr_value);
1011GLIB_AVAILABLE_IN_ALL
1012void g_file_info_set_attribute_object (GFileInfo *info,
1013 const char *attribute,
1014 GObject *attr_value);
1015GLIB_AVAILABLE_IN_ALL
1016void g_file_info_set_attribute_stringv (GFileInfo *info,
1017 const char *attribute,
1018 char **attr_value);
1019
1020GLIB_AVAILABLE_IN_ALL
1021void g_file_info_clear_status (GFileInfo *info);
1022
1023/* Helper getters: */
1024GLIB_AVAILABLE_IN_2_36
1025GDateTime * g_file_info_get_deletion_date (GFileInfo *info);
1026GLIB_AVAILABLE_IN_ALL
1027GFileType g_file_info_get_file_type (GFileInfo *info);
1028GLIB_AVAILABLE_IN_ALL
1029gboolean g_file_info_get_is_hidden (GFileInfo *info);
1030GLIB_AVAILABLE_IN_ALL
1031gboolean g_file_info_get_is_backup (GFileInfo *info);
1032GLIB_AVAILABLE_IN_ALL
1033gboolean g_file_info_get_is_symlink (GFileInfo *info);
1034GLIB_AVAILABLE_IN_ALL
1035const char * g_file_info_get_name (GFileInfo *info);
1036GLIB_AVAILABLE_IN_ALL
1037const char * g_file_info_get_display_name (GFileInfo *info);
1038GLIB_AVAILABLE_IN_ALL
1039const char * g_file_info_get_edit_name (GFileInfo *info);
1040GLIB_AVAILABLE_IN_ALL
1041GIcon * g_file_info_get_icon (GFileInfo *info);
1042GLIB_AVAILABLE_IN_ALL
1043GIcon * g_file_info_get_symbolic_icon (GFileInfo *info);
1044GLIB_AVAILABLE_IN_ALL
1045const char * g_file_info_get_content_type (GFileInfo *info);
1046GLIB_AVAILABLE_IN_ALL
1047goffset g_file_info_get_size (GFileInfo *info);
1048GLIB_AVAILABLE_IN_ALL
1049void g_file_info_get_modification_time (GFileInfo *info,
1050 GTimeVal *result);
1051GLIB_AVAILABLE_IN_ALL
1052const char * g_file_info_get_symlink_target (GFileInfo *info);
1053GLIB_AVAILABLE_IN_ALL
1054const char * g_file_info_get_etag (GFileInfo *info);
1055GLIB_AVAILABLE_IN_ALL
1056gint32 g_file_info_get_sort_order (GFileInfo *info);
1057
1058GLIB_AVAILABLE_IN_ALL
1059void g_file_info_set_attribute_mask (GFileInfo *info,
1060 GFileAttributeMatcher *mask);
1061GLIB_AVAILABLE_IN_ALL
1062void g_file_info_unset_attribute_mask (GFileInfo *info);
1063
1064/* Helper setters: */
1065GLIB_AVAILABLE_IN_ALL
1066void g_file_info_set_file_type (GFileInfo *info,
1067 GFileType type);
1068GLIB_AVAILABLE_IN_ALL
1069void g_file_info_set_is_hidden (GFileInfo *info,
1070 gboolean is_hidden);
1071GLIB_AVAILABLE_IN_ALL
1072void g_file_info_set_is_symlink (GFileInfo *info,
1073 gboolean is_symlink);
1074GLIB_AVAILABLE_IN_ALL
1075void g_file_info_set_name (GFileInfo *info,
1076 const char *name);
1077GLIB_AVAILABLE_IN_ALL
1078void g_file_info_set_display_name (GFileInfo *info,
1079 const char *display_name);
1080GLIB_AVAILABLE_IN_ALL
1081void g_file_info_set_edit_name (GFileInfo *info,
1082 const char *edit_name);
1083GLIB_AVAILABLE_IN_ALL
1084void g_file_info_set_icon (GFileInfo *info,
1085 GIcon *icon);
1086GLIB_AVAILABLE_IN_ALL
1087void g_file_info_set_symbolic_icon (GFileInfo *info,
1088 GIcon *icon);
1089GLIB_AVAILABLE_IN_ALL
1090void g_file_info_set_content_type (GFileInfo *info,
1091 const char *content_type);
1092GLIB_AVAILABLE_IN_ALL
1093void g_file_info_set_size (GFileInfo *info,
1094 goffset size);
1095GLIB_AVAILABLE_IN_ALL
1096void g_file_info_set_modification_time (GFileInfo *info,
1097 GTimeVal *mtime);
1098GLIB_AVAILABLE_IN_ALL
1099void g_file_info_set_symlink_target (GFileInfo *info,
1100 const char *symlink_target);
1101GLIB_AVAILABLE_IN_ALL
1102void g_file_info_set_sort_order (GFileInfo *info,
1103 gint32 sort_order);
1104
1105#define G_TYPE_FILE_ATTRIBUTE_MATCHER (g_file_attribute_matcher_get_type ())
1106GLIB_AVAILABLE_IN_ALL
1107GType g_file_attribute_matcher_get_type (void) G_GNUC_CONST;
1108
1109GLIB_AVAILABLE_IN_ALL
1110GFileAttributeMatcher *g_file_attribute_matcher_new (const char *attributes);
1111GLIB_AVAILABLE_IN_ALL
1112GFileAttributeMatcher *g_file_attribute_matcher_ref (GFileAttributeMatcher *matcher);
1113GLIB_AVAILABLE_IN_ALL
1114void g_file_attribute_matcher_unref (GFileAttributeMatcher *matcher);
1115GLIB_AVAILABLE_IN_ALL
1116GFileAttributeMatcher *g_file_attribute_matcher_subtract (GFileAttributeMatcher *matcher,
1117 GFileAttributeMatcher *subtract);
1118GLIB_AVAILABLE_IN_ALL
1119gboolean g_file_attribute_matcher_matches (GFileAttributeMatcher *matcher,
1120 const char *attribute);
1121GLIB_AVAILABLE_IN_ALL
1122gboolean g_file_attribute_matcher_matches_only (GFileAttributeMatcher *matcher,
1123 const char *attribute);
1124GLIB_AVAILABLE_IN_ALL
1125gboolean g_file_attribute_matcher_enumerate_namespace (GFileAttributeMatcher *matcher,
1126 const char *ns);
1127GLIB_AVAILABLE_IN_ALL
1128const char * g_file_attribute_matcher_enumerate_next (GFileAttributeMatcher *matcher);
1129GLIB_AVAILABLE_IN_2_32
1130char * g_file_attribute_matcher_to_string (GFileAttributeMatcher *matcher);
1131
1132G_END_DECLS
1133
1134#endif /* __G_FILE_INFO_H__ */
1135