smartpqi.4: Various fixes, mostly formatting related

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

smartpqi: initial submit of smartpqi man page

This patch contains the initial submission of the
smartpqi man page.

Signed-off-by: Don Brace <don.brace@microsemi.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

chown.2: ffix

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

seccomp.2: srcfix: Update copyright notice

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

connect.2: Clarify that ECONREFUSED is for stream sockets

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

futex.2: wfix

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

proc.5: srcfix

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

proc.5: Since Linux 4.9, /proc/locks is filtered according to the PID namespace

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

proc.5: Document /proc/locks

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

readv.2: srcfix

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

readv.2: Minor tweaks to Christoph's patch

Reviewed-by: Matthew Wilcox <willy@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

readv.2: Document RWF_NOWAIT added in Linux 4.14

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

seccomp.2: Update timestamp for patch review from kees Cook

Kees reviewed the "Caveats" patch.

Reviewed-by: Kees Cook <keescook@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

fork.2, getsid.2, setpgid.2, setsid.2: Include <sys/types.h> in SYNOPSIS for pid_t

vfork(2), getpid(2) and others which return pid_t already do this.

mtk: Additional info from Ahmad: <unistd.h> defines 'pid_t',
but only dependent on certain FTMs beng defined.

Cc: linux-man@vger.kernel.org
Signed-off-by: Ahmad Fatoum <ahmad@a3f.at>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

seccomp.2: Note that vDSO implementations sometimes fall back to real syscalls

Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

seccomp.2: Add some Caveats regarding the use of seccomp filters

Based on an email discussion with Florian Weimer and
Adhemerval Zanella on the libc-alpha mailing list.
("Seccomp implications for glibc wrapper function changes",
7 Nov 2017).

Reviewed-by: Florian Weimer <fweimer@redhat.com>
Reviewed-by: Adhemerval Zanella <adhemerval.zanella@linaro.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

seccomp.2: Rewrap long source lines and on sentence breaks

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

proc.5: srcfix

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

seccomp.2: Document the SECCOMP_RET_LOG action added In Linux 4.14

Signed-off-by: Tyler Hicks <tyhicks@canonical.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

seccomp.2: Document the SECCOMP_FILTER_FLAG_LOG flag added in Linux 4.14

Signed-off-by: Tyler Hicks <tyhicks@canonical.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

seccomp.2: Document the SECCOMP_GET_ACTION_AVAIL operation added in Linux 4.14

Signed-off-by: Tyler Hicks <tyhicks@canonical.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

proc.5, seccomp.2: Document the seccomp /proc interfaces added in Linux 4.14

Document the seccomp /proc interfaces in Linux 4.14:
/proc/sys/kernel/seccomp/actions_avail and
/proc/sys/kernel/seccomp/actions_logged.

Signed-off-by: Tyler Hicks <tyhicks@canonical.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

seccomp.2: SEE ALSO: add strace(1)

Point the reader at strace(1) as a way of discovering system calls
that might need to be filtered.

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

seccomp.2: wfix

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

seccomp.2: srcfix

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

getcpu.2: getcpu() may have an implementation in the vDSO

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

clock_getres.2: clock_gettime() may be implemented in the vDSO

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

gettimeofday.2: Note that gettimeofday() may be implemented in the vDSO

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

time.2: Note that time() may be implemented in the vDSO

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

Changes.old: tfix

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

locale.7: ffix

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

vmsplice.2: ffix

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

splice.2: ffix

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

setns.2: ffix

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

ptrace.2: ffix

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

perf_event_open.2: ffix

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

fanotify_init.2: wfix

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

bpf.2: ffix

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

open.2: ffix

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

utimensat.2: wfix

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

getrlimit.2, utimensat.2: wsfix

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

timerfd_create.2: wfix

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

strverscmp.3: tfix

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

sockatmark.3: Fix cruft in code example

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

sigaltstack.2: tfix

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

random_r.3: wfix

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

random.4: tfix

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

stdio.3: wsfix

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

stdin.3: tfix

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

atexit.3: wfix

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

aio.7: wsfix

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

aio.7: tfix

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

acct.5: tfix

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

acct.2: wfix

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

userfaultfd.2: tfix

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

userfaultfd.2: BUGS: document spurious UFFD_EVENT_FORK

Signed-off-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ioctl_tty.2: tfix

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

open.2: Since glibc 2.26, the open() wrapper always uses the openat() syscall

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

sigaltstack.2: Update timestamp

For Acked-by from Stas Sergeev

Acked-by: Stas Sergeev <stsp@list.ru>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

sigaltstack.2: Tighten the BUGS wording a little

