gio.types

Type definition for a function that will be called back when an asynchronous operation within GIO has been completed. #GAsyncReadyCallback callbacks from #GTask are guaranteed to be invoked in a later iteration of the [thread-default main context][g-main-context-push-thread-default] where the #GTask was created. All other users of #GAsyncReadyCallback must likewise call it asynchronously in a later iteration of the main context.

The asynchronous operation is guaranteed to have held a reference to source_object from the time when the *_async() function was called, until after this callback returns.

Invoked when a connection to a message bus has been obtained.

Invoked when the name is acquired.

Invoked when the name being watched is known to have to have an owner.

Invoked when the name is lost or connection has been closed.

Invoked when the name being watched is known not to have to have an owner.

This is also invoked when the #GDBusConnection on which the watch was established has been closed. In that case, connection will be null.

This is the function type of the callback used for the #GSource returned by [gio.cancellable.Cancellable.sourceNew].

The type of the get_property function in #GDBusInterfaceVTable.

The type of the method_call function in #GDBusInterfaceVTable.

The type of the set_property function in #GDBusInterfaceVTable.

Signature for function used in [gio.dbus_connection.DBusConnection.addFilter].

A filter function is passed a #GDBusMessage and expected to return a #GDBusMessage too. Passive filter functions that don't modify the message can simply return the message object:

static GDBusMessage *
passive_filter (GDBusConnection *connection
               GDBusMessage    *message,
               gboolean         incoming,
               gpointer         user_data)
{
 // inspect message
 return message;
}

static GDBusMessage *
drop_filter (GDBusConnection *connection
            GDBusMessage    *message,
            gboolean         incoming,
            gpointer         user_data)
{
 if (should_drop_message)
   {
     g_object_unref (message);
     message = NULL;
   }
 return message;
}

static GDBusMessage *
modifying_filter (GDBusConnection *connection
                 GDBusMessage    *message,
                 gboolean         incoming,
                 gpointer         user_data)
{
 GDBusMessage *copy;
 GError *error;

 error = NULL;
 copy = g_dbus_message_copy (message, &error);
 // handle error being set
 g_object_unref (message);

 // modify copy

 return copy;
}

Function signature for a function used to determine the #GType to use for an interface proxy (if interface_name is not null) or object proxy (if interface_name is null).

This function is called in the [thread-default main loop][g-main-context-push-thread-default] that manager was constructed in.

Signature for callback function used in [gio.dbus_connection.DBusConnection.signalSubscribe].

The type of the dispatch function in #GDBusSubtreeVTable.

Subtrees are flat. node, if non-null, is always exactly one segment of the object path (ie: it never contains a slash).

The type of the enumerate function in #GDBusSubtreeVTable.

This function is called when generating introspection data and also when preparing to dispatch incoming messages in the event that the [gio.types.DBusSubtreeFlags.DispatchToUnenumeratedNodes] flag is not specified (ie: to verify that the object path is valid).

Hierarchies are not supported; the items that you return should not contain the `/` character.

The return value will be freed with [glib.global.strfreev].

The type of the introspect function in #GDBusSubtreeVTable.

Subtrees are flat. node, if non-null, is always exactly one segment of the object path (ie: it never contains a slash).

This function should return null to indicate that there is no object at this node.

If this function returns non-null, the return value is expected to be a null-terminated array of pointers to #GDBusInterfaceInfo structures describing the interfaces implemented by node. This array will have [gio.dbus_interface_info.DBusInterfaceInfo.unref] called on each item before being freed with [glib.global.gfree].

The difference between returning null and an array containing zero items is that the standard DBus interfaces will returned to the remote introspector in the empty array case, but not in the null case.

This is the function type of the callback used for the #GSource returned by [gio.datagram_based.DatagramBased.createSource].

During invocation, [gio.desktop_app_info.DesktopAppInfo.launchUrisAsManager] may create one or more child processes. This callback is invoked once for each, providing the process ID.

This callback type is used by [gio.file.File.measureDiskUsage] to make periodic progress reports when measuring the amount of disk spaced used by a directory.

These calls are made on a best-effort basis and not all types of #GFile will support them. At the minimum, however, one call will always be made immediately.

In the case that there is no support, reporting will be set to false (and the other values undefined) and no further calls will be made. Otherwise, the reporting will be true and the other values all-zeros during the first (immediate) call. In this way, you can know which type of progress UI to show without a delay.

For [gio.file.File.measureDiskUsage] the callback is made directly. For [gio.file.File.measureDiskUsageAsync] the callback is made via the default main context of the calling thread (ie: the same way that the final async result would be reported).

current_size is in the same units as requested by the operation (see [gio.types.FileMeasureFlags.ApparentSize]).

The frequency of the updates is implementation defined, but is ideally about once every 200ms.

