Start of man-pages-3.31: updating Changes and Changes.old

Start of man-pages-3.31: updating .Announce and .lsm files

Start of man-pages-3.31: renaming .Announce and .lsm files

Ready for 3.30

Expanded tabs

clone.2, fcntl.2, euidaccess.3, getopt.3: tstamp

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes: Ready for 3.30 release

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

feature_test_macros.7: Update example

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes: spfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes, clone.2, mount.2, nanosleep.2, sigaltstack.2, statfs.2, timer_settime.2, ctime.3, fmemopen.3, nl_langinfo.3, posix_memalign.3, pthread_attr_init.3, pthread_setaffinity_np.3, pthread_setschedprio.3, pthread_testcancel.3, setjmp.3, sigwait.3, tty_ioctl.4, epoll.7, posixoptions.7, unix.7: Add section number to references to functions documented in other pages

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

psignal.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

modf.3: tfix: s/modl/modfl/

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

sync_file_range.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getutent.3: wfix: s/pututent/pututline/

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

statfs.2: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getitimer.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

makedev.3: grfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

timer_create.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, dprintf.3, aio.7: grfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

setaliasent.3: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes, keyctl.2, request_key.2, subpage_prot.2, syslog.2, pthread_kill.3: ERRORS: Place errors in alphabetical order

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

wctype.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes, access.2, clone.2, aio_init.3, atexit.3, makecontext.3, makedev.3, pthread_attr_setdetachstate.3, pthread_exit.3: Remove redundant section number in page references

Remove section number in function references that are for
functions documented on this page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes: sync

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

timer_settime.2: Remove redundant SEE ALSO reference

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes: sync

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

clock_nanosleep.2, getpriority.2, kexec_load.2, nanosleep.2, nice.2, sched_setaffinity.2, timer_create.2, timer_delete.2, timer_settime.2, utime.2, btowc.3, futimes.3, log.3, pthread_attr_setguardsize.3, pthread_kill_other_threads_np.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_tryjoin_np.3, strcoll.3, strcpy.3, string.3, strxfrm.3, networks.5, aio.7, sigevent.7, udplite.7: SEE ALSO: Place entries in correct order

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes: Update for changes to date in 3.30

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

reboot.2: Place 'cmd' values in alphabetical order

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

kexec_load.2: Note that CONFIG_KEXEC is needed

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

reboot.2: Document LINUX_REBOOT_KEXEC

Some fix-ups by Michael Kerrisk

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

kexec_load.2: 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.

Reported-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

kexec_load.2: Added VERSIONS section

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

kexec_load.2: Resore accidentally deleted CONFORMING TO section

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

kexec_load.2: 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.
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.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

kexec_load.2: Add license

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

kexec_load.2: New page documenting kexec_load(2)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getresuid.2, intro.2, mremap.2, open.2, poll.2, posix_fadvise.2, pread.2, remap_file_pages.2, setresuid.2, signal.2, splice.2, sync_file_range.2, tee.2, vmsplice.2, INFINITY.3, asprintf.3, assert_perror.3, basename.3, bsd_signal.3, canonicalize_file_name.3, clog10.3, crypt.3, dl_iterate_phdr.3, dlopen.3, dprintf.3, encrypt.3, exp10.3, fcloseall.3, fenv.3, ffs.3, fmemopen.3, fopencookie.3, ftw.3, getdate.3, getline.3, getloadavg.3, getopt.3, getsubopt.3, getutent.3, grantpt.3, hsearch.3, intro.3, lseek64.3, memmem.3, mempcpy.3, mq_receive.3, mq_send.3, posix_fallocate.3, pow10.3, program_invocation_name.3, ptsname.3, putgrent.3, readdir.3, sigset.3, sincos.3, stpcpy.3, stpncpy.3, strchr.3, strfry.3, strnlen.3, strptime.3, strsignal.3, strstr.3, strverscmp.3, swab.3, sysv_signal.3, tsearch.3, unlocked_stdio.3, unlockpt.3, wcpcpy.3, wcpncpy.3, wcsdup.3, wcwidth.3: SEE ALSO: Remove redundant reference to feature_test_macros(7)

Reported-by: Florian Lehmann <flo.lehmann@googlemail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

strnlen.3: Fix feature test macro requirements

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

sched_getcpu.3: Fix feature test macro requirements

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getresuid.2, mremap.2, poll.2, remap_file_pages.2, setresuid.2, splice.2, sync_file_range.2, syscall.2, tee.2, vmsplice.2, INFINITY.3, aio_init.3, asprintf.3, assert_perror.3, basename.3, bsd_signal.3, canonicalize_file_name.3, clog10.3, crypt.3, dl_iterate_phdr.3, dlopen.3, encrypt.3, exp10.3, fcloseall.3, fenv.3, fopencookie.3, ftw.3, getaddrinfo_a.3, getloadavg.3, getutent.3, grantpt.3, hsearch.3, lseek64.3, memmem.3, mempcpy.3, pow10.3, program_invocation_name.3, ptsname.3, putgrent.3, sched_getcpu.3, sincos.3, strchr.3, strfry.3, strnlen.3, strptime.3, strstr.3, strverscmp.3, swab.3, sysv_signal.3, tsearch.3, unlockpt.3, wcwidth.3: 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.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

