Namespace

Gio – 2.0

Gio is a library providing useful classes for general purpose I/O, networking, IPC, settings, and other high level application functionality

Version2.70
AuthorsGTK Development Team
LicenseGPL-2.1-or-later
Websitehttps://www.gtk.org
Sourcehttps://gitlab.gnome.org/GNOME/glib/

Build

C headersgio/gdesktopappinfo.h, gio/gfiledescriptorbased.h, gio/gio.h, gio/gunixconnection.h, gio/gunixcredentialsmessage.h, gio/gunixfdlist.h, gio/gunixfdmessage.h, gio/gunixinputstream.h, gio/gunixmounts.h, gio/gunixoutputstream.h, gio/gunixsocketaddress.h
pkg-config filesgio-2.0, gio-unix-2.0

Dependencies

GLib The base utility library
Browse documentation
GModule Portable API for dynamically loading modules
Browse documentation
GObject The base type system library
Browse documentation

Classes

AppInfoMonitor

GAppInfoMonitor is a very simple object used for monitoring the app info database for changes (ie: newly installed or removed applications).

AppLaunchContext

Integrating the launch with the launching application. This is used to handle for instance startup notification and launching the new application on the same screen as the launching window.

Application

A GApplication is the foundation of an application. It wraps some low-level platform-specific services and is intended to act as the foundation for higher-level application classes such as GtkApplication or MxApplication. In general, you should not use this class outside of a higher level framework.

ApplicationCommandLine

GApplicationCommandLine represents a command-line invocation of an application. It is created by GApplication and emitted in the GApplication::command-line signal and virtual function.

BufferedInputStream

Buffered input stream implements GFilterInputStream and provides for buffered reads.

BufferedOutputStream

Buffered output stream implements GFilterOutputStream and provides for buffered writes.

BytesIcon

GBytesIcon specifies an image held in memory in a common format (usually png) to be used as icon.

Cancellable

GCancellable is a thread-safe operation cancellation stack used throughout GIO to allow for cancellation of synchronous and asynchronous operations.

CharsetConverter

GCharsetConverter is an implementation of GConverter based on GIConv.

ConverterInputStream

Converter input stream implements GInputStream and allows conversion of data of various types during reading.

ConverterOutputStream

Converter output stream implements GOutputStream and allows conversion of data of various types during reading.

Credentials

The GCredentials type is a reference-counted wrapper for native credentials. This information is typically used for identifying, authenticating and authorizing other processes.

DataInputStream

Data input stream implements GInputStream and includes functions for reading structured data directly from a binary input stream.

DataOutputStream

Data output stream implements GOutputStream and includes functions for writing data directly to an output stream.

DBusActionGroup

GDBusActionGroup is an implementation of the GActionGroup interface that can be used as a proxy for an action group that is exported over D-Bus with g_dbus_connection_export_action_group().

DBusAuthObserver

The GDBusAuthObserver type provides a mechanism for participating in how a GDBusServer (or a GDBusConnection) authenticates remote peers. Simply instantiate a GDBusAuthObserver and connect to the signals you are interested in. Note that new signals may be added in the future.

DBusConnection

The GDBusConnection type is used for D-Bus connections to remote peers such as a message buses. It is a low-level API that offers a lot of flexibility. For instance, it lets you establish a connection over any transport that can by represented as a GIOStream.

DBusInterfaceSkeleton

Abstract base class for D-Bus interfaces on the service side.

DBusMenuModel

GDBusMenuModel is an implementation of GMenuModel that can be used as a proxy for a menu model that is exported over D-Bus with g_dbus_connection_export_menu_model().

DBusMessage

A type for representing D-Bus messages that can be sent or received on a GDBusConnection.

DBusMethodInvocation

Instances of the GDBusMethodInvocation class are used when handling D-Bus method calls. It provides a way to asynchronously return results and errors.

DBusObjectManagerClient

GDBusObjectManagerClient is used to create, monitor and delete object proxies for remote objects exported by a GDBusObjectManagerServer (or any code implementing the org.freedesktop.DBus.ObjectManager interface).

DBusObjectManagerServer

GDBusObjectManagerServer is used to export GDBusObject instances using the standardized org.freedesktop.DBus.ObjectManager interface. For example, remote D-Bus clients can get all objects and properties in a single call. Additionally, any change in the object hierarchy is broadcast using signals. This means that D-Bus clients can keep caches up to date by only listening to D-Bus signals.

DBusObjectProxy

A GDBusObjectProxy is an object used to represent a remote object with one or more D-Bus interfaces. Normally, you don’t instantiate a GDBusObjectProxy yourself - typically GDBusObjectManagerClient is used to obtain it.

DBusObjectSkeleton

A GDBusObjectSkeleton instance is essentially a group of D-Bus interfaces. The set of exported interfaces on the object may be dynamic and change at runtime.

DBusProxy

GDBusProxy is a base class used for proxies to access a D-Bus interface on a remote object. A GDBusProxy can be constructed for both well-known and unique names.

DBusServer

GDBusServer is a helper for listening to and accepting D-Bus connections. This can be used to create a new D-Bus server, allowing two peers to use the D-Bus protocol for their own specialized communication. A server instance provided in this way will not perform message routing or implement the org.freedesktop.DBus interface.

DesktopAppInfo

GDesktopAppInfo is an implementation of GAppInfo based on desktop files.

Emblem

GEmblem is an implementation of GIcon that supports having an emblem, which is an icon with additional properties. It can than be added to a GEmblemedIcon.

EmblemedIcon

GEmblemedIcon is an implementation of GIcon that supports adding an emblem to an icon. Adding multiple emblems to an icon is ensured via g_emblemed_icon_add_emblem().

FileEnumerator

GFileEnumerator allows you to operate on a set of GFiles, returning a GFileInfo structure for each file enumerated (e.g. g_file_enumerate_children() will return a GFileEnumerator for each of the children within a directory).

FileIcon

GFileIcon specifies an icon by pointing to an image file to be used as icon.

FileInfo

Functionality for manipulating basic metadata for files. GFileInfo implements methods for getting information that all files should contain, and allows for manipulation of extended attributes.

FileInputStream

GFileInputStream provides input streams that take their content from a file.

FileIOStream

GFileIOStream provides io streams that both read and write to the same file handle.

FileMonitor

Monitors a file or directory for changes.

FilenameCompleter

Completes partial file and directory names given a partial string by looking in the file system for clues. Can return a list of possible completion strings for widget implementations.

FileOutputStream

GFileOutputStream provides output streams that write their content to a file.

FilterInputStream

Base class for input stream implementations that perform some kind of filtering operation on a base stream. Typical examples of filtering operations are character set conversion, compression and byte order flipping.

FilterOutputStream

Base class for output stream implementations that perform some kind of filtering operation on a base stream. Typical examples of filtering operations are character set conversion, compression and byte order flipping.

