2010-10-19 17:21:45 +00:00
|
|
|
==================== Changes in man-pages-3.30 ====================
|
2007-09-19 21:40:03 +00:00
|
|
|
|
2010-10-19 17:21:45 +00:00
|
|
|
Released: ????-??-??, Munich
|
2007-09-19 21:40:03 +00:00
|
|
|
|
|
|
|
|
2007-11-24 13:50:54 +00:00
|
|
|
Contributors
|
|
|
|
------------
|
2007-10-23 11:33:49 +00:00
|
|
|
|
2007-11-24 13:50:54 +00:00
|
|
|
The following people contributed notes, ideas, or patches that have
|
|
|
|
been incorporated in changes in this release:
|
2007-09-20 18:15:23 +00:00
|
|
|
|
2010-10-31 14:28:25 +00:00
|
|
|
Andi Kleen <andi@firstfloor.org>
|
|
|
|
Bernhard Walle <bernhard@bwalle.de>
|
|
|
|
David Prevot <davidp@altern.org>
|
|
|
|
Eric W. Biederman <ebiederm@xmission.com>
|
|
|
|
Florian Lehmann <flo.lehmann@googlemail.com>
|
|
|
|
Jan Engelhardt <jengelh@medozas.de>
|
|
|
|
Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
|
|
|
|
Michael Kerrisk <mtk.manpages@gmail.com>
|
|
|
|
Paul Mackerras <paulus@samba.org>
|
|
|
|
Pádraig Brady <P@draigbrady.com>
|
|
|
|
Reuben Thomas <rrt@sc3d.org>
|
|
|
|
Yuri Kozlov <yuray@komyakino.ru>
|
|
|
|
scarlettsp <scarlettsp@gmail.com>
|
2008-10-07 08:54:13 +00:00
|
|
|
|
2007-11-24 13:50:54 +00:00
|
|
|
Apologies if I missed anyone!
|
2007-11-24 10:49:28 +00:00
|
|
|
|
2010-09-05 16:04:17 +00:00
|
|
|
|
|
|
|
New and rewritten pages
|
|
|
|
-----------------------
|
|
|
|
|
2010-10-31 14:28:25 +00:00
|
|
|
lio_listio.3
|
|
|
|
Michael Kerrisk
|
|
|
|
New page documenting lio_listio(3)
|
|
|
|
|
|
|
|
kexec_load.2
|
|
|
|
Andi Kleen
|
|
|
|
New page documenting kexec_load(2)
|
|
|
|
Michael Kerrisk
|
|
|
|
Add license
|
|
|
|
Michael Kerrisk
|
|
|
|
Incorporate fixes from Eric W. Biederman
|
|
|
|
Eric noted that a few instances of "virtual" should
|
|
|
|
be "physical" and noted:
|
|
|
|
|
|
|
|
There is an expectation that at hand off from sys_kexec that
|
|
|
|
virtual and physical addresses will be identity mapped. But
|
|
|
|
this isn't the old Alpha booting convention where you have
|
|
|
|
a virtual address and then you have to parse the page table
|
|
|
|
to figure out where your kernel was actually loaded.
|
|
|
|
Michael Kerrisk
|
|
|
|
Additions and edits by mtk
|
|
|
|
Various wording and layout improvements.
|
|
|
|
Fixed the name of a constant: s/KEXEC_ARCH_I386/KEXEC_ARCH_386/.
|
|
|
|
Added RETURN VALUE and ERRORS sections.
|
|
|
|
Added VERSIONS section
|
|
|
|
Note that CONFIG_KEXEC is needed
|
|
|
|
Removed details of using syscall; the reader can find them in
|
|
|
|
syscall(2).
|
|
|
|
Added some details for KEXEC_PRESERVE_CONTEXT.
|
|
|
|
Revised the text mentioning the kernel header, since it is
|
|
|
|
not yet exported, and it's not certain that it will be.
|
|
|
|
|
2010-09-05 16:04:17 +00:00
|
|
|
|
2010-02-26 06:59:33 +00:00
|
|
|
Newly documented interfaces in existing pages
|
|
|
|
---------------------------------------------
|
2009-09-30 03:21:56 +00:00
|
|
|
|
2010-10-31 14:28:25 +00:00
|
|
|
reboot.2
|
|
|
|
Andi Kleen
|
|
|
|
Document LINUX_REBOOT_KEXEC
|
|
|
|
Some fix-ups by Michael Kerrisk
|
|
|
|
Michael Kerrisk
|
|
|
|
Place 'cmd' values in alphabetical order.
|
2010-09-05 16:04:17 +00:00
|
|
|
|
2010-10-31 14:28:25 +00:00
|
|
|
unshare.2
|
|
|
|
Michael Kerrisk
|
|
|
|
Document CLONE_NEWIPC
|
|
|
|
Michael Kerrisk
|
|
|
|
Document CLONE_NEWNET
|
|
|
|
Lucian Adrian Grijincu
|
|
|
|
Improve description of CLONE_NEWNET
|
|
|
|
CLONE_NEWNET creates a new network namespace from scratch.
|
|
|
|
You don't have anything from the old network namespace in
|
|
|
|
the new one. Even the loopback device is new.
|
|
|
|
Michael Kerrisk
|
|
|
|
Dcoument CLONE_SYSVSEM
|
|
|
|
Michael Kerrisk
|
|
|
|
Document CLONE_NEWUTS
|
|
|
|
Michael Kerrisk
|
|
|
|
Relocate discussion of CAP_SYS_ADMIN to CLONE_NEWNS section
|
|
|
|
And rewrite the EPERM description to be more general in
|
|
|
|
preparation for the new flags to be documented.
|
2010-09-22 16:06:46 +00:00
|
|
|
|
|
|
|
|
2010-09-22 16:14:08 +00:00
|
|
|
Global changes
|
|
|
|
--------------
|
2010-09-22 16:06:46 +00:00
|
|
|
|
2010-10-31 14:28:25 +00:00
|
|
|
Various pages
|
|
|
|
Michael Kerrisk
|
|
|
|
Add reference to feature_test_macros(7)
|
|
|
|
Some pages simply list feature test macro requirements in
|
|
|
|
the form:
|
|
|
|
|
|
|
|
#define #GNU_SOURCE
|
|
|
|
#include <someheader.h>
|
|
|
|
|
|
|
|
For these pages, add a "See feature_test_macros(7)" comment
|
|
|
|
on the "#define" line.
|
|
|
|
|
|
|
|
Various pages
|
|
|
|
Michael Kerrisk
|
|
|
|
SEE ALSO: Remove redundant reference to feature_test_macros(7)
|
|
|
|
|
|
|
|
Various pages
|
|
|
|
David Prevot
|
|
|
|
Use greater consistency in NAME line
|
|
|
|
(Remove definite article at start of descriptiive clause.)
|
|
|
|
|
2010-11-01 05:35:26 +00:00
|
|
|
Various pages
|
|
|
|
Michael Kerrisk
|
|
|
|
SEE ALSO: Place entries in correct order
|
|
|
|
|
2010-11-01 06:18:03 +00:00
|
|
|
Various pages
|
|
|
|
Michael Kerrisk
|
|
|
|
ERRORS: Place errors in alphabetical order
|
|
|
|
|
2010-11-01 05:59:37 +00:00
|
|
|
Various pages
|
|
|
|
Michael Kerrisk
|
|
|
|
Remove redundant section number in page references
|
|
|
|
Remove section number in function references that are for
|
|
|
|
functions documented on this page.
|
|
|
|
|
2010-10-31 14:28:25 +00:00
|
|
|
armscii-8.7
|
|
|
|
iso_8859-3.7
|
|
|
|
iso_8859-4.7
|
|
|
|
iso_8859-5.7
|
|
|
|
iso_8859-6.7
|
|
|
|
iso_8859-10.7
|
|
|
|
iso_8859-11.7
|
|
|
|
iso_8859-13.7
|
|
|
|
iso_8859-14.7
|
|
|
|
koi8-u.7
|
|
|
|
David Prevot
|
|
|
|
Capitalize hexadecimal numbers
|
|
|
|
|
2009-09-30 03:21:56 +00:00
|
|
|
|
2007-11-24 13:50:54 +00:00
|
|
|
Changes to individual pages
|
|
|
|
---------------------------
|
2008-06-05 20:14:50 +00:00
|
|
|
|
2010-10-31 14:28:25 +00:00
|
|
|
access.2
|
|
|
|
Michael Kerrisk
|
|
|
|
Note use of faccessat(2) for checking symbolic link permissions
|
|
|
|
Michael Kerrisk
|
|
|
|
Give an example of a safer alternative to using access()
|
|
|
|
|
|
|
|
clone.2
|
|
|
|
Michael Kerrisk
|
|
|
|
Clarify when CLONE_NEWNET implementation was completed
|
|
|
|
|
|
|
|
faccessat.2
|
|
|
|
Michael Kerrisk
|
|
|
|
Note that faccessat() is racy
|
|
|
|
|
|
|
|
fcntl.2
|
|
|
|
Michael Kerrisk
|
|
|
|
RETURN VALUE: Improve description of F_GETFD and F_GETFL
|
|
|
|
|
|
|
|
inotify_add_watch.2
|
|
|
|
Michael Kerrisk
|
|
|
|
Document ENOENT error
|
|
|
|
|
|
|
|
mlock.2
|
|
|
|
Michael Kerrisk
|
|
|
|
Improve wording describing /proc/PID/status /VmLck field
|
|
|
|
Michael Kerrisk
|
|
|
|
shmctl() SHM_LOCKed memory is not included in VmLck
|
|
|
|
|
|
|
|
reboot.2
|
|
|
|
Michael Kerrisk
|
|
|
|
Place 'cmd' values in alphabetical order
|
|
|
|
|
|
|
|
subpage_prot.2
|
|
|
|
Michael Kerrisk
|
|
|
|
Change 1-line page description
|
|
|
|
Michael Kerrisk
|
|
|
|
Improvements after review by Paul Mackerras
|
|
|
|
|
2010-11-01 05:53:03 +00:00
|
|
|
timer_settime.3
|
|
|
|
Michael Kerrisk
|
|
|
|
Remove redundant SEE ALSO reference
|
|
|
|
|
2010-10-31 14:28:25 +00:00
|
|
|
euidaccess.3
|
|
|
|
Michael Kerrisk
|
|
|
|
Note the use of faccessat(2) to operate on symbolic links
|
|
|
|
Michael Kerrisk
|
|
|
|
Note that the use of euidaccess() is racy
|
|
|
|
|
|
|
|
fenv.3
|
|
|
|
Michael Kerrisk
|
|
|
|
Clarify wording relating to glibc version
|
|
|
|
|
|
|
|
getgrent.3
|
|
|
|
getgrent_r.3
|
|
|
|
getgrnam.3
|
|
|
|
Michael Kerrisk
|
|
|
|
Refer reader for group(5) for more info on group structure
|
|
|
|
|
|
|
|
getopt.3
|
|
|
|
Bernhard Walle
|
|
|
|
Use constants in getopt_long() example
|
|
|
|
The description of getopt_long() mentions the constants
|
|
|
|
required_argument, no_argument and optional_argument.
|
|
|
|
Use them in the example to make the code easier to understand.
|
|
|
|
|
|
|
|
getpw.3
|
|
|
|
Michael Kerrisk
|
|
|
|
Change comment describing pw_gecos
|
|
|
|
|
|
|
|
getpw.3
|
|
|
|
getpwent.3
|
|
|
|
getpwent_r.3
|
|
|
|
Michael Kerrisk
|
|
|
|
Refer reader to passwd(5) for more info on the passwd structure
|
|
|
|
|
|
|
|
getpwent.3
|
|
|
|
getpwnam.3
|
|
|
|
Michael Kerrisk
|
|
|
|
Note that pw_gecos is not in POSIX
|
|
|
|
And change the comment describing this field
|
|
|
|
|
|
|
|
getpwent_r.3
|
|
|
|
Michael Kerrisk
|
|
|
|
Change comment describing pw_gecos
|
|
|
|
|
|
|
|
getpwnam.3
|
|
|
|
Michael Kerrisk
|
|
|
|
Some rewording and restructuring
|
|
|
|
|
|
|
|
sched_getcpu.3
|
|
|
|
Michael Kerrisk
|
|
|
|
Fix feature test macro requirements
|
|
|
|
|
|
|
|
strnlen.3
|
|
|
|
Michael Kerrisk
|
|
|
|
Fix feature test macro requirements
|
|
|
|
|
|
|
|
group.5
|
|
|
|
Michael Kerrisk
|
|
|
|
Various minor rewordings
|
|
|
|
|
|
|
|
hosts.5
|
|
|
|
protocols.5
|
|
|
|
spufs.7
|
|
|
|
termio.7
|
|
|
|
David Prevot
|
|
|
|
Remove definite article from NAME section
|
|
|
|
Please find inline another tiny patch in order to shrink
|
|
|
|
the definite article from some other pages (found with
|
|
|
|
"rgrep -i ' \\\- the' man*").
|
|
|
|
|
|
|
|
passwd.5
|
|
|
|
Michael Kerrisk
|
|
|
|
Various minor rewordings
|
|
|
|
|
|
|
|
proc.5
|
|
|
|
Michael Kerrisk
|
|
|
|
Add reference to mlock(2) for further info on /proc/PID/status VmLck
|
|
|
|
|
|
|
|
armscii-8.7
|
|
|
|
David Prevot
|
|
|
|
Write the character set name as ArmSCII
|
|
|
|
|
|
|
|
cp1251.7
|
|
|
|
David Prevot
|
|
|
|
Capitalize hexadecimal numbers
|
|
|
|
|
|
|
|
ip.7
|
|
|
|
David Prevot
|
|
|
|
Fix name of socket option: s/IP_TTL/IP_TRANSPARENT/
|
|
|
|
David Prevot
|
|
|
|
Place socket options in alphabetical order
|
|
|
|
|
|
|
|
koi8-r.7
|
|
|
|
David Prevot
|
|
|
|
Fix special character names
|
|
|
|
Comparing to koi8-u.7, I noticed some inconsistencies in special
|
|
|
|
character names. After checking with the following Unicode related
|
|
|
|
pages, please find inline (and gzipped attached, hopefully not
|
|
|
|
messing with encoding), a patch in order to make it right, on an
|
|
|
|
Unicode point of view.
|
|
|
|
|
|
|
|
http://www.unicode.org/charts/PDF/U2500.pdf
|
|
|
|
http://www.unicode.org/charts/PDF/U25A0.pdf
|
|
|
|
http://www.unicode.org/charts/PDF/U0080.pdf
|
|
|
|
http://www.unicode.org/charts/PDF/U1D400.pdf
|
|
|
|
|
|
|
|
koi8-r.7
|
|
|
|
David Prevot
|
|
|
|
Fix SEE ALSO reference and letter names
|
|
|
|
The koi8-r(7) (Russian Net Character Set) manual page refers to
|
|
|
|
iso-8859-7(7) manual page, which is the Latin/Greek one. I guess it
|
|
|
|
should refer instead to the iso-8859-5(7) (Latin/Cyrillic) one. This is
|
|
|
|
addressed at the end of the patch.
|
|
|
|
|
|
|
|
It has also been spotted that letter names are different in this manual
|
|
|
|
page and in the Unicode related page [0], the first part of the page
|
|
|
|
address this.
|
|
|
|
|
|
|
|
0: http://www.unicode.org/charts/PDF/U0400.pdf
|