fenv.3: Clarify wording relating to glibc version

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

clone.2: Clarify when CLONE_NEWNET implementation was completed

Reported-by: Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

unshare.2: 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.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ipv6.7: tfix: fix IPV6_DSTOP(T)s typo

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

hosts.5, protocols.5, spufs.7, termio.7: 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*").

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

proc.5: Add reference to mlock(2) for further info on /proc/PID/status VmLck

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

mlock.2: shmctl() SHM_LOCKed memory is not included in VmLck

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

mlock.2: Improve wording describing /proc/PID/status /VmLck field

Reported-by: Yuri Kozlov <yuray@komyakino.ru>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

fcntl.2: RETURN VALUE: Improve description of F_GETFD and F_GETFL

Reported-by: scarlettsp <scarlettsp@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

subpage_prot.2: fixup

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

subpage_prot.2: Improvements after review by Paul Mackerras

Reported-by: Paul Mackerras <paulus@samba.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

armscii-8.7, ascii.7, cp1251.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, koi8-r.7, koi8-u.7, unicode.7: Use greater consistency in NAME line

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

iso_8859-6.7: Capitalize hexadecimal numbers

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

iso_8859-5.7: Capitalize hexadecimal numbers

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

iso_8859-4.7: Capitalize hexadecimal numbers

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

iso_8859-3.7: Capitalize hexadecimal numbers

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

iso_8859-14.7: Capitalize hexadecimal numbers

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

iso_8859-13.7: Capitalize hexadecimal numbers

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

iso_8859-11.7: Capitalize hexadecimal numbers

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

iso_8859-10.7: Capitalize hexadecimal numbers

The patch addresses the uppercase hexadecimal numbers
minor issue for iso_8859-10.7. Please note that this
patch also address a minor s/ca/CB/ typo.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cp1251.7: Capitalize hexadecimal numbers

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

armscii-8.7: Write the character set name as ArmSCII

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

armscii-8.7: Capitalize hexadecimal numbers

koi8-u.7 was not the only character set page displaying lowercase
hexadecimal numbers. The patch addresses this minor issue for
armscii-8.7 (other will follow, capitalized number are mostly used,
and that is the way they are presented in Unicode.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

koi8-u.7: Capitalize hexadecimal numbers

koi8-u.7 seems to be the only character set page displaying
lowercase hexadecimal numbers. The inline patch address this
minor issue.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

koi8-r.7: Fox 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

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

koi8-r.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

unshare.2: Document CLONE_NEWNET

Reported-by: Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

unshare.2: Document CLONE_NEWUTS

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

unshare.2: Dcoument CLONE_SYSVSEM

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

unshare.2: Document CLONE_NEWIPC

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

unshare.2: 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.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

unshare.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

access.2: Note use of faccessat(2) for checking symbolic link permissions

Reported-by: Reuben Thomas <rrt@sc3d.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

faccessat.2: Note that faccessat() is racy

Reported-by: Reuben Thomas <rrt@sc3d.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

euidaccess.3: Note the use of faccessat(2) to operate on symbolic links

Reported-by: Reuben Thomas <rrt@sc3d.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

euidaccess.3: Note that the use of euidaccess() is racy

Reported-by: Reuben Thomas <rrt@sc3d.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

access.2: Give an example of a safer alternative to using access()

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

access.2: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getopt.3: 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.

Signed-off-by: Bernhard Walle <bernhard@bwalle.de>

koi8-r.7: Fix SEE ALSO reference and letter names

he 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

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ip.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ip.7: Place socket options in alphabetical order

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ip.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ip.7: Fix name of socket option: s/IP_TTL/IP_TRANSPARENT/

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getgrent.3, getgrent_r.3, getgrnam.3: Refer reader for group(5) for more ino on group structure

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getpw.3, getpwent.3, getpwent_r.3: Refer reader to passwd(5) for more info on the passwd structure

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getpwent.3, getpwnam.3: Note that pw_gecos is not in POSIX

And change the comment describing this field

Reported-by: Reuben Thomas <rrt@sc3d.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getpw.3: Change comment describing pw_gecos

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getpwent_r.3: Change comment describing pw_gecos

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getpwnam.3: Some rewording and restructuring

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

passwd.5: Various minor rewordings

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

group.5: Various minor rewordings

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

group.5: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

passwd.5: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

lio_listio.3: New page documenting lio_listio(3)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

inotify_add_watch.2: Document ENOENT error

Reported-by: Pádraig Brady <P@draigbrady.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

subpage_prot.2: Change 1-line page description

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Start of man-pages-3.30: updating Changes and Changes.old

Start of man-pages-3.30: updating .Announce and .lsm files

Start of man-pages-3.30: renaming .Announce and .lsm files