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

source code of gtk/subprojects/glib/gio/gfileinfo.h