Static$gtypeStaticACCESS_Security restrictions don't allow doing what you're trying to do.
StaticADDRESS_Can't bind a socket since its address is in use (i.e. EADDRINUSE).
StaticADT_Asked for ADT audit data and it wasn't available.
StaticAUTH_Authentication didn't work.
StaticBAD_A D-Bus bus address was malformed.
StaticDISCONNECTEDThe connection is disconnected and you're trying to use it.
StaticFAILEDA generic error; "something went wrong" - see the error message for more.
StaticFILE_Existing file and the operation you're using does not silently overwrite.
StaticFILE_Missing file.
StaticINVALID_Invalid arguments passed to a method call.
StaticINVALID_A file contains invalid syntax or is otherwise broken.
StaticINVALID_A type signature is not valid.
StaticIO_Something went wrong reading or writing to a socket, for example.
StaticLIMITS_Some limited resource is exhausted.
StaticMATCH_The match rule isn't syntactically valid.
StaticMATCH_Tried to remove or modify a match rule that didn't exist.
StaticNAME_The bus name you referenced doesn't exist (i.e. no application owns it).
StaticNO_There was not enough memory to complete an operation.
StaticNO_No network access (probably ENETUNREACH on a socket).
StaticNO_No reply to a message expecting one, usually means a timeout occurred.
StaticNO_Unable to connect to server (probably caused by ECONNREFUSED on a socket).
StaticNOT_Requested operation isn't supported (like ENOSYS on UNIX).
StaticOBJECT_There's already an object with the requested object path.
StaticPROPERTY_Property you tried to set is read-only. Since 2.42
StaticSELINUX_Asked for SELinux security context and it wasn't available.
StaticSERVICE_The bus doesn't know how to launch a service to supply the bus name you wanted.
StaticSPAWN_While starting a new process, the child exited with a status code.
StaticSPAWN_While starting a new process, the child exited on a signal.
StaticSPAWN_We failed to setup the config parser correctly.
StaticSPAWN_While starting a new process, the exec() call failed.
StaticSPAWN_While starting a new process, something went wrong.
StaticSPAWN_Service file invalid (Name, User or Exec missing).
StaticSPAWN_While starting a new process, the fork() call failed.
StaticSPAWN_Tried to get a UNIX process ID and it wasn't available.
StaticSPAWN_Permissions are incorrect on the setuid helper.
StaticSPAWN_Bus name was not valid.
StaticSPAWN_Service file not found in system-services directory.
StaticSPAWN_We failed to setup the environment correctly.
StaticTIMED_Certain timeout errors, e.g. while starting a service. Warning: this is confusingly-named given that Gio.DBusError.TIMEOUT also exists. We can't fix it for compatibility reasons so just be careful.
StaticTIMEOUTCertain timeout errors, possibly ETIMEDOUT on a socket. Note that Gio.DBusError.NO_REPLY is used for message reply timeouts. Warning: this is confusingly-named given that Gio.DBusError.TIMED_OUT also exists. We can't fix it for compatibility reasons so just be careful.
StaticUNIX_Tried to get a UNIX process ID and it wasn't available.
StaticUNKNOWN_Interface you invoked a method on isn't known by the object. Since 2.42
StaticUNKNOWN_Method name you invoked isn't known by the object you invoked it on.
StaticUNKNOWN_Object you invoked a method on isn't known. Since 2.42
StaticUNKNOWN_Property you tried to access isn't known by the object. Since 2.42
Staticencode_Creates a D-Bus error name to use for error.
If error matches a registered error (see
Gio.DBusError.register_error), the corresponding D-Bus error name
will be returned.
Otherwise the a name of the form
org.gtk.GDBus.UnmappedGError.Quark._ESCAPED_QUARK_NAME.Code_ERROR_CODE
will be used. This allows other GDBus applications to map the error
on the wire back to a GLib.Error using
Gio.DBusError.new_for_dbus_error.
This function is typically only used in object mappings to put a GLib.Error on the wire. Regular applications should not use it.
Staticget_Gets the D-Bus error name used for error, if any.
This function is guaranteed to return a D-Bus error name for all
GLib.Errors returned from functions handling remote method calls
(for example, Gio.DBusConnection.call_finish) unless
Gio.DBusError.strip_remote_error has already been used on error.
Staticis_Checks if error represents an error received via D-Bus from a remote peer.
If so, use Gio.DBusError.get_remote_error to get the name of the error.
Staticnew_Creates a GLib.Error based on the contents of dbus_error_name and
dbus_error_message.
Errors registered with Gio.DBusError.register_error will be looked
up using dbus_error_name and if a match is found, the error domain
and code is used. Applications can use Gio.DBusError.get_remote_error
to recover dbus_error_name.
If a match against a registered error is not found and the D-Bus
error name is in a form as returned by Gio.DBusError.encode_gerror
the error domain and code encoded in the name is used to
create the GLib.Error. Also, dbus_error_name is added to the error
message such that it can be recovered with
Gio.DBusError.get_remote_error.
Otherwise, a GLib.Error with the error code
Gio.IOErrorEnum.DBUS_ERROR
in the Gio.IOErrorEnum error domain is returned. Also, dbus_error_name is
added to the error message such that it can be recovered with
Gio.DBusError.get_remote_error.
In all three cases, dbus_error_name can always be recovered from the
returned GLib.Error using the Gio.DBusError.get_remote_error
function (unless Gio.DBusError.strip_remote_error hasn’t been used on
the returned error).
This function is typically only used in object mappings to prepare GLib.Error instances for applications. Regular applications should not use it.
D-Bus error name
D-Bus error message
StaticquarkStaticregister_Creates an association mapping between dbus_error_name and
GLib.Errors specified by error_domain and error_code.
This is typically done in the function that returns the GLib.Quark for an error domain.
a GLib.Quark for an error domain
an error code
a D-Bus error name
Staticregister_Helper function for associating a GLib.Error error domain with D-Bus error names.
While quark_volatile has a volatile qualifier, this is a historical
artifact and the argument passed to it should not be volatile.
the error domain name
return location for the GLib.Quark representing the error domain
items to register
Staticset_Sets *error to a new GLib.Error created with
Gio.DBusError.new_for_dbus_error.
If format is non-NULL then it is prepended to dbus_error_message.
Otherwise dbus_error_message is used unmodified.
This function does nothing if error is NULL.
D-Bus error name
D-Bus error message
printf()-style format to prepend to dbus_error_message, or NULL to not modify the message
arguments for format
Staticset_Like Gio.DBusError.set_dbus_error but intended for language bindings.
D-Bus error name
D-Bus error message
printf()-style format to prepend to dbus_error_message, or NULL to not modify the message
arguments for format
Staticstrip_Looks for extra information in the error message used to recover the D-Bus error name and strips it if found.
If stripped, the
message field in error will correspond exactly to what was
received on the wire.
This is typically used when presenting errors to the end user.
Staticunregister_Destroys an association previously set up with Gio.DBusError.register_error.
a GLib.Quark for an error domain
an error code
a D-Bus error name
Frees a GLib.Error and associated resources.
Returns true if error matches domain and code, false
otherwise. In particular, when error is null, false will
be returned.
If domain contains a FAILED (or otherwise generic) error code,
you should generally not check for it explicitly, but should
instead treat any not-explicitly-recognized error code as being
equivalent to the FAILED code. This way, if the domain is
extended in the future to provide a more specific error code for
a certain case, your code will still work.
whether error has domain and code
Staticdomain_This function registers an extended GLib.Error domain.
error_type_name will be duplicated. Otherwise does the same as
g_error_domain_register_static().
string to create a GLib.Quark from
size of the private error data in bytes
function initializing fields of the private error data
function copying fields of the private error data
function freeing fields of the private error data
Staticdomain_This function registers an extended GLib.Error domain.
error_type_name should not be freed. error_type_private_size must
be greater than 0.
error_type_init receives an initialized GLib.Error and should then initialize
the private data.
error_type_copy is a function that receives both original and a copy
GLib.Error and should copy the fields of the private error data. The standard
GLib.Error fields are already handled.
error_type_clear receives the pointer to the error, and it should free the
fields of the private error data. It should not free the struct itself though.
Normally, it is better to use G_DEFINE_EXTENDED_ERROR(), as it already takes care of passing valid information to this function.
static string to create a GLib.Quark from
size of the private error data in bytes
function initializing fields of the private error data
function copying fields of the private error data
function freeing fields of the private error data
Staticnew_
Error codes for the
G_DBUS_ERRORerror domain.