IOErrorEnum#

class IOErrorEnum#

Error codes returned by GIO functions.

Note that this domain may be extended in future GLib releases. In general, new error codes either only apply to new APIs, or else replace FAILED in cases that were not explicitly distinguished before. You should therefore avoid writing code like

if (g_error_matches (error, G_IO_ERROR, G_IO_ERROR_FAILED))
  {
    // Assume that this is EPRINTERONFIRE
    ...
  }

but should instead treat all unrecognized error codes the same as FAILED.

See also PollableReturn for a cheaper way of returning WOULD_BLOCK to callers without allocating a Error.

Fields#

class IOErrorEnum
ADDRESS_IN_USE#

The requested address is already in use. Since 2.22

ALREADY_MOUNTED#

File is already mounted.

BROKEN_PIPE#

Broken pipe. Since 2.36

BUSY#

File is busy.

CANCELLED#

Operation was cancelled. See Cancellable.

CANT_CREATE_BACKUP#

Backup couldn’t be created.

CLOSED#

File was closed.

CONNECTION_CLOSED#

Connection closed by peer. Note that this is the same code as BROKEN_PIPE; before 2.44 some “connection closed” errors returned BROKEN_PIPE, but others returned FAILED. Now they should all return the same value, which has this more logical name. Since 2.44.

CONNECTION_REFUSED#

Connection refused. Since 2.26

DBUS_ERROR#

A remote object generated an error that doesn’t correspond to a locally registered Error 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.

DESTINATION_UNSET#

Destination address unset. Since 2.80

EXISTS#

File already exists.

FAILED#

Generic error condition for when an operation fails and no more specific IOErrorEnum value is defined.

FAILED_HANDLED#

Operation failed and a helper program has already interacted with the user. Do not display any error dialog.

FILENAME_TOO_LONG#

Filename is too many characters.

HOST_NOT_FOUND#

Host couldn’t be found (remote operations).

HOST_UNREACHABLE#

Host unreachable. Since 2.26

INVALID_ARGUMENT#

Invalid argument.

INVALID_DATA#

The input data was invalid. Since 2.24

INVALID_FILENAME#

Filename is invalid or contains invalid characters.

IS_DIRECTORY#

File is a directory.

MESSAGE_TOO_LARGE#

Message too large. Since 2.48.

NETWORK_UNREACHABLE#

Network unreachable. Since 2.26

NOT_CONNECTED#

Transport endpoint is not connected. Since 2.44

NOT_DIRECTORY#

File is not a directory.

NOT_EMPTY#

File is a directory that isn’t empty.

NOT_FOUND#

File not found.

NOT_INITIALIZED#

The object has not been initialized. Since 2.22

NOT_MOUNTABLE_FILE#

File cannot be mounted.

NOT_MOUNTED#

File isn’t mounted.

NOT_REGULAR_FILE#

File is not a regular file.

NOT_SUPPORTED#

Operation (or one of its parameters) not supported

File is not a symbolic link.

NO_SPACE#

No space left on drive.

NO_SUCH_DEVICE#

No such device found. Since 2.74

PARTIAL_INPUT#

Need more input to finish operation. Since 2.24

PENDING#

Operations are still pending.

PERMISSION_DENIED#

Permission denied.

PROXY_AUTH_FAILED#

Proxy authentication failed. Since 2.26

PROXY_FAILED#

Connection to proxy server failed. Since 2.26

PROXY_NEED_AUTH#

Proxy server needs authentication. Since 2.26

PROXY_NOT_ALLOWED#

Proxy connection is not allowed by ruleset. Since 2.26

READ_ONLY#

File is read only.

TIMED_OUT#

Operation timed out.

File contains too many symbolic links.

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

WOULD_BLOCK#

Operation would block.

WOULD_MERGE#

Operation would merge files.

WOULD_RECURSE#

Operation would be recursive.

WRONG_ETAG#

File’s Entity Tag was incorrect.