==================== Changes in man-pages-3.30 ==================== Released: ????-??-??, Munich 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! 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. 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.) Various pages Michael Kerrisk SEE ALSO: Place entries in correct order 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. 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 timer_settime.3 Michael Kerrisk Remove redundant SEE ALSO reference 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