pivot_root.2: Mention containers as a use case for pivot_root()

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

pivot_root.2: srcfix

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

pivot_root.2: There is no restriction against 'put_old' being a mount point

As far as I can see from the source code, the statement that
"No other filesystem may be mounted on 'put_old'" is incorrect.
Even looking at the 2.4.0 source code, there I can't see such
a restriction. In addition, some testing on a 5.0 kernel
(mounting 'put_old' in the new mount namespace just before
pivot_root()) did not result in an error for this case when
calling pivot_root().

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

pivot_root.2: srcfix: add self to copyright

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

pivot_root.2: pivot_root() affects only other processes in the same mount namespace

pivot_root() only affects the current working directory and root
directory of other processes in the same mount namespace as the
caller.

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

pivot_root.2: Introduce mount namespaces in the very first sentence

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

pivot_root.2: Note capability requirements

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

pivot_root.2: Mention mount namespaces

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

pivot_root.2: SEE ALSO: add mount_namespaces(7)

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

pivot_root.2: wfix

"At the time of writing" was ~20 years ago. Things
have not so far changed.

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

pivot_root.2: Reword some text that is currently rather hard to parse

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

pivot_root.2: Minor tweak

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

pivot_root.2: Minor fix: place some text at a more logical location in the page

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

operator.7: Prefix and postfix ++/-- have different precedences

Harbison and Steele also agree on this.

Reported-by: Rick Stanley <rstanley@rsiny.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

kill.2: Minor clarification

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

rt_sigqueueinfo.2: Rename 'uinfo' argument to 'info'

This is more consistent with the naming in other pages
that refer to a 'siginfo_t' structure.

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

rt_sigqueueinfo.2: The rules for 'si_code' don't apply when sending a signal to oneself

The restriction on what values may be specified in 'si_code'
apply only when sending a signal to a process other than the
caller itself.

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

rt_sigqueueinfo.2: Note that 'si_code' can't be specified as SI_KERNEL

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

rt_sigqueueinfo.2: Minor restructuring in preparation for next patch

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

setns.2: Fix CLONE_NEWNS restriction info

Threads are allowed to switch mount namespaces if the filesystem
details aren't being shared.  That's the purpose of the check in
the kernel quoted by the comment:

    if (fs->users != 1)
        return -EINVAL;

It's been this way since the code was originally merged in v3.8.

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

ptrace.2: Fix description of 'is_error' field in 'struct ptrace_syscall_info'

Reported-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

mmap.2: Fix EINVAL conditions

Since introduction of MAP_SHARED_VALIDATE, in case flags contain
both MAP_PRIVATE and MAP_SHARED, mmap() doesn't fail with EINVAL,
it succeeds.

The reason for that is that MAP_SHARED_VALIDATE is in fact equal
to MAP_PRIVATE | MAP_SHARED.

This is intended behavior, see:
https://lwn.net/Articles/758594/
https://lwn.net/Articles/758598/

Signed-off-by: Nikola Forró <nforro@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

resolv.conf.5: srcfix

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

resolv.conf.5: Update information about search list

Since glibc 2.26, the number of domains in the search list is
no longer limited.

Reference:
https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=3f853f22c87f0b671c0366eb290919719fa56c0e

Signed-off-by: Nikola Forró <nforro@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

CONTRIBUTING: New file with some starting tips on how to contribute

Reported-by: Paul Wise <pabs3@bonedaddy.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

man-pages.7: Relocate and enhance the text on semantic newlines

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

man-pages.7: Paragraphs should not be separated by blank lines

Reported-by: Paul Wise <pabs3@bonedaddy.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

core.5: Minor tweaks to Paul Wise's patch

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

core.5: Explain the new situation with argument splitting

Things changed in Linux v5.3-rc3 commit 315c69261dd3 from
splitting after template expansion to splitting beforehand.

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

printf.3: Add detail on the first digit with the %e format

This requirement on the first digit with the %e format comes from
the ISO C standard. It ensures that all the digits in the output are
significant and forbids output with a precision less than requested.

Signed-off-by: Vincent Lefevre <vincent@vinc17.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

fexecve.3: ERRORS: add ENOENT

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

