* Author: Alexander Larsson <alexl@redhat.com>
*/
+#if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
+#error "Only <gio/gio.h> can be included directly."
+#endif
+
#ifndef __G_FILE_INFO_H__
#define __G_FILE_INFO_H__
#include <glib-object.h>
+#include <glib/gfileutils.h>
#include <gio/gfileattribute.h>
#include <gio/gicon.h>
* @G_FILE_TYPE_UNKNOWN: File's type is unknown.
* @G_FILE_TYPE_REGULAR: File handle represents a regular file.
* @G_FILE_TYPE_DIRECTORY: File handle represents a directory.
- * @G_FILE_TYPE_SYMBOLIC_LINK: File handle represents a symbolic link (Unix systems)
- * @G_FILE_TYPE_SPECIAL: File is a "special" file, such as a socket, fifo, blockdev, or chardev.
- * @G_FILE_TYPE_SHORTCUT: File is a shortcut (Windows systems)
+ * @G_FILE_TYPE_SYMBOLIC_LINK: File handle represents a symbolic link
+ * (Unix systems).
+ * @G_FILE_TYPE_SPECIAL: File is a "special" file, such as a socket, fifo,
+ * block device, or character device.
+ * @G_FILE_TYPE_SHORTCUT: File is a shortcut (Windows systems).
* @G_FILE_TYPE_MOUNTABLE: File is a mountable location.
*
* Indicates the file's on-disk type.
G_FILE_TYPE_MOUNTABLE
} GFileType;
+/**
+ * GFilesystemPreviewType:
+ * @G_FILESYSTEM_PREVIEW_TYPE_IF_ALWAYS: Only preview files if user has explicitly requested it.
+ * @G_FILESYSTEM_PREVIEW_TYPE_IF_LOCAL: Preview files if user has requested preview of "local" files.
+ * @G_FILESYSTEM_PREVIEW_TYPE_NEVER: Never preview files.
+ *
+ * Indicates a hint from the file system whether files should be
+ * previewed in a file manager. Returned as the value of the key
+ * #G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW.
+ **/
+typedef enum {
+ G_FILESYSTEM_PREVIEW_TYPE_IF_ALWAYS = 0,
+ G_FILESYSTEM_PREVIEW_TYPE_IF_LOCAL,
+ G_FILESYSTEM_PREVIEW_TYPE_NEVER
+} GFilesystemPreviewType;
+
/* Common Attributes: */
/**
- * G_FILE_ATTRIBUTE_STD_TYPE:
+ * G_FILE_ATTRIBUTE_STANDARD_TYPE:
*
- * A key in the "std" namespace for storing file types.
+ * A key in the "standard" namespace for storing file types.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
* The value for this key should contain a #GFileType.
**/
-#define G_FILE_ATTRIBUTE_STD_TYPE "std:type" /* uint32 (GFileType) */
+#define G_FILE_ATTRIBUTE_STANDARD_TYPE "standard::type" /* uint32 (GFileType) */
/**
- * G_FILE_ATTRIBUTE_STD_IS_HIDDEN:
+ * G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN:
*
- * A key in the "std" namespace for checking if a file is hidden.
+ * A key in the "standard" namespace for checking if a file is hidden.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/
-#define G_FILE_ATTRIBUTE_STD_IS_HIDDEN "std:is_hidden" /* boolean */
+#define G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN "standard::is-hidden" /* boolean */
/**
- * G_FILE_ATTRIBUTE_STD_IS_BACKUP:
+ * G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP:
*
- * A key in the "std" namespace for checking if a file is a backup file.
+ * A key in the "standard" namespace for checking if a file is a backup file.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/
-#define G_FILE_ATTRIBUTE_STD_IS_BACKUP "std:is_backup" /* boolean */
+#define G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP "standard::is-backup" /* boolean */
/**
- * G_FILE_ATTRIBUTE_STD_IS_SYMLINK:
+ * G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK:
*
- * A key in the "std" namespace for checking if the file is a symlink.
+ * A key in the "standard" namespace for checking if the file is a symlink.
+ * Typically the actual type is something else, if we followed the symlink
+ * to get the type.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/
-#define G_FILE_ATTRIBUTE_STD_IS_SYMLINK "std:is_symlink" /* boolean */
+#define G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK "standard::is-symlink" /* boolean */
/**
- * G_FILE_ATTRIBUTE_STD_IS_VIRTUAL:
+ * G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL:
*
- * A key in the "std" namespace for checking if a file is virtual.
+ * A key in the "standard" namespace for checking if a file is virtual.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/
-#define G_FILE_ATTRIBUTE_STD_IS_VIRTUAL "std:is_virtual" /* boolean */
+#define G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL "standard::is-virtual" /* boolean */
/**
- * G_FILE_ATTRIBUTE_STD_NAME:
+ * G_FILE_ATTRIBUTE_STANDARD_NAME:
*
- * A key in the "std" namespace for getting the name of the file.
+ * A key in the "standard" namespace for getting the name of the file.
+ * The name is the on-disk filename which may not be in any known encoding,
+ * and can thus not be generally displayed as is.
+ * Use #G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME if you need to display the
+ * name in a user interface.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
**/
-#define G_FILE_ATTRIBUTE_STD_NAME "std:name" /* byte string */
+#define G_FILE_ATTRIBUTE_STANDARD_NAME "standard::name" /* byte string */
/**
- * G_FILE_ATTRIBUTE_STD_DISPLAY_NAME:
+ * G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME:
*
- * A key in the "std" namespace for getting the display name of the file.
+ * A key in the "standard" namespace for getting the display name of the file.
+ * A display name is guaranteed to be in UTF8 and can thus be displayed in
+ * the UI.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
**/
-#define G_FILE_ATTRIBUTE_STD_DISPLAY_NAME "std:display_name" /* string */
+#define G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME "standard::display-name" /* string */
/**
- * G_FILE_ATTRIBUTE_STD_EDIT_NAME:
+ * G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME:
+ *
+ * A key in the "standard" namespace for edit name of the file.
+ * An edit name is similar to the display name, but it is meant to be
+ * used when you want to rename the file in the UI. The display name
+ * might contain information you don't want in the new filename (such as
+ * "(invalid unicode)" if the filename was in an invalid encoding).
*
- * A key in the "std" namespace for edit name of the file.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
**/
-#define G_FILE_ATTRIBUTE_STD_EDIT_NAME "std:edit_name" /* string */
+#define G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME "standard::edit-name" /* string */
/**
- * G_FILE_ATTRIBUTE_STD_COPY_NAME:
+ * G_FILE_ATTRIBUTE_STANDARD_COPY_NAME:
+ *
+ * A key in the "standard" namespace for getting the copy name of the file.
+ * The copy name is an optional version of the name. If availible its always
+ * in UTF8, and corresponds directly to the original filename (only transcoded to
+ * UTF8). This is useful if you want to copy the file to another filesystem that
+ * might have a different encoding. If the filename is not a valid string in the
+ * encoding selected for the filesystem it is in then the copy name will not be set.
*
- * A key in the "std" namespace for getting the copy name of the file.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
**/
-#define G_FILE_ATTRIBUTE_STD_COPY_NAME "std:copy_name" /* string */
+#define G_FILE_ATTRIBUTE_STANDARD_COPY_NAME "standard::copy-name" /* string */
/**
- * G_FILE_ATTRIBUTE_STD_ICON:
+ * G_FILE_ATTRIBUTE_STANDARD_DESCRIPTION:
*
- * A key in the "std" namespace for getting the icon for the file.
+ * A key in the "standard" namespace for getting the description of the file.
+ * The description is a utf8 string that describes the file, generally containing
+ * the filename, but can also contain furter information. Example descriptions
+ * could be "filename (on hostname)" for a remote file or "filename (in trash)"
+ * for a file in the trash. This is useful for instance as the window title
+ * when displaying a directory or for a bookmarks menu.
+ *
+ * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
+ **/
+#define G_FILE_ATTRIBUTE_STANDARD_DESCRIPTION "standard::description" /* string */
+
+/**
+ * G_FILE_ATTRIBUTE_STANDARD_ICON:
+ *
+ * A key in the "standard" namespace for getting the icon for the file.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT.
* The value for this key should contain a #GIcon.
**/
-#define G_FILE_ATTRIBUTE_STD_ICON "std:icon" /* object (GIcon) */
+#define G_FILE_ATTRIBUTE_STANDARD_ICON "standard::icon" /* object (GIcon) */
/**
- * G_FILE_ATTRIBUTE_STD_CONTENT_TYPE:
+ * G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE:
*
- * A key in the "std" namespace for getting the content type of the file.
+ * A key in the "standard" namespace for getting the content type of the file.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
* The value for this key should contain a valid content type.
**/
-#define G_FILE_ATTRIBUTE_STD_CONTENT_TYPE "std:content_type" /* string */
+#define G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE "standard::content-type" /* string */
/**
- * G_FILE_ATTRIBUTE_STD_FAST_CONTENT_TYPE:
+ * G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE:
*
- * A key in the "std" namespace for getting the fast content type.
+ * A key in the "standard" namespace for getting the fast content type.
+ * The fast content type isn't as reliable as the regular one, as it
+ * only uses the filename to guess it, but it is faster to calculate than the
+ * regular content type.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
*
**/
-#define G_FILE_ATTRIBUTE_STD_FAST_CONTENT_TYPE "std:fast_content_type" /* string */
+#define G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE "standard::fast-content-type" /* string */
/**
- * G_FILE_ATTRIBUTE_STD_SIZE:
+ * G_FILE_ATTRIBUTE_STANDARD_SIZE:
*
- * A key in the "std" namespace for getting the file's size.
+ * A key in the "standard" namespace for getting the file's size (in bytes).
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
**/
-#define G_FILE_ATTRIBUTE_STD_SIZE "std:size" /* uint64 */
+#define G_FILE_ATTRIBUTE_STANDARD_SIZE "standard::size" /* uint64 */
/**
- * G_FILE_ATTRIBUTE_STD_SYMLINK_TARGET:
+ * G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET:
*
- * A key in the "std" namespace for getting the symlink target, if the file
- * is a symlink. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
+ * A key in the "standard" namespace for getting the symlink target, if the file
+ * is a symlink. Corresponding #GFileAttributeType is
+ * %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
**/
-#define G_FILE_ATTRIBUTE_STD_SYMLINK_TARGET "std:symlink_target" /* byte string */
+#define G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET "standard::symlink-target" /* byte string */
/**
- * G_FILE_ATTRIBUTE_STD_TARGET_URI:
+ * G_FILE_ATTRIBUTE_STANDARD_TARGET_URI:
*
- * A key in the "std" namespace for getting the target URI for the file.
+ * A key in the "standard" namespace for getting the target URI for the file, in
+ * the case of %G_FILE_TYPE_SHORTCUT or %G_FILE_TYPE_MOUNTABLE files.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
**/
-#define G_FILE_ATTRIBUTE_STD_TARGET_URI "std:target_uri" /* string */
+#define G_FILE_ATTRIBUTE_STANDARD_TARGET_URI "standard::target-uri" /* string */
/**
- * G_FILE_ATTRIBUTE_STD_SORT_ORDER:
+ * G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER:
*
- * A key in the "std" namespace for setting the sort order of a file.
+ * A key in the "standard" namespace for setting the sort order of a file.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_INT32.
- * An example use would be in file managers, which would use this key to set
- * the order files are displayed.
+ * An example use would be in file managers, which would use this key
+ * to set the order files are displayed. Files with smaller sort order
+ * should be sorted first, and files without sort order as if sort order
+ * was zero.
**/
-#define G_FILE_ATTRIBUTE_STD_SORT_ORDER "std:sort_order" /* int32 */
+#define G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER "standard::sort-order" /* int32 */
/* Entity tags, used to avoid missing updates on save */
+
/**
* G_FILE_ATTRIBUTE_ETAG_VALUE:
*
* A key in the "etag" namespace for getting the value of the file's
- * entity tag. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
+ * entity tag. Corresponding #GFileAttributeType is
+ * %G_FILE_ATTRIBUTE_TYPE_STRING.
**/
-#define G_FILE_ATTRIBUTE_ETAG_VALUE "etag:value" /* string */
+#define G_FILE_ATTRIBUTE_ETAG_VALUE "etag::value" /* string */
+
+/* File identifier, for e.g. avoiding loops when doing recursive
+ * directory scanning
+ */
-/* File identifier, for e.g. avoiding loops when doing recursive directory scanning */
/**
* G_FILE_ATTRIBUTE_ID_FILE:
*
* An example use would be during listing files, to avoid recursive
* directory scanning.
**/
-#define G_FILE_ATTRIBUTE_ID_FILE "id:file" /* string */
+#define G_FILE_ATTRIBUTE_ID_FILE "id::file" /* string */
/**
- * G_FILE_ATTRIBUTE_ID_FS:
+ * G_FILE_ATTRIBUTE_ID_FILESYSTEM:
*
* A key in the "id" namespace for getting the file system identifier.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
- * An example use would be during listing files, to avoid recursive
- * directory scanning.
+ * An example use would be during drag and drop to see if the source
+ * and target are on the same filesystem (default to move) or not (default
+ * to copy).
**/
-#define G_FILE_ATTRIBUTE_ID_FS "id:fs" /* string */
+#define G_FILE_ATTRIBUTE_ID_FILESYSTEM "id::filesystem" /* string */
/* Calculated Access Rights for current user */
/**
* G_FILE_ATTRIBUTE_ACCESS_CAN_READ:
*
- * A key in the "access" namespace for getting read privilidges.
+ * A key in the "access" namespace for getting read privileges.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
- * This key will be true if the user is able to read the file.
+ * This attribute will be %TRUE if the user is able to read the file.
**/
-#define G_FILE_ATTRIBUTE_ACCESS_CAN_READ "access:can_read" /* boolean */
+#define G_FILE_ATTRIBUTE_ACCESS_CAN_READ "access::can-read" /* boolean */
/**
* G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE:
*
- * A key in the "access" namespace for getting write privilidges.
+ * A key in the "access" namespace for getting write privileges.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
- * This key will be true if the user is able to write to the file.
+ * This attribute will be %TRUE if the user is able to write to the file.
**/
-#define G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE "access:can_write" /* boolean */
+#define G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE "access::can-write" /* boolean */
/**
* G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE:
*
- * A key in the "access" namespace for getting execution privilidges.
+ * A key in the "access" namespace for getting execution privileges.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
- * This key will be true if the user is able to execute the file.
+ * This attribute will be %TRUE if the user is able to execute the file.
**/
-#define G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE "access:can_execute" /* boolean */
+#define G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE "access::can-execute" /* boolean */
/**
* G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE:
*
- * A key in the "access" namespace for checking deletion privilidges.
+ * A key in the "access" namespace for checking deletion privileges.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
- * This key will be true if the user is able to delete the file.
+ * This attribute will be %TRUE if the user is able to delete the file.
**/
-#define G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE "access:can_delete" /* boolean */
+#define G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE "access::can-delete" /* boolean */
/**
* G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH:
*
- * A key in the "access" namespace for checking trashing privilidges.
+ * A key in the "access" namespace for checking trashing privileges.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
- * This key will be true if the user is able to send the file to the
- * virtual file system trash location.
+ * This attribute will be %TRUE if the user is able to move the file to
+ * the trash.
**/
-#define G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH "access:can_trash" /* boolean */
+#define G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH "access::can-trash" /* boolean */
/**
* G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME:
*
- * A key in the "access" namespace for checking renaming privilidges.
+ * A key in the "access" namespace for checking renaming privileges.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
- * This key will be true if the user is able to rename the file.
+ * This attribute will be %TRUE if the user is able to rename the file.
**/
-#define G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME "access:can_rename" /* boolean */
+#define G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME "access::can-rename" /* boolean */
+
/* TODO: Should we have special version for directories? can_enumerate, etc */
/* Mountable attributes */
+
/**
* G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT:
*
- * A key in the "mountable" namespace for checking if a file is mountable.
+ * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is mountable.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/
-#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT "mountable:can_mount" /* boolean */
+#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT "mountable::can-mount" /* boolean */
/**
* G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT:
*
- * A key in the "mountable" namespace for checking if a file is unmountable.
+ * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is unmountable.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/
-#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT "mountable:can_unmount" /* boolean */
+#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT "mountable::can-unmount" /* boolean */
/**
* G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT:
*
- * A key in the "mountable" namespace for checking if a file can be ejected.
+ * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be ejected.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/
-#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT "mountable:can_eject" /* boolean */
+#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT "mountable::can-eject" /* boolean */
/**
* G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE:
* A key in the "mountable" namespace for getting the unix device.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/
-#define G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE "mountable:unix_device" /* uint32 */
+#define G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE "mountable::unix-device" /* uint32 */
/**
* G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI:
*
- * A key in the "mountable" namespace for getting the HAL UDI for the mounted
+ * A key in the "mountable" namespace for getting the HAL UDI for the mountable
* file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
**/
-#define G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI "mountable:hal_udi" /* string */
+#define G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI "mountable::hal-udi" /* string */
/* Time attributes */
- /* The last time the file content or an attribute was modified */
/**
* G_FILE_ATTRIBUTE_TIME_MODIFIED:
*
* A key in the "time" namespace for getting the time the file was last
- * modified. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
- * and contains the UNIX time since the file was modified.
+ * modified. Corresponding #GFileAttributeType is
+ * %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the UNIX time since the
+ * file was modified.
**/
-#define G_FILE_ATTRIBUTE_TIME_MODIFIED "time:modified" /* uint64 */
+#define G_FILE_ATTRIBUTE_TIME_MODIFIED "time::modified" /* uint64 */
/**
* G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC:
* #G_FILE_ATTRIBUTE_TIME_MODIFIED. Corresponding #GFileAttributeType is
* %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/
-#define G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC "time:modified_usec" /* uint32 */
- /* The last time the file was read */
+#define G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC "time::modified-usec" /* uint32 */
+
/**
* G_FILE_ATTRIBUTE_TIME_ACCESS:
*
* A key in the "time" namespace for getting the time the file was last
- * accessed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
- * and contains the UNIX time since the file was last accessed.
+ * accessed. Corresponding #GFileAttributeType is
+ * %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the UNIX time since the
+ * file was last accessed.
**/
-#define G_FILE_ATTRIBUTE_TIME_ACCESS "time:access" /* uint64 */
+#define G_FILE_ATTRIBUTE_TIME_ACCESS "time::access" /* uint64 */
+
/**
* G_FILE_ATTRIBUTE_TIME_ACCESS_USEC:
*
* #G_FILE_ATTRIBUTE_TIME_ACCESS. Corresponding #GFileAttributeType is
* %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/
-#define G_FILE_ATTRIBUTE_TIME_ACCESS_USEC "time:access_usec" /* uint32 */
- /* The last time a file attribute was changed (e.g. unix ctime) */
+#define G_FILE_ATTRIBUTE_TIME_ACCESS_USEC "time::access-usec" /* uint32 */
+
/**
* G_FILE_ATTRIBUTE_TIME_CHANGED:
*
* A key in the "time" namespace for getting the time the file was last
* changed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
* and contains the UNIX time since the file was last changed.
+ *
+ * This corresponds to the traditional UNIX ctime.
**/
-#define G_FILE_ATTRIBUTE_TIME_CHANGED "time:changed" /* uint64 */
+#define G_FILE_ATTRIBUTE_TIME_CHANGED "time::changed" /* uint64 */
+
/**
* G_FILE_ATTRIBUTE_TIME_CHANGED_USEC:
*
* #G_FILE_ATTRIBUTE_TIME_CHANGED. Corresponding #GFileAttributeType is
* %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/
-#define G_FILE_ATTRIBUTE_TIME_CHANGED_USEC "time:changed_usec" /* uint32 */
- /* When the file was originally created (e.g. ntfs ctime) */
+#define G_FILE_ATTRIBUTE_TIME_CHANGED_USEC "time::changed-usec" /* uint32 */
+
/**
* G_FILE_ATTRIBUTE_TIME_CREATED:
*
* A key in the "time" namespace for getting the time the file was created.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
* and contains the UNIX time since the file was created.
+ *
+ * This corresponds to the NTFS ctime.
**/
-#define G_FILE_ATTRIBUTE_TIME_CREATED "time:created" /* uint64 */
+#define G_FILE_ATTRIBUTE_TIME_CREATED "time::created" /* uint64 */
/**
* G_FILE_ATTRIBUTE_TIME_CREATED_USEC:
* #G_FILE_ATTRIBUTE_TIME_CREATED. Corresponding #GFileAttributeType is
* %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/
-#define G_FILE_ATTRIBUTE_TIME_CREATED_USEC "time:created_usec" /* uint32 */
+#define G_FILE_ATTRIBUTE_TIME_CREATED_USEC "time::created-usec" /* uint32 */
/* Unix specific attributes */
+
/**
* G_FILE_ATTRIBUTE_UNIX_DEVICE:
*
* A key in the "unix" namespace for getting the device id of the device the
- * file is located on (see man stat(2)). This attribute is only available
- * for UNIX file systems. Corresponding #GFileAttributeType is
+ * file is located on (see stat() documentation). This attribute is only
+ * available for UNIX file systems. Corresponding #GFileAttributeType is
* %G_FILE_ATTRIBUTE_TYPE_UINT32.
- *
**/
-#define G_FILE_ATTRIBUTE_UNIX_DEVICE "unix:device" /* uint32 */
+#define G_FILE_ATTRIBUTE_UNIX_DEVICE "unix::device" /* uint32 */
+
/**
* G_FILE_ATTRIBUTE_UNIX_INODE:
*
* This attribute is only available for UNIX file systems. Corresponding
* #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
**/
-#define G_FILE_ATTRIBUTE_UNIX_INODE "unix:inode" /* uint64 */
+#define G_FILE_ATTRIBUTE_UNIX_INODE "unix::inode" /* uint64 */
+
/**
* G_FILE_ATTRIBUTE_UNIX_MODE:
*
- * A key in the "unix" namespace for getting the mode of the file (e.g. whether the file
- * is a regular file, symlink, etc). See man lstat(2). This attribute is only available
- * for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
+ * A key in the "unix" namespace for getting the mode of the file
+ * (e.g. whether the file is a regular file, symlink, etc). See lstat()
+ * documentation. This attribute is only available for UNIX file systems.
+ * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/
-#define G_FILE_ATTRIBUTE_UNIX_MODE "unix:mode" /* uint32 */
+#define G_FILE_ATTRIBUTE_UNIX_MODE "unix::mode" /* uint32 */
/**
* G_FILE_ATTRIBUTE_UNIX_NLINK:
*
- * A key in the "unix" namespace for getting the number of hard links for a
- * file. See man lstat(2). This attribute is only available for UNIX file systems.
- * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
- *
+ * A key in the "unix" namespace for getting the number of hard links
+ * for a file. See lstat() documentation. This attribute is only available
+ * for UNIX file systems. Corresponding #GFileAttributeType is
+ * %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/
-#define G_FILE_ATTRIBUTE_UNIX_NLINK "unix:nlink" /* uint32 */
+#define G_FILE_ATTRIBUTE_UNIX_NLINK "unix::nlink" /* uint32 */
+
/**
* G_FILE_ATTRIBUTE_UNIX_UID:
*
* This attribute is only available for UNIX file systems.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/
-#define G_FILE_ATTRIBUTE_UNIX_UID "unix:uid" /* uint32 */
+#define G_FILE_ATTRIBUTE_UNIX_UID "unix::uid" /* uint32 */
+
/**
* G_FILE_ATTRIBUTE_UNIX_GID:
*
* This attribute is only available for UNIX file systems.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/
-#define G_FILE_ATTRIBUTE_UNIX_GID "unix:gid" /* uint32 */
+#define G_FILE_ATTRIBUTE_UNIX_GID "unix::gid" /* uint32 */
+
/**
* G_FILE_ATTRIBUTE_UNIX_RDEV:
*
- * A key in the "unix" namespace for getting the device ID for the file (if it
- * is a special file). See man lstat(2). This attribute is only available for
- * UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
+ * A key in the "unix" namespace for getting the device ID for the file
+ * (if it is a special file). See lstat() documentation. This attribute
+ * is only available for UNIX file systems. Corresponding #GFileAttributeType
+ * is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/
-#define G_FILE_ATTRIBUTE_UNIX_RDEV "unix:rdev" /* uint32 */
+#define G_FILE_ATTRIBUTE_UNIX_RDEV "unix::rdev" /* uint32 */
+
/**
* G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE:
*
- * A key in the "unix" namespace for getting the block size for the file system.
- * This attribute is only available for UNIX file systems.
+ * A key in the "unix" namespace for getting the block size for the file
+ * system. This attribute is only available for UNIX file systems.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/
-#define G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE "unix:block_size" /* uint32 */
+#define G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE "unix::block-size" /* uint32 */
+
/**
* G_FILE_ATTRIBUTE_UNIX_BLOCKS:
*
- * A key in the "unix" namespace for getting the number of blocks allocated for the file.
- * This attribute is only available for UNIX file systems.
+ * A key in the "unix" namespace for getting the number of blocks allocated
+ * for the file. This attribute is only available for UNIX file systems.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
**/
-#define G_FILE_ATTRIBUTE_UNIX_BLOCKS "unix:blocks" /* uint64 */
+#define G_FILE_ATTRIBUTE_UNIX_BLOCKS "unix::blocks" /* uint64 */
/**
* G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT:
*
- * A key in the "unix" namespace for checking if the file represents a unix mount point.
- * Returns %TRUE if the file is a unix mount point. This attribute is only available for
- * UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
+ * A key in the "unix" namespace for checking if the file represents a
+ * UNIX mount point. This attribute is %TRUE if the file is a UNIX mount
+ * point. This attribute is only available for UNIX file systems.
+ * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/
-#define G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT "unix:is_mountpoint" /* boolean */
+#define G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT "unix::is-mountpoint" /* boolean */
/* DOS specific attributes */
+
/**
* G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE:
*
- * A key in the "dos" namespace for checking if the file's archive flag is set.
- * Returns %TRUE if the archive flag is set. This attribute is only available for
- * DOS file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
+ * A key in the "dos" namespace for checking if the file's archive flag
+ * is set. This attribute is %TRUE if the archive flag is set. This attribute
+ * is only available for DOS file systems. Corresponding #GFileAttributeType
+ * is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/
-#define G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE "dos:is_archive" /* boolean */
+#define G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE "dos::is-archive" /* boolean */
/**
* G_FILE_ATTRIBUTE_DOS_IS_SYSTEM:
*
- * A key in the "dos" namespace for checking if the file's backup flag is set.
- * Returns %TRUE if the backup flag is set. This attribute is only available for
- * DOS file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
+ * A key in the "dos" namespace for checking if the file's backup flag
+ * is set. This attribute is %TRUE if the backup flag is set. This attribute
+ * is only available for DOS file systems. Corresponding #GFileAttributeType
+ * is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/
-#define G_FILE_ATTRIBUTE_DOS_IS_SYSTEM "dos:is_system" /* boolean */
+#define G_FILE_ATTRIBUTE_DOS_IS_SYSTEM "dos::is-system" /* boolean */
/* Owner attributes */
+
/**
* G_FILE_ATTRIBUTE_OWNER_USER:
*
- * A key in the "owner" namespace for getting the user name of the file's owner.
- * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
+ * A key in the "owner" namespace for getting the user name of the
+ * file's owner. Corresponding #GFileAttributeType is
+ * %G_FILE_ATTRIBUTE_TYPE_STRING.
**/
-#define G_FILE_ATTRIBUTE_OWNER_USER "owner:user" /* string */
+#define G_FILE_ATTRIBUTE_OWNER_USER "owner::user" /* string */
/**
* G_FILE_ATTRIBUTE_OWNER_USER_REAL:
*
- * A key in the "owner" namespace for getting the real name of the user that owns the file.
- * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
+ * A key in the "owner" namespace for getting the real name of the
+ * user that owns the file. Corresponding #GFileAttributeType is
+ * %G_FILE_ATTRIBUTE_TYPE_STRING.
**/
-#define G_FILE_ATTRIBUTE_OWNER_USER_REAL "owner:user_real" /* string */
+#define G_FILE_ATTRIBUTE_OWNER_USER_REAL "owner::user-real" /* string */
/**
* G_FILE_ATTRIBUTE_OWNER_GROUP:
* A key in the "owner" namespace for getting the file owner's group.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
**/
-#define G_FILE_ATTRIBUTE_OWNER_GROUP "owner:group" /* string */
+#define G_FILE_ATTRIBUTE_OWNER_GROUP "owner::group" /* string */
/* Thumbnails */
/**
* G_FILE_ATTRIBUTE_THUMBNAIL_PATH:
*
- * A key in the "thumbnail" namespace for getting the path to the thumbnail image.
- * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
+ * A key in the "thumbnail" namespace for getting the path to the thumbnail
+ * image. Corresponding #GFileAttributeType is
+ * %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
**/
-#define G_FILE_ATTRIBUTE_THUMBNAIL_PATH "thumbnail:path" /* bytestring */
+#define G_FILE_ATTRIBUTE_THUMBNAIL_PATH "thumbnail::path" /* bytestring */
/**
- * G_FILE_ATTRIBUTE_THUMBNAIL_THUMNAILING_FAILED:
+ * G_FILE_ATTRIBUTE_THUMBNAILING_FAILED:
*
* A key in the "thumbnail" namespace for checking if thumbnailing failed.
- * Is set to %TRUE if thumbnailing failed. Corresponding #GFileAttributeType
- * is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
+ * This attribute is %TRUE if thumbnailing failed. Corresponding
+ * #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/
-#define G_FILE_ATTRIBUTE_THUMBNAILING_FAILED "thumbnail:failed" /* boolean */
+#define G_FILE_ATTRIBUTE_THUMBNAILING_FAILED "thumbnail::failed" /* boolean */
/* File system info (for g_file_get_filesystem_info) */
/**
- * G_FILE_ATTRIBUTE_FS_SIZE:
+ * G_FILE_ATTRIBUTE_FILESYSTEM_SIZE:
*
- * A key in the "fs" namespace for getting the size of the file system, used in
- * g_file_get_filesystem_info(). Corresponding #GFileAttributeType is
- * %G_FILE_ATTRIBUTE_TYPE_UINT64.
+ * A key in the "filesystem" namespace for getting the total size (in bytes) of the file system,
+ * used in g_file_query_filesystem_info(). Corresponding #GFileAttributeType
+ * is %G_FILE_ATTRIBUTE_TYPE_UINT64.
**/
-#define G_FILE_ATTRIBUTE_FS_SIZE "fs:size" /* uint64 */
+#define G_FILE_ATTRIBUTE_FILESYSTEM_SIZE "filesystem::size" /* uint64 */
/**
- * G_FILE_ATTRIBUTE_FS_FREE:
+ * G_FILE_ATTRIBUTE_FILESYSTEM_FREE:
*
- * A key in the "fs" namespace for getting the free space left on the file system.
- * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
+ * A key in the "filesystem" namespace for getting the number of bytes of free space left on the
+ * file system. Corresponding #GFileAttributeType is
+ * %G_FILE_ATTRIBUTE_TYPE_UINT64.
**/
-#define G_FILE_ATTRIBUTE_FS_FREE "fs:free" /* uint64 */
+#define G_FILE_ATTRIBUTE_FILESYSTEM_FREE "filesystem::free" /* uint64 */
/**
- * G_FILE_ATTRIBUTE_FS_TYPE:
+ * G_FILE_ATTRIBUTE_FILESYSTEM_TYPE:
*
- * A key in the "fs" namespace for getting the file system's type.
+ * A key in the "filesystem" namespace for getting the file system's type.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
**/
-#define G_FILE_ATTRIBUTE_FS_TYPE "fs:type" /* string */
+#define G_FILE_ATTRIBUTE_FILESYSTEM_TYPE "filesystem::type" /* string */
/**
- * G_FILE_ATTRIBUTE_FS_READONLY:
- *
- * A key in the "fs" namespace for checking if the file system is read only.
- * Is set to %TRUE if the file system is read only. Corresponding #GFileAttributeType is
- * %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
+ * G_FILE_ATTRIBUTE_FILESYSTEM_READONLY:
+ *
+ * A key in the "filesystem" namespace for checking if the file system
+ * is read only. Is set to %TRUE if the file system is read only.
+ * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/
-#define G_FILE_ATTRIBUTE_FS_READONLY "fs:readonly" /* boolean */
+#define G_FILE_ATTRIBUTE_FILESYSTEM_READONLY "filesystem::readonly" /* boolean */
+
+/**
+ * G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW:
+ *
+ * A key in the "filesystem" namespace for hinting a file manager
+ * application whether it should preview (e.g. thumbnail) files on the
+ * file system. The value for this key contain a
+ * #GFilesystemPreviewType.
+ **/
+#define G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW "filesystem::use-preview" /* uint32 (GFilesystemPreviewType) */
/**
* G_FILE_ATTRIBUTE_GVFS_BACKEND:
*
* A key in the "gvfs" namespace that gets the name of the current
- * GVFS backend in use. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
+ * GVFS backend in use. Corresponding #GFileAttributeType is
+ * %G_FILE_ATTRIBUTE_TYPE_STRING.
+ **/
+#define G_FILE_ATTRIBUTE_GVFS_BACKEND "gvfs::backend" /* string */
+
+/**
+ * G_FILE_ATTRIBUTE_SELINUX_CONTEXT:
+ *
+ * A key in the "selinux" namespace for getting the file's SELinux
+ * context. Corresponding #GFileAttributeType is
+ * %G_FILE_ATTRIBUTE_TYPE_STRING. Note that this attribute is only
+ * available if GLib has been built with SELinux support.
**/
-#define G_FILE_ATTRIBUTE_GVFS_BACKEND "gvfs:backend" /* string */
+#define G_FILE_ATTRIBUTE_SELINUX_CONTEXT "selinux::context" /* string */
+
+/**
+ * G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT:
+ *
+ * A key in the "trash" namespace. When requested against 'trash:///'
+ * returns the number of (toplevel) items in the trash folder.
+ * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
+ **/
+#define G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT "trash::item-count" /* uint32 */
GType g_file_info_get_type (void) G_GNUC_CONST;
const char *attribute);
char ** g_file_info_list_attributes (GFileInfo *info,
const char *name_space);
+gboolean g_file_info_get_attribute_data (GFileInfo *info,
+ const char *attribute,
+ GFileAttributeType *type,
+ gpointer *value_pp,
+ GFileAttributeStatus *status);
GFileAttributeType g_file_info_get_attribute_type (GFileInfo *info,
const char *attribute);
void g_file_info_remove_attribute (GFileInfo *info,
const char *attribute);
-GFileAttributeValue * g_file_info_get_attribute (GFileInfo *info,
+GFileAttributeStatus g_file_info_get_attribute_status (GFileInfo *info,
+ const char *attribute);
+char * g_file_info_get_attribute_as_string (GFileInfo *info,
const char *attribute);
const char * g_file_info_get_attribute_string (GFileInfo *info,
const char *attribute);
void g_file_info_set_attribute (GFileInfo *info,
const char *attribute,
- const GFileAttributeValue *attr_value);
+ GFileAttributeType type,
+ gpointer value_p);
void g_file_info_set_attribute_string (GFileInfo *info,
const char *attribute,
const char *attr_value);
void g_file_info_set_sort_order (GFileInfo *info,
gint32 sort_order);
-/* Helper functions for attributes: */
-/* TODO: Move this to glib when merging */
-char *g_format_file_size_for_display (goffset size);
-
GFileAttributeMatcher *g_file_attribute_matcher_new (const char *attributes);
GFileAttributeMatcher *g_file_attribute_matcher_ref (GFileAttributeMatcher *matcher);
void g_file_attribute_matcher_unref (GFileAttributeMatcher *matcher);