InetAddress

GInetAddress represents an IPv4 or IPv6 internet address. Use g_resolver_lookup_by_name() or g_resolver_lookup_by_name_async() to look up the GInetAddress for a hostname. Use g_resolver_lookup_by_address() or g_resolver_lookup_by_address_async() to look up the hostname for a GInetAddress.

InetAddressMask

GInetAddressMask represents a range of IPv4 or IPv6 addresses described by a base address and a length indicating how many bits of the base address are relevant for matching purposes. These are often given in string form. Eg, “10.0.0.0/8”, or “fe80::/10”.

InetSocketAddress

An IPv4 or IPv6 socket address; that is, the combination of a GInetAddress and a port number.

InputStream

GInputStream has functions to read from a stream (g_input_stream_read()), to close a stream (g_input_stream_close()) and to skip some content (g_input_stream_skip()).

IOModule

Provides an interface and default functions for loading and unloading modules. This is used internally to make GIO extensible, but can also be used by others to implement module loading.

IOStream

GIOStream represents an object that has both read and write streams. Generally the two streams act as separate input and output streams, but they share some common resources and state. For instance, for seekable streams, both streams may use the same position.

ListStore

GListStore is a simple implementation of GListModel that stores all items in memory.

MemoryInputStream

GMemoryInputStream is a class for using arbitrary memory chunks as input for GIO streaming input operations.

MemoryOutputStream

GMemoryOutputStream is a class for using arbitrary memory chunks as output for GIO streaming output operations.

Menu

GMenu is a simple implementation of GMenuModel. You populate a GMenu by adding GMenuItem instances to it.

MenuAttributeIter

GMenuAttributeIter is an opaque structure type. You must access it using the functions below.

MenuItem

GMenuItem is an opaque structure type. You must access it using the functions below.

MenuLinkIter

GMenuLinkIter is an opaque structure type. You must access it using the functions below.

MenuModel

GMenuModel represents the contents of a menu — an ordered list of menu items. The items are associated with actions, which can be activated through them. Items can be grouped in sections, and may have submenus associated with them. Both items and sections usually have some representation data, such as labels or icons. The type of the associated action (ie whether it is stateful, and what kind of state it has) can influence the representation of the item.

MountOperation

GMountOperation provides a mechanism for interacting with the user. It can be used for authenticating mountable operations, such as loop mounting files, hard drive partitions or server locations. It can also be used to ask the user questions or show a list of applications preventing unmount or eject operations from completing.

NativeSocketAddress

A socket address of some unknown native type.

NativeVolumeMonitor
NetworkAddress

GNetworkAddress provides an easy way to resolve a hostname and then attempt to connect to that host, handling the possibility of multiple IP addresses and multiple address families.

NetworkService

Like GNetworkAddress does with hostnames, GNetworkService provides an easy way to resolve a SRV record, and then attempt to connect to one of the hosts that implements that service, handling service priority/weighting, multiple IP addresses, and multiple address families.

Notification

GNotification is a mechanism for creating a notification to be shown to the user — typically as a pop-up notification presented by the desktop environment shell.

OutputStream

GOutputStream has functions to write to a stream (g_output_stream_write()), to close a stream (g_output_stream_close()) and to flush pending writes (g_output_stream_flush()).

Permission

A GPermission represents the status of the caller’s permission to perform a certain action.

PropertyAction

A GPropertyAction is a way to get a GAction with a state value reflecting and controlling the value of a GObject property.

ProxyAddress

Support for proxied GInetSocketAddress.

ProxyAddressEnumerator

GProxyAddressEnumerator is a wrapper around GSocketAddressEnumerator which takes the GSocketAddress instances returned by the GSocketAddressEnumerator and wraps them in GProxyAddress instances, using the given GProxyAddressEnumerator:proxy-resolver.

Resolver

GResolver provides cancellable synchronous and asynchronous DNS resolution, for hostnames (g_resolver_lookup_by_address(), g_resolver_lookup_by_name() and their async variants) and SRV (service) records (g_resolver_lookup_service()).

Settings

The GSettings class provides a convenient API for storing and retrieving application settings.

SettingsBackend

The GSettingsBackend interface defines a generic interface for non-strictly-typed data that is stored in a hierarchy. To implement an alternative storage backend for GSettings, you need to implement the GSettingsBackend interface and then make it implement the extension point #G_SETTINGS_BACKEND_EXTENSION_POINT_NAME.

SimpleAction

A GSimpleAction is the obvious simple implementation of the GAction interface. This is the easiest way to create an action for purposes of adding it to a GSimpleActionGroup.

SimpleActionGroup

GSimpleActionGroup is a hash table filled with GAction objects, implementing the GActionGroup and GActionMap interfaces.

SimpleAsyncResult

As of GLib 2.46, GSimpleAsyncResult is deprecated in favor of GTask, which provides a simpler API.

SimpleIOStream

GSimpleIOStream creates a GIOStream from an arbitrary GInputStream and GOutputStream. This allows any pair of input and output streams to be used with GIOStream methods.

SimplePermission

GSimplePermission is a trivial implementation of GPermission that represents a permission that is either always or never allowed. The value is given at construction and doesn’t change.

SimpleProxyResolver

GSimpleProxyResolver is a simple GProxyResolver implementation that handles a single default proxy, multiple URI-scheme-specific proxies, and a list of hosts that proxies should not be used for.

Socket

A GSocket is a low-level networking primitive. It is a more or less direct mapping of the BSD socket API in a portable GObject based API. It supports both the UNIX socket implementations and winsock2 on Windows.

SocketAddress

GSocketAddress is the equivalent of struct sockaddr in the BSD sockets API. This is an abstract class; use GInetSocketAddress for internet sockets, or GUnixSocketAddress for UNIX domain sockets.

SocketAddressEnumerator

GSocketAddressEnumerator is an enumerator type for GSocketAddress instances. It is returned by enumeration functions such as g_socket_connectable_enumerate(), which returns a GSocketAddressEnumerator to list each GSocketAddress which could be used to connect to that GSocketConnectable.

SocketClient

GSocketClient is a lightweight high-level utility class for connecting to a network host using a connection oriented socket type.

SocketConnection

GSocketConnection is a GIOStream for a connected socket. They can be created either by GSocketClient when connecting to a host, or by GSocketListener when accepting a new client.

SocketControlMessage

A GSocketControlMessage is a special-purpose utility message that can be sent to or received from a GSocket. These types of messages are often called “ancillary data”.

SocketListener

A GSocketListener is an object that keeps track of a set of server sockets and helps you accept sockets from any of the socket, either sync or async.

SocketService

A GSocketService is an object that represents a service that is provided to the network or over local sockets. When a new connection is made to the service the GSocketService::incoming signal is emitted.

Subprocess

GSubprocess allows the creation of and interaction with child processes.

SubprocessLauncher

