GIOError

GIOError — Error helper functions

Synopsis

#include <gio/gio.h>

#define             G_IO_ERROR
enum                GIOErrorEnum;
GIOErrorEnum        g_io_error_from_errno               (gint err_no);
GIOErrorEnum        g_io_error_from_win32_error         (gint error_code);

Object Hierarchy

  GEnum
   +----GIOErrorEnum

Description

Contains helper functions for reporting errors to the user.

Details

G_IO_ERROR

#define G_IO_ERROR g_io_error_quark()

Error domain for GIO. Errors in this domain will be from the GIOErrorEnum enumeration. See GError for more information on error domains.

enum GIOErrorEnum

typedef enum {
  G_IO_ERROR_FAILED,
  G_IO_ERROR_NOT_FOUND,
  G_IO_ERROR_EXISTS,
  G_IO_ERROR_IS_DIRECTORY,
  G_IO_ERROR_NOT_DIRECTORY,
  G_IO_ERROR_NOT_EMPTY,
  G_IO_ERROR_NOT_REGULAR_FILE,
  G_IO_ERROR_NOT_SYMBOLIC_LINK,
  G_IO_ERROR_NOT_MOUNTABLE_FILE,
  G_IO_ERROR_FILENAME_TOO_LONG,
  G_IO_ERROR_INVALID_FILENAME,
  G_IO_ERROR_TOO_MANY_LINKS,
  G_IO_ERROR_NO_SPACE,
  G_IO_ERROR_INVALID_ARGUMENT,
  G_IO_ERROR_PERMISSION_DENIED,
  G_IO_ERROR_NOT_SUPPORTED,
  G_IO_ERROR_NOT_MOUNTED,
  G_IO_ERROR_ALREADY_MOUNTED,
  G_IO_ERROR_CLOSED,
  G_IO_ERROR_CANCELLED,
  G_IO_ERROR_PENDING,
  G_IO_ERROR_READ_ONLY,
  G_IO_ERROR_CANT_CREATE_BACKUP,
  G_IO_ERROR_WRONG_ETAG,
  G_IO_ERROR_TIMED_OUT,
  G_IO_ERROR_WOULD_RECURSE,
  G_IO_ERROR_BUSY,
  G_IO_ERROR_WOULD_BLOCK,
  G_IO_ERROR_HOST_NOT_FOUND,
  G_IO_ERROR_WOULD_MERGE,
  G_IO_ERROR_FAILED_HANDLED,
  G_IO_ERROR_TOO_MANY_OPEN_FILES,
  G_IO_ERROR_NOT_INITIALIZED,
  G_IO_ERROR_ADDRESS_IN_USE,
  G_IO_ERROR_PARTIAL_INPUT,
  G_IO_ERROR_INVALID_DATA,
  G_IO_ERROR_DBUS_ERROR,
  G_IO_ERROR_HOST_UNREACHABLE,
  G_IO_ERROR_NETWORK_UNREACHABLE,
  G_IO_ERROR_CONNECTION_REFUSED,
  G_IO_ERROR_PROXY_FAILED,
  G_IO_ERROR_PROXY_AUTH_FAILED,
  G_IO_ERROR_PROXY_NEED_AUTH,
  G_IO_ERROR_PROXY_NOT_ALLOWED
} GIOErrorEnum;

Error codes returned by GIO functions.

