Expand description
§Rust GIO bindings
Rust bindings and wrappers for GIO, part of gtk-rs-core.
GIO 2.56 is the lowest supported version for the underlying library.
§Minimum supported Rust version
Currently, the minimum supported Rust version is 1.83.0.
§Documentation
§Using
We recommend using crates from crates.io, as demonstrated here.
If you want to track the bleeding edge, use the git dependency instead:
[dependencies]
gio = { git = "https://github.com/gtk-rs/gtk-rs-core.git", package = "gio" }Avoid mixing versioned and git crates like this:
# This will not compile
[dependencies]
gio = "0.13"
gio = { git = "https://github.com/gtk-rs/gtk-rs-core.git", package = "gio" }§See Also
§License
gio is available under the MIT License, please refer to it.
Re-exports§
Modules§
Macros§
- resources_register_ include 
- Include gresources generated with glib_build_tools::compile_resourcesand register with glib.pathis relative toOUTDIR.
Structs§
- Action
- GActionrepresents a single named action.
- ActionEntry 
- This struct defines a single action.  It is for use with
ActionMapExtManual::add_action_entries().
- ActionEntry Builder 
- ActionGroup 
- GActionGrouprepresents a group of actions.
- ActionGroup Export Id 
- ActionMap 
- GActionMapis an interface for action containers.
- AppInfo
- Information about an installed application and methods to launch it (with file arguments).
- AppInfoCreate Flags 
- Flags used when creating a #GAppInfo.
- AppInfoMonitor 
- GAppInfoMonitormonitors application information for changes.
- 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
- GApplicationis the core class for application support.
- ApplicationBusy Guard 
- ApplicationCommand Line 
- GApplicationCommandLinerepresents a command-line invocation of an application.
- ApplicationFlags 
- Flags used to define the behaviour of a #GApplication.
- ApplicationHold Guard 
- AskPasswordFlags 
- #GAskPasswordFlags are used to request specific information from the user, or to notify the user of their choices in an authentication situation.
- AsyncInitable 
- GAsyncInitableis an interface for asynchronously initializable objects.
- AsyncResult 
- GAsyncResultprovides a base class for implementing asynchronous function results.
- BindingBuilder 
- BufferedInput Stream 
- Buffered input stream implements FilterInputStreamand provides for buffered reads.
- BufferedOutput Stream 
- Buffered output stream implements FilterOutputStreamand provides for buffered writes.
- BusNameOwner Flags 
- Flags used in g_bus_own_name().
- BusNameWatcher Flags 
- Flags used in g_bus_watch_name().
- BytesIcon 
- GBytesIconspecifies an image held in memory in a common format (usually PNG) to be used as icon.
- Cancellable
- GCancellableallows operations to be cancelled.
- CancellableFuture 
- A future which can be cancelled via Cancellable.
- Cancelled
- Indicator that the CancellableFuturewas cancelled.
- CancelledHandler Id 
- The id of a cancelled handler that is returned by CancellableExtManual::connect. This type is analogous toglib::SignalHandlerId.
- CharsetConverter 
- GCharsetConverteris an implementation of- Converterbased on- GLib::IConv.
- Converter
- GConverteris an interface for streaming conversions.
- ConverterFlags 
- Flags used when calling a g_converter_convert().
- ConverterInput Stream 
- Converter input stream implements InputStreamand allows conversion of data of various types during reading.
- ConverterOutput Stream 
- Converter output stream implements OutputStreamand allows conversion of data of various types during reading.
- Credentials
- The GCredentialstype is a reference-counted wrapper for native credentials.
- DBusAction Group 
- GDBusActionGroupis an implementation of the- ActionGroupinterface.
- DBusArgInfo 
- Information about an argument for a method or a signal.
- DBusAuth Observer 
- GDBusAuthObserverprovides a mechanism for participating in how a- DBusServer(or a- DBusConnection) authenticates remote peers.
- DBusCall Flags 
- Flags used in g_dbus_connection_call() and similar APIs.
- DBusCapability Flags 
- Capabilities negotiated with the remote peer.
- DBusConnection 
- The GDBusConnectiontype is used for D-Bus connections to remote peers such as a message buses.
- DBusConnection Flags 
- Flags used when creating a new #GDBusConnection.
- DBusInterface 
- Base type for D-Bus interfaces.
- DBusInterface Info 
- Information about a D-Bus interface.
- DBusInterface Skeleton 
- Abstract base class for D-Bus interfaces on the service side.
- DBusInterface Skeleton Flags 
- Flags describing the behavior of a #GDBusInterfaceSkeleton instance.
- DBusMenu Model 
- GDBusMenuModelis an implementation of- MenuModelthat can be used as a proxy for a menu model that is exported over D-Bus with- DBusConnection::export_menu_model().
- DBusMessage 
- A type for representing D-Bus messages that can be sent or received
on a DBusConnection.
- DBusMessage Flags 
- Message flags used in #GDBusMessage.
- DBusMethod Info 
- Information about a method on a D-Bus interface.
- DBusMethod Invocation 
- Instances of the GDBusMethodInvocationclass are used when handling D-Bus method calls. It provides a way to asynchronously return results and errors.
- DBusNode Info 
- Information about nodes in a remote object hierarchy.
- DBusObject 
- The GDBusObjecttype is the base type for D-Bus objects on both the service side (seeDBusObjectSkeleton) and the client side (seeDBusObjectProxy). It is essentially just a container of interfaces.
- DBusObject Manager 
- The GDBusObjectManagertype is the base type for service- and client-side implementations of the standardizedorg.freedesktop.DBus.ObjectManagerinterface.
- DBusObject Manager Client Flags 
- Flags used when constructing a #GDBusObjectManagerClient.
- DBusObject Manager Server 
- GDBusObjectManagerServeris used to export- DBusObjectinstances using the standardized- org.freedesktop.DBus.ObjectManagerinterface. 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.
- DBusObject Proxy 
- A GDBusObjectProxyis an object used to represent a remote object with one or more D-Bus interfaces. Normally, you don’t instantiate aGDBusObjectProxyyourself — typicallyGio::DBusObjectManagerClientis used to obtain it.
- DBusObject Skeleton 
- A GDBusObjectSkeletoninstance is essentially a group of D-Bus interfaces. The set of exported interfaces on the object may be dynamic and change at runtime.
- DBusProperty Info 
- Information about a D-Bus property on a D-Bus interface.
- DBusProperty Info Flags 
- Flags describing the access control of a D-Bus property.
- DBusProxy 
- GDBusProxyis a base class used for proxies to access a D-Bus interface on a remote object. A- GDBusProxycan be constructed for both well-known and unique names.
- DBusProxy Flags 
- Flags used when constructing an instance of a #GDBusProxy derived class.
- DBusSend Message Flags 
- Flags used when sending #GDBusMessages on a #GDBusConnection.
- DBusServer 
- GDBusServeris 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.DBusinterface.
- DBusServer Flags 
- Flags used when creating a #GDBusServer.
- DBusSignal Flags 
- Flags used when subscribing to signals via g_dbus_connection_signal_subscribe().
- DBusSignal Info 
- Information about a signal on a D-Bus interface.
- DBusSubtree Flags 
- Flags passed to g_dbus_connection_register_subtree().
- DataInput Stream 
- Data input stream implements InputStreamand includes functions for reading structured data directly from a binary input stream.
- DataOutput Stream 
- Data output stream implements OutputStreamand includes functions for writing data directly to an output stream.
- DatagramBased 
- Interface for socket-like objects with datagram semantics.
- DebugController v2_72
- GDebugControlleris an interface to expose control of debugging features and debug output.
- DebugControllerD Bus v2_72
- GDebugControllerDBusis an implementation of- DebugControllerwhich exposes debug settings as a D-Bus object.
- DesktopAppInfo Non-Windows and non-macOS 
- GDesktopAppInfois an implementation of- AppInfobased on desktop files.
- Drive
- GDriverepresents a piece of hardware connected to the machine. It’s generally only created for removable hardware or hardware with removable media. For example, an optical disc drive, or a USB flash drive.
- DriveStart Flags 
- Flags used when starting a drive.
- DtlsClient Connection 
- GDtlsClientConnectionis the client-side subclass of- DtlsConnection, representing a client-side DTLS connection.
- DtlsConnection 
- GDtlsConnectionis the base DTLS connection class type, which wraps a- DatagramBasedand provides DTLS encryption on top of it. Its subclasses,- DtlsClientConnectionand- DtlsServerConnection, implement client-side and server-side DTLS, respectively.
- DtlsServer Connection 
- GDtlsServerConnectionis the server-side subclass of- DtlsConnection, representing a server-side DTLS connection.
- Emblem
- GEmblemis an implementation of- Iconthat supports having an emblem, which is an icon with additional properties. It can than be added to a- EmblemedIcon.
- EmblemedIcon 
- GEmblemedIconis an implementation of- Iconthat supports adding an emblem to an icon. Adding multiple emblems to an icon is ensured via- EmblemedIconExt::add_emblem().
- File
- GFileis 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- GFileobjects do not represent files, merely an identifier for a file. All file content I/O is implemented as streaming operations (see- InputStreamand- OutputStream).
- FileAttribute Info 
- Information about a specific attribute.
- FileAttribute Info Flags 
- Flags specifying the behaviour of an attribute.
- FileAttribute Info List 
- Acts as a lightweight registry for possible valid file attributes. The registry stores Key-Value pair formats as #GFileAttributeInfos.
- FileAttribute Matcher 
- Determines if a string matches a file attribute.
- FileAttribute Value 
- FileAttributematcher Iter 
- FileCopy Flags 
- Flags used when copying or moving files.
- FileCreate Flags 
- Flags used when an operation may create a file.
- FileDescriptor Based 
- GFileDescriptorBasedis an interface for file descriptor based IO.
- FileEnumerator 
- GFileEnumeratorallows you to operate on a set of- Fileobjects, returning a- FileInfostructure for each file enumerated (e.g.- FileExt::enumerate_children()will return a- GFileEnumeratorfor each of the children within a directory).
- FileEnumerator Stream 
- A Streamused to enumerate files in directories.
- FileIOStream 
- GFileIOStreamprovides I/O streams that both read and write to the same file handle.
- FileIcon 
- GFileIconspecifies an icon by pointing to an image file to be used as icon.
- FileInfo 
- Stores information about a file system object referenced by a File.
- FileInput Stream 
- GFileInputStreamprovides input streams that take their content from a file.
- FileMeasure Flags 
- Flags that can be used with g_file_measure_disk_usage().
- FileMonitor 
- Monitors a file or directory for changes.
- FileMonitor Flags 
- Flags used to set what a #GFileMonitor will watch for.
- FileOutput Stream 
- GFileOutputStreamprovides output streams that write their content to a file.
- FileQuery Info Flags 
- Flags used when querying a #GFileInfo.
- 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.
- FilterId 
- FilterInput Stream 
- 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.
- FilterOutput Stream 
- 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.
- GioFuture
- GioFutureResult 
- IOExtension
- The implementation of an IOExtensionPoint. #GIOExtension is an opaque data structure and can only be accessed using the following functions.
- IOExtensionPoint 
- An extension point provides a mechanism to extend the functionality of a library or application.
Each extension point is identified by a name, and it may optionally require that any implementation
must be of a certain type.
GIOExtensionPointprovides a mechanism for modules to extend the functionality of the library or application that loaded it in an organized fashion.
- IOExtensionPoint Builder 
- Builder for extension points.
- IOStream
- GIOStreamrepresents 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.
- IOStreamAsync Read Write 
- IOStreamSplice Flags 
- GIOStreamSpliceFlags determine how streams should be spliced.
- Icon
- GIconis 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.
- InetAddress 
- GInetAddressrepresents an IPv4 or IPv6 internet address. Use- ResolverExt::lookup_by_name()or- ResolverExt::lookup_by_name_async()to look up the- GInetAddressfor a hostname. Use- ResolverExt::lookup_by_address()or- ResolverExt::lookup_by_address_async()to look up the hostname for a- GInetAddress.
- InetAddress Mask 
- GInetAddressMaskrepresents 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. For example,- 10.0.0.0/8, or- fe80::/10.
- InetSocket Address 
- An IPv4 or IPv6 socket address. That is, the combination of a
InetAddressand a port number.
- Initable
- GInitableis 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- InitableExt::init()or- AsyncInitableExt::init_async()(the latter is only available if it also implements- AsyncInitable).
- 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.
- InputStream 
- GInputStreamis a base class for implementing streaming input.
- InputStream Async BufRead 
- InputStream Async Read 
- InputStream Read 
- InputVector 
- JoinHandle 
- A handle to a task running on the I/O thread pool.
- ListModel 
- GListModelis an interface that represents a mutable list of- glib::Object. 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.
- ListStore 
- GListStoreis a simple implementation of- ListModelthat stores all items in memory.
- LoadableIcon 
- GLoadableIconextends the- Iconinterface and adds the ability to load icons from streams.
- LocalTask 
- LocalTaskprovides idiomatic access to gio’s- GTaskAPI, for instance by being generic over their value type, while not completely departing from the underlying C API.- LocalTaskdoes not require its value to be- Sendand- Syncand thus is useful to to implement gio style asynchronous tasks that run in the glib main loop. If you need to run tasks in threads see the- Tasktype.
- MemoryInput Stream 
- GMemoryInputStreamis a class for using arbitrary memory chunks as input for GIO streaming input operations.
- MemoryMonitor v2_64
- GMemoryMonitorwill 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).
- MemoryOutput Stream 
- GMemoryOutputStreamis a class for using arbitrary memory chunks as output for GIO streaming output operations.
- Menu
- GMenuis a simple implementation of- MenuModel. You populate a- GMenuby adding- MenuIteminstances to it.
- MenuAttribute Iter 
- #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.
- MenuLink Iter 
- #GMenuLinkIter is an opaque structure type. You must access it using the functions below.
- MenuModel 
- GMenuModelrepresents 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.
- MenuModel Export Id 
- Mount
- The GMountinterface represents a user-visible mount, such as a mounted file system.
- MountMount Flags 
- Flags used when mounting a mount.
- MountOperation 
- GMountOperationprovides 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.
- MountUnmount Flags 
- Flags used when an unmounting a mount.
- NativeSocket Address 
- A socket address of some unknown native type.
- NativeVolume Monitor 
- This is an Abstract Base Class, you cannot instantiate it.
- NetworkAddress 
- GNetworkAddressprovides 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.
- NetworkMonitor 
- GNetworkMonitorprovides 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.
- NetworkService 
- Like NetworkAddressdoes with hostnames,GNetworkServiceprovides 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
- GNotificationis a mechanism for creating a notification to be shown to the user — typically as a pop-up notification presented by the desktop environment shell.
- 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.
- OutputStream 
- GOutputStreamis a base class for implementing streaming output.
- OutputStream Async Write 
- OutputStream Splice Flags 
- GOutputStreamSpliceFlags determine how streams should be spliced.
- OutputStream Write 
- OutputVector 
- OwnerId
- Permission
- A GPermissionrepresents the status of the caller’s permission to perform a certain action.
- PollableInput Stream 
- GPollableInputStreamis implemented by- InputStreams 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.
- PollableOutput Stream 
- GPollableOutputStreamis implemented by- OutputStreams 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.
- PowerProfile Monitor v2_70
- GPowerProfileMonitormakes 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).
- PropertyAction 
- A GPropertyActionis a way to get aActionwith a state value reflecting and controlling the value of aglib::Objectproperty.
- Proxy
- A GProxyhandles connecting to a remote host via a given type of proxy server. It is implemented by thegio-proxyextension point. The extensions are named after their proxy protocol name. As an example, a SOCKS5 proxy implementation can be retrieved with the namesocks5using the functionIOExtensionPoint::extension_by_name().
- ProxyAddress 
- A InetSocketAddressrepresenting a connection via a proxy server.
- ProxyAddress Enumerator 
- GProxyAddressEnumeratoris a wrapper around- SocketAddressEnumeratorwhich takes the- SocketAddressinstances returned by the- SocketAddressEnumeratorand wraps them in- ProxyAddressinstances, using the given- proxy-resolver.
- ProxyResolver 
- GProxyResolverprovides synchronous and asynchronous network proxy resolution.- GProxyResolveris used within- SocketClientthrough the method- SocketConnectableExt::proxy_enumerate().
- ReadInput Stream 
- GLib type: GObject with reference counted clone semantics.
- RegistrationBuilder 
- Build a registered DBus object, by handling different parts of DBus.
- RegistrationId 
- RemoteAction Group 
- The GRemoteActionGroupinterface is implemented byActionGroupinstances that either transmit action invocations to other processes or receive action invocations in the local process from other processes.
- Resolver
- The object that handles DNS resolution. Use default()to get the default resolver.
- ResolverName Lookup Flags v2_60
- Flags to modify lookup behavior.
- Resource
- Applications and libraries often contain binary or textual data that is
really part of the application, rather than user data. For instance
GtkBuilder.uifiles, splashscreen images,Menumarkup XML, CSS files, icons, etc. These are often shipped as files in$datadir/appname, or manually included as literal strings in the code.
- ResourceFlags 
- GResourceFlags give information about a particular file inside a resource bundle.
- ResourceLookup Flags 
- GResourceLookupFlags determine how resource path lookups are handled.
- Seekable
- GSeekableis implemented by streams (implementations of- InputStreamor- OutputStream) that support seeking.
- Settings
- The GSettingsclass provides a convenient API for storing and retrieving application settings.
- SettingsBackend 
- The GSettingsBackendinterface defines a generic interface for non-strictly-typed data that is stored in a hierarchy. To implement an alternative storage backend forSettings, you need to implement theGSettingsBackendinterface and then make it implement the extension pointG_SETTINGS_BACKEND_EXTENSION_POINT_NAME.
- SettingsBind Flags 
- Flags used when creating a binding.
- SettingsSchema 
- The SettingsSchemaSourceandGSettingsSchemaAPIs provide a mechanism for advanced control over the loading of schemas and a mechanism for introspecting their content.
- SettingsSchema Key 
- #GSettingsSchemaKey is an opaque data structure and can only be accessed using the following functions.
- SettingsSchema Source 
- This is an opaque structure type. You may not access it directly.
- SignalSubscription Id 
- SimpleAction 
- A GSimpleActionis the obvious simple implementation of theActioninterface. This is the easiest way to create an action for purposes of adding it to aSimpleActionGroup.
- SimpleAction Group 
- GSimpleActionGroupis a hash table filled with- Actionobjects, implementing the- ActionGroupand- ActionMapinterfaces.
- SimpleIOStream 
- GSimpleIOStreamcreates a- IOStreamfrom an arbitrary- InputStreamand- OutputStream. This allows any pair of input and output streams to be used with- IOStreammethods.
- SimplePermission 
- GSimplePermissionis a trivial implementation of- Permissionthat represents a permission that is either always or never allowed. The value is given at construction and doesn’t change.
- SimpleProxy Resolver 
- GSimpleProxyResolveris a simple- ProxyResolverimplementation 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 GSocketis 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 
- GSocketAddressis the equivalent of- struct sockaddrand its subtypes in the BSD sockets API. This is an abstract class; use- InetSocketAddressfor internet sockets, or- UnixSocketAddressfor UNIX domain sockets.
- SocketAddress Enumerator 
- GSocketAddressEnumeratoris an enumerator type for- SocketAddressinstances. It is returned by enumeration functions such as- SocketConnectableExt::enumerate(), which returns a- GSocketAddressEnumeratorto list each- SocketAddresswhich could be used to connect to that- SocketConnectable.
- SocketClient 
- GSocketClientis a lightweight high-level utility class for connecting to a network host using a connection oriented socket type.
- SocketConnectable 
- Objects that describe one or more potential socket endpoints
implement GSocketConnectable. Callers can then useSocketConnectableExt::enumerate()to get aSocketAddressEnumeratorto try out each socket address in turn until one succeeds, as shown in the sample code below.
- SocketConnection 
- GSocketConnectionis a- IOStreamfor a connected socket. They can be created either by- SocketClientwhen connecting to a host, or by- SocketListenerwhen accepting a new client.
- SocketControl Message 
- A GSocketControlMessageis a special-purpose utility message that can be sent to or received from aSocket. These types of messages are often called ‘ancillary data’.
- SocketControl Messages 
- SocketListener 
- A GSocketListeneris 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.
- 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.
- SocketService 
- A GSocketServiceis 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 theincomingsignal is emitted.
- SrvTarget
- A single target host/port that a network service is running on.
- Subprocess
- GSubprocessallows the creation of and interaction with child processes.
- SubprocessFlags 
- Flags to define the behaviour of a #GSubprocess.
- 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
- Taskprovides idiomatic access to gio’s- GTaskAPI, for instance by being generic over their value type, while not completely departing from the underlying C API.- Taskis- Sendand- Syncand requires its value to also be- Sendand- Sync, thus is useful to to implement gio style asynchronous tasks that run in threads. If you need to only run tasks in glib main loop see the- LocalTasktype.
- TcpConnection
- This is the subclass of SocketConnectionthat is created for TCP/IP sockets.
- TcpWrapperConnection 
- A GTcpWrapperConnectioncan be used to wrap aIOStreamthat is based on aSocket, but which is not actually aSocketConnection. This is used bySocketClientso that it can always return aSocketConnection, even when the connection it has actually created is not directly aSocketConnection.
- TestDBus 
- A helper class for testing code which uses D-Bus without touching the user’s session bus.
- TestDBusFlags 
- Flags to define future #GTestDBus behaviour.
- ThemedIcon 
- GThemedIconis an implementation of- Iconthat supports icon themes.
- ThreadedSocket Service 
- A GThreadedSocketServiceis a simple subclass ofSocketServicethat handles incoming connections by creating a worker thread and dispatching the connection to it by emitting therunsignal] in the new thread.
- TlsBackend
- TLS (Transport Layer Security, aka SSL) and DTLS backend. This is an internal type used to coordinate the different classes implemented by a TLS backend.
- 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
TlsServerConnection).
- TlsCertificateFlags 
- A set of flags describing TLS certification validation. This can be used to describe why a particular certificate was rejected (for example, in #GTlsConnection::accept-certificate).
- TlsClientConnection 
- GTlsClientConnectionis the client-side subclass of- TlsConnection, representing a client-side TLS connection.
- TlsConnection
- GTlsConnectionis the base TLS connection class type, which wraps a- IOStreamand provides TLS encryption on top of it. Its subclasses,- TlsClientConnectionand- TlsServerConnection, implement client-side and server-side TLS, respectively.
- TlsDatabase
- GTlsDatabaseis 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.
- TlsDatabaseVerify Flags 
- Flags for g_tls_database_verify_chain().
- TlsFileDatabase 
- GTlsFileDatabaseis implemented by- TlsDatabaseobjects which load their certificate information from a file. It is an interface which TLS library specific subtypes implement.
- TlsInteraction
- GTlsInteractionprovides 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
- An abstract interface representing a password used in TLS. Often used in user interaction such as unlocking a key storage token.
- TlsPasswordFlags 
- Various flags for the password.
- TlsServerConnection 
- GTlsServerConnectionis the server-side subclass of- TlsConnection, representing a server-side TLS connection.
- UnixConnection Unix 
- This is the subclass of SocketConnectionthat is created for UNIX domain sockets.
- UnixCredentials Message Unix 
- This SocketControlMessagecontains aCredentialsinstance. It may be sent usingSocketExtManual::send_message()and received usingSocketExtManual::receive_message()over UNIX sockets (ie: sockets in theG_SOCKET_FAMILY_UNIXfamily).
- UnixFDList Unix 
- A GUnixFDListcontains a list of file descriptors. It owns the file descriptors that it contains, closing them when finalized.
- UnixFDMessage Unix 
- This SocketControlMessagecontains aUnixFDList. It may be sent usingSocketExtManual::send_message()and received usingSocketExtManual::receive_message()over UNIX sockets (ie: sockets in theG_SOCKET_FAMILY_UNIXfamily). The file descriptors are copied between processes by the kernel.
- UnixInput Stream Unix 
- GUnixInputStreamimplements- InputStreamfor 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.)
- UnixMount Entry Unix 
- Defines a Unix mount entry (e.g. /media/cdrom). This corresponds roughly to a mtab entry.
- UnixMount Monitor Unix 
- Watches for changes to the set of mount entries and mount points in the system.
- UnixMount Point Unix 
- Defines a Unix mount point (e.g. /dev). This corresponds roughly to a fstab entry.
- UnixOutput Stream Unix 
- GUnixOutputStreamimplements- OutputStreamfor 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.)
- UnixSocket Address Unix 
- Support for UNIX-domain (also known as local) sockets, corresponding to
struct sockaddr_un.
- Vfs
- Entry point for using GIO functionality.
- Volume
- The GVolumeinterface represents user-visible objects that can be mounted. For example, a file system partition on a USB flash drive, or an optical disc inserted into a disc drive.
- VolumeMonitor 
- GVolumeMonitoris 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.
- WatcherId 
- WriteOutput Stream 
- GLib type: GObject with reference counted clone semantics.
- ZlibCompressor 
- GZlibCompressoris an implementation of- Converterthat compresses data using zlib.
- ZlibDecompressor 
- GZlibDecompressoris an implementation of- Converterthat decompresses data compressed with zlib.
Enums§
- BusType
- An enumeration for well-known message buses.
- ConverterResult 
- Results returned from g_converter_convert().
- CredentialsType 
- Enumeration describing different kinds of native credential types.
- DBusError 
- Error codes for the G_DBUS_ERRORerror domain.
- DBusMessage Byte Order 
- Enumeration used to describe the byte order of a D-Bus message.
- DBusMessage Header Field 
- Header fields used in #GDBusMessage.
- DBusMessage Type 
- Message types used in #GDBusMessage.
- DataStream Byte Order 
- #GDataStreamByteOrder is used to ensure proper endianness of streaming data sources across various machine architectures.
- DataStream Newline Type 
- #GDataStreamNewlineType is used when checking for or setting the line endings for a given file.
- DriveStart Stop Type 
- Enumeration describing how a drive can be started/stopped.
- EmblemOrigin 
- GEmblemOrigin is used to add information about the origin of the emblem to #GEmblem.
- FileAttribute Status 
- Used by g_file_set_attributes_from_info() when setting file attributes.
- FileAttribute Type 
- The data types for file attributes.
- FileMonitor Event 
- Specifies what type of event a monitor event is.
- FileType 
- Indicates the file’s on-disk type.
- FilesystemPreview Type 
- Indicates a hint from the file system whether files should be
previewed in a file manager. Returned as the value of the key
FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW.
- IOErrorEnum 
- Error codes returned by GIO functions.
- IOModuleScope Flags 
- Flags for use with g_io_module_scope_new().
- InetAddress Bytes 
- MemoryMonitor Warning Level v2_64
- Memory availability warning levels.
- MountOperation Result 
- #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 v2_60
- Return value for various IO operations that signal errors via the return value and not necessarily via a #GError.
- ResolverError 
- An error code used with G_RESOLVER_ERRORin a #GError returned from a #GResolver routine.
- ResolverRecord Type 
- 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.
- ResourceError 
- An error code used with G_RESOURCE_ERRORin a #GError returned from a #GResource routine.
- SocketClient Event 
- 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_INET6andAF_UNIX, if available.)
- SocketListener Event 
- 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.
- TlsCertificateRequest Flags 
- Flags for g_tls_interaction_request_certificate(), g_tls_interaction_request_certificate_async(), and g_tls_interaction_invoke_request_certificate().
- TlsChannelBinding Error v2_66
- An error code used with G_TLS_CHANNEL_BINDING_ERRORin a #GError to indicate a TLS channel binding retrieval error.
- TlsChannelBinding Type v2_66
- The type of TLS channel binding data to retrieve from #GTlsConnection
or #GDtlsConnection, as documented by RFC 5929 or RFC 9266. The
tls-unique-for-telnetbinding type is not currently implemented.
- TlsDatabaseLookup Flags 
- Flags for g_tls_database_lookup_certificate_for_handle(), g_tls_database_lookup_certificate_issuer(), and g_tls_database_lookup_certificates_issued_by().
- TlsError
- An error code used with G_TLS_ERRORin a #GError returned from a TLS-related routine.
- TlsInteractionResult 
- #GTlsInteractionResult is returned by various functions in #GTlsInteraction when finishing an interaction request.
- TlsProtocolVersion v2_70
- 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
Unknownif 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 Deprecated 
- When to allow rehandshaking. See g_tls_connection_set_rehandshake_mode().
- UnixSocket Address Type Unix 
- The type of name used by a #GUnixSocketAddress.
Pathindicates a traditional unix domain socket bound to a filesystem path.Anonymousindicates a socket not bound to any name (eg, a client-side socket, or a socket created with socketpair()).
- ZlibCompressor Format 
- Used to select the type of data format to use for #GZlibDecompressor and #GZlibCompressor.
Statics§
- DEBUG_CONTROLLER_ EXTENSION_ POINT_ NAME v2_72
- Extension point for debug control functionality. See Extending GIO.
- DRIVE_IDENTIFIER_ KIND_ UNIX_ DEVICE v2_58
- 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 v2_60
- 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 v2_60
- 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_ USED 
- A key in the “filesystem” namespace for getting the number of bytes used by data on the file system.
- 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_ 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 FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGETfor 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 FileType::ShortcutorFileType::Mountablefiles.
- FILE_ATTRIBUTE_ STANDARD_ TYPE 
- A key in the “standard” namespace for storing file types.
- FILE_ATTRIBUTE_ THUMBNAILING_ FAILED 
- A key in the “thumbnail” namespace for checking if thumbnailing failed.
- FILE_ATTRIBUTE_ THUMBNAILING_ FAILED_ LARGE v2_76
- A key in the “thumbnail” namespace for checking if thumbnailing failed for the large image.
- FILE_ATTRIBUTE_ THUMBNAILING_ FAILED_ NORMAL v2_76
- A key in the “thumbnail” namespace for checking if thumbnailing failed for the normal image.
- FILE_ATTRIBUTE_ THUMBNAILING_ FAILED_ XLARGE v2_76
- A key in the “thumbnail” namespace for checking if thumbnailing failed for the x-large image.
- FILE_ATTRIBUTE_ THUMBNAILING_ FAILED_ XXLARGE v2_76
- A key in the “thumbnail” namespace for checking if thumbnailing failed for the xx-large image.
- FILE_ATTRIBUTE_ THUMBNAIL_ IS_ VALID 
- A key in the “thumbnail” namespace for checking whether the thumbnail is outdated.
- FILE_ATTRIBUTE_ THUMBNAIL_ IS_ VALID_ LARGE v2_76
- A key in the “thumbnail” namespace for checking whether the large thumbnail is outdated.
- FILE_ATTRIBUTE_ THUMBNAIL_ IS_ VALID_ NORMAL v2_76
- A key in the “thumbnail” namespace for checking whether the normal thumbnail is outdated.
- FILE_ATTRIBUTE_ THUMBNAIL_ IS_ VALID_ XLARGE v2_76
- A key in the “thumbnail” namespace for checking whether the x-large thumbnail is outdated.
- FILE_ATTRIBUTE_ THUMBNAIL_ IS_ VALID_ XXLARGE v2_76
- A key in the “thumbnail” namespace for checking whether the xx-large thumbnail is outdated.
- FILE_ATTRIBUTE_ THUMBNAIL_ PATH 
- A key in the “thumbnail” namespace for getting the path to the thumbnail image with the biggest size available.
- FILE_ATTRIBUTE_ THUMBNAIL_ PATH_ LARGE v2_76
- A key in the “thumbnail” namespace for getting the path to the large thumbnail image.
- FILE_ATTRIBUTE_ THUMBNAIL_ PATH_ NORMAL v2_76
- A key in the “thumbnail” namespace for getting the path to the normal thumbnail image.
- FILE_ATTRIBUTE_ THUMBNAIL_ PATH_ XLARGE v2_76
- A key in the “thumbnail” namespace for getting the path to the x-large thumbnail image.
- FILE_ATTRIBUTE_ THUMBNAIL_ PATH_ XXLARGE v2_76
- A key in the “thumbnail” namespace for getting the path to the xx-large thumbnail image.
- FILE_ATTRIBUTE_ TIME_ ACCESS 
- A key in the “time” namespace for getting the time the file was last accessed.
- FILE_ATTRIBUTE_ TIME_ ACCESS_ NSEC v2_74
- A key in the “time” namespace for getting the nanoseconds of the time
the file was last accessed. This should be used in conjunction with
#G_FILE_ATTRIBUTE_TIME_ACCESS. Corresponding #GFileAttributeType is
FileAttributeType::Uint32.
- 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_ NSEC v2_74
- A key in the “time” namespace for getting the nanoseconds of the time
the file was last changed. This should be used in conjunction with
#G_FILE_ATTRIBUTE_TIME_CHANGED. Corresponding #GFileAttributeType is
FileAttributeType::Uint32.
- 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_ NSEC v2_74
- A key in the “time” namespace for getting the nanoseconds of the time
the file was created. This should be used in conjunction with
#G_FILE_ATTRIBUTE_TIME_CREATED. Corresponding #GFileAttributeType is
FileAttributeType::Uint32.
- 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_ NSEC v2_74
- A key in the “time” namespace for getting the nanoseconds of the time
the file was last modified. This should be used in conjunction with
#G_FILE_ATTRIBUTE_TIME_MODIFIED. Corresponding #GFileAttributeType is
FileAttributeType::Uint32.
- 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_ BLOCKS 
- A key in the “unix” namespace for getting the number of blocks allocated for the file.
- FILE_ATTRIBUTE_ UNIX_ BLOCK_ SIZE 
- A key in the “unix” namespace for getting the block size for the file system.
- 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 v2_64
- Extension point for memory usage monitoring functionality. See 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.
- POWER_PROFILE_ MONITOR_ EXTENSION_ POINT_ NAME v2_70
- Extension point for power profile usage monitoring functionality. See Extending GIO.
- PROXY_EXTENSION_ POINT_ NAME 
- Extension point for proxy functionality. See Extending GIO.
- PROXY_RESOLVER_ EXTENSION_ POINT_ NAME 
- Extension point for proxy resolving functionality. See 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.
- 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.
- VOLUME_IDENTIFIER_ KIND_ CLASS 
- The string used to obtain the volume class with g_volume_get_identifier().
- VOLUME_IDENTIFIER_ KIND_ HAL_ UDI Deprecated 
- 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.
Functions§
- bus_own_ name 
- Requests ownership of @name on the bus specified by @bus_type.
- bus_own_ name_ on_ connection 
- Like bus_own_name()but takes aDBusConnectioninstead of aBusType.
- bus_unown_ name 
- bus_unwatch_ 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
(see [glib::MainContext::push_thread_default()][crate::glib::MainContext::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.
- spawn_blocking 
- Runs a blocking I/O task on the I/O thread pool.