From a conversation with Walter Harms:

    > i am confused, i understand that:
    >            ss.ss_sp = malloc(SIGSTKSZ);
    >
    >            ss.ss_size = SIGSTKSZ;
    >            ss.ss_flags = 0;
    >            if (sigaltstack(&ss, NULL) == -1)
    >
    > is equivalent to:
    >            ss.ss_sp = malloc(SIGSTKSZ);
    >
    >            ss.ss_size = SIGSTKSZ;
    >            ss.ss_flags = SS_ONSTACK ;
    >            if (sigaltstack(&ss, NULL) == -1)
    >
    > but also to
    >            ss.ss_sp = malloc(SIGSTKSZ);
    >
    >            ss.ss_size = SIGSTKSZ;
    >            ss.ss_flags = SS_ONSTACK | SOMETHING_FLAG ;
    >            if (sigaltstack(&ss, NULL) == -1)
    >
    > so the use of SS_ONSTACK would result in ss.ss_flags = 0 no matter what.
    > OR
    > SS_ONSTACK is a no-op in Linux

    I see what you mean. The point is back then that SS_ONSTACK was
    the only flag that could (on Linux) be specified in ss.ss_flags,
    so that "SS_ONSTACK | SOMETHING_FLAG" was a nonexistent case.
    These days, it's possible to specify the new SS_AUTODISARM
    flag in ss.ss_flags, which I think is why you are doubtful
    about the new page text.

Reported-by: Walter Harms <wharms@bfs.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

sigaltstack.2: Reword BUGS text to be a little clearer

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

sigaltstack.2: Add use os sigaction() to example code

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

sigaltstack.2: Add explicit error handling to example code

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

sigaltstack.2: Minor wording fix

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

sigaltstack.2: ffix

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

sigaltstack.2: Document SS_AUTODISARM flag added in Linux 4.7

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

system.3: wfix

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

capget.2: Minor rewording

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

capabilities.7: srcfix: FIXME

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

capabilities.7: srcfix: FIXME

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

capget.2: wfix: consistently use "VFS capabilities"

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

capabilities.7: Add a reference to xattr(7) in the discussion of extended attributes

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

capget.2: Clarify discussion of kernels that have no VFS capability support

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

capget.2: wfix

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

filesystems.5: Refer to VFAT as an extended FAT (not DOS) filesystem

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

filesystems.5: Replace crufty URL reference for 'smb' with up-to-date URL

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

proc.5: Clarify permissions in /proc/[pid]/fd/

Since the symbolic links for pipes and sockets do not refer to real
files in the file system tree, it can be hard to discover that they
still have mode and ownership information (revealed e.g. by `stat -L`),
so let's point this out in the manpage.

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

proc.5: ffix

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

ffs.3: glibc 2.27 relaxes the FTM requriements for ffsl() nand ffsll()

glibc 2.27 relaxes the FTM requriements for ffsl() and
ffsll() to _DEFAULT_SOURCE.

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

recvmmsg.2, sendmmsg.2: Type fixes in SYNOPSIS

[mtk: The raw system calls use "unsigned int", but the glibc
wrappers have "int" for the 'flags' argument.]

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

mmap.2: SEE ALSO: add ftruncate(2)

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

mmap.2: Add explicit text noting that 'length' must be greater than 0

Currently, this detail is hidden in ERRORS. Make it clear in
the main text.

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

stdio.3: Remove crufty reference to pc(1)

I'm not sure what compiler is referred to by "pc(1)",
but "dnf whatprovides" and web searches turn up no
mention of a compiler by that name.

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

stdio.3: Use proper section cross references in function list

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

core.5: wfix

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

mq_overview.7: wfix

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

Replace Latin abbreviation "cf.".

People seem to be using "cf." ("confere"), which means "compare",
to mean "see" instead, for which the Latin abbreviation would be
"q.v." ("quod vide" -> "which see").

In some cases "cf." might actually be the correct term but it's
still not clear what specific aspects of a function/system call
one is supposed to be comparing.

I left one use in place in hope of obtaining clarification,
because it looks like it might be useful there, if contextualized.

Migrate these uses to English and add them to the list of
abbreviations to be avoided.

If the patch to vfork(2) is not accepted, then the cf. still needs
an \& after it because it is at the end of the line but not the
end of a sentence.

Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

pid_namespaces.7: tfix + srcfix

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

proc.5: Add reference to pid_namespaces(7) for /proc/sys/kernel/ns_last_pid

Add reference to pid_namespaces(7) for the description of
/proc/sys/kernel/ns_last_pid.

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

pid_namespaces.7: Document /proc/sys/kernel/ns_last_pid

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

man-pages.7: Add a use case for real minus character

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

hier.7: tfix

Escape hyphen in man page cross reference.

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

ipv6.7: tfix

Use correct indefinite article before noun beginning with vowel sound.

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

connect.2, ioprio_set.2, dbopen.3, group.5, fifo.7: tfix

Fix nonstandard usage.

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

open.2: tfix

This one crept in during the first bit of the "will fail" -> "fails"
migration.

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

lp.4: srcfix

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

lp.4: tfix

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

Changes: infnan.3 is removed

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

infnan.3: Remove page

This function was in libc4 and libc5, but never part
of glibc. It ceased to be relevant nearly 20 years
ago. Time to remove the page.

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

pthread_spin_init(3): tfix

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