9
9
The following people contributed notes, ideas, or patches that have
10
10
been incorporated in changes in this release:
12
Alexander E. Patrakov <patrakov@gmail.com>
13
Andi Kleen <andi@firstfloor.org>
14
Andrew Klossner <andrew@cesa.opbu.xerox.com>
15
Andr� Goddard Rosa <andre.goddard@gmail.com>
16
Bo Borgerson <gigabo@gmail.com>
17
Christian Franke <nobody@nowhere.ws>
18
Daisuke HATAYAMA <d.hatayama@jp.fujitsu.com>
19
David Sommerseth <davids@redhat.com>
12
Alexander Shishkin <virtuoso@slind.org>
13
Brian Sutin <Brian.Sutin@hs.utc.com>
20
14
Denis Barbier <bouzim@gmail.com>
21
Eric Blake <ebb9@byu.net>
22
Fang Wenqi <anton.fang@gmail.com>
23
Francesco Cosoleto <cosoleto@gmail.com>
24
Gernot Tenchio <gernot@tenchio.de>
25
Hugh Dickins <hughd@google.com>
26
Ivana Hutarova Varekova <varekova@redhat.com>
27
Jan Blunck <jblunck@novell.com>
28
Jan Engelhardt <jengelh@medozas.de>
29
Jan Kara <jack@suse.cz>
30
Jeff Barry <JeffBatHome@myletters.us>
31
Manfred Schwarb <manfred99@gmx.ch>
32
Mark Hills <mark@pogo.org.uk>
33
Martin (Joey) Schulze <joey@infodrom.org>
15
Guillem Jover <guillem@hadrons.org>
16
Jianhua Li <jhlicc@gmail.com>
17
Linus Nilsson <lajnold@gmail.com>
18
Lenaic Huard <lenaic.huard@laposte.net>
20
Martin Schulze <joey@infodrom.org>
21
Maxin John <maxin.john@gmail.com>
34
22
Michael Kerrisk <mtk.manpages@gmail.com>
35
Mihai Paraschivescu <paraschivescu_mihail@yahoo.com>
36
Mike Frysinger <vapier@gentoo.org>
37
Miklos Szeredi <miklos@szeredi.hu>
38
Petr Baudis <pasky@suse.cz>
39
Petr Gajdos <pgajdos@suse.cz>
40
Petr Uzel <petr.uzel@suse.cz>
41
Pierre Habouzit <madcoder@madism.org>
42
Reuben Thomas <rrt@sc3d.org>
43
Rob Landley <rob@landley.net>
44
Robert Wohlrab <robert.wohlrab@gmx.de>
45
Serge E. Hallyn <serge@hallyn.com>
46
Tolga Dalman <tdalman@project-psi.org>
47
Tom Swigg <swiggtc@lsbu.ac.uk>
48
Walter Harms <wharms@bfs.de>
23
Nicholas Hunt <nhunt@cs.washington.edu>
24
Peng Haitao <penght@cn.fujitsu.com>
25
Peter Stuge <peter@stuge.se>
26
Przemyslaw Szczepaniak <Przemyslaw.Szczepaniak@imgtec.com>
27
Scott Walls <sawalls@umich.edu>
28
TAN Yee Fan <tanyeefa@comp.nus.edu.sg>
29
Wu Fengguang <fengguang.wu@intel.com>
30
Yitzchak Gale <gale@sefer.org>
49
31
Yuri Kozlov <yuray@komyakino.ru>
51
33
Apologies if I missed anyone!
54
New and rewritten pages
55
-----------------------
59
New page documenting migrate_pages(2).
60
Andi's text based on the move_pages.2 page;
61
additional edits by mtk.
62
migrate_pages(2) was new in Linux 2.6.16.
67
Update the page to consolidate information from the
68
outdated man-pages quotactl.2 page and the quotactl.2
69
page in the "quota-tools" pachage. The page in "quota-tools"
70
has now been dropped by Jan Kara, so that there is just one
71
canonical quotactl.2 page (in pan-pages).
73
Various other pieces added to the page by mtk.
76
35
Newly documented interfaces in existing pages
77
36
---------------------------------------------
81
Document F_SETPIPE_SZ and F_GETPIPE_SZ
82
These commands, new in kernel 2.6.35, set and get the capacity
87
Document MADV_HWPOISON
89
Added documentation of MADV_MERGEABLE and MADV_UNMERGEABLE
90
These flags (used for Kernel Samepage Mergeing, KSM)
93
Document MADV_SOFT_OFFLINE
94
This operation was added in Linux 2.6.33.
98
Document MAP_UNINITIALIZED flag
103
Document the hwpoison prctls in 2.6.32
107
Document SCHED_RESET_ON_FORK
112
Document UMOUNT_NOFOLLOW
117
Document mkstemps() and mkostemps()
118
These functions are new in glibc 2.11. They allow the template
119
string to include a suffix after the "XXXXXX" string.
123
Document /proc/sys/vm/memory_failure_early_kill
124
New in 2.6.32. Description based on the text in
125
Documentation/sysctl/vm.txt.
127
Document /proc/sys/vm/memory_failure_recovery
128
New in Linux 2.6.32. Description based on the text in
129
Documentation/sysctl/vm.txt.
131
Document /proc/sys/fs/pipe-max-size
135
Document SO_DOMAIN and SO_PROTOCOL
136
These read-only socket options were new in Linux 2.6.32.
139
New and changed links
140
---------------------
144
Adjust link to point to Section 3
149
New link to page relocated to Section 3
154
New links to mkstemp.3
155
mkstemp.3 now describes mkstemps(3) and mkostemps(3).
163
Add 'L' to constants in feature test macro specifications
164
Be consistent with POSIX, which uses constants such as 200809L.
40
Document EFD_SEMAPHORE
41
Document the EFD_SEMAPHORE flag, added in kernel 2.6.30.
42
Also restructured some parts of the text to fit with the
43
addition of the EFD_SEMAPHORE text.
174
Global fix: s/filesystem/file system/
53
s/logical OR/bitwise OR/
177
56
Changes to individual pages
178
57
---------------------------
182
Note that glibc 2.11 papers over the kernel F_GETOWN bug
183
Since version 2.11, glibc works around the kernel limitation for
184
process groups IDs < 4096 by implementing F_GETOWN via F_GETOWN_EX.
188
Various fixes in SEE ALSO
193
Move renice from section 8 to section 1
198
See kernel commit 1f10206.
200
Description of maintained fields
201
These descriptions are taken from NetBSD 5.0's getrusage(2).
203
Enhanced description of various fields
207
/proc/PID/status VmLck shows how much memory a process has locked
208
After a note from Tom Swigg, it seems sensible mention VmLck here.
216
Clarify includes/libraries
220
Clarify existence of fifth argument.
226
Move ipcs from section 8 to section 1
230
Remove ambiguity in text on NFS and O_EXCL.
234
Fix discussion of ppoll() timeout argument
235
1. Rename ppoll)(_ argument to "timeout_ts" to distinguish it
236
from the poll() argument in the text.
237
2. More accurately describe the poll() call that is equivalent
242
Add sync_file_range(2) under SEE ALSO
246
Correct PR_SET_KEEPCAPS description
247
The "keep capabilities" flag only affects the treatment of
248
permitted capabilities, not effective capabilities.
249
Also: other improvements to make the PR_SET_KEEPCAPS text clearer.
253
Fix bug in example program
257
Add TRAP_BRANCH and TRAP_HWBKPT to si_code values for SIGTRAP
259
Rearrange text describing fields set by sigqueue(2)
261
Add details for signals sent by POSIX message queue notifications
263
Improve description of various siginfo_t fields
265
Add some details for SIGTRAP and si_trapno
267
Document hwpoison signal extensions
61
Fix discussion of return value when interrupted by a signal
65
Small fix to types in data structures
69
Clarified close-on-exec behavior
73
Improve discussion of MADV_SOFT_OFFLINE
77
Add EMLINK error to ERRORS
86
Fix return type in SYNOPSIS (s/mqd_t/int/)
91
Remove obsolete reference to glibc version in NOTES
96
Adjust type shown for msg_controllen to glibc reality
97
This patch fixes the type of msg_controllen in the struct msghdr
98
definition given in send.2 and recv.2 to match the definition in
103
Update NOTES on old glibc pselect()
104
Make it clear that modern glibc uses the kernel pselect()
105
on systems where it is available.
106
See https://bugzilla.kernel.org/show_bug.cgi?id=14411
271
Bring statfs struct type declarations closer to glibc reality
273
Add definition EXT4_SUPER_MAGIC = 0xEF53
275
Document f_frsize field.
279
Move this page to section 3 (since it's a library call)
282
Ivana Hutarova Varekova
283
Note effect of iCONFIG_MEMORY_FAILURE on MAX_SWAPFILES
284
From 2.6.32, MAX_SWAPFILES is decreased by 1 if the kernel is
285
built with CONFIG_MEMORY_FAILURE.
289
Bring system call list up to date with Linux 2.6.33
291
Fix kernel version number for utimes()
295
Note fix for C99 conformance in glibc 2.12.
299
Correct note on key portion significance
300
As Marcel Moreaux notes:
302
The Linux manpage for crypt()[1] contains the following
303
statement as the last sentence of the NOTES section:
305
In the SHA implementation the entire key is significant
306
(instead of only the first 8 bytes in MD5).
308
It should probably say "DES" where it says "MD5" (and maybe
309
"MD5/SHA" where it says "SHA"), because in MD5 password hashing,
310
the entire key is significant, not just the first 8 bytes.
312
This patch fixes the wording.
316
Bug fix in example program
320
Note that if 'fn' changes CWD, the results are undefined
322
Clarify description of fpath argument
323
As reported by Pierre Habouzit, 'fpath' is not relative
324
to 'dirpath'. It is either relative to the calling process's
325
current working directory (if 'dirpath' was relative), or it
326
is absolute (if 'dirpath' was absolute).
330
Fix a field name mixup: s/ai_family/ai_flags/
334
Remove unneeded check before free()
335
The manpage of getline shows an example with an extra NULL pointer
336
check before it calls free. This is unneeded according to free(3):
338
If ptr is NULL, no operation is performed.
340
This patch removes the "if" check.
342
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=572508
348
Add cross-references to other-base logarithmic functions
352
Specify feature test macro requirements for fdopendir(3)
353
Currently, there is no note on the fact that fdopendir() is
358
Use const as appropriate
360
Note glibc version that added "const" to function arguments
362
Explicitly note that these functions are not in POSIX
366
Fix declaration of dn_comp() in SYNOPSIS
367
Remove the second 'exp_dn' from the calling signature.
371
Change NOFLSH text to speak of characters, not signals
375
Update description of coredump_filter
376
Kernel 2.6.24 added MMF_DUMP_ELF_HEADERS.
377
Kernel 2.6.28 added MMF_DUMP_HUGETLB_PRIVATE and
378
MMF_DUMP_HUGETLB_SHARED.
382
Document PN_XNUM extension
383
In linux-2.6.34-rc1, an ELF core extension was added; user-land
384
tools manipulating ELF core dump such as gdb and binutils has
385
already been modified before; so elf.5 needs to be modified
388
You can follow information on the ELF extension via the LKML post:
389
http://lkml.org/lkml/2010/1/3/103
390
Date Mon, 04 Jan 2010 10:06:07 +0900 (JST)
391
Subject ... elf coredump: Add extended numbering support
393
This Linux-specific extension was added in kernel 2.6.34.
395
Reviewed-by: Petr Baudis <pasky@suse.cz>
399
As reported by Yuri Kozlov and confirmed by Mike Frysinger,
400
EI_BRAND is not in GABI
401
(http://www.sco.com/developers/gabi/latest/ch4.eheader.html)
402
It looks to be a BSDism
404
Remove words under '.note': "described below"
405
The existing text is broken, because there is
406
no '"Note Section" format' describe below. Simplest
407
solution is to remove the words "described below".
411
Add discussion of ntfs and ext4
415
Simplify description of /proc/sys and /proc/sys/fs
416
In the description of these directories, there's no need
417
to list all the files and subdirectories that they contain;
418
that information is provided by the entries that follow.
110
Fix copy & paste error for __SWORD_TYPE definition
114
Clarify that this syscall is obsolete.
115
And strengthen recommendation to use /proc/filesystems instead.
119
Add EDESTADDRREQ error
123
Fix error in NOTES, s/a64l/l64a/
127
Change "perror" to "strerror" in DESCRIPTION of error()
131
Fix EAGAIN description (s/empty/full)
422
Remove crufty reference to nonexistent BUGS section
426
Document CAP_SYS_RESOURCE and F_SETPIPE_SZ
427
With CAP_SYS_RESOURCE, a process can increase pipe capacity above
428
/proc/sys/ps/pipe-max-size.
430
Add get_robust_list() info under CAP_SYS_PTRACE
432
Add MADV_HWPOISON under CAP_SYS_ADMIN
436
Make a clearer statement about nonportable aspect of signal(2)
437
Make a clearer statement that signal(2) is less portable for
438
establishing a signal handler.
442
Use consistent language to describe read-only socket options
446
Add FIONREAD warning.
447
Warn that FIONREAD can't can't distinguish case of a zero-length
448
datagram from the case where no datagrams are available.
135
Fix IP address in explanation of NFS example
139
Add information on version 2 format timezone files
140
Updated using information from the tzcode 2010l release at
141
ftp://elsie.nci.nih.gov/pub.
142
(It's an open question whether or not a version of tzfile.5
143
should live independently in man-pages. It was added to the
144
man-pages set many years ago. For now, I'll follow a
145
conservative course that causes least pain to downstream,
146
by continuing to maintain a separate copy in man-pages.)
148
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=594219