luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-08-02 07:23:41 +02:00
Code Issues Packages Projects Releases Wiki Activity

gdbus: Add a few missing (nullable) annotations to GDBus method invocation related functions

Browse Source 
Sender can be NULL if not specified by the caller, e.g. on peer-to-peer
connections.

Interface name can be NULL on method calls if it was not specified by
the sender.

Both is explicitly allowed by the DBus specification.
This commit is contained in:
Sebastian Dröge
2024-11-30 12:15:10 +02:00
committed by Philip Withnall
parent c50836535a
commit f5678377c0
2 changed files with 25 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
gio/gdbusconnection.h
View File

@@ -265,9 +265,11 @@ GVariant *g_dbus_connection_call_with_unix_fd_list_sync (GDBusConnection
/**
* GDBusInterfaceMethodCallFunc:
* @connection: A #GDBusConnection.
* @sender: The unique bus name of the remote caller.
* @sender: (nullable): The unique bus name of the remote caller, or `NULL` if
* not specified by the caller, e.g. on peer-to-peer connections.
* @object_path: The object path that the method was invoked on.
* @interface_name: The D-Bus interface name the method was invoked on.
* @interface_name: (nullable): The D-Bus interface name the method was invoked on,
* or `NULL` if not specified by the sender.
* @method_name: The name of the method that was invoked.
* @parameters: A #GVariant tuple with parameters.
* @invocation: (transfer full): A #GDBusMethodInvocation object that must be used to return a value or error.
@@ -275,6 +277,13 @@ GVariant *g_dbus_connection_call_with_unix_fd_list_sync (GDBusConnection
*
* The type of the @method_call function in #GDBusInterfaceVTable.
*
* @interface_name may be `NULL` if not specified by the sender, although it’s
* encouraged for the sender to set it. If unset, and the object has only one
* method (across all interfaces) matching @method_name, that method is invoked.
* Otherwise, behaviour is implementation defined. See the
* [D-Bus specification](https://dbus.freedesktop.org/doc/dbus-specification.html#message-protocol-types-method).
* It is recommended to return [error@Gio.DBusError.UNKNOWN_METHOD].
*
* Since: 2.26
*/
typedef void (*GDBusInterfaceMethodCallFunc) (GDBusConnection *connection,
@@ -289,7 +298,8 @@ typedef void (*GDBusInterfaceMethodCallFunc) (GDBusConnection *connection,
/**
* GDBusInterfaceGetPropertyFunc:
* @connection: A #GDBusConnection.
* @sender: The unique bus name of the remote caller.
* @sender: (nullable): The unique bus name of the remote caller or %NULL if
* not specified by the caller, e.g. on peer-to-peer connections.
* @object_path: The object path that the method was invoked on.
* @interface_name: The D-Bus interface name for the property.
* @property_name: The name of the property to get the value of.
@@ -315,7 +325,8 @@ typedef GVariant *(*GDBusInterfaceGetPropertyFunc) (GDBusConnection *conne
/**
* GDBusInterfaceSetPropertyFunc:
* @connection: A #GDBusConnection.
* @sender: The unique bus name of the remote caller.
* @sender: (nullable): The unique bus name of the remote caller or %NULL if
* not specified by the caller, e.g. on peer-to-peer connections.
* @object_path: The object path that the method was invoked on.
* @interface_name: The D-Bus interface name for the property.
* @property_name: The name of the property to get the value of.