Gjsify LogoGjsify Logo

Index

Enumerations

Classes

Interfaces

Variables

Functions

Variables

DBUS_METHOD_INVOCATION_HANDLED: boolean

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


DBUS_METHOD_INVOCATION_UNHANDLED: boolean

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.

DEBUG_CONTROLLER_EXTENSION_POINT_NAME: string

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

DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAME: string

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

DRIVE_IDENTIFIER_KIND_UNIX_DEVICE: string

The string used to obtain a Unix device path with g_drive_get_identifier().

FILE_ATTRIBUTE_ACCESS_CAN_DELETE: string

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.

FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE: string

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.

FILE_ATTRIBUTE_ACCESS_CAN_READ: string

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.

FILE_ATTRIBUTE_ACCESS_CAN_RENAME: string

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.

FILE_ATTRIBUTE_ACCESS_CAN_TRASH: string

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.

FILE_ATTRIBUTE_ACCESS_CAN_WRITE: string

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.

FILE_ATTRIBUTE_DOS_IS_ARCHIVE: string

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.

FILE_ATTRIBUTE_DOS_IS_MOUNTPOINT: string

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.

This attribute is only available for DOS file systems.

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

FILE_ATTRIBUTE_DOS_IS_SYSTEM: string

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.

FILE_ATTRIBUTE_DOS_REPARSE_POINT_TAG: string

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 %G_FILE_ATTRIBUTE_TYPE_UINT32.

FILE_ATTRIBUTE_ETAG_VALUE: string

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

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.

FILE_ATTRIBUTE_FILESYSTEM_FREE: string

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.

FILE_ATTRIBUTE_FILESYSTEM_READONLY: string

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.

FILE_ATTRIBUTE_FILESYSTEM_REMOTE: string

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.

FILE_ATTRIBUTE_FILESYSTEM_SIZE: string

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.

FILE_ATTRIBUTE_FILESYSTEM_TYPE: string

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

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.

FILE_ATTRIBUTE_FILESYSTEM_USED: string

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

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.

FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW: string

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.

FILE_ATTRIBUTE_GVFS_BACKEND: string

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.

FILE_ATTRIBUTE_ID_FILE: string

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.

FILE_ATTRIBUTE_ID_FILESYSTEM: string

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).

FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT: string

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.

FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT: string

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.

FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL: string

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.

FILE_ATTRIBUTE_MOUNTABLE_CAN_START: string

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.

FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED: string

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.

FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP: string

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.

FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT: string

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.

FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI: string

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

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.

FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC: 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 %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE: string

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

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.

FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE: string

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

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.

FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE: string

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

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.

FILE_ATTRIBUTE_OWNER_GROUP: string

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

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.

FILE_ATTRIBUTE_OWNER_USER: string

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

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.

FILE_ATTRIBUTE_OWNER_USER_REAL: string

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

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.

FILE_ATTRIBUTE_PREVIEW_ICON: 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 %G_FILE_ATTRIBUTE_TYPE_OBJECT.

The value for this key should contain a #GIcon.

FILE_ATTRIBUTE_RECENT_MODIFIED: string

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.

FILE_ATTRIBUTE_SELINUX_CONTEXT: string

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.

FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE: string

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.

FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE: string

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.

FILE_ATTRIBUTE_STANDARD_COPY_NAME: string

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.

FILE_ATTRIBUTE_STANDARD_DESCRIPTION: 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 %G_FILE_ATTRIBUTE_TYPE_STRING.

FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME: 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 %G_FILE_ATTRIBUTE_TYPE_STRING.

FILE_ATTRIBUTE_STANDARD_EDIT_NAME: 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 %G_FILE_ATTRIBUTE_TYPE_STRING.

FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE: 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 %G_FILE_ATTRIBUTE_TYPE_STRING.

FILE_ATTRIBUTE_STANDARD_ICON: string

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.

FILE_ATTRIBUTE_STANDARD_IS_BACKUP: string

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

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

FILE_ATTRIBUTE_STANDARD_IS_HIDDEN: string

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

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

FILE_ATTRIBUTE_STANDARD_IS_SYMLINK: string

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.

FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL: string

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

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

FILE_ATTRIBUTE_STANDARD_IS_VOLATILE: string

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.

FILE_ATTRIBUTE_STANDARD_NAME: string

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.

FILE_ATTRIBUTE_STANDARD_SIZE: string

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

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.

FILE_ATTRIBUTE_STANDARD_SORT_ORDER: string

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.

FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON: string

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.

FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET: string

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

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.

FILE_ATTRIBUTE_STANDARD_TARGET_URI: string

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.

FILE_ATTRIBUTE_STANDARD_TYPE: string

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.

FILE_ATTRIBUTE_THUMBNAILING_FAILED: string

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.

FILE_ATTRIBUTE_THUMBNAIL_IS_VALID: string

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.

FILE_ATTRIBUTE_THUMBNAIL_PATH: string

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

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.

FILE_ATTRIBUTE_TIME_ACCESS: string

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.

FILE_ATTRIBUTE_TIME_ACCESS_USEC: string

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.

FILE_ATTRIBUTE_TIME_CHANGED: string

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.

FILE_ATTRIBUTE_TIME_CHANGED_USEC: string

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.

FILE_ATTRIBUTE_TIME_CREATED: string

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.

FILE_ATTRIBUTE_TIME_CREATED_USEC: string

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.

FILE_ATTRIBUTE_TIME_MODIFIED: string

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.

FILE_ATTRIBUTE_TIME_MODIFIED_USEC: string

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.

FILE_ATTRIBUTE_TRASH_DELETION_DATE: string

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 %G_FILE_ATTRIBUTE_TYPE_STRING.

FILE_ATTRIBUTE_TRASH_ITEM_COUNT: string

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

Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.

FILE_ATTRIBUTE_TRASH_ORIG_PATH: string

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 %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.

FILE_ATTRIBUTE_UNIX_BLOCKS: string

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.

FILE_ATTRIBUTE_UNIX_BLOCK_SIZE: string

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.

FILE_ATTRIBUTE_UNIX_DEVICE: string

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.

FILE_ATTRIBUTE_UNIX_GID: string

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.

FILE_ATTRIBUTE_UNIX_INODE: string

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.

FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT: string

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.

FILE_ATTRIBUTE_UNIX_MODE: string

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.

FILE_ATTRIBUTE_UNIX_NLINK: string

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 %G_FILE_ATTRIBUTE_TYPE_UINT32.

FILE_ATTRIBUTE_UNIX_RDEV: string

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 %G_FILE_ATTRIBUTE_TYPE_UINT32.

FILE_ATTRIBUTE_UNIX_UID: string

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.

MEMORY_MONITOR_EXTENSION_POINT_NAME: string

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

MENU_ATTRIBUTE_ACTION: string

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 g_menu_model_get_item_attribute() and g_menu_item_set_attribute().

MENU_ATTRIBUTE_ACTION_NAMESPACE: string

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

MENU_ATTRIBUTE_ICON: string

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

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

MENU_ATTRIBUTE_LABEL: string

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

MENU_ATTRIBUTE_TARGET: string

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

See also g_menu_item_set_action_and_target()

MENU_LINK_SECTION: string

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 g_menu_item_set_link().

MENU_LINK_SUBMENU: string

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

See also g_menu_item_set_link().

NATIVE_VOLUME_MONITOR_EXTENSION_POINT_NAME: string
NETWORK_MONITOR_EXTENSION_POINT_NAME: string

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

POWER_PROFILE_MONITOR_EXTENSION_POINT_NAME: string

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

