From 25060a570c106cf5a14a3268bb0d38d9feb7fdab Mon Sep 17 00:00:00 2001 From: Urs Ritzmann Date: Fri, 3 Dec 2021 15:47:18 +0100 Subject: sd_bus_get_timeout: fix timeout value doc The documentation of sd_bus_get_timeout wrongfully states that the returned time-value is relative. In fact, it is an absolute value which is based of CLOCK_MONOTONIC. This change corrects that documentation. --- man/sd_bus_get_fd.xml | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) (limited to 'man/sd_bus_get_fd.xml') diff --git a/man/sd_bus_get_fd.xml b/man/sd_bus_get_fd.xml index 2c0ec8fc05..a8a1615990 100644 --- a/man/sd_bus_get_fd.xml +++ b/man/sd_bus_get_fd.xml @@ -74,9 +74,10 @@ without any applied timeout. Note that the returned timeout should be considered only a maximum sleeping time. It is permissible (and even expected) that shorter timeouts are used by the calling program, in case other event sources are polled in the same event loop. Note that - the returned time-value is relative and specified in microseconds. When converting this value in - order to pass it as third argument to poll() (which expects milliseconds), - care should be taken to use a division that rounds up to ensure the I/O polling operation + the returned time-value is absolute, based of CLOCK_MONOTONIC and specified + in microseconds. When converting this value in order to pass it as third argument to + poll() (which expects relative milliseconds), care should be taken to convert + to a relative time and use a division that rounds up to ensure the I/O polling operation doesn't sleep for shorter than necessary, which might result in unintended busy looping (alternatively, use ppoll2 -- cgit v1.2.1