This class contains a set of options for launching child processes, such as where its standard input and output will be directed, the argument list, the environment, and more.

Task

A GTask represents and manages a cancellable “task”.

TcpConnection

This is the subclass of GSocketConnection that is created for TCP/IP sockets.

TcpWrapperConnection

A GTcpWrapperConnection can be used to wrap a GIOStream that is based on a GSocket, but which is not actually a GSocketConnection. This is used by GSocketClient so that it can always return a GSocketConnection, even when the connection it has actually created is not directly a GSocketConnection.

TestDBus

A helper class for testing code which uses D-Bus without touching the user’s session bus.

ThemedIcon

GThemedIcon is an implementation of GIcon that supports icon themes. GThemedIcon contains a list of all of the icons present in an icon theme, so that icons can be looked up quickly. GThemedIcon does not provide actual pixmaps for icons, just the icon names. Ideally something like gtk_icon_theme_choose_icon() should be used to resolve the list of names so that fallback icons work nicely with themes that inherit other themes.

ThreadedSocketService

A GThreadedSocketService is a simple subclass of GSocketService that handles incoming connections by creating a worker thread and dispatching the connection to it by emitting the GThreadedSocketService::run signal in the new thread.

TlsCertificate

A certificate used for TLS authentication and encryption. This can represent either a certificate only (eg, the certificate received by a client from a server), or the combination of a certificate and a private key (which is needed when acting as a GTlsServerConnection).

TlsConnection

GTlsConnection is the base TLS connection class type, which wraps a GIOStream and provides TLS encryption on top of it. Its subclasses, GTlsClientConnection and GTlsServerConnection, implement client-side and server-side TLS, respectively.

TlsDatabase

GTlsDatabase is used to look up certificates and other information from a certificate or key store. It is an abstract base class which TLS library specific subtypes override.

TlsInteraction

GTlsInteraction provides a mechanism for the TLS connection and database code to interact with the user. It can be used to ask the user for passwords.

TlsPassword

Holds a password used in TLS.

UnixConnection

This is the subclass of GSocketConnection that is created for UNIX domain sockets.

UnixCredentialsMessage

This GSocketControlMessage contains a GCredentials instance. It may be sent using g_socket_send_message() and received using g_socket_receive_message() over UNIX sockets (ie: sockets in the G_SOCKET_FAMILY_UNIX family).

UnixFDList

A GUnixFDList contains a list of file descriptors. It owns the file descriptors that it contains, closing them when finalized.

UnixFDMessage

This GSocketControlMessage contains a GUnixFDList. It may be sent using g_socket_send_message() and received using g_socket_receive_message() over UNIX sockets (ie: sockets in the G_SOCKET_FAMILY_UNIX family). The file descriptors are copied between processes by the kernel.

UnixInputStream

GUnixInputStream implements GInputStream for reading from a UNIX file descriptor, including asynchronous operations. (If the file descriptor refers to a socket or pipe, this will use poll() to do asynchronous I/O. If it refers to a regular file, it will fall back to doing asynchronous I/O in another thread.)

UnixMountMonitor

Watches GUnixMounts for changes.

UnixOutputStream

GUnixOutputStream implements GOutputStream for writing to a UNIX file descriptor, including asynchronous operations. (If the file descriptor refers to a socket or pipe, this will use poll() to do asynchronous I/O. If it refers to a regular file, it will fall back to doing asynchronous I/O in another thread.)

UnixSocketAddress

Support for UNIX-domain (also known as local) sockets.

Vfs

Entry point for using GIO functionality.

VolumeMonitor

GVolumeMonitor is for listing the user interesting devices and volumes on the computer. In other words, what a file selector or file manager would show in a sidebar.

ZlibCompressor

GZlibCompressor is an implementation of GConverter that compresses data using zlib.

ZlibDecompressor

GZlibDecompressor is an implementation of GConverter that decompresses data compressed with zlib.

Interfaces

Action

GAction represents a single named action.

ActionGroup

GActionGroup represents a group of actions. Actions can be used to expose functionality in a structured way, either from one part of a program to another, or to the outside world. Action groups are often used together with a GMenuModel that provides additional representation data for displaying the actions to the user, e.g. in a menu.

ActionMap

The GActionMap interface is implemented by GActionGroup implementations that operate by containing a number of named GAction instances, such as GSimpleActionGroup.

AppInfo

GAppInfo and GAppLaunchContext are used for describing and launching applications installed on the system.

AsyncInitable

This is the asynchronous version of GInitable; it behaves the same in all ways except that initialization is asynchronous. For more details see the descriptions on GInitable.

AsyncResult

Provides a base class for implementing asynchronous function results.

Converter

GConverter is implemented by objects that convert binary data in various ways. The conversion can be stateful and may fail at any place.

DatagramBased

A GDatagramBased is a networking interface for representing datagram-based communications. It is a more or less direct mapping of the core parts of the BSD socket API in a portable GObject interface. It is implemented by GSocket, which wraps the UNIX socket API on UNIX and winsock2 on Windows.

DBusInterface

The GDBusInterface type is the base type for D-Bus interfaces both on the service side (see GDBusInterfaceSkeleton) and client side (see GDBusProxy).

DBusObject

The GDBusObject type is the base type for D-Bus objects on both the service side (see GDBusObjectSkeleton) and the client side (see GDBusObjectProxy). It is essentially just a container of interfaces.

DBusObjectManager

The GDBusObjectManager type is the base type for service- and client-side implementations of the standardized org.freedesktop.DBus.ObjectManager interface.

DesktopAppInfoLookup

GDesktopAppInfoLookup is an opaque data structure and can only be accessed using the following functions.

Drive

GDrive - this represent a piece of hardware connected to the machine. It’s generally only created for removable hardware or hardware with removable media.

DtlsClientConnection

GDtlsClientConnection is the client-side subclass of GDtlsConnection, representing a client-side DTLS connection.

DtlsConnection

GDtlsConnection is the base DTLS connection class type, which wraps a GDatagramBased and provides DTLS encryption on top of it. Its subclasses, GDtlsClientConnection and GDtlsServerConnection, implement client-side and server-side DTLS, respectively.

DtlsServerConnection

GDtlsServerConnection is the server-side subclass of GDtlsConnection, representing a server-side DTLS connection.

File

GFile is a high level abstraction for manipulating files on a virtual file system. GFiles are lightweight, immutable objects that do no I/O upon creation. It is necessary to understand that GFile objects do not represent files, merely an identifier for a file. All file content I/O is implemented as streaming operations (see GInputStream and GOutputStream).

FileDescriptorBased

GFileDescriptorBased is implemented by streams (implementations of GInputStream or GOutputStream) that are based on file descriptors.

Icon

GIcon is a very minimal interface for icons. It provides functions for checking the equality of two icons, hashing of icons and serializing an icon to and from strings.

Initable

