1 /* GIO - GLib Input, Output and Streaming Library
3 * Copyright (C) 2006-2007 Red Hat, Inc.
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General
16 * Public License along with this library; if not, write to the
17 * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
18 * Boston, MA 02111-1307, USA.
20 * Author: Alexander Larsson <alexl@redhat.com>
23 #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
24 #error "Only <gio/gio.h> can be included directly."
27 #ifndef __G_FILE_INFO_H__
28 #define __G_FILE_INFO_H__
30 #include <gio/giotypes.h>
34 #define G_TYPE_FILE_INFO (g_file_info_get_type ())
35 #define G_FILE_INFO(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_FILE_INFO, GFileInfo))
36 #define G_FILE_INFO_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_FILE_INFO, GFileInfoClass))
37 #define G_IS_FILE_INFO(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_FILE_INFO))
38 #define G_IS_FILE_INFO_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_FILE_INFO))
39 #define G_FILE_INFO_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_FILE_INFO, GFileInfoClass))
44 * Stores information about a file system object referenced by a #GFile.
46 typedef struct _GFileInfoClass GFileInfoClass;
49 /* Common Attributes: */
51 * G_FILE_ATTRIBUTE_STANDARD_TYPE:
53 * A key in the "standard" namespace for storing file types.
54 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
55 * The value for this key should contain a #GFileType.
57 #define G_FILE_ATTRIBUTE_STANDARD_TYPE "standard::type" /* uint32 (GFileType) */
60 * G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN:
62 * A key in the "standard" namespace for checking if a file is hidden.
63 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
65 #define G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN "standard::is-hidden" /* boolean */
68 * G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP:
70 * A key in the "standard" namespace for checking if a file is a backup file.
71 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
73 #define G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP "standard::is-backup" /* boolean */
76 * G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK:
78 * A key in the "standard" namespace for checking if the file is a symlink.
79 * Typically the actual type is something else, if we followed the symlink
81 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
83 #define G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK "standard::is-symlink" /* boolean */
86 * G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL:
88 * A key in the "standard" namespace for checking if a file is virtual.
89 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
91 #define G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL "standard::is-virtual" /* boolean */
94 * G_FILE_ATTRIBUTE_STANDARD_NAME:
96 * A key in the "standard" namespace for getting the name of the file.
97 * The name is the on-disk filename which may not be in any known encoding,
98 * and can thus not be generally displayed as is.
99 * Use #G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME if you need to display the
100 * name in a user interface.
101 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
103 #define G_FILE_ATTRIBUTE_STANDARD_NAME "standard::name" /* byte string */
106 * G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME:
108 * A key in the "standard" namespace for getting the display name of the file.
109 * A display name is guaranteed to be in UTF8 and can thus be displayed in
111 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
113 #define G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME "standard::display-name" /* string */
116 * G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME:
118 * A key in the "standard" namespace for edit name of the file.
119 * An edit name is similar to the display name, but it is meant to be
120 * used when you want to rename the file in the UI. The display name
121 * might contain information you don't want in the new filename (such as
122 * "(invalid unicode)" if the filename was in an invalid encoding).
124 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
126 #define G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME "standard::edit-name" /* string */
129 * G_FILE_ATTRIBUTE_STANDARD_COPY_NAME:
131 * A key in the "standard" namespace for getting the copy name of the file.
132 * The copy name is an optional version of the name. If availible its always
133 * in UTF8, and corresponds directly to the original filename (only transcoded to
134 * UTF8). This is useful if you want to copy the file to another filesystem that
135 * might have a different encoding. If the filename is not a valid string in the
136 * encoding selected for the filesystem it is in then the copy name will not be set.
138 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
140 #define G_FILE_ATTRIBUTE_STANDARD_COPY_NAME "standard::copy-name" /* string */
143 * G_FILE_ATTRIBUTE_STANDARD_DESCRIPTION:
145 * A key in the "standard" namespace for getting the description of the file.
146 * The description is a utf8 string that describes the file, generally containing
147 * the filename, but can also contain furter information. Example descriptions
148 * could be "filename (on hostname)" for a remote file or "filename (in trash)"
149 * for a file in the trash. This is useful for instance as the window title
150 * when displaying a directory or for a bookmarks menu.
152 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
154 #define G_FILE_ATTRIBUTE_STANDARD_DESCRIPTION "standard::description" /* string */
157 * G_FILE_ATTRIBUTE_STANDARD_ICON:
159 * A key in the "standard" namespace for getting the icon for the file.
160 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT.
161 * The value for this key should contain a #GIcon.
163 #define G_FILE_ATTRIBUTE_STANDARD_ICON "standard::icon" /* object (GIcon) */
166 * G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE:
168 * A key in the "standard" namespace for getting the content type of the file.
169 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
170 * The value for this key should contain a valid content type.
172 #define G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE "standard::content-type" /* string */
175 * G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE:
177 * A key in the "standard" namespace for getting the fast content type.
178 * The fast content type isn't as reliable as the regular one, as it
179 * only uses the filename to guess it, but it is faster to calculate than the
180 * regular content type.
181 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
184 #define G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE "standard::fast-content-type" /* string */
187 * G_FILE_ATTRIBUTE_STANDARD_SIZE:
189 * A key in the "standard" namespace for getting the file's size (in bytes).
190 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
192 #define G_FILE_ATTRIBUTE_STANDARD_SIZE "standard::size" /* uint64 */
195 * G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET:
197 * A key in the "standard" namespace for getting the symlink target, if the file
198 * is a symlink. Corresponding #GFileAttributeType is
199 * %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
201 #define G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET "standard::symlink-target" /* byte string */
204 * G_FILE_ATTRIBUTE_STANDARD_TARGET_URI:
206 * A key in the "standard" namespace for getting the target URI for the file, in
207 * the case of %G_FILE_TYPE_SHORTCUT or %G_FILE_TYPE_MOUNTABLE files.
208 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
210 #define G_FILE_ATTRIBUTE_STANDARD_TARGET_URI "standard::target-uri" /* string */
213 * G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER:
215 * A key in the "standard" namespace for setting the sort order of a file.
216 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_INT32.
217 * An example use would be in file managers, which would use this key
218 * to set the order files are displayed. Files with smaller sort order
219 * should be sorted first, and files without sort order as if sort order
222 #define G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER "standard::sort-order" /* int32 */
224 /* Entity tags, used to avoid missing updates on save */
227 * G_FILE_ATTRIBUTE_ETAG_VALUE:
229 * A key in the "etag" namespace for getting the value of the file's
230 * entity tag. Corresponding #GFileAttributeType is
231 * %G_FILE_ATTRIBUTE_TYPE_STRING.
233 #define G_FILE_ATTRIBUTE_ETAG_VALUE "etag::value" /* string */
235 /* File identifier, for e.g. avoiding loops when doing recursive
240 * G_FILE_ATTRIBUTE_ID_FILE:
242 * A key in the "id" namespace for getting a file identifier.
243 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
244 * An example use would be during listing files, to avoid recursive
245 * directory scanning.
247 #define G_FILE_ATTRIBUTE_ID_FILE "id::file" /* string */
250 * G_FILE_ATTRIBUTE_ID_FILESYSTEM:
252 * A key in the "id" namespace for getting the file system identifier.
253 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
254 * An example use would be during drag and drop to see if the source
255 * and target are on the same filesystem (default to move) or not (default
258 #define G_FILE_ATTRIBUTE_ID_FILESYSTEM "id::filesystem" /* string */
260 /* Calculated Access Rights for current user */
263 * G_FILE_ATTRIBUTE_ACCESS_CAN_READ:
265 * A key in the "access" namespace for getting read privileges.
266 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
267 * This attribute will be %TRUE if the user is able to read the file.
269 #define G_FILE_ATTRIBUTE_ACCESS_CAN_READ "access::can-read" /* boolean */
272 * G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE:
274 * A key in the "access" namespace for getting write privileges.
275 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
276 * This attribute will be %TRUE if the user is able to write to the file.
278 #define G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE "access::can-write" /* boolean */
281 * G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE:
283 * A key in the "access" namespace for getting execution privileges.
284 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
285 * This attribute will be %TRUE if the user is able to execute the file.
287 #define G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE "access::can-execute" /* boolean */
290 * G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE:
292 * A key in the "access" namespace for checking deletion privileges.
293 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
294 * This attribute will be %TRUE if the user is able to delete the file.
296 #define G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE "access::can-delete" /* boolean */
299 * G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH:
301 * A key in the "access" namespace for checking trashing privileges.
302 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
303 * This attribute will be %TRUE if the user is able to move the file to
306 #define G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH "access::can-trash" /* boolean */
309 * G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME:
311 * A key in the "access" namespace for checking renaming privileges.
312 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
313 * This attribute will be %TRUE if the user is able to rename the file.
315 #define G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME "access::can-rename" /* boolean */
317 /* TODO: Should we have special version for directories? can_enumerate, etc */
319 /* Mountable attributes */
322 * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT:
324 * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is mountable.
325 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
327 #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT "mountable::can-mount" /* boolean */
330 * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT:
332 * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is unmountable.
333 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
335 #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT "mountable::can-unmount" /* boolean */
338 * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT:
340 * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be ejected.
341 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
343 #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT "mountable::can-eject" /* boolean */
346 * G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE:
348 * A key in the "mountable" namespace for getting the unix device.
349 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
351 #define G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE "mountable::unix-device" /* uint32 */
354 * G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI:
356 * A key in the "mountable" namespace for getting the HAL UDI for the mountable
357 * file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
359 #define G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI "mountable::hal-udi" /* string */
361 /* Time attributes */
364 * G_FILE_ATTRIBUTE_TIME_MODIFIED:
366 * A key in the "time" namespace for getting the time the file was last
367 * modified. Corresponding #GFileAttributeType is
368 * %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the UNIX time since the
371 #define G_FILE_ATTRIBUTE_TIME_MODIFIED "time::modified" /* uint64 */
374 * G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC:
376 * A key in the "time" namespace for getting the miliseconds of the time
377 * the file was last modified. This should be used in conjunction with
378 * #G_FILE_ATTRIBUTE_TIME_MODIFIED. Corresponding #GFileAttributeType is
379 * %G_FILE_ATTRIBUTE_TYPE_UINT32.
381 #define G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC "time::modified-usec" /* uint32 */
384 * G_FILE_ATTRIBUTE_TIME_ACCESS:
386 * A key in the "time" namespace for getting the time the file was last
387 * accessed. Corresponding #GFileAttributeType is
388 * %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the UNIX time since the
389 * file was last accessed.
391 #define G_FILE_ATTRIBUTE_TIME_ACCESS "time::access" /* uint64 */
394 * G_FILE_ATTRIBUTE_TIME_ACCESS_USEC:
396 * A key in the "time" namespace for getting the microseconds of the time
397 * the file was last accessed. This should be used in conjunction with
398 * #G_FILE_ATTRIBUTE_TIME_ACCESS. Corresponding #GFileAttributeType is
399 * %G_FILE_ATTRIBUTE_TYPE_UINT32.
401 #define G_FILE_ATTRIBUTE_TIME_ACCESS_USEC "time::access-usec" /* uint32 */
404 * G_FILE_ATTRIBUTE_TIME_CHANGED:
406 * A key in the "time" namespace for getting the time the file was last
407 * changed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
408 * and contains the UNIX time since the file was last changed.
410 * This corresponds to the traditional UNIX ctime.
412 #define G_FILE_ATTRIBUTE_TIME_CHANGED "time::changed" /* uint64 */
415 * G_FILE_ATTRIBUTE_TIME_CHANGED_USEC:
417 * A key in the "time" namespace for getting the microseconds of the time
418 * the file was last changed. This should be used in conjunction with
419 * #G_FILE_ATTRIBUTE_TIME_CHANGED. Corresponding #GFileAttributeType is
420 * %G_FILE_ATTRIBUTE_TYPE_UINT32.
422 #define G_FILE_ATTRIBUTE_TIME_CHANGED_USEC "time::changed-usec" /* uint32 */
425 * G_FILE_ATTRIBUTE_TIME_CREATED:
427 * A key in the "time" namespace for getting the time the file was created.
428 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
429 * and contains the UNIX time since the file was created.
431 * This corresponds to the NTFS ctime.
433 #define G_FILE_ATTRIBUTE_TIME_CREATED "time::created" /* uint64 */
436 * G_FILE_ATTRIBUTE_TIME_CREATED_USEC:
438 * A key in the "time" namespace for getting the microseconds of the time
439 * the file was created. This should be used in conjunction with
440 * #G_FILE_ATTRIBUTE_TIME_CREATED. Corresponding #GFileAttributeType is
441 * %G_FILE_ATTRIBUTE_TYPE_UINT32.
443 #define G_FILE_ATTRIBUTE_TIME_CREATED_USEC "time::created-usec" /* uint32 */
445 /* Unix specific attributes */
448 * G_FILE_ATTRIBUTE_UNIX_DEVICE:
450 * A key in the "unix" namespace for getting the device id of the device the
451 * file is located on (see stat() documentation). This attribute is only
452 * available for UNIX file systems. Corresponding #GFileAttributeType is
453 * %G_FILE_ATTRIBUTE_TYPE_UINT32.
455 #define G_FILE_ATTRIBUTE_UNIX_DEVICE "unix::device" /* uint32 */
458 * G_FILE_ATTRIBUTE_UNIX_INODE:
460 * A key in the "unix" namespace for getting the inode of the file.
461 * This attribute is only available for UNIX file systems. Corresponding
462 * #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
464 #define G_FILE_ATTRIBUTE_UNIX_INODE "unix::inode" /* uint64 */
467 * G_FILE_ATTRIBUTE_UNIX_MODE:
469 * A key in the "unix" namespace for getting the mode of the file
470 * (e.g. whether the file is a regular file, symlink, etc). See lstat()
471 * documentation. This attribute is only available for UNIX file systems.
472 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
474 #define G_FILE_ATTRIBUTE_UNIX_MODE "unix::mode" /* uint32 */
477 * G_FILE_ATTRIBUTE_UNIX_NLINK:
479 * A key in the "unix" namespace for getting the number of hard links
480 * for a file. See lstat() documentation. This attribute is only available
481 * for UNIX file systems. Corresponding #GFileAttributeType is
482 * %G_FILE_ATTRIBUTE_TYPE_UINT32.
484 #define G_FILE_ATTRIBUTE_UNIX_NLINK "unix::nlink" /* uint32 */
487 * G_FILE_ATTRIBUTE_UNIX_UID:
489 * A key in the "unix" namespace for getting the user ID for the file.
490 * This attribute is only available for UNIX file systems.
491 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
493 #define G_FILE_ATTRIBUTE_UNIX_UID "unix::uid" /* uint32 */
496 * G_FILE_ATTRIBUTE_UNIX_GID:
498 * A key in the "unix" namespace for getting the group ID for the file.
499 * This attribute is only available for UNIX file systems.
500 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
502 #define G_FILE_ATTRIBUTE_UNIX_GID "unix::gid" /* uint32 */
505 * G_FILE_ATTRIBUTE_UNIX_RDEV:
507 * A key in the "unix" namespace for getting the device ID for the file
508 * (if it is a special file). See lstat() documentation. This attribute
509 * is only available for UNIX file systems. Corresponding #GFileAttributeType
510 * is %G_FILE_ATTRIBUTE_TYPE_UINT32.
512 #define G_FILE_ATTRIBUTE_UNIX_RDEV "unix::rdev" /* uint32 */
515 * G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE:
517 * A key in the "unix" namespace for getting the block size for the file
518 * system. This attribute is only available for UNIX file systems.
519 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
521 #define G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE "unix::block-size" /* uint32 */
524 * G_FILE_ATTRIBUTE_UNIX_BLOCKS:
526 * A key in the "unix" namespace for getting the number of blocks allocated
527 * for the file. This attribute is only available for UNIX file systems.
528 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
530 #define G_FILE_ATTRIBUTE_UNIX_BLOCKS "unix::blocks" /* uint64 */
533 * G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT:
535 * A key in the "unix" namespace for checking if the file represents a
536 * UNIX mount point. This attribute is %TRUE if the file is a UNIX mount
537 * point. This attribute is only available for UNIX file systems.
538 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
540 #define G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT "unix::is-mountpoint" /* boolean */
542 /* DOS specific attributes */
545 * G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE:
547 * A key in the "dos" namespace for checking if the file's archive flag
548 * is set. This attribute is %TRUE if the archive flag is set. This attribute
549 * is only available for DOS file systems. Corresponding #GFileAttributeType
550 * is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
552 #define G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE "dos::is-archive" /* boolean */
555 * G_FILE_ATTRIBUTE_DOS_IS_SYSTEM:
557 * A key in the "dos" namespace for checking if the file's backup flag
558 * is set. This attribute is %TRUE if the backup flag is set. This attribute
559 * is only available for DOS file systems. Corresponding #GFileAttributeType
560 * is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
562 #define G_FILE_ATTRIBUTE_DOS_IS_SYSTEM "dos::is-system" /* boolean */
564 /* Owner attributes */
567 * G_FILE_ATTRIBUTE_OWNER_USER:
569 * A key in the "owner" namespace for getting the user name of the
570 * file's owner. Corresponding #GFileAttributeType is
571 * %G_FILE_ATTRIBUTE_TYPE_STRING.
573 #define G_FILE_ATTRIBUTE_OWNER_USER "owner::user" /* string */
576 * G_FILE_ATTRIBUTE_OWNER_USER_REAL:
578 * A key in the "owner" namespace for getting the real name of the
579 * user that owns the file. Corresponding #GFileAttributeType is
580 * %G_FILE_ATTRIBUTE_TYPE_STRING.
582 #define G_FILE_ATTRIBUTE_OWNER_USER_REAL "owner::user-real" /* string */
585 * G_FILE_ATTRIBUTE_OWNER_GROUP:
587 * A key in the "owner" namespace for getting the file owner's group.
588 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
590 #define G_FILE_ATTRIBUTE_OWNER_GROUP "owner::group" /* string */
595 * G_FILE_ATTRIBUTE_THUMBNAIL_PATH:
597 * A key in the "thumbnail" namespace for getting the path to the thumbnail
598 * image. Corresponding #GFileAttributeType is
599 * %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
601 #define G_FILE_ATTRIBUTE_THUMBNAIL_PATH "thumbnail::path" /* bytestring */
603 * G_FILE_ATTRIBUTE_THUMBNAILING_FAILED:
605 * A key in the "thumbnail" namespace for checking if thumbnailing failed.
606 * This attribute is %TRUE if thumbnailing failed. Corresponding
607 * #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
609 #define G_FILE_ATTRIBUTE_THUMBNAILING_FAILED "thumbnail::failed" /* boolean */
614 * G_FILE_ATTRIBUTE_PREVIEW_ICON:
616 * A key in the "preview" namespace for getting a #GIcon that can be
617 * used to get preview of the file. For example, it may be a low
618 * resolution thumbnail without metadata. Corresponding
619 * #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT. The value
620 * for this key should contain a #GIcon.
624 #define G_FILE_ATTRIBUTE_PREVIEW_ICON "preview::icon" /* object (GIcon) */
626 /* File system info (for g_file_get_filesystem_info) */
629 * G_FILE_ATTRIBUTE_FILESYSTEM_SIZE:
631 * A key in the "filesystem" namespace for getting the total size (in bytes) of the file system,
632 * used in g_file_query_filesystem_info(). Corresponding #GFileAttributeType
633 * is %G_FILE_ATTRIBUTE_TYPE_UINT64.
635 #define G_FILE_ATTRIBUTE_FILESYSTEM_SIZE "filesystem::size" /* uint64 */
638 * G_FILE_ATTRIBUTE_FILESYSTEM_FREE:
640 * A key in the "filesystem" namespace for getting the number of bytes of free space left on the
641 * file system. Corresponding #GFileAttributeType is
642 * %G_FILE_ATTRIBUTE_TYPE_UINT64.
644 #define G_FILE_ATTRIBUTE_FILESYSTEM_FREE "filesystem::free" /* uint64 */
647 * G_FILE_ATTRIBUTE_FILESYSTEM_TYPE:
649 * A key in the "filesystem" namespace for getting the file system's type.
650 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
652 #define G_FILE_ATTRIBUTE_FILESYSTEM_TYPE "filesystem::type" /* string */
655 * G_FILE_ATTRIBUTE_FILESYSTEM_READONLY:
657 * A key in the "filesystem" namespace for checking if the file system
658 * is read only. Is set to %TRUE if the file system is read only.
659 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
661 #define G_FILE_ATTRIBUTE_FILESYSTEM_READONLY "filesystem::readonly" /* boolean */
664 * G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW:
666 * A key in the "filesystem" namespace for hinting a file manager
667 * application whether it should preview (e.g. thumbnail) files on the
668 * file system. The value for this key contain a
669 * #GFilesystemPreviewType.
671 #define G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW "filesystem::use-preview" /* uint32 (GFilesystemPreviewType) */
674 * G_FILE_ATTRIBUTE_GVFS_BACKEND:
676 * A key in the "gvfs" namespace that gets the name of the current
677 * GVFS backend in use. Corresponding #GFileAttributeType is
678 * %G_FILE_ATTRIBUTE_TYPE_STRING.
680 #define G_FILE_ATTRIBUTE_GVFS_BACKEND "gvfs::backend" /* string */
683 * G_FILE_ATTRIBUTE_SELINUX_CONTEXT:
685 * A key in the "selinux" namespace for getting the file's SELinux
686 * context. Corresponding #GFileAttributeType is
687 * %G_FILE_ATTRIBUTE_TYPE_STRING. Note that this attribute is only
688 * available if GLib has been built with SELinux support.
690 #define G_FILE_ATTRIBUTE_SELINUX_CONTEXT "selinux::context" /* string */
693 * G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT:
695 * A key in the "trash" namespace. When requested against
696 * "trash:///" returns the number of (toplevel) items in the trash folder.
697 * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
699 #define G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT "trash::item-count" /* uint32 */
701 GType g_file_info_get_type (void) G_GNUC_CONST;
703 GFileInfo * g_file_info_new (void);
704 GFileInfo * g_file_info_dup (GFileInfo *other);
705 void g_file_info_copy_into (GFileInfo *src_info,
706 GFileInfo *dest_info);
707 gboolean g_file_info_has_attribute (GFileInfo *info,
708 const char *attribute);
709 char ** g_file_info_list_attributes (GFileInfo *info,
710 const char *name_space);
711 gboolean g_file_info_get_attribute_data (GFileInfo *info,
712 const char *attribute,
713 GFileAttributeType *type,
715 GFileAttributeStatus *status);
716 GFileAttributeType g_file_info_get_attribute_type (GFileInfo *info,
717 const char *attribute);
718 void g_file_info_remove_attribute (GFileInfo *info,
719 const char *attribute);
720 GFileAttributeStatus g_file_info_get_attribute_status (GFileInfo *info,
721 const char *attribute);
722 char * g_file_info_get_attribute_as_string (GFileInfo *info,
723 const char *attribute);
724 const char * g_file_info_get_attribute_string (GFileInfo *info,
725 const char *attribute);
726 const char * g_file_info_get_attribute_byte_string (GFileInfo *info,
727 const char *attribute);
728 gboolean g_file_info_get_attribute_boolean (GFileInfo *info,
729 const char *attribute);
730 guint32 g_file_info_get_attribute_uint32 (GFileInfo *info,
731 const char *attribute);
732 gint32 g_file_info_get_attribute_int32 (GFileInfo *info,
733 const char *attribute);
734 guint64 g_file_info_get_attribute_uint64 (GFileInfo *info,
735 const char *attribute);
736 gint64 g_file_info_get_attribute_int64 (GFileInfo *info,
737 const char *attribute);
738 GObject * g_file_info_get_attribute_object (GFileInfo *info,
739 const char *attribute);
741 void g_file_info_set_attribute (GFileInfo *info,
742 const char *attribute,
743 GFileAttributeType type,
745 void g_file_info_set_attribute_string (GFileInfo *info,
746 const char *attribute,
747 const char *attr_value);
748 void g_file_info_set_attribute_byte_string (GFileInfo *info,
749 const char *attribute,
750 const char *attr_value);
751 void g_file_info_set_attribute_boolean (GFileInfo *info,
752 const char *attribute,
753 gboolean attr_value);
754 void g_file_info_set_attribute_uint32 (GFileInfo *info,
755 const char *attribute,
757 void g_file_info_set_attribute_int32 (GFileInfo *info,
758 const char *attribute,
760 void g_file_info_set_attribute_uint64 (GFileInfo *info,
761 const char *attribute,
763 void g_file_info_set_attribute_int64 (GFileInfo *info,
764 const char *attribute,
766 void g_file_info_set_attribute_object (GFileInfo *info,
767 const char *attribute,
768 GObject *attr_value);
770 void g_file_info_clear_status (GFileInfo *info);
772 /* Helper getters: */
773 GFileType g_file_info_get_file_type (GFileInfo *info);
774 gboolean g_file_info_get_is_hidden (GFileInfo *info);
775 gboolean g_file_info_get_is_backup (GFileInfo *info);
776 gboolean g_file_info_get_is_symlink (GFileInfo *info);
777 const char * g_file_info_get_name (GFileInfo *info);
778 const char * g_file_info_get_display_name (GFileInfo *info);
779 const char * g_file_info_get_edit_name (GFileInfo *info);
780 GIcon * g_file_info_get_icon (GFileInfo *info);
781 const char * g_file_info_get_content_type (GFileInfo *info);
782 goffset g_file_info_get_size (GFileInfo *info);
783 void g_file_info_get_modification_time (GFileInfo *info,
785 const char * g_file_info_get_symlink_target (GFileInfo *info);
786 const char * g_file_info_get_etag (GFileInfo *info);
787 gint32 g_file_info_get_sort_order (GFileInfo *info);
789 void g_file_info_set_attribute_mask (GFileInfo *info,
790 GFileAttributeMatcher *mask);
791 void g_file_info_unset_attribute_mask (GFileInfo *info);
793 /* Helper setters: */
794 void g_file_info_set_file_type (GFileInfo *info,
796 void g_file_info_set_is_hidden (GFileInfo *info,
798 void g_file_info_set_is_symlink (GFileInfo *info,
799 gboolean is_symlink);
800 void g_file_info_set_name (GFileInfo *info,
802 void g_file_info_set_display_name (GFileInfo *info,
803 const char *display_name);
804 void g_file_info_set_edit_name (GFileInfo *info,
805 const char *edit_name);
806 void g_file_info_set_icon (GFileInfo *info,
808 void g_file_info_set_content_type (GFileInfo *info,
809 const char *content_type);
810 void g_file_info_set_size (GFileInfo *info,
812 void g_file_info_set_modification_time (GFileInfo *info,
814 void g_file_info_set_symlink_target (GFileInfo *info,
815 const char *symlink_target);
816 void g_file_info_set_sort_order (GFileInfo *info,
819 GFileAttributeMatcher *g_file_attribute_matcher_new (const char *attributes);
820 GFileAttributeMatcher *g_file_attribute_matcher_ref (GFileAttributeMatcher *matcher);
821 void g_file_attribute_matcher_unref (GFileAttributeMatcher *matcher);
822 gboolean g_file_attribute_matcher_matches (GFileAttributeMatcher *matcher,
823 const char *attribute);
824 gboolean g_file_attribute_matcher_matches_only (GFileAttributeMatcher *matcher,
825 const char *attribute);
826 gboolean g_file_attribute_matcher_enumerate_namespace (GFileAttributeMatcher *matcher,
828 const char * g_file_attribute_matcher_enumerate_next (GFileAttributeMatcher *matcher);
832 #endif /* __G_FILE_INFO_H__ */