reboot.2: tfix (double word) and minor format issue

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

dlopen.3: Fix description of dli_sname

See https://sourceware.org/bugzilla/show_bug.cgi?id=16262

Reported-by: Stephen Kell <srk31@srcf.ucam.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

adjtime.3, getw.3: srcfix: Start new sentence on new source line

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

setjmp.3: BSD setjmp() semantics go away in glibc 2.19

Reviewed-by: Joseph S. Myers <joseph@codesourcery.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

sigpause.3: BSD sigpause() goes away in glibc 2.19

Reviewed-by: Joseph S. Myers <joseph@codesourcery.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

sigpause.3: Correct feature text macro requirements

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

setpgid.2: BSD getpgrp() and setpgrp() go away in glibc 2.19

Reviewed-by: Joseph S. Myers <joseph@codesourcery.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

feature_test_macros.7: Document _DEFAULT_SOURCE

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

feature_test_macros.7: From glibc 2.19, _BSD_SOURCE no longer causes __FAVOR_BSD

Starting with glibc 2.19, _BSD_SOURCE no longer causes BSD
definitions to be favored in cases where standards conflict.

Reviewed-by: Joseph S. Myers <joseph@codesourcery.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

scanf.3: Improve discussion of obsolete 'a' dynamic allocation modifier

Reported-by: Ondřej Bílka <neleai@seznam.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getline.3: Correct description of how '*n' is used when '*lineptr' == NULL

See https://sourceware.org/bugzilla/show_bug.cgi?id=5468

Reported-by: Luke Hutchison <luke.hutch@mit.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

man-pages.7: s/Real hyphen/Real minus/

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

ld.so.8: Default output file for D_DEBUG is stderr not stdout

See https://sourceware.org/bugzilla/show_bug.cgi?id=6874

Reported-by: Matthias Klose <doko@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

execve.2: Add further cases to EFAULT error

See https://sourceware.org/bugzilla/show_bug.cgi?id=16402

Reported-by: Marco Dione <mdione@grulic.org.ar>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

tanh.3: ATTRIBUTES: Note functions that are thread-safe

The functions tanh(), tanhf() and tanhl() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

tan.3: ATTRIBUTES: Note functions that are thread-safe

The functions tan(), tanf() and tanl() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

sysv_signal.3: ATTRIBUTES: Note function that is thread-safe

The function sysv_signal() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

towupper.3: ATTRIBUTES: Note function that is thread safe with exceptions

The function towupper() is thread safe with exceptions.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

towlower.3: ATTRIBUTES: Note function that is thread safe with exceptions

The function towlower() is thread safe with exceptions.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

regex.3: tfix

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

regex.3: tfix

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

getauxval.3: Added FIXME for AT_HWCAP2

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

man-pages.7: Various improvements to style guide

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

dlopen.3: tfix

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

pthread_getcpuclockid.3: ffix

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

if_nameindex.3: ffix

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

chown.2, clone.2, mmap.2, pipe.2, ftw.3, mq_notify.3: Add "Program source" subheading under EXAMPLE

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

mprotect.2: Add "static" to global variable in example program

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

rtime.3: ffix

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

hsearch.3: Add "static" to global variable in example program

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

getsubopt.3: ffix (K&R style in example program)

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

perf_event_open.2: Add "static" qualifier to function in example program

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

tsearch.3: Add "static" to global variables and functions in example program

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

strftime.3: Add "Program source" subsection heading

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

stpcpy.3: ffix

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

rtime.3: Add "static" qualifier to global variable in example program

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

rtime.3: ffix

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

get_mempolicy.2, mbind.2, mlock.2, set_mempolicy.2, bootparam.7, packet.7: grfix: s/memory mapped/memory-mapped/ when used attributively

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

packet.7: wfix: s/network order/network byte order/

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

packet.7: Add kernel version numbers for PACKET_VERSION and PACKET_TIMESTAMP

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

packet.7: Minor fixes

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

packet.7: Document fanout, ring, and auxiliary options

The packet socket manual page does not list all socket options.

This patch adds descriptions of the common packet socket options
  PACKET_AUXDATA, PACKET_FANOUT, PACKET_RX_RING, PACKET_STATISTICS,
  PACKET_TX_RING

and the ring-specific options
  PACKET_LOSS, PACKET_RESERVE, PACKET_TIMESTAMP, PACKET_VERSION

It does not yet add descriptions for
  PACKET_COPY_THRESH, PACKET_HDRLEN, PACKET_ORIGDEV,
  PACKET_TX_HAS_OFF, PACKET_TX_TIMESTAMP, PACKET_VNET_HDR

It tries to balance being informative with exposing kernel detail
that is unlikely to be used by most readers or that may change
frequently. For implementation details, the manpage points to the
documentation in kernel Documentation/networking. Let me know if
options should be added or removed.

Source: PACKET_FANOUT, PACKET_RX_RING and PACKET_VERSION are in
/tools/testing/net/psock_fanout.c in the latest Linux kernel source
tree. PACKET_STATISTICS was in the first version of that test.
PACKET_TX_RING I have used elsewhere. The other options are based
on reading kernel code.

 [Very minor fixups. -dborkman]

Acked-by: Daniel Borkmann <dborkman@redhat.com>
Signed-off-by: Willem de Bruijn <willemb@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

strstr.3: Clarify RETURN VALUE: s/substring/located substring/

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

strsep.3: Clarify description

The use of "symbols" in the existing description is confusing;
it's "bytes". Other fixes as well.

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

string.3: Fixes and enhancements to Moritz Str?be's patch

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

string.3: Add short description of the functions

It is helpful to have a short description about what the different
functions in string.h do.

Signed-off-by: Moritz 'Morty' Strübe <morty@gmx.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

man-pages.7: Minor fixes