GInitable is implemented by objects that can fail during initialization. If an object implements this interface then it must be initialized as the first thing after construction, either via g_initable_init() or g_async_initable_init_async() (the latter is only available if it also implements GAsyncInitable).

ListModel

GListModel is an interface that represents a mutable list of GObjects. Its main intention is as a model for various widgets in user interfaces, such as list views, but it can also be used as a convenient method of returning lists of data, with support for updates.

LoadableIcon

Extends the GIcon interface and adds the ability to load icons from streams.

MemoryMonitor

GMemoryMonitor will monitor system memory and suggest to the application when to free memory so as to leave more room for other applications. It is implemented on Linux using the Low Memory Monitor (API documentation).

Mount

The GMount interface represents user-visible mounts. Note, when porting from GnomeVFS, GMount is the moral equivalent of GnomeVFSVolume.

NetworkMonitor

GNetworkMonitor provides an easy-to-use cross-platform API for monitoring network connectivity. On Linux, the available implementations are based on the kernel’s netlink interface and on NetworkManager.

PollableInputStream

GPollableInputStream is implemented by GInputStreams that can be polled for readiness to read. This can be used when interfacing with a non-GIO API that expects UNIX-file-descriptor-style asynchronous I/O rather than GIO-style.

PollableOutputStream

GPollableOutputStream is implemented by GOutputStreams that can be polled for readiness to write. This can be used when interfacing with a non-GIO API that expects UNIX-file-descriptor-style asynchronous I/O rather than GIO-style.

PowerProfileMonitor

GPowerProfileMonitor makes it possible for applications as well as OS components to monitor system power profiles and act upon them. It currently only exports whether the system is in “Power Saver” mode (known as “Low Power” mode on some systems).

Proxy

A GProxy handles connecting to a remote host via a given type of proxy server. It is implemented by the ‘gio-proxy’ extension point. The extensions are named after their proxy protocol name. As an example, a SOCKS5 proxy implementation can be retrieved with the name ‘socks5’ using the function g_io_extension_point_get_extension_by_name().

ProxyResolver

GProxyResolver provides synchronous and asynchronous network proxy resolution. GProxyResolver is used within GSocketClient through the method g_socket_connectable_proxy_enumerate().

RemoteActionGroup

The GRemoteActionGroup interface is implemented by GActionGroup instances that either transmit action invocations to other processes or receive action invocations in the local process from other processes.

Seekable

GSeekable is implemented by streams (implementations of GInputStream or GOutputStream) that support seeking.

SocketConnectable

Objects that describe one or more potential socket endpoints implement GSocketConnectable. Callers can then use g_socket_connectable_enumerate() to get a GSocketAddressEnumerator to try out each socket address in turn until one succeeds, as shown in the sample code below.

TlsBackend

TLS (Transport Layer Security, aka SSL) and DTLS backend.

TlsClientConnection

GTlsClientConnection is the client-side subclass of GTlsConnection, representing a client-side TLS connection.

TlsFileDatabase

GTlsFileDatabase is implemented by GTlsDatabase objects which load their certificate information from a file. It is an interface which TLS library specific subtypes implement.

TlsServerConnection

GTlsServerConnection is the server-side subclass of GTlsConnection, representing a server-side TLS connection.

Volume

The GVolume interface represents user-visible objects that can be mounted. Note, when porting from GnomeVFS, GVolume is the moral equivalent of GnomeVFSDrive.

Structs

ActionEntry

This struct defines a single action. It is for use with g_action_map_add_action_entries().

DBusAnnotationInfo

Information about an annotation.

DBusArgInfo

Information about an argument for a method or a signal.

DBusErrorEntry

Struct used in g_dbus_error_register_error_domain().

DBusInterfaceInfo

Information about a D-Bus interface.

DBusInterfaceVTable

Virtual table for handling properties and method calls for a D-Bus interface.

DBusMethodInfo

Information about a method on an D-Bus interface.

DBusNodeInfo

Information about nodes in a remote object hierarchy.

DBusPropertyInfo

Information about a D-Bus property on a D-Bus interface.

DBusSignalInfo

Information about a signal on a D-Bus interface.

DBusSubtreeVTable

Virtual table for handling subtrees registered with g_dbus_connection_register_subtree().

FileAttributeInfo

Information about a specific attribute.

FileAttributeInfoList

Acts as a lightweight registry for possible valid file attributes. The registry stores Key-Value pair formats as GFileAttributeInfos.

FileAttributeMatcher

Determines if a string matches a file attribute.

InputMessage

Structure used for scatter/gather data input when receiving multiple messages or packets in one go. You generally pass in an array of empty GInputVectors and the operation will use all the buffers as if they were one buffer, and will set bytes_received to the total number of bytes received across all GInputVectors.

InputVector

Structure used for scatter/gather data input. You generally pass in an array of GInputVectors and the operation will store the read data starting in the first buffer, switching to the next as needed.

IOExtension

GIOExtension is an opaque data structure and can only be accessed using the following functions.

IOExtensionPoint

GIOExtensionPoint is an opaque data structure and can only be accessed using the following functions.

IOModuleScope

Represents a scope for loading IO modules. A scope can be used for blocking duplicate modules, or blocking a module you don’t want to load.

IOSchedulerJob

Opaque class for defining and scheduling IO jobs.

IOStreamAdapter
OutputMessage

Structure used for scatter/gather data output when sending multiple messages or packets in one go. You generally pass in an array of GOutputVectors and the operation will use all the buffers as if they were one buffer.

OutputVector

Structure used for scatter/gather data output. You generally pass in an array of GOutputVectors and the operation will use all the buffers as if they were one buffer.

Resource

Applications and libraries often contain binary or textual data that is really part of the application, rather than user data. For instance GtkBuilder .ui files, splashscreen images, GMenu markup XML, CSS files, icons, etc. These are often shipped as files in $datadir/appname, or manually included as literal strings in the code.

SettingsSchema

The GSettingsSchemaSource and GSettingsSchema APIs provide a mechanism for advanced control over the loading of schemas and a mechanism for introspecting their content.

SettingsSchemaKey

GSettingsSchemaKey is an opaque data structure and can only be accessed using the following functions.

SettingsSchemaSource

This is an opaque structure type. You may not access it directly.

SrvTarget

SRV (service) records are used by some network protocols to provide service-specific aliasing and load-balancing. For example, XMPP (Jabber) uses SRV records to locate the XMPP server for a domain; rather than connecting directly to “example.com” or assuming a specific server hostname like “xmpp.example.com”, an XMPP client would look up the “xmpp-client” SRV record for “example.com”, and then connect to whatever host was pointed to by that record.

StaticResource

GStaticResource is an opaque data structure and can only be accessed using the following functions.

UnixMountEntry

Defines a Unix mount entry (e.g. /media/cdrom). This corresponds roughly to a mtab entry.

