mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-11-14 05:16:18 +01:00
18aaf33cf1
If `statx()` is supported, query it for the file creation time and use that if returned. Incorporating some minor code rearrangement by Philip Withnall <withnall@endlessm.com>. Fixes: #1970
1149 lines
43 KiB
C
1149 lines
43 KiB
C
/* GIO - GLib Input, Output and Streaming Library
|
|
*
|
|
* Copyright (C) 2006-2007 Red Hat, Inc.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General
|
|
* Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
* Author: Alexander Larsson <alexl@redhat.com>
|
|
*/
|
|
|
|
#ifndef __G_FILE_INFO_H__
|
|
#define __G_FILE_INFO_H__
|
|
|
|
#if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
|
|
#error "Only <gio/gio.h> can be included directly."
|
|
#endif
|
|
|
|
#include <gio/giotypes.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define G_TYPE_FILE_INFO (g_file_info_get_type ())
|
|
#define G_FILE_INFO(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_FILE_INFO, GFileInfo))
|
|
#define G_FILE_INFO_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_FILE_INFO, GFileInfoClass))
|
|
#define G_IS_FILE_INFO(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_FILE_INFO))
|
|
#define G_IS_FILE_INFO_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_FILE_INFO))
|
|
#define G_FILE_INFO_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_FILE_INFO, GFileInfoClass))
|
|
|
|
/**
|
|
* GFileInfo:
|
|
*
|
|
* Stores information about a file system object referenced by a #GFile.
|
|
**/
|
|
typedef struct _GFileInfoClass GFileInfoClass;
|
|
|
|
|
|
/* Common Attributes: */
|
|
/**
|
|
* G_FILE_ATTRIBUTE_STANDARD_TYPE:
|
|
*
|
|
* 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_STANDARD_TYPE "standard::type" /* uint32 (GFileType) */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_STANDARD_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_STANDARD_IS_HIDDEN "standard::is-hidden" /* boolean */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP:
|
|
*
|
|
* 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_STANDARD_IS_BACKUP "standard::is-backup" /* boolean */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_STANDARD_IS_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.
|
|
* On Windows NTFS mountpoints are considered to be symlinks as well.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK "standard::is-symlink" /* boolean */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_STANDARD_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_STANDARD_IS_VIRTUAL "standard::is-virtual" /* boolean */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_STANDARD_IS_VOLATILE:
|
|
*
|
|
* A key in the "standard" namespace for checking if a file is
|
|
* volatile. This is meant for opaque, non-POSIX-like backends to
|
|
* indicate that the URI is not persistent. Applications should look
|
|
* at #G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET for the persistent URI.
|
|
*
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
*
|
|
* Since: 2.46
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_STANDARD_IS_VOLATILE "standard::is-volatile" /* boolean */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_STANDARD_NAME:
|
|
*
|
|
* 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. It is guaranteed to be set on
|
|
* every file.
|
|
* 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_STANDARD_NAME "standard::name" /* byte string */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME:
|
|
*
|
|
* A key in the "standard" namespace for getting the display name of the file.
|
|
* A display name is guaranteed to be in UTF-8 and can thus be displayed in
|
|
* the UI. It is guaranteed to be set on every file.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME "standard::display-name" /* string */
|
|
|
|
/**
|
|
* 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).
|
|
*
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME "standard::edit-name" /* string */
|
|
|
|
/**
|
|
* 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 available it's 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.
|
|
*
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_STANDARD_COPY_NAME "standard::copy-name" /* string */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_STANDARD_DESCRIPTION:
|
|
*
|
|
* 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 further 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_STANDARD_ICON "standard::icon" /* object (GIcon) */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON:
|
|
*
|
|
* A key in the "standard" namespace for getting the symbolic icon for the file.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT.
|
|
* The value for this key should contain a #GIcon.
|
|
*
|
|
* Since: 2.34
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON "standard::symbolic-icon" /* object (GIcon) */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE:
|
|
*
|
|
* 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_STANDARD_CONTENT_TYPE "standard::content-type" /* string */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_STANDARD_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_STANDARD_FAST_CONTENT_TYPE "standard::fast-content-type" /* string */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_STANDARD_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_STANDARD_SIZE "standard::size" /* uint64 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE:
|
|
*
|
|
* A key in the "standard" namespace for getting the amount of disk space
|
|
* that is consumed by the file (in bytes). This will generally be larger
|
|
* than the file size (due to block size overhead) but can occasionally be
|
|
* smaller (for example, for sparse files).
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
|
|
*
|
|
* Since: 2.20
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE "standard::allocated-size" /* uint64 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET:
|
|
*
|
|
* 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_STANDARD_SYMLINK_TARGET "standard::symlink-target" /* byte string */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_STANDARD_TARGET_URI:
|
|
*
|
|
* 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_STANDARD_TARGET_URI "standard::target-uri" /* string */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER:
|
|
*
|
|
* 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. Files with smaller sort order
|
|
* should be sorted first, and files without sort order as if sort order
|
|
* was zero.
|
|
**/
|
|
#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.
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_ETAG_VALUE "etag::value" /* string */
|
|
|
|
/* File identifier, for e.g. avoiding loops when doing recursive
|
|
* directory scanning
|
|
*/
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_ID_FILE:
|
|
*
|
|
* A key in the "id" namespace for getting a file identifier.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
|
|
* An example use would be during listing files, to avoid recursive
|
|
* directory scanning.
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_ID_FILE "id::file" /* string */
|
|
|
|
/**
|
|
* 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 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_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 privileges.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
* 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 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE:
|
|
*
|
|
* A key in the "access" namespace for getting write privileges.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
* 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 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE:
|
|
*
|
|
* A key in the "access" namespace for getting execution privileges.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
* 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 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE:
|
|
*
|
|
* A key in the "access" namespace for checking deletion privileges.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
* 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 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH:
|
|
*
|
|
* A key in the "access" namespace for checking trashing privileges.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
* 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 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME:
|
|
*
|
|
* A key in the "access" namespace for checking renaming privileges.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
* 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 */
|
|
|
|
/* 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 (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 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT:
|
|
*
|
|
* 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 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT:
|
|
*
|
|
* 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 */
|
|
|
|
/**
|
|
* 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 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE:
|
|
*
|
|
* A key in the "mountable" namespace for getting the unix device file.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
|
|
*
|
|
* Since: 2.22
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE "mountable::unix-device-file" /* string */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI:
|
|
*
|
|
* 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 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START:
|
|
*
|
|
* A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
*
|
|
* Since: 2.22
|
|
*/
|
|
#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START "mountable::can-start" /* boolean */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED:
|
|
*
|
|
* A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started
|
|
* degraded.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
*
|
|
* Since: 2.22
|
|
*/
|
|
#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED "mountable::can-start-degraded" /* boolean */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP:
|
|
*
|
|
* A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be stopped.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
*
|
|
* Since: 2.22
|
|
*/
|
|
#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP "mountable::can-stop" /* boolean */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE:
|
|
*
|
|
* A key in the "mountable" namespace for getting the #GDriveStartStopType.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
|
|
*
|
|
* Since: 2.22
|
|
*/
|
|
#define G_FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE "mountable::start-stop-type" /* uint32 (GDriveStartStopType) */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL:
|
|
*
|
|
* A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be polled.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
*
|
|
* Since: 2.22
|
|
*/
|
|
#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL "mountable::can-poll" /* boolean */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC:
|
|
*
|
|
* A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE)
|
|
* is automatically polled for media.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
*
|
|
* Since: 2.22
|
|
*/
|
|
#define G_FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC "mountable::is-media-check-automatic" /* boolean */
|
|
|
|
/* Time attributes */
|
|
|
|
/**
|
|
* 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 time since the
|
|
* file was modified, in seconds since the UNIX epoch.
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_TIME_MODIFIED "time::modified" /* uint64 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC:
|
|
*
|
|
* A key in the "time" namespace for getting the microseconds of the time
|
|
* the file was last modified. This should be used in conjunction with
|
|
* #G_FILE_ATTRIBUTE_TIME_MODIFIED. Corresponding #GFileAttributeType is
|
|
* %G_FILE_ATTRIBUTE_TYPE_UINT32.
|
|
**/
|
|
#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 time since the
|
|
* file was last accessed, in seconds since the UNIX epoch.
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_TIME_ACCESS "time::access" /* uint64 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_TIME_ACCESS_USEC:
|
|
*
|
|
* A key in the "time" namespace for getting the microseconds of the time
|
|
* the file was last accessed. This should be used in conjunction with
|
|
* #G_FILE_ATTRIBUTE_TIME_ACCESS. Corresponding #GFileAttributeType is
|
|
* %G_FILE_ATTRIBUTE_TYPE_UINT32.
|
|
**/
|
|
#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 time since the file was last changed, in seconds since the
|
|
* UNIX epoch.
|
|
*
|
|
* This corresponds to the traditional UNIX ctime.
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_TIME_CHANGED "time::changed" /* uint64 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_TIME_CHANGED_USEC:
|
|
*
|
|
* A key in the "time" namespace for getting the microseconds of the time
|
|
* the file was last changed. This should be used in conjunction with
|
|
* #G_FILE_ATTRIBUTE_TIME_CHANGED. Corresponding #GFileAttributeType is
|
|
* %G_FILE_ATTRIBUTE_TYPE_UINT32.
|
|
**/
|
|
#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 time since the file was created, in seconds since the UNIX
|
|
* epoch.
|
|
*
|
|
* This may correspond to Linux stx_btime, FreeBSD st_birthtim, NetBSD
|
|
* st_birthtime or NTFS ctime.
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_TIME_CREATED "time::created" /* uint64 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_TIME_CREATED_USEC:
|
|
*
|
|
* A key in the "time" namespace for getting the microseconds of the time
|
|
* the file was created. This should be used in conjunction with
|
|
* #G_FILE_ATTRIBUTE_TIME_CREATED. Corresponding #GFileAttributeType is
|
|
* %G_FILE_ATTRIBUTE_TYPE_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 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 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_UNIX_INODE:
|
|
*
|
|
* A key in the "unix" namespace for getting the inode of the file.
|
|
* 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 */
|
|
|
|
/**
|
|
* 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 the
|
|
* documentation for `lstat()`: this attribute is equivalent to the `st_mode`
|
|
* member of `struct stat`, and includes both the file type and permissions.
|
|
* 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 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_UNIX_NLINK:
|
|
*
|
|
* 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 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_UNIX_UID:
|
|
*
|
|
* A key in the "unix" namespace for getting the user ID for the file.
|
|
* 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 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_UNIX_GID:
|
|
*
|
|
* A key in the "unix" namespace for getting the group ID for the file.
|
|
* 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 */
|
|
|
|
/**
|
|
* 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 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 */
|
|
|
|
/**
|
|
* 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.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_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.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_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. This attribute is %TRUE if the file is a UNIX mount
|
|
* point. Since 2.58, `/` is considered to be a 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 */
|
|
|
|
/* 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. 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 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_DOS_IS_SYSTEM:
|
|
*
|
|
* 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 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_DOS_IS_MOUNTPOINT:
|
|
*
|
|
* A key in the "dos" namespace for checking if the file is a NTFS mount point
|
|
* (a volume mount or a junction point).
|
|
* This attribute is %TRUE if file is a reparse point of type
|
|
* [IO_REPARSE_TAG_MOUNT_POINT](https://msdn.microsoft.com/en-us/library/dd541667.aspx).
|
|
* This attribute is only available for DOS file systems.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
*
|
|
* Since: 2.60
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_DOS_IS_MOUNTPOINT "dos::is-mountpoint" /* boolean */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_DOS_REPARSE_POINT_TAG:
|
|
*
|
|
* A key in the "dos" namespace for getting the file NTFS reparse tag.
|
|
* This value is 0 for files that are not reparse points.
|
|
* See the [Reparse Tags](https://msdn.microsoft.com/en-us/library/dd541667.aspx)
|
|
* page for possible reparse tag values. Corresponding #GFileAttributeType
|
|
* is %G_FILE_ATTRIBUTE_TYPE_UINT32.
|
|
*
|
|
* Since: 2.60
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_DOS_REPARSE_POINT_TAG "dos::reparse-point-tag" /* uint32 */
|
|
|
|
/* 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.
|
|
**/
|
|
#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.
|
|
**/
|
|
#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 */
|
|
|
|
/* 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.
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_THUMBNAIL_PATH "thumbnail::path" /* bytestring */
|
|
/**
|
|
* G_FILE_ATTRIBUTE_THUMBNAILING_FAILED:
|
|
*
|
|
* A key in the "thumbnail" namespace for checking if thumbnailing failed.
|
|
* This attribute is %TRUE if thumbnailing failed. Corresponding
|
|
* #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_THUMBNAILING_FAILED "thumbnail::failed" /* boolean */
|
|
/**
|
|
* G_FILE_ATTRIBUTE_THUMBNAIL_IS_VALID:
|
|
*
|
|
* A key in the "thumbnail" namespace for checking whether the thumbnail is outdated.
|
|
* This attribute is %TRUE if the thumbnail is up-to-date with the file it represents,
|
|
* and %FALSE if the file has been modified since the thumbnail was generated.
|
|
*
|
|
* If %G_FILE_ATTRIBUTE_THUMBNAILING_FAILED is %TRUE and this attribute is %FALSE,
|
|
* it indicates that thumbnailing may be attempted again and may succeed.
|
|
*
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
*
|
|
* Since: 2.40
|
|
*/
|
|
#define G_FILE_ATTRIBUTE_THUMBNAIL_IS_VALID "thumbnail::is-valid" /* boolean */
|
|
|
|
/* Preview */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_PREVIEW_ICON:
|
|
*
|
|
* A key in the "preview" namespace for getting a #GIcon that can be
|
|
* used to get preview of the file. For example, it may be a low
|
|
* resolution thumbnail without metadata. Corresponding
|
|
* #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT. The value
|
|
* for this key should contain a #GIcon.
|
|
*
|
|
* Since: 2.20
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_PREVIEW_ICON "preview::icon" /* object (GIcon) */
|
|
|
|
/* File system info (for g_file_get_filesystem_info) */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_FILESYSTEM_SIZE:
|
|
*
|
|
* 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_FILESYSTEM_SIZE "filesystem::size" /* uint64 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_FILESYSTEM_FREE:
|
|
*
|
|
* 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_FILESYSTEM_FREE "filesystem::free" /* uint64 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_FILESYSTEM_USED:
|
|
*
|
|
* A key in the "filesystem" namespace for getting the number of bytes of used on the
|
|
* file system. Corresponding #GFileAttributeType is
|
|
* %G_FILE_ATTRIBUTE_TYPE_UINT64.
|
|
*
|
|
* Since: 2.32
|
|
*/
|
|
#define G_FILE_ATTRIBUTE_FILESYSTEM_USED "filesystem::used" /* uint64 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_FILESYSTEM_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_FILESYSTEM_TYPE "filesystem::type" /* string */
|
|
|
|
/**
|
|
* 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_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_FILESYSTEM_REMOTE:
|
|
*
|
|
* A key in the "filesystem" namespace for checking if the file system
|
|
* is remote. Is set to %TRUE if the file system is remote.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_FILESYSTEM_REMOTE "filesystem::remote" /* boolean */
|
|
|
|
/**
|
|
* 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.
|
|
**/
|
|
#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_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 */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_TRASH_ORIG_PATH:
|
|
*
|
|
* A key in the "trash" namespace. When requested against
|
|
* items in `trash:///`, will return the original path to the file before it
|
|
* was trashed. Corresponding #GFileAttributeType is
|
|
* %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
|
|
*
|
|
* Since: 2.24
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_TRASH_ORIG_PATH "trash::orig-path" /* byte string */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_TRASH_DELETION_DATE:
|
|
*
|
|
* A key in the "trash" namespace. When requested against
|
|
* items in `trash:///`, will return the date and time when the file
|
|
* was trashed. The format of the returned string is YYYY-MM-DDThh:mm:ss.
|
|
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
|
|
*
|
|
* Since: 2.24
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_TRASH_DELETION_DATE "trash::deletion-date" /* string */
|
|
|
|
/**
|
|
* G_FILE_ATTRIBUTE_RECENT_MODIFIED:
|
|
*
|
|
* A key in the "recent" namespace for getting time, when the metadata for the
|
|
* file in `recent:///` was last changed. Corresponding #GFileAttributeType is
|
|
* %G_FILE_ATTRIBUTE_TYPE_INT64.
|
|
*
|
|
* Since: 2.52
|
|
**/
|
|
#define G_FILE_ATTRIBUTE_RECENT_MODIFIED "recent::modified" /* int64 (time_t) */
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GType g_file_info_get_type (void) G_GNUC_CONST;
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GFileInfo * g_file_info_new (void);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GFileInfo * g_file_info_dup (GFileInfo *other);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_copy_into (GFileInfo *src_info,
|
|
GFileInfo *dest_info);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_file_info_has_attribute (GFileInfo *info,
|
|
const char *attribute);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_file_info_has_namespace (GFileInfo *info,
|
|
const char *name_space);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
char ** g_file_info_list_attributes (GFileInfo *info,
|
|
const char *name_space);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_file_info_get_attribute_data (GFileInfo *info,
|
|
const char *attribute,
|
|
GFileAttributeType *type,
|
|
gpointer *value_pp,
|
|
GFileAttributeStatus *status);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GFileAttributeType g_file_info_get_attribute_type (GFileInfo *info,
|
|
const char *attribute);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_remove_attribute (GFileInfo *info,
|
|
const char *attribute);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GFileAttributeStatus g_file_info_get_attribute_status (GFileInfo *info,
|
|
const char *attribute);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_file_info_set_attribute_status (GFileInfo *info,
|
|
const char *attribute,
|
|
GFileAttributeStatus status);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
char * g_file_info_get_attribute_as_string (GFileInfo *info,
|
|
const char *attribute);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
const char * g_file_info_get_attribute_string (GFileInfo *info,
|
|
const char *attribute);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
const char * g_file_info_get_attribute_byte_string (GFileInfo *info,
|
|
const char *attribute);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_file_info_get_attribute_boolean (GFileInfo *info,
|
|
const char *attribute);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
guint32 g_file_info_get_attribute_uint32 (GFileInfo *info,
|
|
const char *attribute);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gint32 g_file_info_get_attribute_int32 (GFileInfo *info,
|
|
const char *attribute);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
guint64 g_file_info_get_attribute_uint64 (GFileInfo *info,
|
|
const char *attribute);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gint64 g_file_info_get_attribute_int64 (GFileInfo *info,
|
|
const char *attribute);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GObject * g_file_info_get_attribute_object (GFileInfo *info,
|
|
const char *attribute);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
char ** g_file_info_get_attribute_stringv (GFileInfo *info,
|
|
const char *attribute);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_attribute (GFileInfo *info,
|
|
const char *attribute,
|
|
GFileAttributeType type,
|
|
gpointer value_p);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_attribute_string (GFileInfo *info,
|
|
const char *attribute,
|
|
const char *attr_value);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_attribute_byte_string (GFileInfo *info,
|
|
const char *attribute,
|
|
const char *attr_value);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_attribute_boolean (GFileInfo *info,
|
|
const char *attribute,
|
|
gboolean attr_value);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_attribute_uint32 (GFileInfo *info,
|
|
const char *attribute,
|
|
guint32 attr_value);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_attribute_int32 (GFileInfo *info,
|
|
const char *attribute,
|
|
gint32 attr_value);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_attribute_uint64 (GFileInfo *info,
|
|
const char *attribute,
|
|
guint64 attr_value);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_attribute_int64 (GFileInfo *info,
|
|
const char *attribute,
|
|
gint64 attr_value);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_attribute_object (GFileInfo *info,
|
|
const char *attribute,
|
|
GObject *attr_value);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_attribute_stringv (GFileInfo *info,
|
|
const char *attribute,
|
|
char **attr_value);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_clear_status (GFileInfo *info);
|
|
|
|
/* Helper getters: */
|
|
GLIB_AVAILABLE_IN_2_36
|
|
GDateTime * g_file_info_get_deletion_date (GFileInfo *info);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GFileType g_file_info_get_file_type (GFileInfo *info);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_file_info_get_is_hidden (GFileInfo *info);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_file_info_get_is_backup (GFileInfo *info);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_file_info_get_is_symlink (GFileInfo *info);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
const char * g_file_info_get_name (GFileInfo *info);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
const char * g_file_info_get_display_name (GFileInfo *info);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
const char * g_file_info_get_edit_name (GFileInfo *info);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GIcon * g_file_info_get_icon (GFileInfo *info);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GIcon * g_file_info_get_symbolic_icon (GFileInfo *info);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
const char * g_file_info_get_content_type (GFileInfo *info);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
goffset g_file_info_get_size (GFileInfo *info);
|
|
G_GNUC_BEGIN_IGNORE_DEPRECATIONS
|
|
GLIB_DEPRECATED_IN_2_62_FOR(g_file_info_get_modification_date_time)
|
|
void g_file_info_get_modification_time (GFileInfo *info,
|
|
GTimeVal *result);
|
|
G_GNUC_END_IGNORE_DEPRECATIONS
|
|
GLIB_AVAILABLE_IN_2_62
|
|
GDateTime * g_file_info_get_modification_date_time (GFileInfo *info);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
const char * g_file_info_get_symlink_target (GFileInfo *info);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
const char * g_file_info_get_etag (GFileInfo *info);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gint32 g_file_info_get_sort_order (GFileInfo *info);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_attribute_mask (GFileInfo *info,
|
|
GFileAttributeMatcher *mask);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_unset_attribute_mask (GFileInfo *info);
|
|
|
|
/* Helper setters: */
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_file_type (GFileInfo *info,
|
|
GFileType type);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_is_hidden (GFileInfo *info,
|
|
gboolean is_hidden);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_is_symlink (GFileInfo *info,
|
|
gboolean is_symlink);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_name (GFileInfo *info,
|
|
const char *name);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_display_name (GFileInfo *info,
|
|
const char *display_name);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_edit_name (GFileInfo *info,
|
|
const char *edit_name);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_icon (GFileInfo *info,
|
|
GIcon *icon);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_symbolic_icon (GFileInfo *info,
|
|
GIcon *icon);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_content_type (GFileInfo *info,
|
|
const char *content_type);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_size (GFileInfo *info,
|
|
goffset size);
|
|
G_GNUC_BEGIN_IGNORE_DEPRECATIONS
|
|
GLIB_DEPRECATED_IN_2_62_FOR(g_file_info_set_modification_date_time)
|
|
void g_file_info_set_modification_time (GFileInfo *info,
|
|
GTimeVal *mtime);
|
|
G_GNUC_END_IGNORE_DEPRECATIONS
|
|
GLIB_AVAILABLE_IN_2_62
|
|
void g_file_info_set_modification_date_time (GFileInfo *info,
|
|
GDateTime *mtime);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_symlink_target (GFileInfo *info,
|
|
const char *symlink_target);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_info_set_sort_order (GFileInfo *info,
|
|
gint32 sort_order);
|
|
|
|
#define G_TYPE_FILE_ATTRIBUTE_MATCHER (g_file_attribute_matcher_get_type ())
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GType g_file_attribute_matcher_get_type (void) G_GNUC_CONST;
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GFileAttributeMatcher *g_file_attribute_matcher_new (const char *attributes);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GFileAttributeMatcher *g_file_attribute_matcher_ref (GFileAttributeMatcher *matcher);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_file_attribute_matcher_unref (GFileAttributeMatcher *matcher);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GFileAttributeMatcher *g_file_attribute_matcher_subtract (GFileAttributeMatcher *matcher,
|
|
GFileAttributeMatcher *subtract);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_file_attribute_matcher_matches (GFileAttributeMatcher *matcher,
|
|
const char *attribute);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_file_attribute_matcher_matches_only (GFileAttributeMatcher *matcher,
|
|
const char *attribute);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_file_attribute_matcher_enumerate_namespace (GFileAttributeMatcher *matcher,
|
|
const char *ns);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
const char * g_file_attribute_matcher_enumerate_next (GFileAttributeMatcher *matcher);
|
|
GLIB_AVAILABLE_IN_2_32
|
|
char * g_file_attribute_matcher_to_string (GFileAttributeMatcher *matcher);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __G_FILE_INFO_H__ */
|