Constants ========= .. currentmodule:: gi.repository.Gio .. data:: DBUS_METHOD_INVOCATION_HANDLED :value: True The value returned by handlers of the signals generated by the ``gdbus-codegen`` tool to indicate that a method call has been handled by an implementation. It is equal to :const:`True`, but using this macro is sometimes more readable. In code that needs to be backwards-compatible with older GLib, use :const:`True` instead, often written like this: .. code-block:: :dedent: g_dbus_method_invocation_return_error (invocation, ...); return TRUE; // handled .. data:: DBUS_METHOD_INVOCATION_UNHANDLED :value: False The value returned by handlers of the signals generated by the ``gdbus-codegen`` tool to indicate that a method call has not been handled by an implementation. It is equal to :const:`False`, but using this macro is sometimes more readable. In code that needs to be backwards-compatible with older GLib, use :const:`False` instead. .. data:: DEBUG_CONTROLLER_EXTENSION_POINT_NAME :value: gio-debug-controller Extension point for debug control functionality. See [Extending GIO][extending-gio]. .. data:: DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAME :value: gio-desktop-app-info-lookup Extension point for default handler to URI association. See [Extending GIO][extending-gio]. .. deprecated:: 2.28 The :obj:`~gi.repository.Gio.DesktopAppInfoLookup` interface is deprecated and unused by GIO. .. data:: DRIVE_IDENTIFIER_KIND_UNIX_DEVICE :value: unix-device The string used to obtain a Unix device path with :func:`~gi.repository.Gio.Drive.get_identifier`. .. data:: FILE_ATTRIBUTE_ACCESS_CAN_DELETE :value: access::can-delete A key in the "access" namespace for checking deletion privileges. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. This attribute will be :const:`True` if the user is able to delete the file. .. data:: FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE :value: access::can-execute A key in the "access" namespace for getting execution privileges. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. This attribute will be :const:`True` if the user is able to execute the file. .. data:: FILE_ATTRIBUTE_ACCESS_CAN_READ :value: access::can-read A key in the "access" namespace for getting read privileges. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. This attribute will be :const:`True` if the user is able to read the file. .. data:: FILE_ATTRIBUTE_ACCESS_CAN_RENAME :value: access::can-rename A key in the "access" namespace for checking renaming privileges. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. This attribute will be :const:`True` if the user is able to rename the file. .. data:: FILE_ATTRIBUTE_ACCESS_CAN_TRASH :value: access::can-trash A key in the "access" namespace for checking trashing privileges. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. This attribute will be :const:`True` if the user is able to move the file to the trash. .. data:: FILE_ATTRIBUTE_ACCESS_CAN_WRITE :value: access::can-write A key in the "access" namespace for getting write privileges. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. This attribute will be :const:`True` if the user is able to write to the file. .. data:: FILE_ATTRIBUTE_DOS_IS_ARCHIVE :value: dos::is-archive A key in the "dos" namespace for checking if the file's archive flag is set. This attribute is :const:`True` if the archive flag is set. This attribute is only available for DOS file systems. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_DOS_IS_MOUNTPOINT :value: 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 :const:`True` if file is a reparse point of type `IO_REPARSE_TAG_MOUNT_POINT `__\. This attribute is only available for DOS file systems. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_DOS_IS_SYSTEM :value: dos::is-system A key in the "dos" namespace for checking if the file's backup flag is set. This attribute is :const:`True` if the backup flag is set. This attribute is only available for DOS file systems. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_DOS_REPARSE_POINT_TAG :value: 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 `__ page for possible reparse tag values. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_ETAG_VALUE :value: etag::value A key in the "etag" namespace for getting the value of the file's entity tag. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. .. data:: FILE_ATTRIBUTE_FILESYSTEM_FREE :value: filesystem::free A key in the "filesystem" namespace for getting the number of bytes of free space left on the file system. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT64`. .. data:: FILE_ATTRIBUTE_FILESYSTEM_READONLY :value: filesystem::readonly A key in the "filesystem" namespace for checking if the file system is read only. Is set to :const:`True` if the file system is read only. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_FILESYSTEM_REMOTE :value: filesystem::remote A key in the "filesystem" namespace for checking if the file system is remote. Is set to :const:`True` if the file system is remote. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_FILESYSTEM_SIZE :value: filesystem::size A key in the "filesystem" namespace for getting the total size (in bytes) of the file system, used in :func:`~gi.repository.Gio.File.query_filesystem_info`. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT64`. .. data:: FILE_ATTRIBUTE_FILESYSTEM_TYPE :value: filesystem::type A key in the "filesystem" namespace for getting the file system's type. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. .. data:: FILE_ATTRIBUTE_FILESYSTEM_USED :value: filesystem::used A key in the "filesystem" namespace for getting the number of bytes used by data on the file system. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT64`. .. data:: FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW :value: 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``. .. data:: FILE_ATTRIBUTE_GVFS_BACKEND :value: gvfs::backend A key in the "gvfs" namespace that gets the name of the current GVFS backend in use. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. .. data:: FILE_ATTRIBUTE_ID_FILE :value: id::file A key in the "id" namespace for getting a file identifier. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. An example use would be during listing files, to avoid recursive directory scanning. .. data:: FILE_ATTRIBUTE_ID_FILESYSTEM :value: id::filesystem A key in the "id" namespace for getting the file system identifier. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.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). .. data:: FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT :value: mountable::can-eject A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be ejected. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT :value: mountable::can-mount A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is mountable. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL :value: mountable::can-poll A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be polled. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_MOUNTABLE_CAN_START :value: mountable::can-start A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED :value: 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 :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP :value: mountable::can-stop A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be stopped. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT :value: mountable::can-unmount A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is unmountable. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI :value: mountable::hal-udi A key in the "mountable" namespace for getting the HAL UDI for the mountable file. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. .. data:: FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC :value: 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 :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE :value: mountable::start-stop-type A key in the "mountable" namespace for getting the :obj:`~gi.repository.Gio.DriveStartStopType`\. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE :value: mountable::unix-device A key in the "mountable" namespace for getting the unix device. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE :value: mountable::unix-device-file A key in the "mountable" namespace for getting the unix device file. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. .. data:: FILE_ATTRIBUTE_OWNER_GROUP :value: owner::group A key in the "owner" namespace for getting the file owner's group. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. .. data:: FILE_ATTRIBUTE_OWNER_USER :value: owner::user A key in the "owner" namespace for getting the user name of the file's owner. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. .. data:: FILE_ATTRIBUTE_OWNER_USER_REAL :value: owner::user-real A key in the "owner" namespace for getting the real name of the user that owns the file. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. .. data:: FILE_ATTRIBUTE_PREVIEW_ICON :value: preview::icon A key in the "preview" namespace for getting a :obj:`~gi.repository.Gio.Icon` that can be used to get preview of the file. For example, it may be a low resolution thumbnail without metadata. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.OBJECT`. The value for this key should contain a :obj:`~gi.repository.Gio.Icon`\. .. data:: FILE_ATTRIBUTE_RECENT_MODIFIED :value: recent::modified A key in the "recent" namespace for getting time, when the metadata for the file in ``recent:///`` was last changed. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.INT64`. .. data:: FILE_ATTRIBUTE_SELINUX_CONTEXT :value: selinux::context A key in the "selinux" namespace for getting the file's SELinux context. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. Note that this attribute is only available if GLib has been built with SELinux support. .. data:: FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE :value: 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 :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT64`. .. data:: FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE :value: standard::content-type A key in the "standard" namespace for getting the content type of the file. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. The value for this key should contain a valid content type. .. data:: FILE_ATTRIBUTE_STANDARD_COPY_NAME :value: 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 :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. .. data:: FILE_ATTRIBUTE_STANDARD_DESCRIPTION :value: 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 :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. .. data:: FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME :value: 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 :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. .. data:: FILE_ATTRIBUTE_STANDARD_EDIT_NAME :value: 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 :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. .. data:: FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE :value: 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 :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. .. data:: FILE_ATTRIBUTE_STANDARD_ICON :value: standard::icon A key in the "standard" namespace for getting the icon for the file. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.OBJECT`. The value for this key should contain a :obj:`~gi.repository.Gio.Icon`\. .. data:: FILE_ATTRIBUTE_STANDARD_IS_BACKUP :value: standard::is-backup A key in the "standard" namespace for checking if a file is a backup file. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_STANDARD_IS_HIDDEN :value: standard::is-hidden A key in the "standard" namespace for checking if a file is hidden. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_STANDARD_IS_SYMLINK :value: 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 :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL :value: standard::is-virtual A key in the "standard" namespace for checking if a file is virtual. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_STANDARD_IS_VOLATILE :value: 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 :const:`~gi.repository.Gio.FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET` for the persistent URI. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_STANDARD_NAME :value: 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 :const:`~gi.repository.Gio.FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME` if you need to display the name in a user interface. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BYTE_STRING`. .. data:: FILE_ATTRIBUTE_STANDARD_SIZE :value: standard::size A key in the "standard" namespace for getting the file's size (in bytes). Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT64`. .. data:: FILE_ATTRIBUTE_STANDARD_SORT_ORDER :value: standard::sort-order A key in the "standard" namespace for setting the sort order of a file. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.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. .. data:: FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON :value: standard::symbolic-icon A key in the "standard" namespace for getting the symbolic icon for the file. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.OBJECT`. The value for this key should contain a :obj:`~gi.repository.Gio.Icon`\. .. data:: FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET :value: standard::symlink-target A key in the "standard" namespace for getting the symlink target, if the file is a symlink. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BYTE_STRING`. .. data:: FILE_ATTRIBUTE_STANDARD_TARGET_URI :value: standard::target-uri A key in the "standard" namespace for getting the target URI for the file, in the case of :const:`~gi.repository.Gio.FileType.SHORTCUT` or :const:`~gi.repository.Gio.FileType.MOUNTABLE` files. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. .. data:: FILE_ATTRIBUTE_STANDARD_TYPE :value: standard::type A key in the "standard" namespace for storing file types. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. The value for this key should contain a :obj:`~gi.repository.Gio.FileType`\. .. data:: FILE_ATTRIBUTE_THUMBNAILING_FAILED :value: thumbnail::failed A key in the "thumbnail" namespace for checking if thumbnailing failed. This attribute is :const:`True` if thumbnailing failed. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_THUMBNAILING_FAILED_LARGE :value: thumbnail::failed-large A key in the "thumbnail" namespace for checking if thumbnailing failed for the large image. This attribute is :const:`True` if thumbnailing failed. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_THUMBNAILING_FAILED_NORMAL :value: thumbnail::failed-normal A key in the "thumbnail" namespace for checking if thumbnailing failed for the normal image. This attribute is :const:`True` if thumbnailing failed. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_THUMBNAILING_FAILED_XLARGE :value: thumbnail::failed-xlarge A key in the "thumbnail" namespace for checking if thumbnailing failed for the x-large image. This attribute is :const:`True` if thumbnailing failed. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_THUMBNAILING_FAILED_XXLARGE :value: thumbnail::failed-xxlarge A key in the "thumbnail" namespace for checking if thumbnailing failed for the xx-large image. This attribute is :const:`True` if thumbnailing failed. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_THUMBNAIL_IS_VALID :value: thumbnail::is-valid A key in the "thumbnail" namespace for checking whether the thumbnail is outdated. This attribute is :const:`True` if the thumbnail is up-to-date with the file it represents, and :const:`False` if the file has been modified since the thumbnail was generated. If :const:`~gi.repository.Gio.FILE_ATTRIBUTE_THUMBNAILING_FAILED` is :const:`True` and this attribute is :const:`False`, it indicates that thumbnailing may be attempted again and may succeed. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_THUMBNAIL_IS_VALID_LARGE :value: thumbnail::is-valid-large A key in the "thumbnail" namespace for checking whether the large thumbnail is outdated. This attribute is :const:`True` if the large thumbnail is up-to-date with the file it represents, and :const:`False` if the file has been modified since the thumbnail was generated. If :const:`~gi.repository.Gio.FILE_ATTRIBUTE_THUMBNAILING_FAILED_LARGE` is :const:`True` and this attribute is :const:`False`, it indicates that thumbnailing may be attempted again and may succeed. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_THUMBNAIL_IS_VALID_NORMAL :value: thumbnail::is-valid-normal A key in the "thumbnail" namespace for checking whether the normal thumbnail is outdated. This attribute is :const:`True` if the normal thumbnail is up-to-date with the file it represents, and :const:`False` if the file has been modified since the thumbnail was generated. If :const:`~gi.repository.Gio.FILE_ATTRIBUTE_THUMBNAILING_FAILED_NORMAL` is :const:`True` and this attribute is :const:`False`, it indicates that thumbnailing may be attempted again and may succeed. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_THUMBNAIL_IS_VALID_XLARGE :value: thumbnail::is-valid-xlarge A key in the "thumbnail" namespace for checking whether the x-large thumbnail is outdated. This attribute is :const:`True` if the x-large thumbnail is up-to-date with the file it represents, and :const:`False` if the file has been modified since the thumbnail was generated. If :const:`~gi.repository.Gio.FILE_ATTRIBUTE_THUMBNAILING_FAILED_XLARGE` is :const:`True` and this attribute is :const:`False`, it indicates that thumbnailing may be attempted again and may succeed. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_THUMBNAIL_IS_VALID_XXLARGE :value: thumbnail::is-valid-xxlarge A key in the "thumbnail" namespace for checking whether the xx-large thumbnail is outdated. This attribute is :const:`True` if the x-large thumbnail is up-to-date with the file it represents, and :const:`False` if the file has been modified since the thumbnail was generated. If :const:`~gi.repository.Gio.FILE_ATTRIBUTE_THUMBNAILING_FAILED_XXLARGE` is :const:`True` and this attribute is :const:`False`, it indicates that thumbnailing may be attempted again and may succeed. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_THUMBNAIL_PATH :value: thumbnail::path A key in the "thumbnail" namespace for getting the path to the thumbnail image with the biggest size available. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BYTE_STRING`. .. data:: FILE_ATTRIBUTE_THUMBNAIL_PATH_LARGE :value: thumbnail::path-large A key in the "thumbnail" namespace for getting the path to the large thumbnail image. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BYTE_STRING`. .. data:: FILE_ATTRIBUTE_THUMBNAIL_PATH_NORMAL :value: thumbnail::path-normal A key in the "thumbnail" namespace for getting the path to the normal thumbnail image. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BYTE_STRING`. .. data:: FILE_ATTRIBUTE_THUMBNAIL_PATH_XLARGE :value: thumbnail::path-xlarge A key in the "thumbnail" namespace for getting the path to the x-large thumbnail image. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BYTE_STRING`. .. data:: FILE_ATTRIBUTE_THUMBNAIL_PATH_XXLARGE :value: thumbnail::path-xxlarge A key in the "thumbnail" namespace for getting the path to the xx-large thumbnail image. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BYTE_STRING`. .. data:: FILE_ATTRIBUTE_TIME_ACCESS :value: time::access A key in the "time" namespace for getting the time the file was last accessed. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT64`, and contains the time since the file was last accessed, in seconds since the UNIX epoch. .. data:: FILE_ATTRIBUTE_TIME_ACCESS_NSEC :value: time::access-nsec A key in the "time" namespace for getting the nanoseconds of the time the file was last accessed. This should be used in conjunction with ``G_FILE_ATTRIBUTE_TIME_ACCESS``. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_TIME_ACCESS_USEC :value: 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 :const:`~gi.repository.Gio.FILE_ATTRIBUTE_TIME_ACCESS`. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_TIME_CHANGED :value: time::changed A key in the "time" namespace for getting the time the file was last changed. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT64`, and contains the time since the file was last changed, in seconds since the UNIX epoch. This corresponds to the traditional UNIX ctime. .. data:: FILE_ATTRIBUTE_TIME_CHANGED_NSEC :value: time::changed-nsec A key in the "time" namespace for getting the nanoseconds of the time the file was last changed. This should be used in conjunction with ``G_FILE_ATTRIBUTE_TIME_CHANGED``. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_TIME_CHANGED_USEC :value: 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 :const:`~gi.repository.Gio.FILE_ATTRIBUTE_TIME_CHANGED`. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_TIME_CREATED :value: time::created A key in the "time" namespace for getting the time the file was created. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.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``\. .. data:: FILE_ATTRIBUTE_TIME_CREATED_NSEC :value: time::created-nsec A key in the "time" namespace for getting the nanoseconds of the time the file was created. This should be used in conjunction with ``G_FILE_ATTRIBUTE_TIME_CREATED``. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_TIME_CREATED_USEC :value: 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 :const:`~gi.repository.Gio.FILE_ATTRIBUTE_TIME_CREATED`. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_TIME_MODIFIED :value: time::modified A key in the "time" namespace for getting the time the file was last modified. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT64`, and contains the time since the file was modified, in seconds since the UNIX epoch. .. data:: FILE_ATTRIBUTE_TIME_MODIFIED_NSEC :value: time::modified-nsec A key in the "time" namespace for getting the nanoseconds of the time the file was last modified. This should be used in conjunction with ``G_FILE_ATTRIBUTE_TIME_MODIFIED``. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_TIME_MODIFIED_USEC :value: 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 :const:`~gi.repository.Gio.FILE_ATTRIBUTE_TIME_MODIFIED`. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_TRASH_DELETION_DATE :value: trash::deletion-date A key in the "trash" namespace for getting the deletion date and time of a file inside the ``trash:///`` folder. The format of the returned string is ``YYYY-MM-DDThh:mm:ss``\. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.STRING`. .. data:: FILE_ATTRIBUTE_TRASH_ITEM_COUNT :value: trash::item-count A key in the "trash" namespace for getting the number of (toplevel) items that are present in the ``trash:///`` folder. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_TRASH_ORIG_PATH :value: trash::orig-path A key in the "trash" namespace for getting the original path of a file inside the ``trash:///`` folder before it was trashed. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BYTE_STRING`. .. data:: FILE_ATTRIBUTE_UNIX_BLOCKS :value: 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 :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT64`. .. data:: FILE_ATTRIBUTE_UNIX_BLOCK_SIZE :value: 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 :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_UNIX_DEVICE :value: 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 :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_UNIX_GID :value: 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 :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_UNIX_INODE :value: 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 :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT64`. .. data:: FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT :value: unix::is-mountpoint A key in the "unix" namespace for checking if the file represents a UNIX mount point. This attribute is :const:`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 :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.BOOLEAN`. .. data:: FILE_ATTRIBUTE_UNIX_MODE :value: 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 :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_UNIX_NLINK :value: unix::nlink A key in the "unix" namespace for getting the number of hard links for a file. See the documentation for ``lstat()``\. This attribute is only available for UNIX file systems. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_UNIX_RDEV :value: unix::rdev A key in the "unix" namespace for getting the device ID for the file (if it is a special file). See the documentation for ``lstat()``\. This attribute is only available for UNIX file systems. Corresponding :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: FILE_ATTRIBUTE_UNIX_UID :value: 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 :obj:`~gi.repository.Gio.FileAttributeType` is :const:`~gi.repository.Gio.FileAttributeType.UINT32`. .. data:: MEMORY_MONITOR_EXTENSION_POINT_NAME :value: gio-memory-monitor Extension point for memory usage monitoring functionality. See [Extending GIO][extending-gio]. .. data:: MENU_ATTRIBUTE_ACTION :value: action The menu item attribute which holds the action name of the item. Action names are namespaced with an identifier for the action group in which the action resides. For example, "win." for window-specific actions and "app." for application-wide actions. See also :func:`~gi.repository.Gio.MenuModel.get_item_attribute` and :func:`~gi.repository.Gio.MenuItem.set_attribute`. .. data:: MENU_ATTRIBUTE_ACTION_NAMESPACE :value: action-namespace The menu item attribute that holds the namespace for all action names in menus that are linked from this item. .. data:: MENU_ATTRIBUTE_ICON :value: icon The menu item attribute which holds the icon of the item. The icon is stored in the format returned by :func:`~gi.repository.Gio.Icon.serialize`. This attribute is intended only to represent 'noun' icons such as favicons for a webpage, or application icons. It should not be used for 'verbs' (ie: stock icons). .. data:: MENU_ATTRIBUTE_LABEL :value: label The menu item attribute which holds the label of the item. .. data:: MENU_ATTRIBUTE_TARGET :value: target The menu item attribute which holds the target with which the item's action will be activated. See also :func:`~gi.repository.Gio.MenuItem.set_action_and_target` .. data:: MENU_EXPORTER_MAX_SECTION_SIZE :value: 1000 The maximum number of entries in a menu section supported by :func:`~gi.repository.Gio.DBusConnection.export_menu_model`. The exact value of the limit may change in future GLib versions. .. data:: MENU_LINK_SECTION :value: section The name of the link that associates a menu item with a section. The linked menu will usually be shown in place of the menu item, using the item's label as a header. See also :func:`~gi.repository.Gio.MenuItem.set_link`. .. data:: MENU_LINK_SUBMENU :value: submenu The name of the link that associates a menu item with a submenu. See also :func:`~gi.repository.Gio.MenuItem.set_link`. .. data:: NATIVE_VOLUME_MONITOR_EXTENSION_POINT_NAME :value: gio-native-volume-monitor .. data:: NETWORK_MONITOR_EXTENSION_POINT_NAME :value: gio-network-monitor Extension point for network status monitoring functionality. See [Extending GIO][extending-gio]. .. data:: POWER_PROFILE_MONITOR_EXTENSION_POINT_NAME :value: gio-power-profile-monitor Extension point for power profile usage monitoring functionality. See [Extending GIO][extending-gio]. .. data:: PROXY_EXTENSION_POINT_NAME :value: gio-proxy Extension point for proxy functionality. See [Extending GIO][extending-gio]. .. data:: PROXY_RESOLVER_EXTENSION_POINT_NAME :value: gio-proxy-resolver Extension point for proxy resolving functionality. See [Extending GIO][extending-gio]. .. data:: SETTINGS_BACKEND_EXTENSION_POINT_NAME :value: gsettings-backend Extension point for :obj:`~gi.repository.Gio.SettingsBackend` functionality. .. data:: TLS_BACKEND_EXTENSION_POINT_NAME :value: gio-tls-backend Extension point for TLS functionality via :obj:`~gi.repository.Gio.TlsBackend`\. See [Extending GIO][extending-gio]. .. data:: TLS_DATABASE_PURPOSE_AUTHENTICATE_CLIENT :value: 1.3.6.1.5.5.7.3.2 The purpose used to verify the client certificate in a TLS connection. Used by TLS servers. .. data:: TLS_DATABASE_PURPOSE_AUTHENTICATE_SERVER :value: 1.3.6.1.5.5.7.3.1 The purpose used to verify the server certificate in a TLS connection. This is the most common purpose in use. Used by TLS clients. .. data:: VFS_EXTENSION_POINT_NAME :value: gio-vfs Extension point for :obj:`~gi.repository.Gio.Vfs` functionality. See [Extending GIO][extending-gio]. .. data:: VOLUME_IDENTIFIER_KIND_CLASS :value: class The string used to obtain the volume class with :func:`~gi.repository.Gio.Volume.get_identifier`. Known volume classes include ``device``\, ``network``\, and ``loop``\. Other classes may be added in the future. This is intended to be used by applications to classify :obj:`~gi.repository.Gio.Volume` instances into different sections - for example a file manager or file chooser can use this information to show ``network`` volumes under a "Network" heading and ``device`` volumes under a "Devices" heading. .. data:: VOLUME_IDENTIFIER_KIND_HAL_UDI :value: hal-udi The string used to obtain a Hal UDI with :func:`~gi.repository.Gio.Volume.get_identifier`. .. deprecated:: 2.58 Do not use, HAL is deprecated. .. data:: VOLUME_IDENTIFIER_KIND_LABEL :value: label The string used to obtain a filesystem label with :func:`~gi.repository.Gio.Volume.get_identifier`. .. data:: VOLUME_IDENTIFIER_KIND_NFS_MOUNT :value: nfs-mount The string used to obtain a NFS mount with :func:`~gi.repository.Gio.Volume.get_identifier`. .. data:: VOLUME_IDENTIFIER_KIND_UNIX_DEVICE :value: unix-device The string used to obtain a Unix device path with :func:`~gi.repository.Gio.Volume.get_identifier`. .. data:: VOLUME_IDENTIFIER_KIND_UUID :value: uuid The string used to obtain a UUID with :func:`~gi.repository.Gio.Volume.get_identifier`. .. data:: VOLUME_MONITOR_EXTENSION_POINT_NAME :value: gio-volume-monitor Extension point for volume monitor functionality. See [Extending GIO][extending-gio].