The last progress callback may or may not be equal to the final result. Always check the async result to get the final value.

When doing file operations that may take a while, such as moving a file or copying a file, a progress callback is used to pass how far along that operation is to the application.

When loading the partial contents of a file with [gio.file.File.loadPartialContentsAsync], it may become necessary to determine if any more data from the file should be loaded. A #GFileReadMoreCallback function facilitates this by returning true if more data should be read, or false otherwise.

I/O Job function.

Long-running jobs should periodically check the cancellable to see if they have been cancelled.

This is the function type of the callback used for the #GSource returned by [gio.pollable_input_stream.PollableInputStream.createSource] and [gio.pollable_output_stream.PollableOutputStream.createSource].

Changes the size of the memory block pointed to by data to size bytes.

The function should have the same semantics as realloc().

The type for the function that is used to convert from #GSettings to an object property. The value is already initialized to hold values of the appropriate type.

The type for the function that is used to convert an object property value to a #GVariant for storing it in #GSettings.

The type of the function that is used to convert from a value stored in a #GSettings to a value that is useful to the application.

If the value is successfully mapped, the result should be stored at result and true returned. If mapping fails (for example, if value is not in the right format) then false should be returned.

If value is null then it means that the mapping function is being given a "last chance" to successfully return a valid value. true must be returned in this case.

Simple thread function that runs an asynchronous operation and checks for cancellation.

This is the function type of the callback used for the #GSource returned by [gio.socket.Socket.createSource].

The prototype for a task function to be run in a thread via [gio.task.Task.runInThread] or [gio.task.Task.runInThreadSync].

If the return-on-cancel flag is set on task, and cancellable gets cancelled, then the #GTask will be completed immediately (as though [gio.task.Task.returnErrorIfCancelled] had been called), without waiting for the task function to complete. However, the task function will continue running in its thread in the background. The function therefore needs to be careful about how it uses externally-visible state in this case. See [gio.task.Task.setReturnOnCancel] for more details.

Other than in that case, task will be completed when the #GTaskThreadFunc returns, not when it calls a g_task_return_ function.

This function type is used by [gio.vfs.Vfs.registerUriScheme] to make it possible for a client to associate an URI scheme to a different #GFile implementation.

The client should return a reference to the new file that has been created for uri, or null to continue with the default implementation.

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 true, but using this macro is sometimes more readable.

In code that needs to be backwards-compatible with older GLib, use true instead, often written like this:

g_dbus_method_invocation_return_error (invocation, ...);
 return TRUE;    // handled

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 false, but using this macro is sometimes more readable.

In code that needs to be backwards-compatible with older GLib, use false instead.

Extension point for debug control functionality. See [Extending GIO][extending-gio].

Extension point for default handler to URI association. See [Extending GIO][extending-gio].

The string used to obtain a Unix device path with [gio.drive.Drive.getIdentifier].

A key in the "access" namespace for checking deletion privileges.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

This attribute will be true if the user is able to delete the file.

A key in the "access" namespace for getting execution privileges.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

This attribute will be true if the user is able to execute the file.

A key in the "access" namespace for getting read privileges.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

This attribute will be true if the user is able to read the file.

A key in the "access" namespace for checking renaming privileges.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

This attribute will be true if the user is able to rename the file.

A key in the "access" namespace for checking trashing privileges.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

This attribute will be true if the user is able to move the file to the trash.

A key in the "access" namespace for getting write privileges.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

This attribute will be true if the user is able to write to the file.

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 [gio.types.FileAttributeType.Boolean].

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

This attribute is only available for DOS file systems.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.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 [gio.types.FileAttributeType.Boolean].

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 #GFileAttributeType is [gio.types.FileAttributeType.Uint32].

A key in the "etag" namespace for getting the value of the file's entity tag.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.String].

A key in the "filesystem" namespace for getting the number of bytes of free space left on the file system.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Uint64].

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 [gio.types.FileAttributeType.Boolean].

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 [gio.types.FileAttributeType.Boolean].

A key in the "filesystem" namespace for getting the total size (in bytes) of the file system, used in [gio.file.File.queryFilesystemInfo].

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Uint64].

A key in the "filesystem" namespace for getting the file system's type.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.String].

A key in the "filesystem" namespace for getting the number of bytes used by data on the file system.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Uint64].

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.

A key in the "gvfs" namespace that gets the name of the current GVFS backend in use.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.String].

A key in the "id" namespace for getting a file identifier.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.String].

An example use would be during listing files, to avoid recursive directory scanning.

A key in the "id" namespace for getting the file system identifier.

Corresponding #GFileAttributeType is [gio.types.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).

A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be ejected.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is mountable.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be polled.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started degraded.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be stopped.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is unmountable.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

A key in the "mountable" namespace for getting the HAL UDI for the mountable file.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.String].

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 [gio.types.FileAttributeType.Boolean].

