]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
sd_bus_get_timeout: fix timeout value doc
authorUrs Ritzmann <ursritzmann@protonmail.ch>
Fri, 3 Dec 2021 14:47:18 +0000 (15:47 +0100)
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Mon, 6 Dec 2021 10:21:48 +0000 (11:21 +0100)
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

index 2c0ec8fc055eb588ee782049059cf2684a2c03d5..a8a16159902a786997646d40757953259a679e4d 100644 (file)
     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 <function>poll()</function> (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 <constant>CLOCK_MONOTONIC</constant> and specified 
+    in microseconds. When converting this value in order to pass it as third argument to 
+    <function>poll()</function> (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
     <citerefentry project='man-pages'><refentrytitle>ppoll</refentrytitle><manvolnum>2</manvolnum></citerefentry>