kexec_file_load.2: New link to kexec_load.2

kexec_load.2: Remove crufty statements that constants are not exported to glibc

With the kernel "uapi" changes of a a few releases ago, these
constants are now automatically provided to glibc.

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

kexec_load.2: Move some text from NOTES to DESCRIPTION

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

kexec_load.2: SEE ALSO: add Documentation/kernel-parameters.txt

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

kexec_load.2: SEE ALSO: add Documentation/kdump/kdump.txt

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

kexec_load.2: Edits after review comments by Vivek Goyal

Reviewed-by: Vivek Goyal <vgoyal@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

kexec_load.2: srcfix: Add Vivek Goyal to copyright notice

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

kexec_load.2: tfix

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

kexec_load.2: Note rationale for kexec_file_load()

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

kexec_load.2: Minor rewording

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

kexec_load.2: SEE ALSO: add kexec(8)

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

reboot.2: ffix

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

reboot.2: SEE ALSO: add kexec_load(2)

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

kexec_load.2: Add FIXMEs

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

kexec_load.2: srcfix

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

kexec_load.2: srcfix: remove a FIXME

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

kexec_load.2: kexec_file_load() requires CONFIG_KEXEC_FILE

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

kexec_load.2: CONFORMING TO: update for kexec_file_load()

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

kexec_load.2: wfix

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

kexec_load.2: Note kernel version for kexec_file_load()

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

kexec_load.2: Tweaks to Vivek Goyal's patch

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

kexec_load.2: Document new kexec_file_load() system call

Signed-off-by: Vivek Goyal <vgoyal@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

iconvconfig.8: wfix

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

tcp.7: wfix

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

tcp.7: tfix

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

socket.7: wfix

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

pthreads.7: wfix

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

pipe.7: wfix

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

namespaces.7: wfix

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

ipv6.7: wfix

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

epoll.7: wfix

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

bootparam.7: wfix

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

repertoiremap.5: wfix

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

proc.5: wfix

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

st.4: tfix

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

rtc.4: wfix

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

mem.4: wfix

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

statfs.2: wfix

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

shmctl.2: wfix

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

setns.2: wfix

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

select_tut.2: wfix

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

perf_event_open.2: wfix

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

ioprio_set.2: wfix

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

execve.2: wfix

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

close.2: wfix

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

memusage.1: wfix

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

strcmp.3: wfix

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

fmemopen.3: wfix

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

pow.3: wfix

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

fclose.3: wfix

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

addseverity.3: wfix

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

fflush.3: wfix

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

fflush.3: srcfix

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

fflush.3: tfix

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

fflush.3: POSIX.1-2008 specifies the behavior when flushing input streams

POSIX.1-2001 did not have a specification for input streams,
but POSIX.1-2008 added one.

Reported-by: Sergey V. Zubkov <cubbi@cubbi.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

fflush.3: Clarify that flushing of input streams occurs only for seekable files

See https://bugzilla.kernel.org/show_bug.cgi?id=91931

Reported-by: Sergey V. Zubkov <cubbi@cubbi.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.1: ffix

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

prctl.2: Unused arguments of PR_MPX_(EN,DIS}ABLE_MANAGEMENT must be zero

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

perf_event_open.2: srcfix: add git commit references

I noticed you were adding git commit references to the various
Linux version markers.

This adds git commit references for all Linux kernel version
notes in perf_event_open.2

mtk: I backed out two pieces of Vince's patch that were not
source comments. They can be dealt with as separate commits.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

tzset.3: Clarify that first timezone format does not contain spaces

Reported-by: J William Piggott <elseifthen@gmx.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

tzset.3: Correct system timezone file path

The manual incorrectly states the system timezone
path as /usr/share/zoneinfo/localtime. Glibc does
not use that file for anything, it uses
$(prefix)/etc/localtime.

There is an ambiguous reference in the man-page to
/etc/localtime, but it does not indicate that it
will be used. It states clearly that
/usr/share/zoneinfo/localtime is used.

