GIO Reference Manual

for GIO 2.28.8 The latest version of this documentation can be found on-line at http://library.gnome.org/devel/gio/unstable/.

I. GIO Overview

Introduction
Compiling GIO applications
Running GIO applications
Extending GIO

II. API Reference

File Operations

GFile — File and Directory Handling
GFileAttribute — Key-Value Paired File Attributes
GFileInfo — File Information and Attributes
GFileEnumerator — Enumerated Files Routines
GIOError — Error helper functions
GMountOperation — Object used for authentication and user interaction

File System Monitoring

GFileMonitor — File Monitor

File-related Utilities

GFilenameCompleter — Filename Completer

Asynchronous I/O

GCancellable — Thread-safe Operation Cancellation Stack
GAsyncResult — Asynchronous Function Results
GIOScheduler — I/O Scheduler
GSimpleAsyncResult — Simple asynchronous results implementation

Data conversion

GConverter — Data conversion interface
GCharsetConverter — Convert between charsets
GZlibCompressor — Zlib compressor
GZlibDecompressor — Zlib decompressor

Streaming I/O

GSeekable — Stream seeking interface
GInputStream — Base class for implementing streaming input
GOutputStream — Base class for implementing streaming output
GIOStream — Base class for implementing read/write streams
GFileInputStream — File input streaming operations
GFileOutputStream — File output streaming operations
GFileIOStream — File read and write streaming operations
GFileDescriptorBased — Interface for file descriptor based IO
GFilterInputStream — Filter Input Stream
GFilterOutputStream — Filter Output Stream
GMemoryInputStream — Streaming input operations on memory chunks
GMemoryOutputStream — Streaming output operations on memory chunks
GBufferedInputStream — Buffered Input Stream
GBufferedOutputStream — Buffered Output Stream
GDataInputStream — Data Input Stream
GDataOutputStream — Data Output Stream
GUnixInputStream — Streaming input operations for UNIX file descriptors
GUnixOutputStream — Streaming output operations for UNIX file descriptors
GConverterInputstream — Converter Input Stream
GConverterOutputstream — Converter Output Stream
GPollableInputStream — Interface for pollable input streams
GPollableOutputStream — Interface for pollable output streams

File types and applications

GContentType — Platform-specific content typing
GAppInfo — Application information and launch contexts
GDesktopAppInfo — Application information from desktop files

Volumes and Drives

GVolumeMonitor — Volume Monitor
GVolume — Volume management
GMount — Mount management
GDrive — Drive management
Unix Mounts — UNIX mounts

GIcon — Interface for icons
GFileIcon — Icons pointing to an image file
GLoadableIcon — Loadable Icons
GThemedIcon — Icon theming support
GEmblemedIcon — Icon with emblems
GEmblem — An object for emblems

Failable Initialization

GInitable — Failable object initialization interface
GAsyncInitable — Asynchronously failable object initialization interface

Lowlevel network support

GSocket — Low-level socket object
GInetAddress — An IPv4/IPv6 address
GSocketAddress — Abstract base class representing endpoints for socket communication
GInetSocketAddress — Internet GSocketAddress
GUnixSocketAddress — UNIX GSocketAddress
GSocketControlMessage — A GSocket control message
GUnixFDList — An object containing a set of UNIX file descriptors
GUnixFDMessage — A GSocketControlMessage containing a GUnixFDList
GCredentials — An object containing credentials
GUnixCredentialsMessage — A GSocketControlMessage containing credentials
GProxy — Interface for proxy handling
GProxyAddress — An internet address with proxy information

Highlevel network functionallity

GSocketClient — Helper for connecting to a network service
GSocketConnection — A socket connection
GUnixConnection — A UNIX domain GSocketConnection
GTcpConnection — A TCP GSocketConnection
GTcpWrapperConnection — wrapper for non-GSocketConnection-based, GSocket-based GIOStreams
GSocketListener — Helper for accepting network client connections
GSocketService — Make it easy to implement a network service
GThreadedSocketService — A threaded GSocketService

TLS (SSL) support

TLS Overview — TLS (aka SSL) support for GSocketConnection
GTlsCertificate — TLS certificate
GTlsConnection — TLS connection type
GTlsClientConnection — TLS client-side connection
GTlsServerConnection — TLS server-side connection
GTlsBackend — TLS backend implementation

DNS resolution

GResolver — Asynchronous and cancellable DNS resolver
GProxyResolver — Asynchronous and cancellable network proxy resolver
GSocketConnectable — Interface for potential socket endpoints
GNetworkAddress — A GSocketConnectable for resolving hostnames
GNetworkService — A GSocketConnectable for resolving SRV records
GSrvTarget — DNS SRV record target

Lowlevel D-Bus Support

D-Bus Utilities — Various utilities related to D-Bus.
D-Bus Addresses — D-Bus connection endpoints
D-Bus Introspection Data — Node and interface description data structures
GDBusError — Mapping D-Bus errors to and from GError
GDBusMessage — D-Bus Message
GDBusConnection — D-Bus Connections
GDBusMethodInvocation — Object for handling remote calls
GDBusServer — Helper for accepting connections
GDBusAuthObserver — Object used for authenticating connections

Highlevel D-Bus Support

Owning Bus Names — Simple API for owning bus names
Watching Bus Names — Simple API for watching bus names
GDBusProxy — Client-side proxies

GSettings — High-level API for application settings
GSettingsBackend — Interface for settings backend implementations

Permissions

GPermission — An object representing the permission to perform a certain action
GSimplePermission — A GPermission that doesn't change value

Application support

GActionGroup — A group of actions
GSimpleActionGroup — A simple GActionGroup implementation
GAction — An action
GSimpleAction — A simple GSimpleAction
GApplication — Core application class
GApplicationCommandLine — A command-line invocation of an application

Extending GIO

GVfs — Virtual File System
GIOModule — Loadable GIO Modules
Extension Points — Extension Points

gio-querymodules — GIO module cache creation
gsettings — GSettings configuration tool
glib-compile-schemas — GSettings schema compiler
gdbus — Introspect and call remote objects

III. Migrating to GIO

Migrating from GnomeVFS to GIO

Trash handling
Operations on multiple files
Mime monitoring

Migrating from GConf to GSettings

Before you start
Conceptual differences
GConfClient (and GConfBridge) API conversion
Change notification
Change sets
Schema conversion
Data conversion

Migrating to GDBus

Conceptual differences
API comparison
Owning bus names
Creating proxies for well-known names
Client-side GObject bindings
Exporting objects

Object Hierarchy

Index of deprecated symbols

Index of new symbols in 2.18

Index of new symbols in 2.20

Index of new symbols in 2.22

Index of new symbols in 2.24

Index of new symbols in 2.26

Index of new symbols in 2.28

Annotation Glossary