manpagez: man pages & more
html files: gio
Home | html | info | man

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

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