Let's start filling the big, longstanding gap for documentation
of Linux's implementation(s) of POSIX threads.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
POSIX.1 marks gethostbyname(), gethostbyaddr(), and 'h_errno'
as obsolete. The man page explained this, but with some
duplication. Remove the duplication, and otherwise tidy up
discussion of this point.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The man page already noted that these functions need not set
'tzname', but things could be clearer: it tzset() is not called,
then the other two variables also are not set.
Also, clarify that ctime() does set 'timezone' and 'daylight'.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Strategic calls to sched_yield() can be used to improve
performance, but unnecessary use should be avoided.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The text formerly described the operation of sched_yield() in
terms of processes. It should be in terms of threads.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The page didn't previously clearly explain the scope of the
signal mask that is affected by sa_mask.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The first sentence of the page was vague on the scope of the
attribute changed by sigprocmask(). Reword to make this
clearer and add a sentence in NOTES to explicitly state that
the signal mask is a per-thread attribute.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Describe the usual success (0) and failure (non-zero) returns,
and note that POSIX.1-2001 specifies that pthreads functions
can never fail with the error EINTR.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
If setsockopt() is used to set a timeout on a socket(),
then the various socket interfaces are not automatically
restarted, even if SA_RESTART is specified when
establishing the signal handler. Analogous behavior occurs
for the "stop signals" case.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Didier <did447@gmail.com>
Explain capability requirements for TIOCCONS, and describe
changes in 2.6.10 relating to capabilities.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
For TIOCSLCKTRMIOS, TIOCSCTTY, TIOCEXCL, explain the exact
capability that is required (the text formerly just said "root"
in each case).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Add a sentence in DESCRIPTION pointing reader to NOTES for
discussion of glibc extensions for 'mode'.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
glibc 2.9 implements the 'e' flag in 'type', which sets the
close-on-exec flag on the underlying file descriptor.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Glibc 2.9 adds support to fmemopen() for binary mode opens.
Binary mode is specified by inclusion of the letter 'b' in
the 'mode' argument.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Refer the reader to socket(2) for a description of the SOCK_CLOEXEC
and SOCK_NONBLOCK flags, which are supported by socketpair() since
Linux 2.6.27.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>