fexecve.3: ENOSYS occurs only if the kernel provides no execveat() syscall

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

io_submit.2: Fix kernel version numbers for 'aio_rw_flags' flags

Even though the RFW_* flags were first introduced in Linux 4.6,
they could not be used with aio until 4.13 where the aio_rw_flags
field was added to struct iocb (9830f4be159b "fs: Use RWF_* flags
for AIO operations"). Correct the stated version for each flag.

Fixes: 2f72816f8680 ("io_submit.2: Add kernel version numbers for various 'aio_rw_flags' flags")
Signed-off-by: Matti Möll <Matti.Moell@opensynergy.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

move_pages.2: Some reworking of Yang Xu's text

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

move_pages.2: Mark E2BIG as deprecated

E2BIG was removed in 2.6.29, we should mark it as deprecated.

Signed-off-by: Yang Xu <xuyang2018.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

regex.3: Minor rewording

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

regex.3: ffix

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

regex.3: srcfix: Wrap source lines at sentence boundaries

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

regex.3: Document REG_STARTEND

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

syscall.2: Add information for powerpc64

Add powerpc64 to the calling convention tables.

Signed-off-by: Shawn Anastasio <shawn@anastas.io>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ptrace.2: Clarify meaning of ptrace_syscall_info 'is_error' field

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

ptrace.2: ffix

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

ptrace.2: Describe the PTRACE_GET_SYSCALL_INFO 'op' value in more detail

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

ptrace.2: ffix

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

ptrace.2: Minor tweaks to Dmitry Levin's patch

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

ptrace.2: Document struct ptrace_syscall_info

Signed-off-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

mprotect.2: wfix

Signed-off-by: Christopher M. Riedl <cmr@informatik.wtf>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

syscalls.2: Add clone3() and pidfd_open()

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

syscalls.2: Add fsconfig(), fsmount(), fsopen(), fspick(), move_mount(), open_tree()

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

syscalls.2: Add new syscalls in 5.1

Add io_uring_enter(), io_uring_register(), io_uring_setup(), and
pidfd_send_signal().

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

ptrace.2: Minor tweaks to Dmitry Levin's patch

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

ptrace.2: Document PTRACE_GET_SYSCALL_INFO

PTRACE_GET_SYSCALL_INFO request was introduced by Linux kernel
commit 201766a20e30f982ccfe36bebfad9602c3ff574a aka
v5.3-rc1~65^2~23.

Signed-off-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

syscall.2: Update name of syscall instruction for riscv

As reported by Florin:

    In the first table, for the riscv Arch/ABI, the instruction
    should be ecall instead of scall.

    According the official manual, the instruction has been
    renamed.
    https://content.riscv.org/wp-content/uploads/2017/05/riscv-spec-v2.2.pdf

    "The SCALL and SBREAK instructions have been renamed to
    ECALL and EBREAK, respectively. Their encoding and
    functionality are unchanged."

Reported-by: Florin Blanaru <florin.blanaru96@gmail.com>
Reviewed-by: Adam Borowski <kilobyte@angband.pl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

fanotify_mark.2: Document FAN_MOVE_SELF

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

fanotify_mark.2: Add kernel version numbers for some FAN_* constants

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

fanotify_mark.2: ffix

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

fanotify.7: tfix

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

errno.3: Minor tweaks to Rasmus Villemoes's patch

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

errno.3: Add some comments on EAGAIN/EWOULDBLOCK and EDEADLK/EDEADLOCK

Signed-off-by: Rasmus Villemoes <rv@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

signal.7: tfix

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

prctl.2: tfix

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

smartpqi.4: wfix

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

smartpqi.4: srcfix

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

smartpqi.4: ffix

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

smartpqi.4: Add sysfs entries

Reviewed-by: Matt Perricone <matt.perricone@microsemi.com>
Reviewed-by: Scott Benesh <scott.benesh@microsemi.com>
Signed-off-by: Murthy Bhat <Murthy.Bhat@microsemi.com>
Signed-off-by: Don Brace <don.brace@microsemi.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

smartpqi.4: Add module param to hide vsep

Reviewed-by: Matt Perricone <matt.perricone@microsemi.com>
Reviewed-by: Scott Benesh <scott.benesh@microsemi.com>
Reviewed-by: Kevin Barnett <kevin.barnett@microsemi.com>
Signed-off-by: Dave Carroll <david.carroll@microsemi.com>
Signed-off-by: Don Brace <don.brace@microsemi.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

smartpqi.4: Add module param expose ld first

Reviewed-by: Matt Perricone <matt.perricone@microsemi.com>
Reviewed-by: Scott Benesh <scott.benesh@microsemi.com>
Reviewed-by: Kevin Barnett <kevin.barnett@microsemi.com>
Signed-off-by: Gilbert Wu <gilbert.wu@microsemi.com>
Signed-off-by: Don Brace <don.brace@microsemi.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

smartpqi.4: Update copyright

Reviewed-by: Scott Benesh <scott.benesh@microsemi.com>
Reviewed-by: Kevin Barnett <kevin.barnett@microsemi.com>
Signed-off-by: Don Brace <don.brace@microsemi.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

smartpqi.4: tfix

- correct smarpqi to smartpqi

Reviewed-by: Scott Teel <scott.teel@microsemi.com>
Reviewed-by: Scott Benesh <scott.benesh@microsemi.com>
Reviewed-by: Kevin Barnett <kevin.barnett@microsemi.com>
Signed-off-by: Don Brace <don.brace@microsemi.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

localedef.1: describe recently added options

Describe few recently added options (present in glibc-2.29).

Sort the options a bit more logically and alphabetically.

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

cgroups.7: tfix

Signed-off-by: Eric Biggers <ebiggers@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

socket.2: tfix

Signed-off-by: Eric Biggers <ebiggers@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

capabilities.7: tfix

Hi Michael, it's been a while but few simple patches today..

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

user_namespaces.7: tfix

This and the previous were the only ones grep found.

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

uname.2: Replace reference to namespaces(7) with reference to uts_namespaces(7)

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

getdomainname.2: Add mention of UTS namespaces

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

uts_namespaces.7: SEE ALSO: add gethostname(2), getdomainname(2), uname(2)

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

gethostname.2: Mention UTS namespaces

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

namespaces.7: Remove content migrated to uts_namespaces(7)

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

uts_namespaces.7: New page with content migrated from namespaces(7)

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

mq_overview.7: wfix

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

mq_overview.7, sysvipc.7: Adjust references to namespaces(7) to ipc_namespaces(7)

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

namespaces.7: Remove content migrated to new ipc_namespaces(7) page

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

ipc_namespaces.7: New page with content migrated from namespaces(7)

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

ld.so.8: tfix

Escape hyphens.

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

signal.7: Enhance the text on process-directed and thread-directed signals

clone(2) has a good description of these concepts; borrow
from it liberally.

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

clone.2: tfix

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

signal.7: tfix

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

user_namespaces.7: Improve explanation of  meaning of ownership of nonuser namespaces

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

statx.2: Clarify details of a case where an invalid 'mask' value may be rejected

As reported by Simone:

    I was looking at version from 2017-09-15 but it's the same
    on: http://man7.org/linux/man-pages/man2/statx.2.html
    (2019-03-06)

    There is reported (about the mask argument) after the list
    of constants:

    > Note that the kernel does not reject values in mask other
    > than the above.  Instead, it simply informs the caller which
    > values are sup‐ ported by this kernel and filesystem via the
    > statx.stx_mask field.

    But as reported in the error values, there can be EINVAL if
    mask has a reserved valued, and I found a check against
    STATX__RESERVED in fs/stat.c for this. So if you use a that
    bit (0x80000000U) the kernel will reject the value.

    Probably is better to say that the kernel do not enforce the
    use of only the listed values, but there are anyway reserved
    values so and so you cannot put whatever you want on mask
    (that apply to more values than UINT_MAX).

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

proc.5: tfix

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

proc.5: ffix

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

capabilities.7: CAP_SYS_ADMIN allows modifying autogroup nice values

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

Changes.old: Fixes to 5.02 log

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

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

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

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

Ready for 5.02

proc.5: tfix

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

prctl.2: ffix

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