Ready for 3.36

Removed trailing white space at end of lines

fallocate.2, fork.2, open.2, send.2: tstamp

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

Changes: Update for 3.36

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

fsync.2: Note that some systems require a writable file descriptor

An edited version of Guillem Jover's comments:
[While the file descriptor does not need to be writable on Linux]
that's not a safe portable assumption to make on POSIX in general
as that behavior is not specified and as such is
implementation-specific. Some Unix systems do actually fail on
read-only file descriptors, for example [HP-UX and AIX].

Reported-by: Guillem Jover <guillem@hadrons.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

fsync.2: Minor clean-ups of Christoph's patch

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

fsync.2: Various improvements

- explain the situation with disk caches better
- remove the duplicate fdatasync() explanation in the NOTES
  section
- remove an incorrect note about fsync() generally requiring two
  writes
- remove an obsolete ext2 example note
- fsync() works on any file descriptor (doesn't need to be
  writable); correct the EBADF error code explanation

Signed-off-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

fallocate.2: srcfix: Added FIXME

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

fallocate.2: tfix

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

fallocate.2: ERRORS: Add EPERM error case for FALLOC_FL_PUNCH_HOLE

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

fallocate.2: Substantial restructuring of DESCRIPTION

The addition of a second class of operation ("hole punching")
to the man page made it clear that some significant restructuring
is required. So I substantially reworked the page, including the
preexisting material on the default "file allocation" operation.

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

fallocate.2: Add further details for FALLOC_FL_PUNCH_HOLE

Reported-by: Josef Bacik <josef@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

fallocate.2: Document FALLOC_FL_PUNCH_HOLE

FALLOC_FL_PUNCH_HOLE was added in Linux 2.6.38,
for punching holes in the allocated space in a file.

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

request_key.2: ffix

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

add_key.2: ffix

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

sendmmsg.2: minor changes

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

sendmmsg.2: srcfix: Added FIXME

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

send.2: Add mention of sendmmsg(2)

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

sendmmsg.2: New page for sendmmsg(2)

Some pieces inspired by an initial attempt by Stephan Mueller.

Reported-by: Stephan Mueller <stephan.mueller@atsec.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

dup.2: SYNOPSIS: Add "#include <fntl.h>" for O_* constants

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

pipe.2: SYNOPSIS: Add "#include <fntl.h>" for O_* constants

See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=659750

Reported-by: Salvo Tomaselli <tiposchi@tiscali.it>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

passwd.5: s/asterisk/asterisk (*)/ to improve clarity

Reported-by: Walter Haidinger <walter.haidinger@gmx.at>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

open.2: Fix grammar in O_DIRECT description

Some small grammar fixes to the O_DIRECT description.

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

mremap.2: spfix

Reported-by: Vijay Rao <vijay@portuosus.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

sem_wait.3: EXAMPLE: Remove extraneous line of output from shell session

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

sync.2: PROTOTYPE: Fix return type of syncfs()

Reported-by: Simone Piccardi <piccardi@truelite.it>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

vfork.2: CONFORMING TO: Note that POSIX.1-2001 marked vfork() obsolete

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

vfork.2: ffix

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

vfork.2: Add some notes on reasons why vfork() still exists

Reported-by: starlight@binnacle.cx
Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

vfork.2: Note clone() flags equivalent to vfork()

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

vfork.2: Clarify what is duplicated in the child

Add some words to make it clear to the reader that vfork(),
like fork(), creates duplicates of process attributes
in the child.

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

fork.2: NOTES: Descibe clone() call equivalent to fork()

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

vfork.2: Clarify that calling *thread* is suspended during vfork()

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

resolv.conf.5: Describe syntax used for comments

See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=656994

Reported-by: Slaven Rezic <srezic@iconmobile.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

passwd.5: Correct note on passwd field value when shadowing is enabled