Reported-by: Bert Wesarg <bert.wesarg@googlemail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

man-pages.7: Add STYLE GUIDE section

Incorporate some of the existing material in the page
into the STYLE GUIDE, and add a lot more material, mainly
drawn from the "Global changes" sections in the release
changelogs.

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

epoll_ctl.2, execve.2, recv.2, timer_create.2, wait.2, argz_add.3, basename.3, dlopen.3, exec.3, fopencookie.3, fts.3, getaddrinfo.3, getcwd.3, gethostbyname.3, getifaddrs.3, getipnodebyname.3, getlogin.3, getnetent.3, getprotoent.3, getrpcent.3, getservent.3, getusershell.3, glob.3, if_nameindex.3, inet_ntop.3, lio_listio.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mq_notify.3, ptsname.3, realpath.3, setnetgrent.3, sigvec.3, strsignal.3, strtok.3, wcrtomb.3, wcsnrtombs.3, wcsrtombs.3, wcstombs.3, xdr.3: Global fix of "NULL pointer"

Change "NULL pointer: to "NUL " or null pointer".
POSIX uses the term "null pointer", not "NULL pointer".

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

exec.3, fts.3: srcfix

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

hpsa.4: wfix

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

termios.3: wfix

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

perf_event_open.2: wfix

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

mtrace.3: wfix

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

fts.3: wfix

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

man-pages.7: Add some further style notes for code examples

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

INFINITY.3: wfix

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

prctl.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>

mallopt.3: wfix

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

clone.2: wfix

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

capabilities.7: wfix

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

spu_create.2: wfix

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

man-pages.7: Add historical note on reason for use of Americal spelling

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

man-pages.7: wfix

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

dlopen.3: Minor fixes

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

vdso.7: Minor fixes

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

dlopen.3: srcfix: add a reference to Austin "Pointer Types" issue

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

dlopen.3: Tweaks to previous patch

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

standards.7: wfix

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

dlopen.3: Update remarks on cast needed when assigning dlsym() return value

POSIX.1-2013 eases life when casting the dlsym() return value to a
function pointer

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

ptrace.2: tfix userspace->user space

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

syscall.2, syscalls.2, getauxval.3: Add references to new vdso(7) page

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

libc.7: SEE ALSO: add various entries

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

vdso.7: srcfix: wrap some long source lines

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

vdso.7: Further tweaks after discussion with Mike Frysinger

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

vdso.7: Clean-ups

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

vdso.7: New page documenting the vDSO mapped into each process by the kernel

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

uselib.2, getfsent.3, regex.3, nsswitch.conf.5, inotify.7, man-pages.7, symlink.7: Replace uses of "e.g." in main text with "for example" or similar

    Usual man-pages style is to use "e.g." only within
    parenthetical expressions.

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

proc.5, unix.7: grfix

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

eventfd.2, set_mempolicy.2, timerfd_create.2, fwide.3, resolver.3, spufs.7, symlink.7, udplite.7, unicode.7: Replace uses of "i.e.," in main text with "that is" or similar

Usual man-pages style is to use "i.e." only within
parenthetical expressions.

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

puts.3: SEE ALSO: replace reference to gets(3) with fgets(3)

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

getline.3: Remove SEE ALSO reference to unsafe gets(3)

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

fgetc.3: Minor fix to ordering in SEE ALSO

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

gets.3: Tweaks to David Malcolm's patch

Reported-by: Andre Majorel <aym-xunil@teaser.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

gets.3: Tweaks to David Malcolm's patch

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

fgetc.3, gets.3: tstamp

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

fgets.3, getc.3, getchar.3, ungetc.3: Adjust links to gets(3) to point to fgetc(3)

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

fgetc.3, gets.3: Split gets(3) to isolate unsafe gets(3) to a page on its own

Currently man3/gets.3 documents various safe I/O functions, along
with the toxic "gets" function.

At the risk of being melodramatic, this strikes me as akin to
storing rat poison in a food cabinet, in the same style of
packaging as the food, but with a post-it note on it saying
"see warnings below".

I think such "never use this" functions should be quarantined
into their own manpages, rather than listing them alongside
sane functions.

The attached patch does this for "gets", moving the documentation
of the good functions from man3/gets.3 into man3/fgetc.3,
updating the SO links in the relevant functions to point at the
latter.

It then rewrites man3/gets.3 to spell out that "gets" is toxic
and should never be used (with a link to CWE-242 for good
measure).

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

socket.7: wfix

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

socket.2: Remove crufty statement that AF_INET does not support SOCK_SEQPACKET

Linux AF_INET supports SOCK_SEQPACKET via SCTP.

Reported-by: Dongsheng Song <dongsheng.song@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes: Add dedication

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

close.2: Note that errors from close() should be used only for diagnosis

In particular, retrying after EINTR is a bad idea.

See http://austingroupbugs.net/view.php?id=529

See http://thread.gmane.org/gmane.comp.lib.glibc.alpha/37702
Subject: [RFC][BZ #14627] Make linux close errno to EINPROGRESS
         when interrupted in signal.

Reported-by: P?draig Brady <P@draigBrady.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

strspn.3: Improve description in NAME

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

Reported-by: Mathieu Malaterre <malat@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

select_tut.2, dlopen.3, err.3, printf.3: Stylistic changes to code example

For ease of reading, don't embed assignments inside if().

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

printf.3: Fix memory link in snprintf() example

See http://stackoverflow.com/questions/19933479/snprintf-man-page-example-memory-leak

Reported-by: Arif Zaman <arifz@lums.edu.pk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

proc.5: Fix formula for CommitLimit under /proc/meminfo

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

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

ctime.3: grfix: add some commas

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

strptime.3: grfix: add some commas

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

strptime.3: Some rewording and reorganization

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