wcsdup.3: RETURN VALUE: fix error in return value description

Return value for failure was accidentally changed from NULL to
-1 in man-pages commit 572acb41c48b6b8e690d50edff367d8b8b01702a.

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

socketcall(2): Document call argument

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

tty_ioctl.4: tfix

Reported-by: Nominal Animal <question@nominal-animal.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

futex.2: Minor wording fix

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

unix.7: wfix

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

openpty.3: Minor wording improvements

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

tmpfs.5: tmpfs supports extended attributes, but not 'user' extended attributes

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

xattr.7: SEE ALSO: add ioctl_iflags(2)

People sometimes confuse xattrs and inode flags. Provide a link
to the page that describes inode flags to give them a tip.

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

xattr.7: tfix

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

prctl.2: Explain rationale for use of subreaper processes

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

keyctl.2: srcfix

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

keyctl.2: tfix

Remove duplicated word.

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

epoll_create.2: wfix

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

epoll.7: wfix

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

alarm.2: SEE ALSO: add timer_create(2) and timerfd_create(2)

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

getpid.2: Mention init(1) and "subreapers" in discussion of parent PID

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

exit.3: Improve discussion of zombie processes

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

exit.3: Minor text restructuring for clarity

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

prctl.2: Improve description of PR_SET_CHILD_SUBREAPER

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

prctl.2: Note semantics of child_subreaper setting on fork() and exec()

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

open.2: Minor wording fix

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

open.2: Add statx() to list of "at" calls in rationale discussion

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

proc.5: Document /proc/sys/kernel/sched_child_runs_first

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

wait.2: Orphaned children may be adopted by a "subreaper", rather by than PD 1

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

_exit.2: On exit, child processes may be inherited by a "subreaper"

It is no longer necessarily true that orphaned processes
are inherited by PID 1.

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

_exit.2: Minor rewording

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

signalfd.2: SIGKILL and SIGSTOP are silently ignored in 'mask'

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

sigwaitinfo.2: sigwaitinfo() can't be used to accept synchronous signals

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

Changes.old: Fixes to 4.10 changelog

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

getentropy.3: SYNOPSIS: add missing return type for getentropy() declaration

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

sigsetops.3: tfix

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

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

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

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

Ready for 4.10

Removed trailing white space at end of lines

add_key.2, execve.2, fork.2, fsync.2, getrandom.2, getrlimit.2, getxattr.2, inotify_add_watch.2, ioctl.2, ioctl_fat.2, kcmp.2, keyctl.2, link.2, listxattr.2, lseek.2, madvise.2, mincore.2, mlock.2, nanosleep.2, poll.2, posix_fadvise.2, read.2, readv.2, recv.2, request_key.2, select.2, send.2, setxattr.2, sigaction.2, stat.2, statfs.2, syscall.2, tkill.2, truncate.2, unlink.2, vfork.2, write.2, __ppc_set_ppr_med.3, aio_suspend.3, backtrace.3, bcmp.3, bcopy.3, bzero.3, exec.3, fopen.3, fts.3, ftw.3, getline.3, getmntent.3, getopt.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, memfrob.3, memmem.3, memmove.3, memset.3, random.3, random_r.3, resolver.3, scandir.3, scanf.3, sem_post.3, sem_wait.3, setjmp.3, sleep.3, strerror.3, strverscmp.3, system.3, random.4, core.5, intro.5, resolv.conf.5, slabinfo.5, environ.7, ip.7, keyrings.7, man.7, persistent-keyring.7, pipe.7, process-keyring.7, random.7, session-keyring.7, signal-safety.7, signal.7, thread-keyring.7, unix.7, user-keyring.7, user-session-keyring.7, ld.so.8: tstamp

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

Changes: Ready for 4.10

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

keyctl.2: wfix

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

keyctl.2: Minor wording fix for KEYCTL_SET_REQKEY_KEYRING

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

keyctl.2: Improve KEYCTL_REJECT description

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

keyctl.2: Minor improvement to KEYCTL_INSTANTIATE description

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

keyctl.2: Minor improvements to KEYCTL_ASSUME_AUTHORITY description

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

keyctl.2: Minor clarification for KEYCTL_UPDATE

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

keyctl.2: Minor clarification for KEYCTL_REJECT

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

keyctl.2, request_key.2: Consistently use term "negatively instantiated key"

Eliminate uses of the term "negative key" in favor of
"negatively instantiated key".

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

keyctl.2: srcfix

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

keyctl.2: Improvements to description of KEYCTL_GET_KEYRING_ID

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

keyctl.2: Minor wording fix

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

keyctl.2: wfix

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