A key in the "mountable" namespace for getting the #GDriveStartStopType.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Uint32].

A key in the "mountable" namespace for getting the unix device.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Uint32].

A key in the "mountable" namespace for getting the unix device file.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.String].

A key in the "owner" namespace for getting the file owner's group.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.String].

A key in the "owner" namespace for getting the user name of the file's owner.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.String].

A key in the "owner" namespace for getting the real name of the user that owns the file.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.String].

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 [gio.types.FileAttributeType.Object].

The value for this key should contain a #GIcon.

A key in the "recent" namespace for getting time, when the metadata for the file in recent:/// was last changed.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Int64].

A key in the "selinux" namespace for getting the file's SELinux context.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.String].

Note that this attribute is only available if GLib has been built with SELinux support.

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 [gio.types.FileAttributeType.Uint64].

A key in the "standard" namespace for getting the content type of the file.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.String].

The value for this key should contain a valid content type.

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 [gio.types.FileAttributeType.String].

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 [gio.types.FileAttributeType.String].

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 [gio.types.FileAttributeType.String].

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 [gio.types.FileAttributeType.String].

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 [gio.types.FileAttributeType.String].

A key in the "standard" namespace for getting the icon for the file.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Object].

The value for this key should contain a #GIcon.

A key in the "standard" namespace for checking if a file is a backup file.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

A key in the "standard" namespace for checking if a file is hidden.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

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 [gio.types.FileAttributeType.Boolean].

A key in the "standard" namespace for checking if a file is virtual.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

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 [gio.types.FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET] for the persistent URI.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

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 [gio.types.FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME] if you need to display the name in a user interface.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.ByteString].

A key in the "standard" namespace for getting the file's size (in bytes).

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Uint64].

A key in the "standard" namespace for setting the sort order of a file.

Corresponding #GFileAttributeType is [gio.types.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.

A key in the "standard" namespace for getting the symbolic icon for the file.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Object].

The value for this key should contain a #GIcon.

A key in the "standard" namespace for getting the symlink target, if the file is a symlink.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.ByteString].

A key in the "standard" namespace for getting the target URI for the file, in the case of [gio.types.FileType.Shortcut] or [gio.types.FileType.Mountable] files.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.String].

A key in the "standard" namespace for storing file types.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Uint32].

The value for this key should contain a #GFileType.

A key in the "thumbnail" namespace for checking if thumbnailing failed.

This attribute is true if thumbnailing failed.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

A key in the "thumbnail" namespace for checking if thumbnailing failed for the large image.

This attribute is true if thumbnailing failed.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

A key in the "thumbnail" namespace for checking if thumbnailing failed for the normal image.

This attribute is true if thumbnailing failed.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

A key in the "thumbnail" namespace for checking if thumbnailing failed for the x-large image.

This attribute is true if thumbnailing failed.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

A key in the "thumbnail" namespace for checking if thumbnailing failed for the xx-large image.

This attribute is true if thumbnailing failed.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

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 [gio.types.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 [gio.types.FileAttributeType.Boolean].

A key in the "thumbnail" namespace for checking whether the large thumbnail is outdated.

This attribute is true if the large thumbnail is up-to-date with the file it represents, and false if the file has been modified since the thumbnail was generated.

If [gio.types.FILE_ATTRIBUTE_THUMBNAILING_FAILED_LARGE] is true and this attribute is false, it indicates that thumbnailing may be attempted again and may succeed.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

A key in the "thumbnail" namespace for checking whether the normal thumbnail is outdated.

This attribute is true if the normal thumbnail is up-to-date with the file it represents, and false if the file has been modified since the thumbnail was generated.

If [gio.types.FILE_ATTRIBUTE_THUMBNAILING_FAILED_NORMAL] is true and this attribute is false, it indicates that thumbnailing may be attempted again and may succeed.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

A key in the "thumbnail" namespace for checking whether the x-large thumbnail is outdated.

This attribute is true if the x-large thumbnail is up-to-date with the file it represents, and false if the file has been modified since the thumbnail was generated.

If [gio.types.FILE_ATTRIBUTE_THUMBNAILING_FAILED_XLARGE] is true and this attribute is false, it indicates that thumbnailing may be attempted again and may succeed.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

A key in the "thumbnail" namespace for checking whether the xx-large thumbnail is outdated.

This attribute is true if the x-large thumbnail is up-to-date with the file it represents, and false if the file has been modified since the thumbnail was generated.

If [gio.types.FILE_ATTRIBUTE_THUMBNAILING_FAILED_XXLARGE] is true and this attribute is false, it indicates that thumbnailing may be attempted again and may succeed.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Boolean].

A key in the "thumbnail" namespace for getting the path to the thumbnail image with the biggest size available.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.ByteString].

A key in the "thumbnail" namespace for getting the path to the large thumbnail image.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.ByteString].