A comment in the glibc Makeconfig even says that
file should not exist:

> ... relative to $(zonedir).  It is a good idea
> to put this somewhere other than there, so the
> zoneinfo directory contains only universal data,
> localizing the configuration data elsewhere.

Furthermore, the man page does not indicate the
reason this file is being used; which is because
it is the configured system timezone.

A later patch in this series addresses the
possibility that /etc/localtime could be changed
during glibc's compilation. The language changed
in this patch points to the FILE section which is
where the explanation will be. There is no reason
to repeat that information multiple times
throughout the man-page.

EVIDENCE:

glibc/Makeconfig:256: sysconfdir = $(prefix)/etc
glibc/Makeconfig:272: localtime-file = $(sysconfdir)/localtime

FROM INFO LIBC:
C.2 Installing the C Library
============================
   To configure the locally used timezone, set the `TZ' environment
variable.  The script `tzselect' helps you to select the right value.
As an example, for Germany, `tzselect' would tell you to use
`TZ='Europe/Berlin''.  For a system wide installation (the given paths
are for an installation with `--prefix=/usr'), link the timezone file
which is in `/usr/share/zoneinfo' to the file `/etc/localtime'.  For
Germany, you might execute `ln -s /usr/share/zoneinfo/Europe/Berlin
/etc/localtime'.

STEPS TO REPRODUCE:

cd /usr/share/zoneinfo/
cp Antarctica/South_Pole localtime
cp /US/Eastern /etc/localtime
cd
date
Sun Jan 18 12:06:36 EST 2015
TZ=:/usr/share/zoneinfo/localtime date
Mon Jan 19 06:06:54 NZDT 2015
rm /etc/localtime
date
Sun Jan 18 17:08:37 UTC 2015
TZ=:/usr/share/zoneinfo/localtime date
Mon Jan 19 06:08:41 NZDT 2015

Signed-off-by: J William Piggott <elseifthen@gmx.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

tzset.3: Document behavior when TZ filespec omits the colon

If the TZ filespec omits the leading colon, glibc will parse
it for any valid format, i.e., it will still work.

STEPS TO REPRODUCE:
TZ=:Europe/Kiev date
Sun Jan 18 20:19:13 EET 2015
TZ=Europe/Kiev date
Sun Jan 18 20:19:20 EET 2015

Signed-off-by: J William Piggott <elseifthen@gmx.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

tzset.3: Filespec omitted incorrect

Paragraph three of the DESCRIPTION section says
that when TZ is set, but empty, then UTC is used.

Later it says if the TZ filespec is omitted then the file
/usr/share/zoneinfo/localtime is used.  This is incorrect,
it will use UTC in that case as well.

Steps to reproduce:

cd /usr/share/zoneinfo/
cp Antarctica/South_Pole localtime
cd
date
Sun Jan 18 10:59:50 EST 2015
TZ=:Hongkong date
Sun Jan 18 23:59:56 HKT 2015
TZ=:/usr/share/zoneinfo/localtime date
Mon Jan 19 05:00:03 NZDT 2015
TZ=: date
Sun Jan 18 16:00:11 UTC 2015
TZ=":" date
Sun Jan 18 16:00:18 UTC 2015
TZ=':' date
Sun Jan 18 16:00:24 UTC 2015
TZ=:/ date
Sun Jan 18 16:00:34  2015
TZ=":/" date
Sun Jan 18 16:00:40  2015
TZ="" date
Sun Jan 18 16:00:45 UTC 2015

Signed-off-by: J William Piggott <elseifthen@gmx.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes.old: tfix in 3.78 changelog

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

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

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

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

Ready for 3.78

Removed trailing white space at end of lines

Changes: Expanded tabs

_exit.2, dup.2, execve.2, execveat.2, fallocate.2, fcntl.2, get_robust_list.2, getrlimit.2, mbind.2, memfd_create.2, mmap.2, open.2, ptrace.2, readv.2, select.2, sigaction.2, syscall.2, syscalls.2, truncate.2, utimensat.2, write.2, errno.3, exec.3, fclose.3, fexecve.3, fmemopen.3, fopencookie.3, getgrent_r.3, getline.3, getmntent.3, getpw.3, getpwent_r.3, getspnam.3, malloc_info.3, posix_fallocate.3, putgrent.3, shm_open.3, locale.5, proc.5: tstamp

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

Changes: Ready for 3.78

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

execveat.2: srcfix: Copyright

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

proc.5: tfix

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

proc.5: Document /proc/sys/vm/compact_memory

Since 2.6.36 [1] CONFIG_COMPACTION is supported in Linux (for a
detailed explanation see [2]). But in essence the contents of
/proc/buddyinfo shows how much contiguous areas of a certain
size are available. These numbers are not actually up to date
as the Linux kernel will implicitly trigger compaction
(+- defragmentation) when an allocation is done.  This makes it
difficult since you can't predict upfront whether or not a large
allocation will succeed or not.  By using
/proc/sys/vm/compact_memory you can explicitly trigger compaction
to occur and /proc/buddyinfo will give a more realistic view on
the available memory in contiguous areas.

This patch updates proc.5 to explain the usage of this file and is
inspired by Documentation/systcl/vm.txt [3]

[1] http://kernelnewbies.org/Linux_2_6_35#head-9cb0a1275559d40296da42efb7977896ac9edab7
[2] http://lwn.net/Articles/368869/
[3] http://lxr.free-electrons.com/source/Documentation/sysctl/vm.txt#L100

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

sigaction.2: tfix and ffix

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

fanotify_mark.2: tfix

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

perf_event_open.2: Correct the kernel version number for PERF_COUNT_HW_CACHE_NODE

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

perf_event_open.2: Add some kernel version numbers to various fields and constants

And add some commit hashes in the page source.

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

perf_event_open.2: tfix

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

perf_event_open.2: wfix

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

perf_event_open.2: tfix

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

perf_event_open.2: Clarify description of overflow events

Update the perf_event_open manpage to be more consistent when
discussing overflow events.  It merges the discussion of
poll-type notifications with those generated by SIGIO
signal handlers.
This addresses the remaining FIXMEs is the document.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

perf_event_open.2: Remove innaccurate paragraph describing attr.config

Remove an inaccurate paragraph about values in the attr.config
field.  This information was never true in any released kernel;
it somehow snuck into the manpage because it is still described
this way in tools/perf/design.txt in the kernel source tree.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

readv.2: Reorder "C library/kernel ABI differences" subsections under NOTES

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

readv.2: Update details on glibc readv()/writev() wrapper behavior

And add a historical detail about Linux 2.0.

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

readv.2: Minor reformatting in ERRORS

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

_exit.2: Add "C library/kernel ABI differences" for paragraph on exit_group()

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

syscalls.2: Adds390_pci_mmio_read(2) and s390_pci_mmio_write(2)

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

s390_pci_mmio_write.2: Tweaks to Alexey Ishchuk's page

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

s390_pci_mmio_write.2: srcfix

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

s390_pci_mmio_read.2: New link to new s390_pci_mmio_write(2) page

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

s390_pci_mmio_write.2: New page for s390 s390_pci_mmio_write() and s390_pci_mmio_read()

New manual page for the new PCI MMIO memory access system
calls, s390_pci_mmio_write() and s390_pci_mmio_read(),
added for the s390 platform.

Signed-off-by: Alexey Ishchuk <aishchuk@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

mbind.2: Clarify EFAULT text

Reported-by: Daniel J Blueman <daniel@quora.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

fcntl.2: ERRORS: add EBUSY case for F_SETPIPE_SZ

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

fcntl.2: ERRORS: add open file description lock error cases

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

fcntl.2: wfix

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

fcntl.2: wfix

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

fcntl.2: ERRORS: add various file-sealing error cases

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

fcntl.2: Edits and additions after review by David Herrmann

Reviewed-by: David Herrmann <dh.herrmann@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>