`G_IO_ERROR_FAILED`	Generic error condition for when any operation fails.
`G_IO_ERROR_NOT_FOUND`	File not found error.
`G_IO_ERROR_EXISTS`	File already exists error.
`G_IO_ERROR_IS_DIRECTORY`	File is a directory error.
`G_IO_ERROR_NOT_DIRECTORY`	File is not a directory.
`G_IO_ERROR_NOT_EMPTY`	File is a directory that isn't empty.
`G_IO_ERROR_NOT_REGULAR_FILE`	File is not a regular file.
`G_IO_ERROR_NOT_SYMBOLIC_LINK`	File is not a symbolic link.
`G_IO_ERROR_NOT_MOUNTABLE_FILE`	File cannot be mounted.
`G_IO_ERROR_FILENAME_TOO_LONG`	Filename is too many characters.
`G_IO_ERROR_INVALID_FILENAME`	Filename is invalid or contains invalid characters.
`G_IO_ERROR_TOO_MANY_LINKS`	File contains too many symbolic links.
`G_IO_ERROR_NO_SPACE`	No space left on drive.
`G_IO_ERROR_INVALID_ARGUMENT`	Invalid argument.
`G_IO_ERROR_PERMISSION_DENIED`	Permission denied.
`G_IO_ERROR_NOT_SUPPORTED`	Operation not supported for the current backend.
`G_IO_ERROR_NOT_MOUNTED`	File isn't mounted.
`G_IO_ERROR_ALREADY_MOUNTED`	File is already mounted.
`G_IO_ERROR_CLOSED`	File was closed.
`G_IO_ERROR_CANCELLED`	Operation was cancelled. See GCancellable.
`G_IO_ERROR_PENDING`	Operations are still pending.
`G_IO_ERROR_READ_ONLY`	File is read only.
`G_IO_ERROR_CANT_CREATE_BACKUP`	Backup couldn't be created.
`G_IO_ERROR_WRONG_ETAG`	File's Entity Tag was incorrect.
`G_IO_ERROR_TIMED_OUT`	Operation timed out.
`G_IO_ERROR_WOULD_RECURSE`	Operation would be recursive.
`G_IO_ERROR_BUSY`	File is busy.
`G_IO_ERROR_WOULD_BLOCK`	Operation would block.
`G_IO_ERROR_HOST_NOT_FOUND`	Host couldn't be found (remote operations).
`G_IO_ERROR_WOULD_MERGE`	Operation would merge files.
`G_IO_ERROR_FAILED_HANDLED`	Operation failed and a helper program has already interacted with the user. Do not display any error dialog.
`G_IO_ERROR_TOO_MANY_OPEN_FILES`	The current process has too many files open and can't open any more. Duplicate descriptors do count toward this limit. Since 2.20
`G_IO_ERROR_NOT_INITIALIZED`	The object has not been initialized. Since 2.22
`G_IO_ERROR_ADDRESS_IN_USE`	The requested address is already in use. Since 2.22
`G_IO_ERROR_PARTIAL_INPUT`	Need more input to finish operation. Since 2.24
`G_IO_ERROR_INVALID_DATA`	There input data was invalid. Since 2.24
`G_IO_ERROR_DBUS_ERROR`	A remote object generated an error that doesn't correspond to a locally registered GError error domain. Use `g_dbus_error_get_remote_error()` to extract the D-Bus error name and `g_dbus_error_strip_remote_error()` to fix up the message so it matches what was received on the wire. Since 2.26.
`G_IO_ERROR_HOST_UNREACHABLE`	Host unreachable. Since 2.26
`G_IO_ERROR_NETWORK_UNREACHABLE`	Network unreachable. Since 2.26
`G_IO_ERROR_CONNECTION_REFUSED`	Connection refused. Since 2.26
`G_IO_ERROR_PROXY_FAILED`	Connection to proxy server failed. Since 2.26
`G_IO_ERROR_PROXY_AUTH_FAILED`	Proxy authentication failed. Since 2.26
`G_IO_ERROR_PROXY_NEED_AUTH`	Proxy server needs authentication. Since 2.26
`G_IO_ERROR_PROXY_NOT_ALLOWED`	Proxy connection is not allowed by ruleset. Since 2.26

g_io_error_from_errno ()

GIOErrorEnum        g_io_error_from_errno               (gint err_no);

Converts errno.h error codes into GIO error codes.

`err_no` :	Error number as defined in errno.h.
Returns :	GIOErrorEnum value for the given errno.h error number.

g_io_error_from_win32_error ()

GIOErrorEnum        g_io_error_from_win32_error         (gint error_code);

Converts some common error codes into GIO error codes. The fallback value G_IO_ERROR_FAILED is returned for error codes not handled.

`error_code` :	Windows error number.
Returns :	GIOErrorEnum value for the given error number.

Since 2.26