[PATCH 5/7] service: Document 'service_set_proxy_method'.
Grant Erickson <[email protected]> Tue, 4 Mar 2025 13:03:03 -0800
| Newsgroups | dev.linux.lists.connman |
|---|---|
| Message-ID | <810603ffd15c53a1347da81bc84d393db4d0e67a.1741121901.git.gerickson@nuovations.com> |
Add documentation to the 'service_set_proxy_method' function. --- src/service.c | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/src/service.c b/src/service.c index cb168b03c790..17193706d9d4 100644 --- a/src/service.c +++ b/src/service.c @@ -5569,6 +5569,41 @@ const char * const *connman_service_get_timeservers(const struct connman_service return (const char * const *)service->timeservers; } +/** + * @brief + * Set the proxy method for the specified service. + * + * This attempts to set the proxy method for the specified + * service. If the service is null or if the service is hidden, no + * action is taken. If specified, a handler will be invoked, with the + * specified context, after setting the proxy method. + * + * If the handler is specified and it returns true, following, a + * D-Bus change notification should be sent for the service "Proxy" + * property and, if requested by @a donotifier, the proxy changed + * notifier chain will be run. + * + * @param[in,out] service A pointer to the mutable network + * service for which to set the proxy + * method. + * @param[in] method The network service proxy method to set + * on @a service. + * @param[in] donotifier A Boolean indicating whether the proxy + * changed notifier chain should be run + * after @a method is set on @a service. + * @param[in] handler An optional pointer to a handler that, + * if specified, will be invoked after @a + * method is set on @a service. + * @param[in] context An optional pointer to immutable context + * that will be passed to @a handler, + * along with @a service and @a method. + * + * @sa __connman_notifier_proxy_changed + * @sa proxy_changed + * + * @private + * + */ static void service_set_proxy_method(struct connman_service *service, enum connman_service_proxy_method method, bool donotifier, -- 2.45.0