Thread (22 messages) 22 messages, 7 authors, 2015-07-28

Re: Revised futex(2) man page for review

From: Michael Kerrisk (man-pages) <hidden>
Date: 2015-07-27 11:11:13
Also in: linux-man, lkml

Hello Pavel,

On 04/27/2015 10:37 PM, Pavel Machek wrote:
Hi!
quoted
              The FUTEX_WAIT_OP operation is equivalent to execute the follow???
              ing  code  atomically  and totally ordered with respect to other
              futex operations on any of the two supplied futex words:
"to executing"?
Yep. Fixed.
quoted
              The  operation  and  comparison  that  are  to  be performed are
              encoded in the bits of  the  argument  val3.   Pictorially,  the
              encoding is:

                      +---+---+-----------+-----------+
                      |op |cmp|   oparg   |  cmparg   |
                      +---+---+-----------+-----------+
                        4   4       12          12    <== # of bits
:-)
quoted
RETURN VALUE
       In the event of an error, all operations return -1  and  set  errno  to
       indicate  the  cause of the error.  The return value on success depends
       on the operation, as described in the following list:
Did you say (at the begining) that there is no glibc wrapper?
Yes, this could be clearer. I changed it to

RETURN VALUE
       In the event of an error (and assuming that futex()  was  invoked
       via  syscall(2)), all operations return -1 and set errno to indi‐
       cate the cause of the error.
quoted
       EINVAL The operation in futex_op is one of those that employs  a  time???
              out,  but  the supplied timeout argument was invalid (tv_sec was
              less than zero, or tv_nsec was not less than 1000,000,000).
1,000...?
Fixed.

Thanks for the comments!

Cheers,

Michael


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help