diff options
author | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2018-02-28 10:53:18 +0100 |
---|---|---|
committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2018-02-28 10:54:37 +0100 |
commit | 34fd5f69dd10a8bc096c797b80c946613321cefd (patch) | |
tree | 86a9754c43b055ce90fc7f105004e306586d7e12 /man/sd_bus_get_n_queued_read.xml | |
parent | e0a085811de1d1976c019afcfc2e4e74f590cc9f (diff) | |
download | systemd-34fd5f69dd10a8bc096c797b80c946613321cefd.tar.gz |
man: shorten/reword a bit in sd_bus_get_n_queued_read
In particular:
- drop "when it is non-zero" to avoid implying that it can be called if the
queue is not empty.
- "has been created" sounds like something happened in parallel,
but what we really mean is that *this* particular object *was* created in a
certain way.
Diffstat (limited to 'man/sd_bus_get_n_queued_read.xml')
-rw-r--r-- | man/sd_bus_get_n_queued_read.xml | 16 |
1 files changed, 8 insertions, 8 deletions
diff --git a/man/sd_bus_get_n_queued_read.xml b/man/sd_bus_get_n_queued_read.xml index b39e87f8dd..32be403fc5 100644 --- a/man/sd_bus_get_n_queued_read.xml +++ b/man/sd_bus_get_n_queued_read.xml @@ -75,18 +75,18 @@ <para> <function>sd_bus_get_n_queued_read()</function> may be used to query the number of bus messages in the read queue of a bus connection object. The read queue contains all messages read from the transport medium (e.g. network - socket) but not yet processed locally. The function expects two arguments: the bus object to query the number of - queued messages of, and a pointer to a 64bit counter variable to write the current queue size to. Use - <function>sd_bus_process()</function> in order to process queued messages, i.e. to reduce the size of the read - queue (as well as, in fact, the write queue, see below) when it is non-zero. + socket) but not yet processed locally. The function expects two arguments: the bus object to query, and a pointer + to a 64bit counter variable to write the current queue size to. Use <function>sd_bus_process()</function> in + order to process queued messages, i.e. to reduce the size of the read queue (as well as, in fact, the write + queue, see below). </para> <para> - Similar, <function>sd_bus_get_n_queued_write()</function> may be used to query the number of currently pending + Similarly, <function>sd_bus_get_n_queued_write()</function> may be used to query the number of currently pending bus messages in the write queue of a bus connection object. The write queue contains all messages enqueued into the connection with a call such as <function>sd_bus_send()</function> but not yet written to the transport - medium. The expected arguments are similar to the ones of <function>sd_bus_get_n_queued_read()</function>. Here - too, use <function>sd_bus_process()</function> to reduce the size of the write queue. Alternatively, use + medium. The expected arguments are similar to <function>sd_bus_get_n_queued_read()</function>. Here too, use + <function>sd_bus_process()</function> to reduce the size of the write queue. Alternatively, use <function>sd_bus_flush()</function> to synchronously write out any pending bus messages until the write queue is empty. </para> @@ -108,7 +108,7 @@ <varlistentry> <term><constant>-ECHILD</constant></term> - <listitem><para>The bus connection has been created in a different process.</para></listitem> + <listitem><para>The bus connection was created in a different process.</para></listitem> </varlistentry> </variablelist> |