mirror of https://github.com/mkerrisk/man-pages
Changes: Update Changelog for 3.12 release
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
a439142940
commit
ae8aa0f501
456
Changes
456
Changes
|
@ -1,6 +1,6 @@
|
|||
==================== Changes in man-pages-3.12 ====================
|
||||
|
||||
Released: ????-??-??, Munich
|
||||
Released: ????-??-??, Bucaramanga
|
||||
|
||||
|
||||
Contributors
|
||||
|
@ -16,19 +16,473 @@ Apologies if I missed anyone!
|
|||
New and rewritten pages
|
||||
-----------------------
|
||||
|
||||
pthread_attr_init.3
|
||||
Michael Kerrisk
|
||||
New page for pthread_attr_init(3) and pthread_attr_destroy(3)
|
||||
|
||||
pthread_attr_setdetachstate.3
|
||||
Michael Kerrisk
|
||||
New page for pthread_attr_setdetachstate(3) and
|
||||
pthread_attr_getdetachstate(3)
|
||||
|
||||
pthread_attr_setguardsize.3
|
||||
Michael Kerrisk
|
||||
New page for pthread_attr_setguardsize(3) and
|
||||
pthread_attr_getguardsize(3)
|
||||
|
||||
pthread_attr_setscope.3
|
||||
Michael Kerrisk
|
||||
New page for pthread_attr_setscope(3) and pthread_attr_getscope(3)
|
||||
|
||||
pthread_attr_setstack.3
|
||||
Michael Kerrisk
|
||||
New page for pthread_attr_setstack(3) and pthread_attr_getstack(3)
|
||||
|
||||
pthread_attr_setstackaddr.3
|
||||
Michael Kerrisk
|
||||
New page for pthread_attr_setstackaddr(3) and
|
||||
pthread_attr_getstackaddr(3)
|
||||
|
||||
pthread_attr_setstacksize.3
|
||||
Michael Kerrisk
|
||||
New page for pthread_attr_setstacksize(3) and
|
||||
pthread_attr_getstacksize(3)
|
||||
|
||||
pthread_create.3
|
||||
Michael Kerrisk
|
||||
New page describing pthread_create(3)
|
||||
|
||||
pthread_detach.3
|
||||
Michael Kerrisk
|
||||
New page for pthread_detach(3)
|
||||
|
||||
pthread_equal.3
|
||||
Michael Kerrisk
|
||||
New page for pthread_equal(3)
|
||||
|
||||
pthread_exit.3
|
||||
Michael Kerrisk
|
||||
New page describing pthread_exit(3)
|
||||
|
||||
pthread_getattr_np.3
|
||||
Michael Kerrisk
|
||||
New page for pthread_getattr_np(3)
|
||||
|
||||
pthread_join.3
|
||||
Michael Kerrisk
|
||||
New page for pthread_join(3)
|
||||
|
||||
pthread_self.3
|
||||
Michael Kerrisk
|
||||
New page for pthread_self(3)
|
||||
|
||||
pthread_tryjoin_np.3
|
||||
Michael Kerrisk
|
||||
New page for pthread_tryjoin_np(3) and pthread_timedjoin_np(3)
|
||||
|
||||
|
||||
Newly documented interfaces in existing pages
|
||||
---------------------------------------------
|
||||
|
||||
dup.2
|
||||
Michael Kerrisk
|
||||
Add description of dup3()
|
||||
dup3() was added in kernel 2.6.27.
|
||||
|
||||
epoll_create.2
|
||||
Michael Kerrisk
|
||||
Add description of new epoll_create1()
|
||||
The new epoll_create1() system call appeared in Linux 2.6.27.
|
||||
eventfd.2
|
||||
Michael Kerrisk
|
||||
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,
|
||||
|
||||
inotify_init.2
|
||||
Michael Kerrisk
|
||||
Add description of inotify_init1()
|
||||
The inotify_init1() system call was added in Linux 2.6.27.
|
||||
|
||||
pipe.2
|
||||
Michael Kerrisk
|
||||
Add description of new pipe2() syscall
|
||||
pipe2() was added in 2.6.27. Describe the O_NONBLOCK and
|
||||
O_CLOEXEC flags.
|
||||
|
||||
signalfd.2
|
||||
Michael Kerrisk
|
||||
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.
|
||||
|
||||
|
||||
New and changed links
|
||||
---------------------
|
||||
|
||||
dup3.2
|
||||
Michael Kerrisk
|
||||
New link to dup.2
|
||||
dup.2 now contains the description of the new dup3() syscall.
|
||||
|
||||
epoll_create1.2
|
||||
Michael Kerrisk
|
||||
New link to epoll_create.2
|
||||
epoll_create.2 now includes a description of the new
|
||||
epoll_create1() system call.
|
||||
|
||||
eventfd2.2
|
||||
Michael Kerrisk
|
||||
New link to eventfd.2
|
||||
The eventfd.2 page has some details on the eventfd2() system call,
|
||||
which was new in Linux 2.6.27.
|
||||
|
||||
inotify_init1.2
|
||||
Michael Kerrisk
|
||||
New link to inotify_init.2
|
||||
inotify_init.2 now includes a description of the new
|
||||
inotify_init1() system call.
|
||||
|
||||
pipe2.2
|
||||
Michael Kerrisk
|
||||
New link to pipe.2
|
||||
pipe(2) now contains a description of the new pipe2() syscall.
|
||||
|
||||
pthread_attr_destroy.3
|
||||
Michael Kerrisk
|
||||
New link to new pthread_attr_init.3
|
||||
|
||||
pthread_attr_getdetachstate.3
|
||||
Michael Kerrisk
|
||||
New link to new pthread_attr_setdetachstate.3
|
||||
|
||||
pthread_attr_getguardsize.3
|
||||
Michael Kerrisk
|
||||
New link to new pthread_attr_setguardsize.3
|
||||
|
||||
pthread_attr_getscope.3
|
||||
Michael Kerrisk
|
||||
New link to new pthread_attr_setscope.3
|
||||
|
||||
pthread_attr_getstack.3
|
||||
Michael Kerrisk
|
||||
New link to new pthread_attr_setstack.3
|
||||
|
||||
pthread_attr_getstackaddr.3
|
||||
Michael Kerrisk
|
||||
New link to new pthread_attr_setstackaddr.3
|
||||
|
||||
pthread_attr_getstacksize.3
|
||||
Michael Kerrisk
|
||||
New link to new pthread_attr_setstacksize.3
|
||||
|
||||
pthread_timedjoin_np.3
|
||||
Michael Kerrisk
|
||||
New link to new pthread_tryjoin_np.3
|
||||
|
||||
signalfd4.2
|
||||
Michael Kerrisk
|
||||
New link to signalfd.2
|
||||
signalfd.2 now includes text describing signalfd4() system call,
|
||||
new in Linux 2.6.27.
|
||||
|
||||
|
||||
Global changes
|
||||
--------------
|
||||
|
||||
eventfd.2, getdents.2, mprotect.2, signalfd.2, timerfd_create.2,
|
||||
wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3,
|
||||
fopencookie.3, getdate.3, getgrouplist.3, getprotoent_r.3,
|
||||
getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3,
|
||||
makecontext.3, matherr.3, offsetof.3, pthread_attr_init.3,
|
||||
pthread_create.3, pthread_getattr_np.3, sem_wait.3, strtol.3, core.5
|
||||
Michael Kerrisk
|
||||
Add ".SS Program source" to EXAMPLE
|
||||
Add ".SS Program source" to clearly distinguish shell session and
|
||||
descriptive text from actual program code.
|
||||
|
||||
eventfd.2, execve.2, getdents.2, ioprio_set.2, mprotect.2,
|
||||
signalfd.2, timerfd_create.2, wait.2, backtrace.3,
|
||||
clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, frexp.3,
|
||||
getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3,
|
||||
gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3,
|
||||
malloc.3, matherr.3, offsetof.3, pthread_attr_init.3,
|
||||
pthread_create.3, pthread_getattr_np.3, sem_wait.3, strftime.3,
|
||||
strtok.3, strtol.3, core.5, proc.5, cpuset.7, mq_overview.7
|
||||
Michael Kerrisk
|
||||
Format user input in shell sessions in boldface
|
||||
|
||||
frexp.3, strftime.3, strtok.3
|
||||
Michael Kerrisk
|
||||
Relocate shell session above example program
|
||||
Move the shell session text that demonstrates the use of
|
||||
the example program so that it precedes the actual
|
||||
example program. This makes the page consistent with the
|
||||
majority of other pages.
|
||||
|
||||
|
||||
Changes to individual pages
|
||||
---------------------------
|
||||
|
||||
epoll_create.2
|
||||
Michael Kerrisk
|
||||
Say more about unused epoll_create() 'size' arg
|
||||
Supply a little more explanation about why the 'size' argument
|
||||
of epoll_create() is nowadays ignored.
|
||||
|
||||
eventfd.2
|
||||
Michael Kerrisk
|
||||
Remove crufty text relating to flags argument
|
||||
Remove sentence saying that glibc adds a flags argument
|
||||
to the syscall; that was only relevant for the older
|
||||
eventfd() system call.
|
||||
getdents.2
|
||||
Christoph Hellwig
|
||||
Fix text relating to DT_UNKNOWN and 'd_type' support
|
||||
Some file systems provide partial support for 'dt_type',
|
||||
returning DT_UNKNOWN for cases they don't support.
|
||||
Update the discussion of 'd_type' and DT_UNKNOWN to
|
||||
support this.
|
||||
|
||||
getpeername.2, getsockname.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add ip(7) and unix(7)
|
||||
|
||||
getsockopt.2
|
||||
Michael Kerrisk
|
||||
EINVAL can also occur if 'optval' is invalid
|
||||
In some cases, EINVAL can occur if 'optval' is invalid.
|
||||
Note this, and point reader to an example in ip(7).
|
||||
In response to:
|
||||
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=216092
|
||||
|
||||
inotify_init.2, pipe.2, timerfd_create.2
|
||||
Michael Kerrisk
|
||||
Clarify *_NONBLOCK description
|
||||
Make it clear that the NONBLOCK flag sets an attribute in the new
|
||||
open file description.
|
||||
|
||||
sched_yield.2
|
||||
Michael Kerrisk
|
||||
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.
|
||||
Michael Kerrisk
|
||||
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.
|
||||
|
||||
sigaction.2
|
||||
Michael Kerrisk
|
||||
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.
|
||||
|
||||
signalfd.2
|
||||
Michael Kerrisk
|
||||
Remove crufty text relating to flags argument
|
||||
Remove sentence saying that glibc adds a flags argument
|
||||
to the syscall; that was only relevant for the older
|
||||
signalfd() system call.
|
||||
|
||||
sigprocmask.2
|
||||
Michael Kerrisk
|
||||
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.
|
||||
|
||||
socket.2
|
||||
Michael Kerrisk
|
||||
Document SOCK_NONBLOCK and SOCK_CLOEXEC flags
|
||||
These flags, specified in the 'type' argument, are supported
|
||||
since Linux 2.6.27.
|
||||
|
||||
socketpair.2
|
||||
Michael Kerrisk
|
||||
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
|
||||
Linux 2.6.27.
|
||||
|
||||
syscalls.2
|
||||
Michael Kerrisk
|
||||
Add new 2.6.27 system calls
|
||||
Add pipe2(), dup3(), epoll_create1(), inotify_init1(),
|
||||
eventfd2(), signalfd4().
|
||||
|
||||
timerfd_create.2
|
||||
Michael Kerrisk
|
||||
Document timerfd_create() TFD_CLOEXEC and TFD_NONBLOCK
|
||||
TFD_CLOEXEC and TFD_NONBLOCK are supported since LInux 2.6.27.
|
||||
|
||||
vfork.2
|
||||
Michael Kerrisk
|
||||
Clarify meaning of "child releases the parent's memory"
|
||||
The man page was not explicit about how the memory used by
|
||||
the child is released back to the parent.
|
||||
|
||||
ctime.3
|
||||
Michael Kerrisk
|
||||
ctime_r() and localtime_r() need not set 'timezone' and 'daylight'
|
||||
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'.
|
||||
|
||||
dlopen.3
|
||||
Michael Kerrisk
|
||||
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.)
|
||||
|
||||
fmemopen.3
|
||||
Michael Kerrisk
|
||||
Document binary mode (mode 'b')
|
||||
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.
|
||||
|
||||
getaddrinfo.3
|
||||
Michael Kerrisk
|
||||
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
|
||||
EAI_SOCKTYPE.)
|
||||
|
||||
Also, add an error case for EAI_BADFLAGS.
|
||||
|
||||
gethostbyname.3
|
||||
Michael Kerrisk
|
||||
Rationalize text on POSIX.1-2001 obsolete interfaces
|
||||
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.
|
||||
|
||||
popen.3
|
||||
Michael Kerrisk
|
||||
Change one-line description in NAME
|
||||
s%process I/O%pipe stream to or from a process%
|
||||
Michael Kerrisk
|
||||
Document 'e' (close-on-exec) flag
|
||||
glibc 2.9 implements the 'e' flag in 'type', which sets the
|
||||
close-on-exec flag on the underlying file descriptor.
|
||||
|
||||
raise.3
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add pthread_kill(3)
|
||||
|
||||
readdir.3
|
||||
Christoph Hellwig
|
||||
Fix text relating to DT_UNKNOWN and 'd_type' support
|
||||
(This mirrors the previous change to getdents.2)
|
||||
Some file systems provide partial support for 'dt_type',
|
||||
returning DT_UNKNOWN for cases they don't support.
|
||||
Update the discussion of 'd_type' and DT_UNKNOWN to
|
||||
support this.
|
||||
|
||||
strcpy.3
|
||||
Jason Spiro
|
||||
Strengthen warning about checking against buffer overruns
|
||||
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=413940
|
||||
|
||||
tty_ioctl.4
|
||||
Michael Kerrisk
|
||||
Explain capability requirements for TIOCCONS
|
||||
Explain capability requirements for TIOCCONS, and describe
|
||||
changes in 2.6.10 relating to capabilities.
|
||||
Michael Kerrisk
|
||||
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).
|
||||
|
||||
proc.5
|
||||
Michael Kerrisk
|
||||
Document /proc/sys/kernel/threads-max
|
||||
Defines the system-wide limit on the number of threads (tasks).
|
||||
|
||||
utmp.5
|
||||
Pierre Cazenave
|
||||
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.
|
||||
|
||||
epoll.7
|
||||
Michael Kerrisk
|
||||
Mention epoll_create1() as part of epoll API
|
||||
epoll_create1() was added in Linux 2.6.27, and extends the
|
||||
functionality of epoll_create().
|
||||
|
||||
inotify.7
|
||||
Michael Kerrisk
|
||||
Mention inotify_init1() in overview of API
|
||||
Discuss the new inotify_init1() system call in the overview of
|
||||
the inotify API.
|
||||
|
||||
ip.7
|
||||
Michael Kerrisk
|
||||
Detail EINVAL error for IP_ADD_MEMBERSHIP socket option
|
||||
In response to:
|
||||
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=216092
|
||||
|
||||
iso_8859-7.7
|
||||
Lefteris Dimitroulakis
|
||||
Add Drachma, Euro, and Greek Ypogegrammeni
|
||||
Also, amend description of characters 0241 and 0242.
|
||||
|
||||
man-pages.7
|
||||
Michael Kerrisk
|
||||
Example shell sessions should have user input boldfaced
|
||||
|
||||
pthreads.7
|
||||
Michael Kerrisk
|
||||
Describe return value from pthreads functions
|
||||
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.
|
||||
|
||||
signal.7
|
||||
Michael Kerrisk
|
||||
Timeouts make socket interfaces non-restartable
|
||||
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.
|
||||
|
||||
socket.7
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add unix(7)
|
||||
|
||||
ld.so.8
|
||||
Michael Kerrisk
|
||||
Document LD_USE_LOAD_BIAS
|
||||
Drawing heavily on Jakub Jelinek's description in
|
||||
http://sources.redhat.com/ml/libc-hacker/2003-11/msg00127.html
|
||||
(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).
|
||||
Michael Kerrisk
|
||||
Since glibc 2.4, setuid/setgid programs ignore LD_ORIGIN_PATH
|
||||
Michael Kerrisk
|
||||
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?)
|
||||
Michael Kerrisk
|
||||
Since glibc 2.3.4, setuid/setgid programs ignore LD_DYNAMIC_WEAK
|
||||
Michael Kerrisk
|
||||
Since version 2.3.5, setuid/setgid programs ignore LD_SHOW_AUXV
|
||||
Michael Kerrisk
|
||||
Reorder lists of LD_* environment variables alphabetically
|
||||
Michael Kerrisk
|
||||
Since glibc 2.3.4, setuid/setgid programs ignore LD_DEBUG
|
||||
|
|
Loading…
Reference in New Issue