This is a discussion on man-pages-3.12 is released - Kernel ; Gidday I've released man-pages-3.12. This release is now available for download at: http://www.kernel.org/pub/linux/docs/man-pages or ftp://ftp.kernel.org/pub/linux/docs/man-pages The online changelog is available at http://www.kernel.org/doc/man-pages/changelog.html (blogged at http://linux-man-pages.blogspot.com/...-released.html ) and the current version of the pages is browsable at http://www.kernel.org/doc/man-pages/ An abridged version ...
I've released man-pages-3.12.
This release is now available for download at:
The online changelog is available at
and the current version of the pages is browsable at
An abridged version of the changes in this release that may be of
particular interest to readers of this list is provided below.
==================== Changes in man-pages-3.12 ====================
New and rewritten pages
New page for pthread_attr_init(3) and pthread_attr_destroy(3)
New page for pthread_attr_setdetachstate(3) and
New page for pthread_attr_setguardsize(3) and
New page for pthread_attr_setscope(3) and pthread_attr_getscope(3)
New page for pthread_attr_setstack(3) and pthread_attr_getstack(3)
New page for pthread_attr_setstackaddr(3) and
New page for pthread_attr_setstacksize(3) and
New page describing pthread_create(3)
New page for pthread_detach(3)
New page for pthread_equal(3)
New page describing pthread_exit(3)
New page for pthread_getattr_np(3)
New page for pthread_join(3)
New page for pthread_self(3)
New page for pthread_tryjoin_np(3) and pthread_timedjoin_np(3)
Newly documented interfaces in existing pages
Add description of dup3()
dup3() was added in kernel 2.6.27.
Add description of new epoll_create1()
The new epoll_create1() system call appeared in Linux 2.6.27.
Describe eventfd2() and EFD_NONBLOCK and EFD_CLOEXEC
Linux 2.6.27 added eventfd(), which supports a flags argument
that eventfd() did not provide. The flags so far implemented
are EFD_NONBLOCK and EFD_CLOEXEC,
Add description of inotify_init1()
The inotify_init1() system call was added in Linux 2.6.27.
Add description of new pipe2() syscall
pipe2() was added in 2.6.27. Describe the O_NONBLOCK and
Describe signalfd4() and SFD_NONBLOCK and SFD_CLOEXEC
Linux 2.6.27 added signalfd4(), which supports a flags argument
that signalfd() did not provide. The flags so far implemented
are SFD_NONBLOCK and SFD_CLOEXEC.
Changes to individual pages
Rewrite description in terms of threads
The text formerly described the operation of sched_yield() in
terms of processes. It should be in terms of threads.
Add NOTES text on appropriate use of sched_yield()
Strategic calls to sched_yield() can be used to improve
performance, but unnecessary use should be avoided.
Clarify that sa_mask affects the *per-thread* signal mask
The page didn't previously clearly explain the scope of the
signal mask that is affected by sa_mask.
Clarify that sigprocmask() operates on a per-thread mask
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.
Document SOCK_NONBLOCK and SOCK_CLOEXEC flags
These flags, specified in the 'type' argument, are supported
since Linux 2.6.27.
Refer to socket(2) for SOCK_CLOEXEC and SOCK_NONBLOCK
Refer the reader to socket(2) for a description of the SOCK_CLOEXEC
and SOCK_NONBLOCK flags, which are supported by socketpair() since
Document timerfd_create() TFD_CLOEXEC and TFD_NONBLOCK
TFD_CLOEXEC and TFD_NONBLOCK are supported since LInux 2.6.27.
LD_LIBRARY_PATH is inspected once, at program start-up
Make it clear that LD_LIBRARY_PATH is inspected *once*, at
program start-up. (Verified from source and by experiment.)
Clarify error descriptions with some examples
Clarify the description of some errors by giving examples
that produce the errors. (Text added for EAI_SERVICE and
Also, add an error case for EAI_BADFLAGS.
Explain capability requirements for TIOCCONS
Explain capability requirements for TIOCCONS, and describe
changes in 2.6.10 relating to capabilities.
Explain capability requirements for various ioctls
For TIOCSLCKTRMIOS, TIOCSCTTY, TIOCEXCL, explain the exact
capability that is required (the text formerly just said "root"
in each case).
Defines the system-wide limit on the number of threads (tasks).
It is just "other" who should not have write perms on utmp
The page was vague before, saying that utmp should not be
writable by any user. This isn't true: it can be, and
typically is, writable by user and group.
Drawing heavily on Jakub Jelinek's description in
(Subject: [PATCH] Support LD_USE_LOAD_BIAS)
--inhibit-rpath is ignored for setuid/setgid ld.so
The --inhibit-rpath option is ignored if ld.so is setuid/setgid
(not if the executable is setuid/setgid).
Since glibc 2.4, setuid/setgid programs ignore LD_ORIGIN_PATH
Fix description of LD_PROFILE and LD_PROFILE_OUTPUT
Clarify that LD_PROFILE is pathname or a soname,
and identify name of profiling output file.
Fix description of LD_PROFILE_OUTPUT, which wasn't even close to
the truth. (But why did it remain unfixed for so many years?)
Since glibc 2.3.4, setuid/setgid programs ignore LD_DYNAMIC_WEAK
Since version 2.3.5, setuid/setgid programs ignore LD_SHOW_AUXV
Reorder lists of LD_* environment variables alphabetically
Since glibc 2.3.4, setuid/setgid programs ignore LD_DEBUG
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html
Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to firstname.lastname@example.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/