UnixMountPoint

Defines a Unix mount point (e.g. /dev). This corresponds roughly to a fstab entry.

Enumerations

BusType

An enumeration for well-known message buses.

ConverterResult

Results returned from g_converter_convert().

CredentialsType

Enumeration describing different kinds of native credential types.

DataStreamByteOrder

GDataStreamByteOrder is used to ensure proper endianness of streaming data sources across various machine architectures.

DataStreamNewlineType

GDataStreamNewlineType is used when checking for or setting the line endings for a given file.

DBusMessageByteOrder

Enumeration used to describe the byte order of a D-Bus message.

DBusMessageHeaderField

Header fields used in GDBusMessage.

DBusMessageType

Message types used in GDBusMessage.

DriveStartStopType

Enumeration describing how a drive can be started/stopped.

EmblemOrigin

GEmblemOrigin is used to add information about the origin of the emblem to GEmblem.

FileAttributeStatus

Used by g_file_set_attributes_from_info() when setting file attributes.

FileAttributeType

The data types for file attributes.

FileMonitorEvent

Specifies what type of event a monitor event is.

FilesystemPreviewType

Indicates a hint from the file system whether files should be previewed in a file manager. Returned as the value of the key

G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW.

FileType

Indicates the file’s on-disk type.

IOModuleScopeFlags

Flags for use with g_io_module_scope_new().

MemoryMonitorWarningLevel

Memory availability warning levels.

MountOperationResult

GMountOperationResult is returned as a result when a request for information is send by the mounting operation.

NetworkConnectivity

The host’s network connectivity state, as reported by GNetworkMonitor.

NotificationPriority

Priority levels for GNotifications.

PasswordSave

GPasswordSave is used to indicate the lifespan of a saved password.

PollableReturn

Return value for various IO operations that signal errors via the return value and not necessarily via a GError.

ResolverRecordType

The type of record that g_resolver_lookup_records() or g_resolver_lookup_records_async() should retrieve. The records are returned as lists of GVariant tuples. Each record type has different values in the variant tuples returned.

SocketClientEvent

Describes an event occurring on a GSocketClient. See the GSocketClient::event signal for more details.

SocketFamily

The protocol family of a GSocketAddress. (These values are identical to the system defines AF_INET, AF_INET6 and AF_UNIX, if available.)

SocketListenerEvent

Describes an event occurring on a GSocketListener. See the GSocketListener::event signal for more details.

SocketProtocol

A protocol identifier is specified when creating a GSocket, which is a family/type specific identifier, where 0 means the default protocol for the particular family/type.

SocketType

Flags used when creating a GSocket. Some protocols may not implement all the socket types.

TlsAuthenticationMode

The client authentication mode for a GTlsServerConnection.

TlsCertificateRequestFlags

Flags for g_tls_interaction_request_certificate(), g_tls_interaction_request_certificate_async(), and g_tls_interaction_invoke_request_certificate().

TlsChannelBindingType

The type of TLS channel binding data to retrieve from GTlsConnection or GDtlsConnection, as documented by RFC 5929. The tls-unique-for-telnet binding type is not currently implemented.

TlsDatabaseLookupFlags

Flags for g_tls_database_lookup_certificate_for_handle(), g_tls_database_lookup_certificate_issuer(), and g_tls_database_lookup_certificates_issued_by().

TlsInteractionResult

GTlsInteractionResult is returned by various functions in GTlsInteraction when finishing an interaction request.

TlsProtocolVersion

The TLS or DTLS protocol version used by a GTlsConnection or GDtlsConnection. The integer values of these versions are sequential to ensure newer known protocol versions compare greater than older known versions. Any known DTLS protocol version will compare greater than any SSL or TLS protocol version. The protocol version may be G_TLS_PROTOCOL_VERSION_UNKNOWN if the TLS backend supports a newer protocol version that GLib does not yet know about. This means that it’s possible for an unknown DTLS protocol version to compare less than the TLS protocol versions.

TlsRehandshakeMode

When to allow rehandshaking. See g_tls_connection_set_rehandshake_mode().

UnixSocketAddressType

The type of name used by a GUnixSocketAddress. G_UNIX_SOCKET_ADDRESS_PATH indicates a traditional unix domain socket bound to a filesystem path. G_UNIX_SOCKET_ADDRESS_ANONYMOUS indicates a socket not bound to any name (eg, a client-side socket, or a socket created with socketpair()).

ZlibCompressorFormat

Used to select the type of data format to use for GZlibDecompressor and GZlibCompressor.

Bitfields

AppInfoCreateFlags

Flags used when creating a GAppInfo.

ApplicationFlags

Flags used to define the behaviour of a GApplication.

AskPasswordFlags

GAskPasswordFlags are used to request specific information from the user, or to notify the user of their choices in an authentication situation.

BusNameOwnerFlags

Flags used in g_bus_own_name().

BusNameWatcherFlags

Flags used in g_bus_watch_name().

ConverterFlags

Flags used when calling a g_converter_convert().

DBusCallFlags

Flags used in g_dbus_connection_call() and similar APIs.

DBusCapabilityFlags

Capabilities negotiated with the remote peer.

DBusConnectionFlags

Flags used when creating a new GDBusConnection.

DBusInterfaceSkeletonFlags

Flags describing the behavior of a GDBusInterfaceSkeleton instance.

DBusMessageFlags

Message flags used in GDBusMessage.

DBusObjectManagerClientFlags

Flags used when constructing a GDBusObjectManagerClient.

DBusPropertyInfoFlags

Flags describing the access control of a D-Bus property.

DBusProxyFlags

Flags used when constructing an instance of a GDBusProxy derived class.

DBusSendMessageFlags

Flags used when sending GDBusMessages on a GDBusConnection.

DBusServerFlags

Flags used when creating a GDBusServer.

DBusSignalFlags

Flags used when subscribing to signals via g_dbus_connection_signal_subscribe().

DBusSubtreeFlags

Flags passed to g_dbus_connection_register_subtree().

DriveStartFlags

Flags used when starting a drive.

FileAttributeInfoFlags

Flags specifying the behaviour of an attribute.

FileCopyFlags

Flags used when copying or moving files.

FileCreateFlags

Flags used when an operation may create a file.

FileMeasureFlags

Flags that can be used with g_file_measure_disk_usage().

FileMonitorFlags

Flags used to set what a GFileMonitor will watch for.

FileQueryInfoFlags

Flags used when querying a GFileInfo.

IOStreamSpliceFlags

GIOStreamSpliceFlags determine how streams should be spliced.

MountMountFlags

Flags used when mounting a mount.

MountUnmountFlags

Flags used when an unmounting a mount.

OutputStreamSpliceFlags

GOutputStreamSpliceFlags determine how streams should be spliced.

ResolverNameLookupFlags

Flags to modify lookup behavior.

ResourceFlags