request_key.2: wfix

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

request_key.2: wfix

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

request_key.2: srcfix

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

request_key.2: Add links to some keyrings pages

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

request_key.2: wfix

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

keyrings.7: tfix

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

add_key.2: srcfix

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

signal.7: wfix

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

signal.7: tfix

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

syscall.2: Note parisc handling of aligned register pairs

While parisc would normally have the same behavior as ARM/PowerPC,
they decide to write shim syscall stubs to unpack/realign rather
than expose the padding to userspace.

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

proc.5: Mention other system calls that create 'anon_inode' file descriptors

Mention a few other system calls that create file descriptors
that display an 'anon_inode' symlink in /proc/PID/fd

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

proc.5: Minor improvement to description of /proc/PID/fd symlinks

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

proc.5: Remove duplicate /proc/[pid]/seccomp entry

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

proc.5: Minor: fix alphabetical order of some /proc/PID entries

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

proc.5: srcfix

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

proc.5: wfix

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

proc.5: wfix

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

mbind.2: Restore description of MPOL_BIND behavior before Linux 2.6.265

Krzysztof Kulakowski's patch updated the MPOL_BIND description
to describe current behavior, but the page should retain a
description of the older behavior as well.

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

mbind.2: Restore a sentence that should not have been removed by preceding patch

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

mbind.2: Update MPOL_BIND section

Behavior of MPOL_BIND has been changed in kernel commit
19770b32609b6bf97a3dece2529089494cbfc549 (Linux 2.6.26). This
patch updates section describing MPOL_BIND to be in sync with
current state of Documentation/vm/numa_memory_policy.txt.

Signed-off-by: Krzysztof Kulakowski <krzysztof.kulakowski@intel.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

open.2: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

syscall.2: Add endian details with 64-bit splitting

Architectures that split 64-bit values across register pairs
usually do so according to their C ABI calling convention (which
means endianness).  Add some notes to that effect, and change the
readahead example to show a little endian example (since that is
way more common than big endian).

Also start a new list of syscalls that this issue does not apply
to.

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

backtrace.3: SEE ALSO: add addr2line(1) and gdb(1)

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

posix_spawn.3: tfix

Reported-by: Paul Fee <paul.f.fee@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

namespaces.7: SEE ALSO: add ip-netns(8)

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

ip.7: SEE ALSO: add ip(8)

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

nanosleep.2: Describe "creeping sleep" problem

nanosleep() has a problem if used in a program that catches
signals and those signals are delivered at a very high rate.
Describe the problem, and note that clock_nanosleep(2)
provides a solution.

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

nanosleep.2: BUGS: explicitly note that the Linux 2.4 bug was fixed in Linux 2.6

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

ioctl_ns.2: Minor reworking of text

In preparation for material on new Linux 4.11 namespace
ioctl() operations.

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

listxattr.2: Eliminate extra E2BIG error text

Andreas' patch added a second description of E2BIG that
was (mostly) more detailed than the existing text. Combine
the two texts.

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

getxattr.2, listxattr.2: srcfix

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

getxattr.2, listxattr.2: Minor: fix alphabetic order of errors

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

getxattr.2, listxattr.2: Document E2BIG errors

Signed-off-by: Andreas Gruenbacher <agruenba@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ftw.3: Correctly handle use of stat info for FTW_NS in example program

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

ftw.3: Clarify that stat buffer is undefined for FTW_NS

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

link.2: Note limits where EMLINK is encountered on ext4 and Btrfs

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

proc.5: Add reference to vdso(7) in discussion of /proc/PID/maps

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

open.2: Make it clear that O_APPEND implies atomicity

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

lseek.2: Remove slightly bogus advice about race conditions

The page already (by now) contains a reference to open(2)
for a discussion of open file descriptions. Leave it at that,
since the reader can then deduce how things work.

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

readv.2: Remove generic advice about mixing stdio and syscalls on same file

There is nothing specific to readv()/writev() about this advice.

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

lseek.2: O_APPEND overrides the effect of lseek() when doing file writes

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

lseek.2: wfix

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

lseek.2: Remove ancient info about whence values and return values on old systems

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

environ.7: Mention prctl(2) PR_SET_MM_ENV_START and PR_SET_MM_ENV_END operations

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

proc.5: Tweaks to Mike's patch

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

proc.5: Clarify that /proc/PID/environ is set at time of execve(2)

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

proc(5): Clarify /proc/pid/environ behavior

/proc/pid/environ reflects process environment at
*start* of program execution.

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

environ.7: tfix/ffix

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

environ.7: ffix

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

fork.2: ffix

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