PROXY_EXTENSION_POINT_NAME: string

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

PROXY_RESOLVER_EXTENSION_POINT_NAME: string

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

SETTINGS_BACKEND_EXTENSION_POINT_NAME: string

Extension point for #GSettingsBackend functionality.

TLS_BACKEND_EXTENSION_POINT_NAME: string

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

TLS_DATABASE_PURPOSE_AUTHENTICATE_CLIENT: string

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

TLS_DATABASE_PURPOSE_AUTHENTICATE_SERVER: string

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

VFS_EXTENSION_POINT_NAME: string

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

VOLUME_IDENTIFIER_KIND_CLASS: string

The string used to obtain the volume class with g_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 #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.

VOLUME_IDENTIFIER_KIND_HAL_UDI: string

The string used to obtain a Hal UDI with g_volume_get_identifier().

VOLUME_IDENTIFIER_KIND_LABEL: string

The string used to obtain a filesystem label with g_volume_get_identifier().

VOLUME_IDENTIFIER_KIND_NFS_MOUNT: string

The string used to obtain a NFS mount with g_volume_get_identifier().

VOLUME_IDENTIFIER_KIND_UNIX_DEVICE: string

The string used to obtain a Unix device path with g_volume_get_identifier().

VOLUME_IDENTIFIER_KIND_UUID: string

The string used to obtain a UUID with g_volume_get_identifier().

VOLUME_MONITOR_EXTENSION_POINT_NAME: string

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

