mirror of https://github.com/mkerrisk/man-pages
212 lines
7.0 KiB
Plaintext
212 lines
7.0 KiB
Plaintext
==================== Changes in man-pages-3.36 ====================
|
|
|
|
Released: 2012-02-27, Christchurch
|
|
|
|
|
|
Contributors
|
|
------------
|
|
|
|
The following people contributed patches/fixes or (noted in brackets
|
|
in the changelog below) reports, notes and ideas that have been
|
|
incorporated in changes in this release:
|
|
|
|
Alain Benedetti <alainb06@free.fr>
|
|
carado <carado@savhon.org>
|
|
Christoph Hellwig <hch@lst.de>
|
|
Clemens Ladisch <clemens@ladisch.de>
|
|
David Prévot <taffit@debian.org>
|
|
Elie De Brauwer <eliedebrauwer@gmail.com>
|
|
Guillem Jover <guillem@hadrons.org>
|
|
Jessica McKellar <jesstess@mit.edu>
|
|
Josef Bacik <josef@redhat.com>
|
|
Junjiro Okajima <jro@mx3.ttcn.ne.jp>
|
|
Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
|
|
Michael Kerrisk <mtk.manpages@gmail.com>
|
|
Mike Frysinger <vapier@gentoo.org>
|
|
Pat Pannuto <pat.pannuto@gmail.com>
|
|
Salvo Tomaselli <tiposchi@tiscali.it>
|
|
Simone Piccardi <piccardi@truelite.it>
|
|
Slaven Rezic <srezic@iconmobile.com>
|
|
starlight@binnacle.cx
|
|
Stephan Mueller <stephan.mueller@atsec.com>
|
|
Vijay Rao <vijay@portuosus.com>
|
|
Walter Haidinger <walter.haidinger@gmx.at>
|
|
Walter Harms <wharms@bfs.de>
|
|
Yang Yang <wdscxsj@gmail.com>
|
|
|
|
Apologies if I missed anyone!
|
|
|
|
|
|
New and rewritten pages
|
|
-----------------------
|
|
|
|
sendmmsg.2
|
|
Michael Kerrisk [Stephan Mueller]
|
|
New page for sendmmsg(2)
|
|
Some pieces inspired by an initial attempt by Stephan Mueller.
|
|
|
|
|
|
Newly documented interfaces in existing pages
|
|
---------------------------------------------
|
|
|
|
fallocate.2
|
|
Lucian Adrian Grijincu
|
|
Document FALLOC_FL_PUNCH_HOLE
|
|
FALLOC_FL_PUNCH_HOLE was added in Linux 2.6.38,
|
|
for punching holes in the allocated space in a file.
|
|
|
|
|
|
Changes to individual pages
|
|
---------------------------
|
|
|
|
dup.2
|
|
Michael Kerrisk
|
|
SYNOPSIS: Add "#include <fntl.h>" for O_* constants
|
|
|
|
fallocate.2
|
|
Michael Kerrisk
|
|
Substantial restructuring of DESCRIPTION
|
|
The addition of a second class of operation ("hole punching")
|
|
to the man page made it clear that some significant restructuring
|
|
is required. So I substantially reworked the page, including the
|
|
preexisting material on the default "file allocation" operation.
|
|
Michael Kerrisk [Josef Bacik]
|
|
Add further details for FALLOC_FL_PUNCH_HOLE
|
|
Michael Kerrisk
|
|
ERRORS: Add EPERM error case for FALLOC_FL_PUNCH_HOLE
|
|
|
|
fork.2
|
|
Michael Kerrisk
|
|
NOTES: Describe clone() call equivalent to fork()
|
|
|
|
fsync.2
|
|
Christoph Hellwig
|
|
Various improvements
|
|
- explain the situation with disk caches better
|
|
- remove the duplicate fdatasync() explanation in the NOTES
|
|
section
|
|
- remove an incorrect note about fsync() generally requiring two
|
|
writes
|
|
- remove an obsolete ext2 example note
|
|
- fsync() works on any file descriptor (doesn't need to be
|
|
writable); correct the EBADF error code explanation
|
|
Michael Kerrisk [Guillem Jover]
|
|
Note that some systems require a writable file descriptor
|
|
An edited version of Guillem Jover's comments:
|
|
[While the file descriptor does not need to be writable on Linux]
|
|
that's not a safe portable assumption to make on POSIX in general
|
|
as that behavior is not specified and as such is
|
|
implementation-specific. Some Unix systems do actually fail on
|
|
read-only file descriptors, for example [HP-UX and AIX].
|
|
|
|
mount.2
|
|
Michael Kerrisk [Junjiro Okajima]
|
|
Removed erroneous statement about MS_RDONLY and bind mounts
|
|
|
|
open.2
|
|
Jessica McKellar
|
|
Fix grammar in O_DIRECT description
|
|
Some small grammar fixes to the O_DIRECT description.
|
|
|
|
pipe.2
|
|
Michael Kerrisk [Salvo Tomaselli]
|
|
SYNOPSIS: Add "#include <fntl.h>" for O_* constants
|
|
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=659750
|
|
|
|
sched_rr_get_interval.2
|
|
Clemens Ladisch
|
|
Update notes on modifying quantum
|
|
Since Linux 2.6.24, it is no longer possible to
|
|
modify the SCHED_RR quantum using setpriority(2).
|
|
(Slight edits to Clemens' patch by mtk.)
|
|
Michael Kerrisk
|
|
Reordered various pieces of text
|
|
Michael Kerrisk
|
|
Reworded text of ESRCH error
|
|
|
|
send.2
|
|
Michael Kerrisk
|
|
Add mention of sendmmsg(2)
|
|
|
|
sync.2
|
|
Michael Kerrisk [Simone Piccardi]
|
|
PROTOTYPE: Fix return type of syncfs()
|
|
|
|
vfork.2
|
|
Michael Kerrisk [starlight@binnacle.cx]
|
|
Clarify what is duplicated in the child
|
|
Add some words to make it clear to the reader that vfork(),
|
|
like fork(), creates duplicates of process attributes
|
|
in the child.
|
|
Michael Kerrisk
|
|
Note clone() flags equivalent to vfork()
|
|
Michael Kerrisk [starlight@binnacle.cx, Mike Frysinger]
|
|
Add some notes on reasons why vfork() still exists
|
|
Michael Kerrisk [starlight@binnacle.cx]
|
|
Clarify that calling *thread* is suspended during vfork()
|
|
Michael Kerrisk
|
|
CONFORMING TO: Note that POSIX.1-2001 marked vfork() obsolete
|
|
|
|
gets.3
|
|
Michael Kerrisk
|
|
Document C11 and glibc 2.16 changes affecting gets()
|
|
|
|
pthread_sigmask.3
|
|
Michael Kerrisk [Pat Pannuto]
|
|
Fix comment that was inconsistent with code in example program
|
|
|
|
sem_wait.3
|
|
Walter Harms
|
|
EXAMPLE: Remove extraneous line of output from shell session
|
|
|
|
wcsnrtombs.3
|
|
wcsrtombs.3
|
|
wcstombs.3
|
|
Michael Kerrisk
|
|
Fix-ups for e9c23bc636426366d659809bc99cd84661e86464
|
|
|
|
core.5
|
|
Michael Kerrisk [Junjiro Okajima]
|
|
Document %E specifier for core_pattern
|
|
|
|
passwd.5
|
|
Michael Kerrisk [Walter Haidinger]
|
|
s/asterisk/asterisk (*)/ to improve clarity
|
|
Michael Kerrisk
|
|
Correct note on passwd field value when shadowing is enabled
|
|
When password shadowing is enabled, the password field
|
|
contains an 'x' (not a "8').
|
|
|
|
proc.5
|
|
Elie De Brauwer
|
|
Fix description of fourth field of /proc/loadavg
|
|
SIgned-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
|
|
|
|
resolv.conf.5
|
|
Michael Kerrisk [Slaven Rezic]
|
|
Describe syntax used for comments
|
|
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=656994
|
|
|
|
feature_test_macros.7
|
|
Michael Kerrisk
|
|
Document _ISOC11_SOURCE
|
|
|
|
inotify.7
|
|
Michael Kerrisk [Yang Yang]
|
|
Note that 'cookie' field is set to zero when unused
|
|
|
|
man.7
|
|
Michael Kerrisk
|
|
Various fixes for description of NAME section
|
|
As noted by reporter:
|
|
* The code sample given for the NAME section is incomplete because
|
|
the actual content sample is not given.
|
|
* Additionally, the description assumes that the item described is
|
|
a command, which need not be the case.
|
|
* The command makewhatis is not present on my system; the
|
|
documented tool to create the whatis database is called mandb.
|
|
* The description on .SH NAME in man(7) should either copy the
|
|
relevant paragraph of lexgrog(1) or refer to it.
|
|
|
|
Reported by: Kristof Zelechovski <giecrilj@stegny.2a.pl>
|