From 3df44954f17d1d331d636d31ac72cea5cd23ce7f Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Sun, 31 Oct 2010 15:28:25 +0100 Subject: [PATCH] Changes: Update for changes to date in 3.30 Signed-off-by: Michael Kerrisk --- Changes | 261 +++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 259 insertions(+), 2 deletions(-) diff --git a/Changes b/Changes index a4ebcd43b..932d142ec 100644 --- a/Changes +++ b/Changes @@ -9,6 +9,19 @@ Contributors The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: +Andi Kleen +Bernhard Walle +David Prevot +Eric W. Biederman +Florian Lehmann +Jan Engelhardt +Lucian Adrian Grijincu +Michael Kerrisk +Paul Mackerras +Pádraig Brady +Reuben Thomas +Yuri Kozlov +scarlettsp Apologies if I missed anyone! @@ -16,19 +29,263 @@ Apologies if I missed anyone! New and rewritten pages ----------------------- +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. + Newly documented interfaces in existing pages --------------------------------------------- +reboot.2 + Andi Kleen + Document LINUX_REBOOT_KEXEC + Some fix-ups by Michael Kerrisk + Michael Kerrisk + Place 'cmd' values in alphabetical order. -New and changed links ---------------------- +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. Global changes -------------- +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 + + 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.) + +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 + Changes to individual pages --------------------------- +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 + +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