GResourceFlags give information about a particular file inside a resource bundle.

ResourceLookupFlags

GResourceLookupFlags determine how resource path lookups are handled.

SettingsBindFlags

Flags used when creating a binding. These flags determine in which direction the binding works. The default is to synchronize in both directions.

SocketMsgFlags

Flags used in g_socket_receive_message() and g_socket_send_message(). The flags listed in the enum are some commonly available flags, but the values used for them are the same as on the platform, and any other flags are passed in/out as is. So to use a platform specific flag, just include the right system header and pass in the flag.

SubprocessFlags

Flags to define the behaviour of a GSubprocess.

TestDBusFlags

Flags to define future GTestDBus behaviour.

TlsCertificateFlags

A set of flags describing TLS certification validation. This can be used to set which validation steps to perform (eg, with g_tls_client_connection_set_validation_flags()), or to describe why a particular certificate was rejected (eg, in GTlsConnection::accept-certificate).

TlsDatabaseVerifyFlags

Flags for g_tls_database_verify_chain().

TlsPasswordFlags

Various flags for the password.

Error Domains

DBusError

Error codes for the G_DBUS_ERROR error domain.

IOErrorEnum

Error codes returned by GIO functions.

ResolverError

An error code used with G_RESOLVER_ERROR in a GError returned from a GResolver routine.

ResourceError

An error code used with G_RESOURCE_ERROR in a GError returned from a GResource routine.

TlsChannelBindingError

An error code used with G_TLS_CHANNEL_BINDING_ERROR in a GError to indicate a TLS channel binding retrieval error.

TlsError

An error code used with G_TLS_ERROR in a GError returned from a TLS-related routine.

Callbacks

AsyncReadyCallback

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.

BusAcquiredCallback

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

BusNameAcquiredCallback

Invoked when the name is acquired.

BusNameAppearedCallback

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

BusNameLostCallback

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

BusNameVanishedCallback

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

CancellableSourceFunc

This is the function type of the callback used for the GSource returned by g_cancellable_source_new().

DatagramBasedSourceFunc

This is the function type of the callback used for the GSource returned by g_datagram_based_create_source().

DBusInterfaceGetPropertyFunc

The type of the get_property function in GDBusInterfaceVTable.

DBusInterfaceMethodCallFunc

The type of the method_call function in GDBusInterfaceVTable.

DBusInterfaceSetPropertyFunc

The type of the set_property function in GDBusInterfaceVTable.

DBusMessageFilterFunction

Signature for function used in g_dbus_connection_add_filter().

DBusProxyTypeFunc

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

DBusSignalCallback

Signature for callback function used in g_dbus_connection_signal_subscribe().

DBusSubtreeDispatchFunc

The type of the dispatch function in GDBusSubtreeVTable.

DBusSubtreeEnumerateFunc

The type of the enumerate function in GDBusSubtreeVTable.

DBusSubtreeIntrospectFunc

The type of the introspect function in GDBusSubtreeVTable.

DesktopAppLaunchCallback

During invocation, g_desktop_app_info_launch_uris_as_manager() may create one or more child processes. This callback is invoked once for each, providing the process ID.

FileMeasureProgressCallback

This callback type is used by g_file_measure_disk_usage() to make periodic progress reports when measuring the amount of disk spaced used by a directory.

FileProgressCallback

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.

FileReadMoreCallback

When loading the partial contents of a file with g_file_load_partial_contents_async(), 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.

IOSchedulerJobFunc

I/O Job function.

PollableSourceFunc

This is the function type of the callback used for the GSource returned by g_pollable_input_stream_create_source() and g_pollable_output_stream_create_source().

ReallocFunc

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

SettingsBindGetMapping

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.

SettingsBindSetMapping

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

SettingsGetMapping

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.

SimpleAsyncThreadFunc

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

SocketSourceFunc

This is the function type of the callback used for the GSource returned by g_socket_create_source().

TaskThreadFunc

The prototype for a task function to be run in a thread via g_task_run_in_thread() or g_task_run_in_thread_sync().

VfsFileLookupFunc

This function type is used by g_vfs_register_uri_scheme() to make it possible for a client to associate an URI scheme to a different GFile implementation.

Functions

bus_get

Asynchronously connects to the message bus specified by bus_type.

bus_get_finish

Finishes an operation started with g_bus_get().

bus_get_sync

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.

bus_own_name

Starts acquiring name on the bus specified by bus_type and calls name_acquired_handler and name_lost_handler when the name is acquired respectively lost. Callbacks will be invoked in the [thread-default main context][g-main-context-push-thread-default] of the thread you are calling this function from.

bus_own_name_on_connection

Like g_bus_own_name() but takes a GDBusConnection instead of a GBusType.

bus_own_name_on_connection_with_closures

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

bus_own_name_with_closures

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

bus_unown_name

Stops owning a name.

bus_unwatch_name

Stops watching a name.

bus_watch_name

Starts watching name on the bus specified by bus_type and calls name_appeared_handler and name_vanished_handler when the name is known to have an owner respectively known to lose its owner. Callbacks will be invoked in the [thread-default main context][g-main-context-push-thread-default] of the thread you are calling this function from.

bus_watch_name_on_connection

Like g_bus_watch_name() but takes a GDBusConnection instead of a GBusType.

bus_watch_name_on_connection_with_closures

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

bus_watch_name_with_closures

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

content_type_can_be_executable

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

content_type_equals

Compares two content types for equality.

content_type_from_mime_type

Tries to find a content type based on the mime type name.

content_type_get_description

Gets the human readable description of the content type.

content_type_get_generic_icon_name

Gets the generic icon name for a content type.

content_type_get_icon

Gets the icon for a content type.

content_type_get_mime_dirs

Get the list of directories which MIME data is loaded from. See g_content_type_set_mime_dirs() for details.

content_type_get_mime_type

Gets the mime type for the content type, if one is registered.

content_type_get_symbolic_icon

Gets the symbolic icon for a content type.

content_type_guess

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.

content_type_guess_for_tree

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.

content_type_is_a

Determines if type is a subset of supertype.

content_type_is_mime_type

Determines if type is a subset of mime_type. Convenience wrapper around g_content_type_is_a().

content_type_is_unknown

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.

content_type_set_mime_dirs

Set the list of directories used by GIO to load the MIME database. If dirs is NULL, the directories used are the default:

content_types_get_registered

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

dbus_address_escape_value

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

dbus_address_get_for_bus_sync

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.

dbus_address_get_stream

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.

dbus_address_get_stream_finish

Finishes an operation started with g_dbus_address_get_stream().

dbus_address_get_stream_sync

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.

dbus_escape_object_path

This is a language binding friendly version of g_dbus_escape_object_path_bytestring().

dbus_escape_object_path_bytestring

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.

dbus_generate_guid

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

dbus_gvalue_to_gvariant

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

dbus_gvariant_to_gvalue

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