When password shadowing is enabled, the password field
contains an 'x' (not a "8').

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

proc.5: Fix description of fourth field of /proc/loadavg

SIgned-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

scanf.3: tfix

Reported-by: Alain Benedetti <alainb06@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

wcslen.3: tfix

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

mount.2: Removed erroneous statement about MS_RDONLY and bind mounts

Reported-by: Junjiro Okajima <jro@mx3.ttcn.ne.jp>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

gets.3: Document C11 and glibc 2.16 changes affecting gets()

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

feature_test_macros.7: Document _ISOC11_SOURCE

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

core.5: Document %E specifier for core_pattern

Reported-by: Junjiro Okajima <jro@mx3.ttcn.ne.jp>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

readdir.3: wfix

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

inotify.7: Note that 'cookie' field is set to zero when unused

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

Expanded tabs

wcsnrtombs.3, wcsrtombs.3, wcstombs.3: Fix-ups for e9c23bc636426366d659809bc99cd84661e86464

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

wcpcpy.3: tfix

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

wcrtomb.3: ffix

Signed-off-by: David Prévot <taffit@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

pthread_sigmask.3: Fix comment that was inconsistent with code in example program

Reported-by: Pat Pannuto <pat.pannuto@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

sched_rr_get_interval.2: Update notes on modifying quantum

Since Linux 2.6.24, it is no longer possible to
modify the SCHED_RR quantum using setpriority(2).
(Slight edits to Clemens' patch by mtk.)

Signed-off-by: Clemens Ladisch <clemens@ladisch.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

sched_rr_get_interval.2: Reworded text of ESRCH error

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

sched_rr_get_interval.2: srcfix: Changed in-line formatting to dot directives

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

sched_rr_get_interval.2: Reordered various pieces of text

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

man.7: Various fixes for description of NAME section

As noted by reporter:
* The code sample given for the NAME section is incomplete because
  the actual content sample is not given.
* Additionally, the description assumes that the item described is
  a command, which need not be the case.
* The command makewhatis is not present on my system; the
  documented tool to create the whatis database is called mandb.
* The description on .SH NAME in man(7) should either copy the
  relevant paragraph of lexgrog(1) or refer to it.

Reported by: Kristof Zelechovski <giecrilj@stegny.2a.pl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

proc.5: srcfix: Added pointer to a commit

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

recvmmsg.2: srcfix: Added FIXME

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

syscalls.2: ffix

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

Changes.old: ffix

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

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

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

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

Ready for 3.35

Removed trailing white space at end of lines

Changes, setns.2, stat.2, proc.5, capabilities.7: tstamp

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

recvmmsg.2: tstamp

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

recvmmsg.2: SEE ALSO: add sendmmsg(2)

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

recvmmsg.2: Added copyright and license notice

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

recv.2: Add mention of recvmmsg(2)

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

recvmmsg.2: Various improvements and formatting fixes

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

recvmmsg.2: New man page for recvmmsg(2)

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

aio_cancel.3: Clarify meaning of "return status" and "error status"

Reported-by: Jon Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

aio_write.3: ffix

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

aio_read.3: ffix

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

mount.2, prctl.2: s/task/thread/ for consistency with other pages

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

intro.1, fork.2, futex.2, open.2, rename.2, select_tut.2, semop.2, spu_create.2, stat.2, netlink.3, random.3, scanf.3, shm_open.3, strftime.3, console.4, console_codes.4, sk98lin.4, st.4, bootparam.7, cpuset.7, credentials.7, man-pages.7, path_resolution.7, uri.7: Global fix: remove spaces around em-dash

Normal English typographical convention is not to have
spaces around em dashes.

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

stdio.3: ffix

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

setns.2: Edited in review comments from Eric Biederman

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

setns.2: Various improvements

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

proc.5: Some edit's to Eric Biederman's /proc/[pid]/ns/ additions

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

proc.5: Document /proc/[pid]/ns/

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

capabilities.7: List setns(2) as an operation allowed by CAP_SYS_ADMIN

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

setns.2: Minor improvements

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

setns.2: srcfix: Added FIXMEs

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

setns.2: Note privileges required

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

setns.2: Minor improvements

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

setns.2: New manual page for setns(2)

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

sigwaitinfo.2: Note that attempts to wait for SIGKILL and SIGSTOP are silently ignored

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

nsswitch.conf.5: wfix

Reported-by: Kevin Lyda <kevin@ie.suberic.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

netlink.3: wfix

Reported-by: Kevin Lyda <kevin@ie.suberic.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

termios.3: spfix

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

rt_sigqueueinfo.2: spfix

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

mknodat.2: scrfix: spelling fix

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

stat.2: Regarding automounter action, add a reference to fstatat(2)

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

stat.2: Note POSIX.1-2001 and POSIX.1-2008 requirements for lstat()

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

stat.2: Clean up text describing which POSIX descibes S_IF* constants

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

send.2: CONFORMING TO: POSIX.1-2008 adds MSG_NOSIGNAL

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

gets.3: POSIX.1-2008 marks gets() obsolescent

The page formerly erroneously stated that POSIX.1-2008
removed the specification of this function.

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

mbsnrtowcs.3, wcpcpy.3, wcpncpy.3, wcsnlen.3, wcsnrtombs.3: CONFORMING TO: Add POSIX.1-2008

These functions are specified in the POSIX.1-2008 revision.

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

strdup.3: CONFORMING TO: strndup() is in POSIX.1-2008

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

strcpy.3: SEE ALSO: Add stpncpy(3)

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>