:right-sidebar: True

IOErrorEnum
===================================================================

.. currentmodule:: gi.repository.Gio





.. class:: IOErrorEnum
   :no-contents-entry:






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 :const:`~gi.repository.Gio.IOErrorEnum.FAILED` in cases that were not explicitly
distinguished before. You should therefore avoid writing code like

.. code-block:: C
   :dedent:

   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
:const:`~gi.repository.Gio.IOErrorEnum.FAILED`.

See also :obj:`~gi.repository.Gio.PollableReturn` for a cheaper way of returning
:const:`~gi.repository.Gio.IOErrorEnum.WOULD_BLOCK` to callers without allocating a :obj:`~gi.repository.GLib.Error`.













Fields
------

.. rst-class:: interim-class

.. class:: IOErrorEnum
   :no-index:
   

   .. attribute:: ADDRESS_IN_USE

      The requested address is already in use. Since 2.22







   .. attribute:: ALREADY_MOUNTED

      File is already mounted.







   .. attribute:: BROKEN_PIPE

      Broken pipe. Since 2.36







   .. attribute:: BUSY

      File is busy.







   .. attribute:: CANCELLED

      Operation was cancelled. See :obj:`~gi.repository.Gio.Cancellable`.







   .. attribute:: CANT_CREATE_BACKUP

      Backup couldn't be created.







   .. attribute:: CLOSED

      File was closed.







   .. attribute:: CONNECTION_CLOSED

      Connection closed by peer. Note that this
      is the same code as :const:`~gi.repository.Gio.IOErrorEnum.BROKEN_PIPE`; before 2.44 some
      "connection closed" errors returned :const:`~gi.repository.Gio.IOErrorEnum.BROKEN_PIPE`, but others
      returned :const:`~gi.repository.Gio.IOErrorEnum.FAILED`. Now they should all return the same
      value, which has this more logical name. Since 2.44.







   .. attribute:: CONNECTION_REFUSED

      Connection refused. Since 2.26







   .. attribute:: DBUS_ERROR

      A remote object generated an error that
      doesn't correspond to a locally registered :obj:`~gi.repository.GLib.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.







   .. attribute:: DESTINATION_UNSET

      Destination address unset. Since 2.80







   .. attribute:: EXISTS

      File already exists.







   .. attribute:: FAILED

      Generic error condition for when an operation fails
      and no more specific :obj:`~gi.repository.Gio.IOErrorEnum` value is defined.







   .. attribute:: FAILED_HANDLED

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







   .. attribute:: FILENAME_TOO_LONG

      Filename is too many characters.







   .. attribute:: HOST_NOT_FOUND

      Host couldn't be found (remote operations).







   .. attribute:: HOST_UNREACHABLE

      Host unreachable. Since 2.26







   .. attribute:: INVALID_ARGUMENT

      Invalid argument.







   .. attribute:: INVALID_DATA

      The input data was invalid. Since 2.24







   .. attribute:: INVALID_FILENAME

      Filename is invalid or contains invalid characters.







   .. attribute:: IS_DIRECTORY

      File is a directory.







   .. attribute:: MESSAGE_TOO_LARGE

      Message too large. Since 2.48.







   .. attribute:: NETWORK_UNREACHABLE

      Network unreachable. Since 2.26







   .. attribute:: NOT_CONNECTED

      Transport endpoint is not connected. Since 2.44







   .. attribute:: NOT_DIRECTORY

      File is not a directory.







   .. attribute:: NOT_EMPTY

      File is a directory that isn't empty.







   .. attribute:: NOT_FOUND

      File not found.







   .. attribute:: NOT_INITIALIZED

      The object has not been initialized. Since 2.22







   .. attribute:: NOT_MOUNTABLE_FILE

      File cannot be mounted.







   .. attribute:: NOT_MOUNTED

      File isn't mounted.







   .. attribute:: NOT_REGULAR_FILE

      File is not a regular file.







   .. attribute:: NOT_SUPPORTED

      Operation (or one of its parameters) not supported







   .. attribute:: NOT_SYMBOLIC_LINK

      File is not a symbolic link.







   .. attribute:: NO_SPACE

      No space left on drive.







   .. attribute:: NO_SUCH_DEVICE

      No such device found. Since 2.74







   .. attribute:: PARTIAL_INPUT

      Need more input to finish operation. Since 2.24







   .. attribute:: PENDING

      Operations are still pending.







   .. attribute:: PERMISSION_DENIED

      Permission denied.







   .. attribute:: PROXY_AUTH_FAILED

      Proxy authentication failed. Since 2.26







   .. attribute:: PROXY_FAILED

      Connection to proxy server failed. Since 2.26







   .. attribute:: PROXY_NEED_AUTH

      Proxy server needs authentication. Since 2.26







   .. attribute:: PROXY_NOT_ALLOWED

      Proxy connection is not allowed by ruleset.
      Since 2.26







   .. attribute:: READ_ONLY

      File is read only.







   .. attribute:: TIMED_OUT

      Operation timed out.







   .. attribute:: TOO_MANY_LINKS

      File contains too many symbolic links.







   .. attribute:: 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







   .. attribute:: WOULD_BLOCK

      Operation would block.







   .. attribute:: WOULD_MERGE

      Operation would merge files.







   .. attribute:: WOULD_RECURSE

      Operation would be recursive.







   .. attribute:: WRONG_ETAG

      File's Entity Tag was incorrect.