dbus_is_address

Checks if string is a D-Bus address.

dbus_is_error_name

Check whether string is a valid D-Bus error name.

dbus_is_guid

Checks if string is a D-Bus GUID.

dbus_is_interface_name

Checks if string is a valid D-Bus interface name.

dbus_is_member_name

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

dbus_is_name

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

dbus_is_supported_address

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.

dbus_is_unique_name

Checks if string is a valid D-Bus unique bus name.

dbus_unescape_object_path

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.

io_error_from_errno

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

io_error_quark

Gets the GIO Error Quark.

io_modules_load_all_in_directory

Loads all the modules in the specified directory.

io_modules_load_all_in_directory_with_scope

Loads all the modules in the specified directory.

io_modules_scan_all_in_directory

Scans all the modules in the specified directory, ensuring that any extension point implemented by a module is registered.

io_modules_scan_all_in_directory_with_scope

Scans all the modules in the specified directory, ensuring that any extension point implemented by a module is registered.

io_scheduler_cancel_all_jobs

Cancels all cancellable I/O jobs.

io_scheduler_push_job

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

keyfile_settings_backend_new

Creates a keyfile-backed GSettingsBackend.

memory_settings_backend_new

Creates a memory-backed GSettingsBackend.

networking_init

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

null_settings_backend_new

Creates a readonly GSettingsBackend.

pollable_source_new

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.

pollable_source_new_full

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.

pollable_stream_read

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.

pollable_stream_write

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.

pollable_stream_write_all

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

resources_enumerate_children

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

resources_get_info

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

resources_lookup_data

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.

resources_open_stream

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.

resources_register

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

resources_unregister

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

simple_async_report_error_in_idle

Reports an error in an asynchronous function in an idle function by directly setting the contents of the GAsyncResult with the given error information.

simple_async_report_gerror_in_idle

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.

simple_async_report_take_gerror_in_idle

Reports an error in an idle function. Similar to g_simple_async_report_gerror_in_idle(), but takes over the caller’s ownership of error, so the caller does not have to free it any more.

unix_is_mount_path_system_internal

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.

unix_is_system_device_path

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.

unix_is_system_fs_type

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.

unix_mount_at

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

unix_mount_compare

Compares two unix mounts.

unix_mount_copy

Makes a copy of mount_entry.

unix_mount_for

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

unix_mount_free

Frees a unix mount.

unix_mount_get_device_path

Gets the device path for a unix mount.

unix_mount_get_fs_type

Gets the filesystem type for the unix mount.

unix_mount_get_mount_path

Gets the mount path for a unix mount.

unix_mount_get_options

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

unix_mount_get_root_path

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

unix_mount_guess_can_eject

Guesses whether a Unix mount can be ejected.

unix_mount_guess_icon

Guesses the icon of a Unix mount.

unix_mount_guess_name

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

unix_mount_guess_should_display

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

unix_mount_guess_symbolic_icon

Guesses the symbolic icon of a Unix mount.

unix_mount_is_readonly

Checks if a unix mount is mounted read only.

unix_mount_is_system_internal

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.

unix_mount_points_changed_since

Checks if the unix mount points have changed since a given unix time.

unix_mount_points_get

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

unix_mounts_changed_since

Checks if the unix mounts have changed since a given unix time.

unix_mounts_get

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

Constants

DBUS_METHOD_INVOCATION_HANDLED

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.

DBUS_METHOD_INVOCATION_UNHANDLED

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.

DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAME

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

DRIVE_IDENTIFIER_KIND_UNIX_DEVICE

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

FILE_ATTRIBUTE_ACCESS_CAN_DELETE

A key in the “access” namespace for checking deletion privileges.

FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE

A key in the “access” namespace for getting execution privileges.

FILE_ATTRIBUTE_ACCESS_CAN_READ

A key in the “access” namespace for getting read privileges.

FILE_ATTRIBUTE_ACCESS_CAN_RENAME

A key in the “access” namespace for checking renaming privileges.

FILE_ATTRIBUTE_ACCESS_CAN_TRASH

A key in the “access” namespace for checking trashing privileges.

FILE_ATTRIBUTE_ACCESS_CAN_WRITE

A key in the “access” namespace for getting write privileges.

FILE_ATTRIBUTE_DOS_IS_ARCHIVE

A key in the “dos” namespace for checking if the file’s archive flag is set.

FILE_ATTRIBUTE_DOS_IS_MOUNTPOINT

A key in the “dos” namespace for checking if the file is a NTFS mount point (a volume mount or a junction point).

FILE_ATTRIBUTE_DOS_IS_SYSTEM

A key in the “dos” namespace for checking if the file’s backup flag is set.

FILE_ATTRIBUTE_DOS_REPARSE_POINT_TAG

A key in the “dos” namespace for getting the file NTFS reparse tag.

FILE_ATTRIBUTE_ETAG_VALUE

A key in the “etag” namespace for getting the value of the file’s entity tag.

FILE_ATTRIBUTE_FILESYSTEM_FREE

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

FILE_ATTRIBUTE_FILESYSTEM_READONLY

A key in the “filesystem” namespace for checking if the file system is read only.

FILE_ATTRIBUTE_FILESYSTEM_REMOTE

A key in the “filesystem” namespace for checking if the file system is remote.

FILE_ATTRIBUTE_FILESYSTEM_SIZE

A key in the “filesystem” namespace for getting the total size (in bytes) of the file system, used in g_file_query_filesystem_info().

FILE_ATTRIBUTE_FILESYSTEM_TYPE

A key in the “filesystem” namespace for getting the file system’s type.

FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW

A key in the “filesystem” namespace for hinting a file manager application whether it should preview (e.g. thumbnail) files on the file system.

FILE_ATTRIBUTE_FILESYSTEM_USED

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

FILE_ATTRIBUTE_GVFS_BACKEND

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

FILE_ATTRIBUTE_ID_FILE

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

FILE_ATTRIBUTE_ID_FILESYSTEM

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

FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT

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

FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT

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

FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL

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

FILE_ATTRIBUTE_MOUNTABLE_CAN_START

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

FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED

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

FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP

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

FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT

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

FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI

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

FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC

A key in the “mountable” namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is automatically polled for media.

FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE

A key in the “mountable” namespace for getting the GDriveStartStopType.

FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE

A key in the “mountable” namespace for getting the unix device.

FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE

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

FILE_ATTRIBUTE_OWNER_GROUP

A key in the “owner” namespace for getting the file owner’s group.

FILE_ATTRIBUTE_OWNER_USER

A key in the “owner” namespace for getting the user name of the file’s owner.

FILE_ATTRIBUTE_OWNER_USER_REAL

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

FILE_ATTRIBUTE_PREVIEW_ICON

A key in the “preview” namespace for getting a GIcon that can be used to get preview of the file.

