From 2e4238a6d14223728dbfbb24830e644d31b04111 Mon Sep 17 00:00:00 2001 From: igo95862 Date: Tue, 17 Nov 2020 10:54:19 +0300 Subject: [PATCH] man: Separated paragraph about making sd_bus object reply async --- man/sd_bus_add_object.xml | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/man/sd_bus_add_object.xml b/man/sd_bus_add_object.xml index f03839ec6f..0f5d00cd5b 100644 --- a/man/sd_bus_add_object.xml +++ b/man/sd_bus_add_object.xml @@ -292,11 +292,13 @@ attached to the request object path, interface and member. Finally, the property callbacks attached to the request object path, interface and member are called. If the final callback returns zero, an error reply is sent back to the caller indicating no matching object for the - request was found. Note that you can return a positive integer from a callback without + request was found. + + Note that you can return a positive integer from a callback without immediately sending a reply. This informs sd-bus this callback will take responsibility for replying to the request without forcing the callback to produce a reply immediately. This allows - a callback to perform any number of asynchronous operations required to construct a reply. Note - that if producing a reply takes too long, the method call will time out at the caller. + a callback to perform any number of asynchronous operations required to construct a reply. + However, if producing a reply takes too long, the method call will time out at the caller. If a callback was invoked to handle a request that expects a reply and the callback returns a negative value, the value is interpreted as a negative errno-style error code and sent