Functions

  • actionNameIsValid(actionName: string): boolean
  • Checks if action_name is valid.

    action_name is valid if it consists only of alphanumeric characters, plus '-' and '.'. The empty string is not a valid action name.

    It is an error to call this function with a non-utf8 action_name. action_name must not be %NULL.

    Parameters

    • actionName: string

      a potential action name

    Returns boolean

  • actionParseDetailedName(detailedName: string): [boolean, string, GLib.Variant]
  • Parses a detailed action name into its separate name and target components.

    Detailed action names can have three formats.

    The first format is used to represent an action name with no target value and consists of just an action name containing no whitespace nor the characters ':', '(' or ')'. For example: "app.action".

    The second format is used to represent an action with a target value that is a non-empty string consisting only of alphanumerics, plus '-' and '.'. In that case, the action name and target value are separated by a double colon ("::"). For example: "app.action::target".

    The third format is used to represent an action with any type of target value, including strings. The target value follows the action name, surrounded in parens. For example: "app.action(42)". The target value is parsed using g_variant_parse(). If a tuple-typed value is desired, it must be specified in the same way, resulting in two sets of parens, for example: "app.action((1,2,3))". A string target can be specified this way as well: "app.action('target')". For strings, this third format must be used if * target value is empty or contains characters other than alphanumerics, '-' and '.'.

    Parameters

    • detailedName: string

      a detailed action name

    Returns [boolean, string, GLib.Variant]

  • actionPrintDetailedName(actionName: string, targetValue: GLib.Variant): string
  • Formats a detailed action name from action_name and target_value.

    It is an error to call this function with an invalid action name.

    This function is the opposite of g_action_parse_detailed_name(). It will produce a string that can be parsed back to the action_name and target_value by that function.

    See that function for the types of strings that will be printed by this function.

    Parameters

    • actionName: string

      a valid action name

    • targetValue: GLib.Variant

      a #GVariant target value, or %NULL

    Returns string

  • Creates a new #GAppInfo from the given information.

    Note that for commandline, the quoting rules of the Exec key of the freedesktop.org Desktop Entry Specification are applied. For example, if the commandline contains percent-encoded URIs, the percent-character must be doubled in order to prevent it from being swallowed by Exec key unquoting. See the specification for exact quoting rules.

    Parameters

    • commandline: string

      the commandline to use

    • applicationName: string

      the application name, or %NULL to use commandline

    • flags: AppInfoCreateFlags

      flags that can specify details of the created #GAppInfo

    Returns AppInfo

  • Gets a list of all of the applications currently registered on this system.

    For desktop files, this includes applications that have NoDisplay=true set or are excluded from display by means of OnlyShowIn or NotShowIn. See g_app_info_should_show(). The returned list does not include applications which have the Hidden key set.

    Returns AppInfo[]

  • appInfoGetAllForType(contentType: string): AppInfo[]
  • Gets a list of all #GAppInfos for a given content type, including the recommended and fallback #GAppInfos. See g_app_info_get_recommended_for_type() and g_app_info_get_fallback_for_type().

    Parameters

    • contentType: string

      the content type to find a #GAppInfo for

    Returns AppInfo[]

  • appInfoGetDefaultForType(contentType: string, mustSupportUris: boolean): AppInfo | null
  • Gets the default #GAppInfo for a given content type.

    Parameters

    • contentType: string

      the content type to find a #GAppInfo for

    • mustSupportUris: boolean

      if %TRUE, the #GAppInfo is expected to support URIs

    Returns AppInfo | null

  • appInfoGetDefaultForUriScheme(uriScheme: string): AppInfo | null
  • Gets the default application for handling URIs with the given URI scheme. A URI scheme is the initial part of the URI, up to but not including the ':', e.g. "http", "ftp" or "sip".

    Parameters

    • uriScheme: string

      a string containing a URI scheme.

    Returns AppInfo | null

  • appInfoGetFallbackForType(contentType: string): AppInfo[]
  • Gets a list of fallback #GAppInfos for a given content type, i.e. those applications which claim to support the given content type by MIME type subclassing and not directly.

    Parameters

    • contentType: string

      the content type to find a #GAppInfo for

    Returns AppInfo[]

  • appInfoGetRecommendedForType(contentType: string): AppInfo[]
  • Gets a list of recommended #GAppInfos for a given content type, i.e. those applications which claim to support the given content type exactly, and not by MIME type subclassing. Note that the first application of the list is the last used one, i.e. the last one for which g_app_info_set_as_last_used_for_type() has been called.

    Parameters

    • contentType: string

      the content type to find a #GAppInfo for

    Returns AppInfo[]

  • Utility function that launches the default application registered to handle the specified uri. Synchronous I/O is done on the uri to detect the type of the file if required.

    The D-Bus–activated applications don't have to be started if your application terminates too soon after this function. To prevent this, use g_app_info_launch_default_for_uri_async() instead.

    Parameters

    Returns boolean

  • Async version of g_app_info_launch_default_for_uri().

    This version is useful if you are interested in receiving error information in the case where the application is sandboxed and the portal may present an application chooser dialog to the user.

    This is also useful if you want to be sure that the D-Bus–activated applications are really started before termination and if you are interested in receiving error information from their activation.

    Parameters

    Returns void

  • appInfoLaunchDefaultForUriFinish(result: AsyncResult): boolean
  • Finishes an asynchronous launch-default-for-uri operation.

    Parameters

    Returns boolean

  • appInfoResetTypeAssociations(contentType: string): void
  • Removes all changes to the type associations done by g_app_info_set_as_default_for_type(), g_app_info_set_as_default_for_extension(), g_app_info_add_supports_type() or g_app_info_remove_supports_type().

    Parameters

    • contentType: string

      a content type

    Returns void

  • Helper function for constructing #GAsyncInitable object. This is similar to g_object_newv() but also initializes the object asynchronously.

    When the initialization is finished, callback will be called. You can then call g_async_initable_new_finish() to get the new object and check for any errors.

    Parameters

    • objectType: GType<unknown>

      a #GType supporting #GAsyncInitable.

    • nParameters: number

      the number of parameters in parameters

    • parameters: GObject.Parameter

      the parameters to use to construct the object

    • ioPriority: number

      the [I/O priority][io-priority] of the operation

    • cancellable: Gio.Cancellable

      optional #GCancellable object, %NULL to ignore.

    • callback: AsyncReadyCallback

      a #GAsyncReadyCallback to call when the initialization is finished

    Returns void

  • Asynchronously connects to the message bus specified by bus_type.

    When the operation is finished, callback will be invoked. You can then call g_bus_get_finish() to get the result of the operation.

    This is an asynchronous failable function. See g_bus_get_sync() for the synchronous version.

    Parameters

    Returns void

  • Finishes an operation started with g_bus_get().

    The returned object is a singleton, that is, shared with other callers of g_bus_get() and g_bus_get_sync() for bus_type. In the event that you need a private message bus connection, use g_dbus_address_get_for_bus_sync() and g_dbus_connection_new_for_address() with G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_CLIENT and G_DBUS_CONNECTION_FLAGS_MESSAGE_BUS_CONNECTION flags.

    Note that the returned #GDBusConnection object will (usually) have the #GDBusConnection:exit-on-close property set to %TRUE.

    Parameters

    • res: AsyncResult

      a #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_bus_get()

    Returns DBusConnection

  • Synchronously connects to the message bus specified by bus_type. Note that the returned object may shared with other callers, e.g. if two separate parts of a process calls this function with the same bus_type, they will share the same object.

    This is a synchronous failable function. See g_bus_get() and g_bus_get_finish() for the asynchronous version.

    The returned object is a singleton, that is, shared with other callers of g_bus_get() and g_bus_get_sync() for bus_type. In the event that you need a private message bus connection, use g_dbus_address_get_for_bus_sync() and g_dbus_connection_new_for_address() with G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_CLIENT and G_DBUS_CONNECTION_FLAGS_MESSAGE_BUS_CONNECTION flags.

    Note that the returned #GDBusConnection object will (usually) have the #GDBusConnection:exit-on-close property set to %TRUE.

    Parameters

    Returns DBusConnection

  • Version of g_bus_own_name() using closures instead of callbacks for easier binding in other languages.

    Parameters

    • busType: Gio.BusType

      the type of bus to own a name on

    • name: string

      the well-known name to own

    • flags: BusNameOwnerFlags

      a set of flags from the #GBusNameOwnerFlags enumeration

    • busAcquiredClosure: TClosure<any, any>

      #GClosure to invoke when connected to the bus of type bus_type or %NULL

    • nameAcquiredClosure: TClosure<any, any>

      #GClosure to invoke when name is acquired or %NULL

    • nameLostClosure: TClosure<any, any>

      #GClosure to invoke when name is lost or %NULL

    Returns number

  • Version of g_bus_own_name_on_connection() using closures instead of callbacks for easier binding in other languages.

    Parameters

    • connection: DBusConnection

      a #GDBusConnection

    • name: string

      the well-known name to own

    • flags: BusNameOwnerFlags

      a set of flags from the #GBusNameOwnerFlags enumeration

    • nameAcquiredClosure: TClosure<any, any>

      #GClosure to invoke when name is acquired or %NULL

    • nameLostClosure: TClosure<any, any>

      #GClosure to invoke when name is lost or %NULL

    Returns number

  • busUnownName(ownerId: number): void
  • Stops owning a name.

    Note that there may still be D-Bus traffic to process (relating to owning and unowning the name) in the current thread-default #GMainContext after this function has returned. You should continue to iterate the #GMainContext until the #GDestroyNotify function passed to g_bus_own_name() is called, in order to avoid memory leaks through callbacks queued on the #GMainContext after it’s stopped being iterated.

    Parameters

    • ownerId: number

      an identifier obtained from g_bus_own_name()

    Returns void

  • busUnwatchName(watcherId: number): void
  • Stops watching a name.

    Note that there may still be D-Bus traffic to process (relating to watching and unwatching the name) in the current thread-default #GMainContext after this function has returned. You should continue to iterate the #GMainContext until the #GDestroyNotify function passed to g_bus_watch_name() is called, in order to avoid memory leaks through callbacks queued on the #GMainContext after it’s stopped being iterated.

    Parameters

    • watcherId: number

      An identifier obtained from g_bus_watch_name()

    Returns void

  • Version of g_bus_watch_name() using closures instead of callbacks for easier binding in other languages.

    Parameters

    • busType: Gio.BusType

      The type of bus to watch a name on.

    • name: string

      The name (well-known or unique) to watch.

    • flags: BusNameWatcherFlags

      Flags from the #GBusNameWatcherFlags enumeration.

    • nameAppearedClosure: TClosure<any, any>

      #GClosure to invoke when name is known to exist or %NULL.

    • nameVanishedClosure: TClosure<any, any>

      #GClosure to invoke when name is known to not exist or %NULL.

    Returns number

  • Version of g_bus_watch_name_on_connection() using closures instead of callbacks for easier binding in other languages.

    Parameters

    • connection: DBusConnection

      A #GDBusConnection.

    • name: string

      The name (well-known or unique) to watch.

    • flags: BusNameWatcherFlags

      Flags from the #GBusNameWatcherFlags enumeration.

    • nameAppearedClosure: TClosure<any, any>

      #GClosure to invoke when name is known to exist or %NULL.

    • nameVanishedClosure: TClosure<any, any>

      #GClosure to invoke when name is known to not exist or %NULL.

    Returns number

  • contentTypeCanBeExecutable(type: string): boolean
  • Checks if a content type can be executable. Note that for instance things like text files can be executables (i.e. scripts and batch files).

    Parameters

    • type: string

      a content type string

    Returns boolean

  • contentTypeEquals(type1: string, type2: string): boolean
  • Compares two content types for equality.

    Parameters

    • type1: string

      a content type string

    • type2: string

      a content type string

    Returns boolean

  • contentTypeFromMimeType(mimeType: string): string | null
  • Tries to find a content type based on the mime type name.

    Parameters

    • mimeType: string

      a mime type string

    Returns string | null

  • contentTypeGetDescription(type: string): string
  • Gets the human readable description of the content type.

    Parameters

    • type: string

      a content type string

    Returns string

  • contentTypeGetGenericIconName(type: string): string | null
  • Gets the generic icon name for a content type.

    See the shared-mime-info specification for more on the generic icon name.

    Parameters

    • type: string

      a content type string

    Returns string | null

  • contentTypeGetIcon(type: string): Gio.Icon
  • Gets the icon for a content type.

    Parameters

    • type: string

      a content type string

    Returns Gio.Icon

  • contentTypeGetMimeDirs(): string[]
  • Get the list of directories which MIME data is loaded from. See g_content_type_set_mime_dirs() for details.

    Returns string[]

  • contentTypeGetMimeType(type: string): string | null
  • Gets the mime type for the content type, if one is registered.

    Parameters

    • type: string

      a content type string

    Returns string | null

  • contentTypeGetSymbolicIcon(type: string): Gio.Icon
  • Gets the symbolic icon for a content type.

    Parameters

    • type: string

      a content type string

    Returns Gio.Icon

  • contentTypeGuess(filename: string, data: Uint8Array): [string, boolean]
  • Guesses the content type based on example data. If the function is uncertain, result_uncertain will be set to %TRUE. Either filename or data may be %NULL, in which case the guess will be based solely on the other argument.

    Parameters

    • filename: string

      a path, or %NULL

    • data: Uint8Array

      a stream of data, or %NULL

    Returns [string, boolean]

  • contentTypeGuessForTree(root: Gio.File): string[]
  • Tries to guess the type of the tree with root root, by looking at the files it contains. The result is an array of content types, with the best guess coming first.

    The types returned all have the form x-content/foo, e.g. x-content/audio-cdda (for audio CDs) or x-content/image-dcf (for a camera memory card). See the shared-mime-info specification for more on x-content types.

    This function is useful in the implementation of g_mount_guess_content_type().

    Parameters

    • root: Gio.File

      the root of the tree to guess a type for

    Returns string[]

  • contentTypeIsA(type: string, supertype: string): boolean
  • Determines if type is a subset of supertype.

    Parameters

    • type: string

      a content type string

    • supertype: string

      a content type string

    Returns boolean

  • contentTypeIsMimeType(type: string, mimeType: string): boolean
  • Determines if type is a subset of mime_type. Convenience wrapper around g_content_type_is_a().

    Parameters

    • type: string

      a content type string

    • mimeType: string

      a mime type string

    Returns boolean

  • contentTypeIsUnknown(type: string): boolean
  • Checks if the content type is the generic "unknown" type. On UNIX this is the "application/octet-stream" mimetype, while on win32 it is "*" and on OSX it is a dynamic type or octet-stream.

    Parameters

    • type: string

      a content type string

    Returns boolean

  • contentTypeSetMimeDirs(dirs: string[]): void
  • Set the list of directories used by GIO to load the MIME database. If dirs is %NULL, the directories used are the default:

    • the mime subdirectory of the directory in $XDG_DATA_HOME
    • the mime subdirectory of every directory in $XDG_DATA_DIRS

    This function is intended to be used when writing tests that depend on information stored in the MIME database, in order to control the data.

    Typically, in case your tests use %G_TEST_OPTION_ISOLATE_DIRS, but they depend on the system’s MIME database, you should call this function with dirs set to %NULL before calling g_test_init(), for instance:

      // Load MIME data from the system
    g_content_type_set_mime_dirs (NULL);
    // Isolate the environment
    g_test_init (&argc, &argv, G_TEST_OPTION_ISOLATE_DIRS, NULL);

    …

    return g_test_run ();

    Parameters

    • dirs: string[]

      %NULL-terminated list of directories to load MIME data from, including any mime/ subdirectory, and with the first directory to try listed first

    Returns void

  • contentTypesGetRegistered(): string[]
  • Gets a list of strings containing all the registered content types known to the system. The list and its data should be freed using g_list_free_full (list, g_free).

    Returns string[]

  • dbusAddressEscapeValue(string: string): string
  • Escape string so it can appear in a D-Bus address as the value part of a key-value pair.

    For instance, if string is /run/bus-for-:0, this function would return /run/bus-for-%3A0, which could be used in a D-Bus address like unix:nonce-tcp:host=127.0.0.1,port=42,noncefile=/run/bus-for-%3A0.

    Parameters

    • string: string

      an unescaped string to be included in a D-Bus address as the value in a key-value pair

    Returns string

  • Synchronously looks up the D-Bus address for the well-known message bus instance specified by bus_type. This may involve using various platform specific mechanisms.

    The returned address will be in the D-Bus address format.

    Parameters

    Returns string

  • Asynchronously connects to an endpoint specified by address and sets up the connection so it is in a state to run the client-side of the D-Bus authentication conversation. address must be in the D-Bus address format.

    When the operation is finished, callback will be invoked. You can then call g_dbus_address_get_stream_finish() to get the result of the operation.

    This is an asynchronous failable function. See g_dbus_address_get_stream_sync() for the synchronous version.

    Parameters

    • address: string

      A valid D-Bus address.

    • cancellable: Gio.Cancellable

      A #GCancellable or %NULL.

    • callback: AsyncReadyCallback

      A #GAsyncReadyCallback to call when the request is satisfied.

    Returns void

  • Finishes an operation started with g_dbus_address_get_stream().

    A server is not required to set a GUID, so out_guid may be set to %NULL even on success.

    Parameters

    • res: AsyncResult

      A #GAsyncResult obtained from the GAsyncReadyCallback passed to g_dbus_address_get_stream().

    Returns [IOStream, string | null]

  • Synchronously connects to an endpoint specified by address and sets up the connection so it is in a state to run the client-side of the D-Bus authentication conversation. address must be in the D-Bus address format.

    A server is not required to set a GUID, so out_guid may be set to %NULL even on success.

    This is a synchronous failable function. See g_dbus_address_get_stream() for the asynchronous version.

    Parameters

    • address: string

      A valid D-Bus address.

    • cancellable: Gio.Cancellable

      A #GCancellable or %NULL.

    Returns [IOStream, string | null]

  • Looks up the value of an annotation.

    The cost of this function is O(n) in number of annotations.

    Parameters

    • annotations: DBusAnnotationInfo[]

      A %NULL-terminated array of annotations or %NULL.

    • name: string

      The name of the annotation to look up.

    Returns string | null

  • dbusErrorEncodeGerror(error: GLib.Error): string
  • Creates a D-Bus error name to use for error. If error matches a registered error (cf. g_dbus_error_register_error()), the corresponding D-Bus error name will be returned.

    Otherwise the a name of the form org.gtk.GDBus.UnmappedGError.Quark._ESCAPED_QUARK_NAME.Code_ERROR_CODE will be used. This allows other GDBus applications to map the error on the wire back to a #GError using g_dbus_error_new_for_dbus_error().

    This function is typically only used in object mappings to put a #GError on the wire. Regular applications should not use it.

    Parameters

    Returns string

  • dbusErrorGetRemoteError(error: GLib.Error): string | null
  • Gets the D-Bus error name used for error, if any.

    This function is guaranteed to return a D-Bus error name for all #GErrors returned from functions handling remote method calls (e.g. g_dbus_connection_call_finish()) unless g_dbus_error_strip_remote_error() has been used on error.

    Parameters

    Returns string | null

  • dbusErrorIsRemoteError(error: GLib.Error): boolean
  • Checks if error represents an error received via D-Bus from a remote peer. If so, use g_dbus_error_get_remote_error() to get the name of the error.

    Parameters

    Returns boolean

  • dbusErrorNewForDbusError(dbusErrorName: string, dbusErrorMessage: string): GLib.Error
  • Creates a #GError based on the contents of dbus_error_name and dbus_error_message.

    Errors registered with g_dbus_error_register_error() will be looked up using dbus_error_name and if a match is found, the error domain and code is used. Applications can use g_dbus_error_get_remote_error() to recover dbus_error_name.

    If a match against a registered error is not found and the D-Bus error name is in a form as returned by g_dbus_error_encode_gerror() the error domain and code encoded in the name is used to create the #GError. Also, dbus_error_name is added to the error message such that it can be recovered with g_dbus_error_get_remote_error().

    Otherwise, a #GError with the error code %G_IO_ERROR_DBUS_ERROR in the %G_IO_ERROR error domain is returned. Also, dbus_error_name is added to the error message such that it can be recovered with g_dbus_error_get_remote_error().

    In all three cases, dbus_error_name can always be recovered from the returned #GError using the g_dbus_error_get_remote_error() function (unless g_dbus_error_strip_remote_error() hasn't been used on the returned error).

    This function is typically only used in object mappings to prepare #GError instances for applications. Regular applications should not use it.

    Parameters

    • dbusErrorName: string

      D-Bus error name.

    • dbusErrorMessage: string

      D-Bus error message.

    Returns GLib.Error

  • dbusErrorRegisterError(errorDomain: number, errorCode: number, dbusErrorName: string): boolean
  • Creates an association to map between dbus_error_name and #GErrors specified by error_domain and error_code.

    This is typically done in the routine that returns the #GQuark for an error domain.

    Parameters

    • errorDomain: number

      A #GQuark for an error domain.

    • errorCode: number

      An error code.

    • dbusErrorName: string

      A D-Bus error name.

    Returns boolean

  • dbusErrorRegisterErrorDomain(errorDomainQuarkName: string, quarkVolatile: number, entries: DBusErrorEntry[]): void
  • Helper function for associating a #GError error domain with D-Bus error names.

    While quark_volatile has a volatile qualifier, this is a historical artifact and the argument passed to it should not be volatile.

    Parameters

    • errorDomainQuarkName: string

      The error domain name.

    • quarkVolatile: number

      A pointer where to store the #GQuark.

    • entries: DBusErrorEntry[]

      A pointer to num_entries #GDBusErrorEntry struct items.

    Returns void

  • dbusErrorStripRemoteError(error: GLib.Error): boolean
  • Looks for extra information in the error message used to recover the D-Bus error name and strips it if found. If stripped, the message field in error will correspond exactly to what was received on the wire.

    This is typically used when presenting errors to the end user.

    Parameters

    Returns boolean

  • dbusErrorUnregisterError(errorDomain: number, errorCode: number, dbusErrorName: string): boolean
  • Destroys an association previously set up with g_dbus_error_register_error().

    Parameters

    • errorDomain: number

      A #GQuark for an error domain.

    • errorCode: number

      An error code.

    • dbusErrorName: string

      A D-Bus error name.

    Returns boolean

  • dbusEscapeObjectPath(s: string): string
  • This is a language binding friendly version of g_dbus_escape_object_path_bytestring().

    Parameters

    • s: string

      the string to escape

    Returns string

  • dbusEscapeObjectPathBytestring(bytes: Uint8Array): string
  • Escapes bytes for use in a D-Bus object path component. bytes is an array of zero or more nonzero bytes in an unspecified encoding, followed by a single zero byte.

    The escaping method consists of replacing all non-alphanumeric characters (see g_ascii_isalnum()) with their hexadecimal value preceded by an underscore (_). For example: foo.bar.baz will become foo_2ebar_2ebaz.

    This method is appropriate to use when the input is nearly a valid object path component but is not when your input is far from being a valid object path component. Other escaping algorithms are also valid to use with D-Bus object paths.

    This can be reversed with g_dbus_unescape_object_path().

    Parameters

    • bytes: Uint8Array

      the string of bytes to escape

    Returns string

  • dbusGenerateGuid(): string
  • Generate a D-Bus GUID that can be used with e.g. g_dbus_connection_new().

    See the D-Bus specification regarding what strings are valid D-Bus GUIDs. The specification refers to these as ‘UUIDs’ whereas GLib (for historical reasons) refers to them as ‘GUIDs’. The terms are interchangeable.

    Note that D-Bus GUIDs do not follow RFC 4122.

    Returns string

  • Converts a #GValue to a #GVariant of the type indicated by the type parameter.

    The conversion is using the following rules:

    • G_TYPE_STRING: 's', 'o', 'g' or 'ay'
    • G_TYPE_STRV: 'as', 'ao' or 'aay'
    • G_TYPE_BOOLEAN: 'b'
    • G_TYPE_UCHAR: 'y'
    • G_TYPE_INT: 'i', 'n'
    • G_TYPE_UINT: 'u', 'q'
    • G_TYPE_INT64: 'x'
    • G_TYPE_UINT64: 't'
    • G_TYPE_DOUBLE: 'd'
    • G_TYPE_VARIANT: Any #GVariantType

    This can fail if e.g. gvalue is of type %G_TYPE_STRING and type is 'i', i.e. %G_VARIANT_TYPE_INT32. It will also fail for any #GType (including e.g. %G_TYPE_OBJECT and %G_TYPE_BOXED derived-types) not in the table above.

    Note that if gvalue is of type %G_TYPE_VARIANT and its value is %NULL, the empty #GVariant instance (never %NULL) for type is returned (e.g. 0 for scalar types, the empty string for string types, '/' for object path types, the empty array for any array type and so on).

    See the g_dbus_gvariant_to_gvalue() function for how to convert a #GVariant to a #GValue.

    Parameters

    • gvalue: any

      A #GValue to convert to a #GVariant

    • type: VariantType

      A #GVariantType

    Returns GLib.Variant

  • Converts a #GVariant to a #GValue. If value is floating, it is consumed.

    The rules specified in the g_dbus_gvalue_to_gvariant() function are used - this function is essentially its reverse form. So, a #GVariant containing any basic or string array type will be converted to a #GValue containing a basic value or string array. Any other #GVariant (handle, variant, tuple, dict entry) will be converted to a #GValue containing that #GVariant.

    The conversion never fails - a valid #GValue is always returned in out_gvalue.

    Parameters

    Returns any

  • dbusIsAddress(string: string): boolean
  • Checks if string is a D-Bus address.

    This doesn't check if string is actually supported by #GDBusServer or #GDBusConnection - use g_dbus_is_supported_address() to do more checks.

    Parameters

    • string: string

      A string.

    Returns boolean

  • dbusIsErrorName(string: string): boolean
  • Check whether string is a valid D-Bus error name.

    This function returns the same result as g_dbus_is_interface_name(), because D-Bus error names are defined to have exactly the same syntax as interface names.

    Parameters

    • string: string

      The string to check.

    Returns boolean

  • dbusIsGuid(string: string): boolean
  • Checks if string is a D-Bus GUID.

    See the documentation for g_dbus_generate_guid() for more information about the format of a GUID.

    Parameters

    • string: string

      The string to check.

    Returns boolean

  • dbusIsInterfaceName(string: string): boolean
  • Checks if string is a valid D-Bus interface name.

    Parameters

    • string: string

      The string to check.

    Returns boolean

  • dbusIsMemberName(string: string): boolean
  • Checks if string is a valid D-Bus member (e.g. signal or method) name.

    Parameters

    • string: string

      The string to check.

    Returns boolean

  • dbusIsName(string: string): boolean
  • Checks if string is a valid D-Bus bus name (either unique or well-known).

    Parameters

    • string: string

      The string to check.

    Returns boolean

  • dbusIsSupportedAddress(string: string): boolean
  • Like g_dbus_is_address() but also checks if the library supports the transports in string and that key/value pairs for each transport are valid. See the specification of the D-Bus address format.

    Parameters

    • string: string

      A string.

    Returns boolean

  • dbusIsUniqueName(string: string): boolean
  • Checks if string is a valid D-Bus unique bus name.

    Parameters

    • string: string

      The string to check.

    Returns boolean

  • dbusUnescapeObjectPath(s: string): Uint8Array | null
  • Unescapes an string that was previously escaped with g_dbus_escape_object_path(). If the string is in a format that could not have been returned by g_dbus_escape_object_path(), this function returns %NULL.

    Encoding alphanumeric characters which do not need to be encoded is not allowed (e.g _63 is not valid, the string should contain c instead).

    Parameters

    • s: string

      the string to unescape

    Returns Uint8Array | null

  • fileNewForCommandlineArg(arg: string): Gio.File
  • Creates a #GFile with the given argument from the command line. The value of arg can be either a URI, an absolute path or a relative path resolved relative to the current working directory. This operation never fails, but the returned object might not support any I/O operation if arg points to a malformed path.

    Note that on Windows, this function expects its argument to be in UTF-8 -- not the system code page. This means that you should not use this function with string from argv as it is passed to main(). g_win32_get_command_line() will return a UTF-8 version of the commandline. #GApplication also uses UTF-8 but g_application_command_line_create_file_for_arg() may be more useful for you there. It is also always possible to use this function with #GOptionContext arguments of type %G_OPTION_ARG_FILENAME.

    Parameters

    • arg: string

      a command line string

    Returns Gio.File

  • fileNewForCommandlineArgAndCwd(arg: string, cwd: string): Gio.File
  • Creates a #GFile with the given argument from the command line.

    This function is similar to g_file_new_for_commandline_arg() except that it allows for passing the current working directory as an argument instead of using the current working directory of the process.

    This is useful if the commandline argument was given in a context other than the invocation of the current process.

    See also g_application_command_line_create_file_for_arg().

    Parameters

    • arg: string

      a command line string

    • cwd: string

      the current working directory of the commandline

    Returns Gio.File

  • fileNewForPath(path: string): Gio.File
  • Constructs a #GFile for a given path. This operation never fails, but the returned object might not support any I/O operation if path is malformed.

    Parameters

    • path: string

      a string containing a relative or absolute path. The string must be encoded in the glib filename encoding.

    Returns Gio.File

  • fileNewForUri(uri: string): Gio.File
  • Constructs a #GFile for a given URI. This operation never fails, but the returned object might not support any I/O operation if uri is malformed or if the uri type is not supported.

    Parameters

    • uri: string

      a UTF-8 string containing a URI

    Returns Gio.File

  • Opens a file in the preferred directory for temporary files (as returned by g_get_tmp_dir()) and returns a #GFile and #GFileIOStream pointing to it.

    tmpl should be a string in the GLib file name encoding containing a sequence of six 'X' characters, and containing no directory components. If it is %NULL, a default template is used.

    Unlike the other #GFile constructors, this will return %NULL if a temporary file could not be created.

    Parameters

    • tmpl: string

      Template for the file name, as in g_file_open_tmp(), or %NULL for a default template

    Returns [Gio.File, FileIOStream]

  • fileParseName(parseName: string): Gio.File
  • Constructs a #GFile with the given parse_name (i.e. something given by g_file_get_parse_name()). This operation never fails, but the returned object might not support any I/O operation if the parse_name cannot be parsed.

    Parameters

    • parseName: string

      a file name or path to be parsed

    Returns Gio.File

  • Deserializes a #GIcon previously serialized using g_icon_serialize().

    Parameters

    • value: GLib.Variant

      a #GVariant created with g_icon_serialize()

    Returns Gio.Icon | null

  • iconHash(icon: object): number
  • Gets a hash for an icon.

    Parameters

    • icon: object

      #gconstpointer to an icon object.

    Returns number

  • iconNewForString(str: string): Gio.Icon
  • Generate a #GIcon instance from str. This function can fail if str is not valid - see g_icon_to_string() for discussion.

    If your application or library provides one or more #GIcon implementations you need to ensure that each #GType is registered with the type system prior to calling g_icon_new_for_string().

    Parameters

    • str: string

      A string obtained via g_icon_to_string().

    Returns Gio.Icon

  • Helper function for constructing #GInitable object. This is similar to g_object_newv() but also initializes the object and returns %NULL, setting an error on failure.

    Parameters

    • objectType: GType<unknown>

      a #GType supporting #GInitable.

    • parameters: GObject.Parameter[]

      the parameters to use to construct the object

    • cancellable: Gio.Cancellable

      optional #GCancellable object, %NULL to ignore.

    Returns GObject.Object

  • Converts errno.h error codes into GIO error codes. The fallback value %G_IO_ERROR_FAILED is returned for error codes not currently handled (but note that future GLib releases may return a more specific value instead).

    As %errno is global and may be modified by intermediate function calls, you should save its value as soon as the call which sets it

    Parameters

    • errNo: number

      Error number as defined in errno.h.

    Returns IOErrorEnum

  • ioExtensionPointImplement(extensionPointName: string, type: GType<unknown>, extensionName: string, priority: number): IOExtension
  • Registers type as extension for the extension point with name extension_point_name.

    If type has already been registered as an extension for this extension point, the existing #GIOExtension object is returned.

    Parameters

    • extensionPointName: string

      the name of the extension point

    • type: GType<unknown>

      the #GType to register as extension

    • extensionName: string

      the name for the extension

    • priority: number

      the priority for the extension

    Returns IOExtension

  • ioModulesLoadAllInDirectory(dirname: string): IOModule[]
  • Loads all the modules in the specified directory.

    If don't require all modules to be initialized (and thus registering all gtypes) then you can use g_io_modules_scan_all_in_directory() which allows delayed/lazy loading of modules.

    Parameters

    • dirname: string

      pathname for a directory containing modules to load.

    Returns IOModule[]

  • Loads all the modules in the specified directory.

    If don't require all modules to be initialized (and thus registering all gtypes) then you can use g_io_modules_scan_all_in_directory() which allows delayed/lazy loading of modules.

    Parameters

    • dirname: string

      pathname for a directory containing modules to load.

    • scope: IOModuleScope

      a scope to use when scanning the modules.

    Returns IOModule[]

  • ioModulesScanAllInDirectory(dirname: string): void
  • Scans all the modules in the specified directory, ensuring that any extension point implemented by a module is registered.

    This may not actually load and initialize all the types in each module, some modules may be lazily loaded and initialized when an extension point it implements is used with e.g. g_io_extension_point_get_extensions() or g_io_extension_point_get_extension_by_name().

    If you need to guarantee that all types are loaded in all the modules, use g_io_modules_load_all_in_directory().

    Parameters

    • dirname: string

      pathname for a directory containing modules to scan.

    Returns void

  • ioModulesScanAllInDirectoryWithScope(dirname: string, scope: IOModuleScope): void
  • Scans all the modules in the specified directory, ensuring that any extension point implemented by a module is registered.

    This may not actually load and initialize all the types in each module, some modules may be lazily loaded and initialized when an extension point it implements is used with e.g. g_io_extension_point_get_extensions() or g_io_extension_point_get_extension_by_name().

    If you need to guarantee that all types are loaded in all the modules, use g_io_modules_load_all_in_directory().

    Parameters

    • dirname: string

      pathname for a directory containing modules to scan.

    • scope: IOModuleScope

      a scope to use when scanning the modules

    Returns void

  • ioSchedulerCancelAllJobs(): void
  • Cancels all cancellable I/O jobs.

    A job is cancellable if a #GCancellable was passed into g_io_scheduler_push_job().

    Returns void

  • Schedules the I/O job to run in another thread.

    notify will be called on user_data after job_func has returned, regardless whether the job was cancelled or has run to completion.

    If cancellable is not %NULL, it can be used to cancel the I/O job by calling g_cancellable_cancel() or by calling g_io_scheduler_cancel_all_jobs().

    Parameters

    • jobFunc: IOSchedulerJobFunc

      a #GIOSchedulerJobFunc.

    • ioPriority: number

      the [I/O priority][io-priority] of the request.

    • cancellable: Gio.Cancellable

      optional #GCancellable object, %NULL to ignore.

    Returns void

  • keyfileSettingsBackendNew(filename: string, rootPath: string, rootGroup: string): SettingsBackend
  • Creates a keyfile-backed #GSettingsBackend.

    The filename of the keyfile to use is given by filename.

    All settings read to or written from the backend must fall under the path given in root_path (which must start and end with a slash and not contain two consecutive slashes). root_path may be "/".

    If root_group is non-%NULL then it specifies the name of the keyfile group used for keys that are written directly below root_path. For example, if root_path is "/apps/example/" and root_group is "toplevel", then settings the key "/apps/example/enabled" to a value of %TRUE will cause the following to appear in the keyfile:

    |[ [toplevel] enabled=true



    If `root_group` is %NULL then it is not permitted to store keys
    directly below the `root_path`.

    For keys not stored directly below `root_path` (ie: in a sub-path),
    the name of the subpath (with the final slash stripped) is used as
    the name of the keyfile group. To continue the example, if
    "/apps/example/profiles/default/font-size" were set to
    12 then the following would appear in the keyfile:

    |[
    [profiles/default]
    font-size=12

    The backend will refuse writes (and return writability as being %FALSE) for keys outside of root_path and, in the event that root_group is %NULL, also for keys directly under root_path. Writes will also be refused if the backend detects that it has the inability to rewrite the keyfile (ie: the containing directory is not writable).

    There is no checking done for your key namespace clashing with the syntax of the key file format. For example, if you have '[' or ']' characters in your path names or '=' in your key names you may be in trouble.

    The backend reads default values from a keyfile called defaults in the directory specified by the #GKeyfileSettingsBackend:defaults-dir property, and a list of locked keys from a text file with the name locks in the same location.

    Parameters

    • filename: string

      the filename of the keyfile

    • rootPath: string

      the path under which all settings keys appear

    • rootGroup: string

      the group name corresponding to root_path, or %NULL

    Returns SettingsBackend

  • Creates a memory-backed #GSettingsBackend.

    This backend allows changes to settings, but does not write them to any backing storage, so the next time you run your application, the memory backend will start out with the default values again.

    Returns SettingsBackend

  • networkingInit(): void
  • Initializes the platform networking libraries (eg, on Windows, this calls WSAStartup()). GLib will call this itself if it is needed, so you only need to call it if you directly call system networking functions (without calling any GLib networking functions first).

    Returns void

  • Creates a readonly #GSettingsBackend.

    This backend does not allow changes to settings, so all settings will always have their default values.

    Returns SettingsBackend

  • Utility method for #GPollableInputStream and #GPollableOutputStream implementations. Creates a new #GSource that expects a callback of type #GPollableSourceFunc. The new source does not actually do anything on its own; use g_source_add_child_source() to add other sources to it to cause it to trigger.

    Parameters

    • pollableStream: GObject.Object

      the stream associated with the new source

    Returns GLib.Source

  • Utility method for #GPollableInputStream and #GPollableOutputStream implementations. Creates a new #GSource, as with g_pollable_source_new(), but also attaching child_source (with a dummy callback), and cancellable, if they are non-%NULL.

    Parameters

    • pollableStream: GObject.Object

      the stream associated with the new source

    • childSource: GLib.Source

      optional child source to attach

    • cancellable: Gio.Cancellable

      optional #GCancellable to attach

    Returns GLib.Source

  • Tries to read from stream, as with g_input_stream_read() (if blocking is %TRUE) or g_pollable_input_stream_read_nonblocking() (if blocking is %FALSE). This can be used to more easily share code between blocking and non-blocking implementations of a method.

    If blocking is %FALSE, then stream must be a #GPollableInputStream for which g_pollable_input_stream_can_poll() returns %TRUE, or else the behavior is undefined. If blocking is %TRUE, then stream does not need to be a #GPollableInputStream.

    Parameters

    • stream: Gio.InputStream

      a #GInputStream

    • buffer: Uint8Array

      a buffer to read data into

    • blocking: boolean

      whether to do blocking I/O

    • cancellable: Gio.Cancellable

      optional #GCancellable object, %NULL to ignore.

    Returns number

  • Tries to write to stream, as with g_output_stream_write() (if blocking is %TRUE) or g_pollable_output_stream_write_nonblocking() (if blocking is %FALSE). This can be used to more easily share code between blocking and non-blocking implementations of a method.

    If blocking is %FALSE, then stream must be a #GPollableOutputStream for which g_pollable_output_stream_can_poll() returns %TRUE or else the behavior is undefined. If blocking is %TRUE, then stream does not need to be a #GPollableOutputStream.

    Parameters

    • stream: Gio.OutputStream

      a #GOutputStream.

    • buffer: Uint8Array

      the buffer containing the data to write.

    • blocking: boolean

      whether to do blocking I/O

    • cancellable: Gio.Cancellable

      optional #GCancellable object, %NULL to ignore.

    Returns number

  • Tries to write count bytes to stream, as with g_output_stream_write_all(), but using g_pollable_stream_write() rather than g_output_stream_write().

    On a successful write of count bytes, %TRUE is returned, and bytes_written is set to count.

    If there is an error during the operation (including %G_IO_ERROR_WOULD_BLOCK in the non-blocking case), %FALSE is returned and error is set to indicate the error status, bytes_written is updated to contain the number of bytes written into the stream before the error occurred.

    As with g_pollable_stream_write(), if blocking is %FALSE, then stream must be a #GPollableOutputStream for which g_pollable_output_stream_can_poll() returns %TRUE or else the behavior is undefined. If blocking is %TRUE, then stream does not need to be a #GPollableOutputStream.

    Parameters

    • stream: Gio.OutputStream

      a #GOutputStream.

    • buffer: Uint8Array

      the buffer containing the data to write.

    • blocking: boolean

      whether to do blocking I/O

    • cancellable: Gio.Cancellable

      optional #GCancellable object, %NULL to ignore.

    Returns [boolean, number]

  • proxyGetDefaultForProtocol(protocol: string): Gio.Proxy | null
  • Find the gio-proxy extension point for a proxy implementation that supports the specified protocol.

    Parameters

    • protocol: string

      the proxy protocol name (e.g. http, socks, etc)

    Returns Gio.Proxy | null

  • resolverErrorQuark(): Quark
  • resourceErrorQuark(): Quark
  • Loads a binary resource bundle and creates a #GResource representation of it, allowing you to query it for data.

    If you want to use this resource in the global resource namespace you need to register it with g_resources_register().

    If filename is empty or the data in it is corrupt, %G_RESOURCE_ERROR_INTERNAL will be returned. If filename doesn’t exist, or there is an error in reading it, an error from g_mapped_file_new() will be returned.

    Parameters

    • filename: string

      the path of a filename to load, in the GLib filename encoding

    Returns Gio.Resource

  • Returns all the names of children at the specified path in the set of globally registered resources. The return result is a %NULL terminated list of strings which should be released with g_strfreev().

    lookup_flags controls the behaviour of the lookup.

    Parameters

    • path: string

      A pathname inside the resource

    • lookupFlags: ResourceLookupFlags

      A #GResourceLookupFlags

    Returns string[]

  • Looks for a file at the specified path in the set of globally registered resources and if found returns information about it.

    lookup_flags controls the behaviour of the lookup.

    Parameters

    • path: string

      A pathname inside the resource

    • lookupFlags: ResourceLookupFlags

      A #GResourceLookupFlags

    Returns [boolean, number, number]

  • Looks for a file at the specified path in the set of globally registered resources and returns a #GBytes that lets you directly access the data in memory.

    The data is always followed by a zero byte, so you can safely use the data as a C string. However, that byte is not included in the size of the GBytes.

    For uncompressed resource files this is a pointer directly into the resource bundle, which is typically in some readonly data section in the program binary. For compressed files we allocate memory on the heap and automatically uncompress the data.

    lookup_flags controls the behaviour of the lookup.

    Parameters

    • path: string

      A pathname inside the resource

    • lookupFlags: ResourceLookupFlags

      A #GResourceLookupFlags

    Returns any

  • Looks for a file at the specified path in the set of globally registered resources and returns a #GInputStream that lets you read the data.

    lookup_flags controls the behaviour of the lookup.

    Parameters

    • path: string

      A pathname inside the resource

    • lookupFlags: ResourceLookupFlags

      A #GResourceLookupFlags

    Returns Gio.InputStream

  • Registers the resource with the process-global set of resources. Once a resource is registered the files in it can be accessed with the global resource lookup functions like g_resources_lookup_data().

    Parameters

    Returns void

  • Unregisters the resource from the process-global set of resources.

    Parameters

    Returns void

  • Gets the default system schema source.

    This function is not required for normal uses of #GSettings but it may be useful to authors of plugin management systems or to those who want to introspect the content of schemas.

    If no schemas are installed, %NULL will be returned.

    The returned source may actually consist of multiple schema sources from different directories, depending on which directories were given in XDG_DATA_DIRS and GSETTINGS_SCHEMA_DIR. For this reason, all lookups performed against the default source should probably be done recursively.

    Returns SettingsSchemaSource | null

  • Reports an error in an idle function. Similar to g_simple_async_report_error_in_idle(), but takes a #GError rather than building a new one.

    Parameters

    Returns void

  • tlsChannelBindingErrorQuark(): Quark
  • Creates a new #GTlsClientConnection wrapping base_io_stream (which must have pollable input and output streams) which is assumed to communicate with the server identified by server_identity.

    See the documentation for #GTlsConnection:base-io-stream for restrictions on when application code can run operations on the base_io_stream after this function has returned.

    Parameters

    Returns TlsClientConnection

  • Creates a new #GTlsFileDatabase which uses anchor certificate authorities in anchors to verify certificate chains.

    The certificates in anchors must be PEM encoded.

    Parameters

    • anchors: string

      filename of anchor certificate authorities.

    Returns TlsFileDatabase

  • Creates a new #GTlsServerConnection wrapping base_io_stream (which must have pollable input and output streams).

    See the documentation for #GTlsConnection:base-io-stream for restrictions on when application code can run operations on the base_io_stream after this function has returned.

    Parameters

    • baseIoStream: IOStream

      the #GIOStream to wrap

    • certificate: TlsCertificate

      the default server certificate, or %NULL

    Returns TlsServerConnection

  • unixIsMountPathSystemInternal(mountPath: string): boolean
  • Determines if mount_path is considered an implementation of the OS. This is primarily used for hiding mountable and mounted volumes that only are used in the OS and has little to no relevance to the casual user.

    Parameters

    • mountPath: string

      a mount path, e.g. /media/disk or /usr

    Returns boolean

  • unixIsSystemDevicePath(devicePath: string): boolean
  • Determines if device_path is considered a block device path which is only used in implementation of the OS. This is primarily used for hiding mounted volumes that are intended as APIs for programs to read, and system administrators at a shell; rather than something that should, for example, appear in a GUI. For example, the Linux /proc filesystem.

    The list of device paths considered ‘system’ ones may change over time.

    Parameters

    • devicePath: string

      a device path, e.g. /dev/loop0 or nfsd

    Returns boolean

  • unixIsSystemFsType(fsType: string): boolean
  • Determines if fs_type is considered a type of file system which is only used in implementation of the OS. This is primarily used for hiding mounted volumes that are intended as APIs for programs to read, and system administrators at a shell; rather than something that should, for example, appear in a GUI. For example, the Linux /proc filesystem.

    The list of file system types considered ‘system’ ones may change over time.

    Parameters

    • fsType: string

      a file system type, e.g. procfs or tmpfs

    Returns boolean

  • Gets a #GUnixMountEntry for a given mount path. If time_read is set, it will be filled with a unix timestamp for checking if the mounts have changed since with g_unix_mounts_changed_since().

    If more mounts have the same mount path, the last matching mount is returned.

    This will return %NULL if there is no mount point at mount_path.

    Parameters

    • mountPath: string

      path for a possible unix mount.

    Returns [UnixMountEntry | null, number]

  • Gets a #GUnixMountEntry for a given file path. If time_read is set, it will be filled with a unix timestamp for checking if the mounts have changed since with g_unix_mounts_changed_since().

    If more mounts have the same mount path, the last matching mount is returned.

    This will return %NULL if looking up the mount entry fails, if file_path doesn’t exist or there is an I/O error.

    Parameters

    • filePath: string

      file path on some unix mount.

    Returns [UnixMountEntry | null, number]

  • Gets the mount path for a unix mount.

    Parameters

    • mountEntry: UnixMountEntry

      input #GUnixMountEntry to get the mount path for.

    Returns string

  • Gets a comma-separated list of mount options for the unix mount. For example, rw,relatime,seclabel,data=ordered.

    This is similar to g_unix_mount_point_get_options(), but it takes a #GUnixMountEntry as an argument.

    Parameters

    Returns string | null

  • Gets the root of the mount within the filesystem. This is useful e.g. for mounts created by bind operation, or btrfs subvolumes.

    For example, the root path is equal to "/" for mount created by "mount /dev/sda1 /mnt/foo" and "/bar" for "mount --bind /mnt/foo/bar /mnt/bar".

    Parameters

    Returns string | null

  • Guesses the name of a Unix mount. The result is a translated string.

    Parameters

    Returns string

  • Guesses whether a Unix mount should be displayed in the UI.

    Parameters

    Returns boolean

  • Checks if a Unix mount is a system mount. This is the Boolean OR of g_unix_is_system_fs_type(), g_unix_is_system_device_path() and g_unix_is_mount_path_system_internal() on mount_entry’s properties.

    The definition of what a ‘system’ mount entry is may change over time as new file system types and device paths are ignored.

    Parameters

    Returns boolean

  • Gets a #GUnixMountPoint for a given mount path. If time_read is set, it will be filled with a unix timestamp for checking if the mount points have changed since with g_unix_mount_points_changed_since().

    If more mount points have the same mount path, the last matching mount point is returned.

    Parameters

    • mountPath: string

      path for a possible unix mount point.

    Returns [UnixMountPoint | null, number]

  • unixMountPointsChangedSince(time: number): boolean
  • Checks if the unix mount points have changed since a given unix time.

    Parameters

    • time: number

      guint64 to contain a timestamp.

    Returns boolean

  • Gets a #GList of #GUnixMountPoint containing the unix mount points. If time_read is set, it will be filled with the mount timestamp, allowing for checking if the mounts have changed with g_unix_mount_points_changed_since().

    Returns [UnixMountPoint[], number]

  • unixMountsChangedSince(time: number): boolean
  • Checks if the unix mounts have changed since a given unix time.

    Parameters

    • time: number

      guint64 to contain a timestamp.

    Returns boolean

  • Gets a #GList of #GUnixMountEntry containing the unix mounts. If time_read is set, it will be filled with the mount timestamp, allowing for checking if the mounts have changed with g_unix_mounts_changed_since().

    Returns [UnixMountEntry[], number]

Legend

  • Module
  • Object literal
  • Variable
  • Function
  • Function with type parameter
  • Index signature
  • Type alias
  • Type alias with type parameter
  • Enumeration
  • Enumeration member
  • Property
  • Method
  • Interface
  • Interface with type parameter
  • Constructor
  • Property
  • Method
  • Index signature
  • Class
  • Class with type parameter
  • Constructor
  • Property
  • Method
  • Accessor
  • Index signature
  • Inherited constructor
  • Inherited property
  • Inherited method
  • Inherited accessor
  • Protected property
  • Protected method
  • Protected accessor
  • Private property
  • Private method
  • Private accessor
  • Static property
  • Static method