FILE_ATTRIBUTE_RECENT_MODIFIED

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

FILE_ATTRIBUTE_SELINUX_CONTEXT

A key in the “selinux” namespace for getting the file’s SELinux context.

FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE

A key in the “standard” namespace for getting the amount of disk space that is consumed by the file (in bytes).

FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE

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

FILE_ATTRIBUTE_STANDARD_COPY_NAME

A key in the “standard” namespace for getting the copy name of the file.

FILE_ATTRIBUTE_STANDARD_DESCRIPTION

A key in the “standard” namespace for getting the description of the file.

FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME

A key in the “standard” namespace for getting the display name of the file.

FILE_ATTRIBUTE_STANDARD_EDIT_NAME

A key in the “standard” namespace for edit name of the file.

FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE

A key in the “standard” namespace for getting the fast content type.

FILE_ATTRIBUTE_STANDARD_ICON

A key in the “standard” namespace for getting the icon for the file.

FILE_ATTRIBUTE_STANDARD_IS_BACKUP

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

FILE_ATTRIBUTE_STANDARD_IS_HIDDEN

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

FILE_ATTRIBUTE_STANDARD_IS_SYMLINK

A key in the “standard” namespace for checking if the file is a symlink. Typically the actual type is something else, if we followed the symlink to get the type.

FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL

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

FILE_ATTRIBUTE_STANDARD_IS_VOLATILE

A key in the “standard” namespace for checking if a file is volatile. This is meant for opaque, non-POSIX-like backends to indicate that the URI is not persistent. Applications should look at G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET for the persistent URI.

FILE_ATTRIBUTE_STANDARD_NAME

A key in the “standard” namespace for getting the name of the file.

FILE_ATTRIBUTE_STANDARD_SIZE

A key in the “standard” namespace for getting the file’s size (in bytes).

FILE_ATTRIBUTE_STANDARD_SORT_ORDER

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

FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON

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

FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET

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

FILE_ATTRIBUTE_STANDARD_TARGET_URI

A key in the “standard” namespace for getting the target URI for the file, in the case of G_FILE_TYPE_SHORTCUT or G_FILE_TYPE_MOUNTABLE files.

FILE_ATTRIBUTE_STANDARD_TYPE

A key in the “standard” namespace for storing file types.

FILE_ATTRIBUTE_THUMBNAIL_IS_VALID

A key in the “thumbnail” namespace for checking whether the thumbnail is outdated.

FILE_ATTRIBUTE_THUMBNAIL_PATH

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

FILE_ATTRIBUTE_THUMBNAILING_FAILED

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

FILE_ATTRIBUTE_TIME_ACCESS

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

FILE_ATTRIBUTE_TIME_ACCESS_USEC

A key in the “time” namespace for getting the microseconds of the time the file was last accessed.

FILE_ATTRIBUTE_TIME_CHANGED

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

FILE_ATTRIBUTE_TIME_CHANGED_USEC

A key in the “time” namespace for getting the microseconds of the time the file was last changed.

FILE_ATTRIBUTE_TIME_CREATED

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

FILE_ATTRIBUTE_TIME_CREATED_USEC

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

FILE_ATTRIBUTE_TIME_MODIFIED

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

FILE_ATTRIBUTE_TIME_MODIFIED_USEC

A key in the “time” namespace for getting the microseconds of the time the file was last modified.

FILE_ATTRIBUTE_TRASH_DELETION_DATE

A key in the “trash” namespace for getting the deletion date and time of a file inside the trash:/// folder.

FILE_ATTRIBUTE_TRASH_ITEM_COUNT

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

FILE_ATTRIBUTE_TRASH_ORIG_PATH

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

FILE_ATTRIBUTE_UNIX_BLOCK_SIZE

A key in the “unix” namespace for getting the block size for the file system.

FILE_ATTRIBUTE_UNIX_BLOCKS

A key in the “unix” namespace for getting the number of blocks allocated for the file.

FILE_ATTRIBUTE_UNIX_DEVICE

A key in the “unix” namespace for getting the device id of the device the file is located on (see stat() documentation).

FILE_ATTRIBUTE_UNIX_GID

A key in the “unix” namespace for getting the group ID for the file.

FILE_ATTRIBUTE_UNIX_INODE

A key in the “unix” namespace for getting the inode of the file.

FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT

A key in the “unix” namespace for checking if the file represents a UNIX mount point.

FILE_ATTRIBUTE_UNIX_MODE

A key in the “unix” namespace for getting the mode of the file (e.g. whether the file is a regular file, symlink, etc).

FILE_ATTRIBUTE_UNIX_NLINK

A key in the “unix” namespace for getting the number of hard links for a file.

FILE_ATTRIBUTE_UNIX_RDEV

A key in the “unix” namespace for getting the device ID for the file (if it is a special file).

FILE_ATTRIBUTE_UNIX_UID

A key in the “unix” namespace for getting the user ID for the file.

MEMORY_MONITOR_EXTENSION_POINT_NAME

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

MENU_ATTRIBUTE_ACTION

The menu item attribute which holds the action name of the item. Action names are namespaced with an identifier for the action group in which the action resides. For example, “win.” for window-specific actions and “app.” for application-wide actions.

MENU_ATTRIBUTE_ACTION_NAMESPACE

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

MENU_ATTRIBUTE_ICON

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

MENU_ATTRIBUTE_LABEL

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

MENU_ATTRIBUTE_TARGET

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

MENU_LINK_SECTION

The name of the link that associates a menu item with a section. The linked menu will usually be shown in place of the menu item, using the item’s label as a header.

MENU_LINK_SUBMENU

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

NATIVE_VOLUME_MONITOR_EXTENSION_POINT_NAME
NETWORK_MONITOR_EXTENSION_POINT_NAME

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

POWER_PROFILE_MONITOR_EXTENSION_POINT_NAME

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

PROXY_EXTENSION_POINT_NAME

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

PROXY_RESOLVER_EXTENSION_POINT_NAME

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

SETTINGS_BACKEND_EXTENSION_POINT_NAME

Extension point for GSettingsBackend functionality.

TLS_BACKEND_EXTENSION_POINT_NAME

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

TLS_DATABASE_PURPOSE_AUTHENTICATE_CLIENT

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

TLS_DATABASE_PURPOSE_AUTHENTICATE_SERVER

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

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

VOLUME_IDENTIFIER_KIND_CLASS

The string used to obtain the volume class with g_volume_get_identifier().

VOLUME_IDENTIFIER_KIND_HAL_UDI

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

VOLUME_IDENTIFIER_KIND_LABEL

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

VOLUME_IDENTIFIER_KIND_NFS_MOUNT

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

VOLUME_IDENTIFIER_KIND_UNIX_DEVICE

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

VOLUME_IDENTIFIER_KIND_UUID

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

VOLUME_MONITOR_EXTENSION_POINT_NAME

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