A key in the "thumbnail" namespace for getting the path to the normal thumbnail image.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.ByteString].

A key in the "thumbnail" namespace for getting the path to the x-large thumbnail image.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.ByteString].

A key in the "thumbnail" namespace for getting the path to the xx-large thumbnail image.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.ByteString].

A key in the "time" namespace for getting the time the file was last accessed.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Uint64], and contains the time since the file was last accessed, in seconds since the UNIX epoch.

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 #GFileAttributeType is [gio.types.FileAttributeType.Uint32].

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 [gio.types.FILE_ATTRIBUTE_TIME_ACCESS].

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Uint32].

A key in the "time" namespace for getting the time the file was last changed.

Corresponding #GFileAttributeType is [gio.types.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.

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 #GFileAttributeType is [gio.types.FileAttributeType.Uint32].

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 [gio.types.FILE_ATTRIBUTE_TIME_CHANGED].

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Uint32].

A key in the "time" namespace for getting the time the file was created.

Corresponding #GFileAttributeType is [gio.types.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.

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 #GFileAttributeType is [gio.types.FileAttributeType.Uint32].

A key in the "time" namespace for getting the microseconds of the time the file was created.

This should be used in conjunction with [gio.types.FILE_ATTRIBUTE_TIME_CREATED].

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Uint32].

A key in the "time" namespace for getting the time the file was last modified.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Uint64], and contains the time since the file was modified, in seconds since the UNIX epoch.

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 #GFileAttributeType is [gio.types.FileAttributeType.Uint32].

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 [gio.types.FILE_ATTRIBUTE_TIME_MODIFIED].

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Uint32].

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 #GFileAttributeType is [gio.types.FileAttributeType.String].

A key in the "trash" namespace for getting the number of (toplevel) items that are present in the trash:/// folder.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.Uint32].

A key in the "trash" namespace for getting the original path of a file inside the trash:/// folder before it was trashed.

Corresponding #GFileAttributeType is [gio.types.FileAttributeType.ByteString].

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 [gio.types.FileAttributeType.Uint64].

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 [gio.types.FileAttributeType.Uint32].

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 [gio.types.FileAttributeType.Uint32].

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 [gio.types.FileAttributeType.Uint32].

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 [gio.types.FileAttributeType.Uint64].

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 [gio.types.FileAttributeType.Boolean].

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 [gio.types.FileAttributeType.Uint32].

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 #GFileAttributeType is [gio.types.FileAttributeType.Uint32].

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 #GFileAttributeType is [gio.types.FileAttributeType.Uint32].

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 [gio.types.FileAttributeType.Uint32].

Extension point for memory usage monitoring functionality. See [Extending GIO][extending-gio].

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 [gio.menu_model.MenuModel.getItemAttribute] and [gio.menu_item.MenuItem.setAttribute].

The menu item attribute that holds the namespace for all action names in menus that are linked from this item.

The menu item attribute which holds the icon of the item.

The icon is stored in the format returned by [gio.icon.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).

The menu item attribute which holds the label of the item.

The menu item attribute which holds the target with which the item's action will be activated.

See also [gio.menu_item.MenuItem.setActionAndTarget]

The maximum number of entries in a menu section supported by [gio.dbus_connection.DBusConnection.exportMenuModel].

The exact value of the limit may change in future GLib versions.

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 [gio.menu_item.MenuItem.setLink].

The name of the link that associates a menu item with a submenu.

See also [gio.menu_item.MenuItem.setLink].

Extension point for network status monitoring functionality. See [Extending GIO][extending-gio].

Extension point for power profile usage monitoring functionality. See [Extending GIO][extending-gio].

Extension point for proxy functionality. See [Extending GIO][extending-gio].

Extension point for proxy resolving functionality. See [Extending GIO][extending-gio].

Extension point for #GSettingsBackend functionality.

Extension point for TLS functionality via #GTlsBackend. See [Extending GIO][extending-gio].

The purpose used to verify the client certificate in a TLS connection. Used by TLS servers.

The purpose used to verify the server certificate in a TLS connection. This is the most common purpose in use. Used by TLS clients.

Extension point for #GVfs functionality. See [Extending GIO][extending-gio].

The string used to obtain the volume class with [gio.volume.Volume.getIdentifier].

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 #GVolume 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.

The string used to obtain a Hal UDI with [gio.volume.Volume.getIdentifier].

The string used to obtain a filesystem label with [gio.volume.Volume.getIdentifier].

The string used to obtain a NFS mount with [gio.volume.Volume.getIdentifier].

The string used to obtain a Unix device path with [gio.volume.Volume.getIdentifier].

The string used to obtain a UUID with [gio.volume.Volume.getIdentifier].

Extension point for volume monitor functionality. See [Extending GIO][extending-gio].