proc.5: Add details for threads-max

Add detail information for threads-max.
The checks for minimum and maximum values exist since kernel 4.1.
https://lkml.org/lkml/2015/3/15/96

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

signal.7: Note async-signal-safe functions added by POSIX.1-2008 TC1

Reported-by: Michael Hocko <mhocko@kernel.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getspnam.3: ffix

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

termios.3: srcfix: add FIXME

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

sigpause.3: srcfix: add FIXME

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

mallinfo.3: ATTRIBUTES: Note function that is not thread-safe

The marking matches glibc marking.
The marking of functions in glibc is:
- mallinfo: MT-Unsafe init const:mallopt

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getspnam.3: ATTRIBUTES: Note functions that are/aren't thread-safe

After research, We think
* getspnam(),
* getspent(),
* setspent(),
* endspent(),
* getspent_r(),
* fgetspent(),
* sgetspent(),
are not thread-safe. And
* putspent(),
* getspnam_r(),
* sgetspent_r(),
* lckpwdf(),
* ulckpwdf(),
* fgetspent_r(),
are thread-safe. But, there are not
markings of them in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

fgetpwent.3: ATTRIBUTES: Note function that is not thread-safe

The marking matches glibc marking.
marking of function in glibc is:
- fgetgrent: MT-Unsafe race:fpwent

ps: We think race:fpwent in glibc maybe hard for users to understand,
and have sent a patch to the GNU libc community for changing it to
race:fgetpwent, however, something about the copyright impeded the progress.
Here we mark it "race:fgetpwent", so there is a little different.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

fgetgrent.3: ATTRIBUTES: Note function that is not thread-safe

The marking matches glibc marking.
marking of function in glibc is:
- fgetgrent: MT-Unsafe race:fgrent

ps: We think race:fgrent in glibc maybe hard for users to understand,
and have sent a patch to the GNU libc community for changing it to
race:fgetgrent, however, something about the copyright impeded the progress.
Here we mark it "race:fgetgrent", so there is a little different.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

tcp.7: wfix

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

tcp.7: Add some version details for 'tcp_ecn' changes

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

tcp.7: Improve paragraphs on tcp_ecn and add tcp_ecn_fallback bullet

Improve description of tcp_ecn, fix the RFC number and it's
not a boolean anymore since long time, and add a description
for tcp_ecn_fallback.

See also kernel doc under Documentation/networking/ip-sysctl.txt
on tcp_ecn and tcp_ecn_fallback.

Signed-off-by: Daniel Borkmann <daniel@iogearbox.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getent.1: ffix

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

man-pages.7: ffix

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

seccomp.2: Note why all filters in a set are executed even after SECCOMP_RET_KILL

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

seccomp.2: wfix

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

seccomp.2: Describe use of 'instruction_pointer' data field

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

seccomp.2: wfix

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

setsid.2: tfix

it -> its

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

mallopt.3: Minor wording fixes

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

mallopt.3: Minor tweaks to Carlos's patch

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

mallopt.3: Document M_ARENA_TEST and M_ARENA_MAX

In 2013 I brought up the discussion if M_ARENA_MAX and M_ARENA_TEST
were public parameters:
https://sourceware.org/ml/libc-alpha/2013-03/msg00376.html
Consensus among Siddhesh and myself was that they should be
public, and in fact they were already in the public header.
Therefore there may already be applications uses these constants
and expecting them to work. At best we could limit mallopt()'s
acceptance of the options, but that seems like a bad solution
that could lead to unexpected behavior for user applications.
A quick google search shows that there are packages relying on
these constants to tune the glibc malloc implementation.

Since glibc 2.10 the M_ARENA_TEST and M_ARENA_MAX features
have been part of the public interface with
--enable-experimental-malloc.

Since glibc 2.15 the experimental allocator has been on by default
and M_ARENA_TEST and M_ARENA_MAX have been more broadly used.

There are environment variables, without trailing underscore, that
can also be used to adjust these values at runtime i.e.
MALLOC_ARENA_MAX, and MALLOC_ARENA_TEST.

This change describes these two options in the mallopt(3) man page
along with their environment variables.

Tested with glibc master on x86_64 to verify it works as expected.

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

signalfd.2: Describe semantics with respect to SCM_RIGHTS

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

open.2: Remove accidental mention of O_TTY_INIT

An earlier edit mentioned O_TTY_INIT as a file creation flag.
That's true, according POSIX, but Linux does not implement
this flag, so remove mention of it.

Reported-by: David Drysdale <drysdale@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

mq_overview.7: Document QSIZE bug that appeared in 3.5 and was fixed in 4.2

Reported-by: Arto Bendiken <arto@bendiken.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes.old: tfix in 4.02 changelog

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

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

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

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

Ready for 4.02

Removed trailing white space at end of lines

mktemp.3: ffix

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

ldd.1, sprof.1, accept.2, alarm.2, bind.2, chdir.2, clock_nanosleep.2, close.2, connect.2, dup.2, execve.2, fsync.2, getgid.2, getpeername.2, getsid.2, getsockname.2, getsockopt.2, getuid.2, io_getevents.2, kill.2, listen.2, lseek.2, mmap.2, msgctl.2, msgget.2, msgop.2, msync.2, nanosleep.2, nice.2, pause.2, pipe.2, rmdir.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, select_tut.2, semctl.2, semop.2, setsid.2, shmctl.2, shmget.2, shmop.2, shutdown.2, sigaction.2, signal.2, socketpair.2, sync.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, times.2, truncate.2, umask.2, MB_CUR_MAX.3, a64l.3, abs.3, assert.3, atexit.3, atof.3, atoi.3, basename.3, bsearch.3, btowc.3, byteorder.3, catgets.3, catopen.3, clock.3, clock_getcpuclockid.3, closedir.3, confstr.3, crypt.3, ctermid.3, difftime.3, div.3, dladdr.3, dlerror.3, dlinfo.3, dlopen.3, dlsym.3, drand48.3, encrypt.3, exit.3, fclose.3, ffs.3, fgetc.3, fgetwc.3, fgetws.3, flockfile.3, fmtmsg.3, fnmatch.3, fopen.3, fpathconf.3, fpclassify.3, fputwc.3, fputws.3, fseek.3, fseeko.3, ftok.3, fwide.3, getdate.3, getenv.3, getgrent.3, getgrnam.3, gethostid.3, getlogin.3, getnetent.3, getopt.3, getpwent.3, getpwnam.3, getsubopt.3, getutent.3, getwchar.3, grantpt.3, hsearch.3, iconv.3, iconv_close.3, iconv_open.3, if_nameindex.3, inet.3, inet_ntop.3, inet_pton.3, insque.3, isatty.3, isgreater.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, lockf.3, longjmp.3, lsearch.3, malloc.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, memccpy.3, memchr.3, memcmp.3, memmove.3, memset.3, mktemp.3, mq_close.3, mq_getattr.3, mq_receive.3, mq_send.3, mq_unlink.3, offsetof.3, popen.3, posix_memalign.3, posix_openpt.3, printf.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstacksize.3, pthread_equal.3, pthread_exit.3, pthread_getcpuclockid.3, pthread_kill.3, pthread_self.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_sigmask.3, pthread_testcancel.3, ptsname.3, putenv.3, puts.3, putwchar.3, qsort.3, raise.3, random.3, readdir.3, regex.3, remove.3, rewinddir.3, seekdir.3, sem_destroy.3, sem_getvalue.3, sem_unlink.3, sem_wait.3, setenv.3, setjmp.3, setlocale.3, setlogmask.3, signbit.3, sigpause.3, sigset.3, sigsetops.3, sigwait.3, sleep.3, sockatmark.3, statvfs.3, strcat.3, strchr.3, strcmp.3, strcoll.3, strcpy.3, strlen.3, strpbrk.3, strptime.3, strspn.3, strstr.3, strtod.3, strtoimax.3, strtok.3, strtol.3, strtoul.3, strxfrm.3, swab.3, sysconf.3, system.3, tcgetpgrp.3, tcgetsid.3, telldir.3, tmpfile.3, towctrans.3, tsearch.3, ttyname.3, tzset.3, ungetwc.3, unlocked_stdio.3, unlockpt.3, wcrtomb.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcslen.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstoimax.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wordexp.3, wprintf.3, fanotify.7, mq_overview.7, nptl.7, sem_overview.7, shm_overview.7, sigevent.7, symlink.7, ld.so.8: tstamp

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

Changes: Ready for 4.02

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

nl_langinfo.3: srcfix (copyright)

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

dlinfo.3: ffix

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

dlinfo.3: ffix

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

dlopen.3: Note a case where dlmopen() provides better isolation than RTLD_LOCAL

Cowritten-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

dlopen.3: srcfix

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

dlopen.3: wfix

Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

dladdr.3: Minor wording fixes

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

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

After research, we think
* dlinfo()
is thread-safe. But, there are not markings of it in
glibc document.

[mtk: split out of a larger dlopen() patch]

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

dlopen.3: Reorganize conformance information for 'flags'

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

dlopen.3: srcfix: FIXME

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

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

After research, We think
* dlsym(),
* dlvsym()
are thread-safe. But, there are not markings of them in
glibc document.

[mtk: Split out patch for formerly single dlopen.3 page]

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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

After research, we think
* dlopen(),
* dlmopen(),
* dlclose()
are thread-safe. But, there are not markings of them in
glibc document.

[mtk: Split out patch for formerly single dlopen.3 page]

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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

After research, we think
* dlerror()
is thread-safe. But, there are not markings of it in
glibc document.

[mtk: Split out patch for formerly single dlopen.3 page]

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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

After research, we think
* dladdr(),
* dladdr1()
are thread-safe. But, there are not markings of them in
glibc document.

[mtk: Split out patches for formerly single dlopen.3 page]

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

atexit.3: SEE ALSO: add dlopen(3)

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

dlopen.3: Move atexit() discussion under "Initialization and Finalization"

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

dlopen.3: Mention other functions in the dlopen API in the initial paragraph

Doing so helps orient the reader.

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

dlopen.3: dlclose() will unload the object when all references have been released

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

dlopen.3: tfix

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

dlerror.3: Note that the returned string does not include a trailing newline

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

dlerror.3: wfix

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

dlerror.3: Note that the returned message may be in a statically allocated buffer

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

dlopen.3: Corrections and improvements after comments from Carlos O'Donell

Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

dlopen.3: Remove dlerror() content that was migrated to dlerror(3)

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

dlsym.3: SEE ALSO: add dlerror(3)

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

dlinfo.3: SEE ALSO: add dlerror(3)

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

dlerror.3: Migrate dlerror(3) to a separate man page

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

dlopen.3: wfix

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

dlopen.3: wfix

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

dlopen.3: EXAMPLE: Remove mention of "-rdynamic"

That option isn't needed for compiling and running this program.

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

dlopen.3: Remove content migrated to new dlsym() page

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

dlinfo.3: SEE ALSO: add dlysm(3)

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

dladdr.3: SEE ALSO: add dlysm(3)

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

dlvsym.3: Adjust link to point to new self-contained dlsym(3) page

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

dlsym.3: Move dlsym() and dlvsym3() content to their own page

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

dlopen.3: Rework the discussion of initialization and finalization functions

Deemphasize the obsolete _init/_fini and give more prominence
to gcc constructors/destructors.

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

dlopen.3: Move discussion of _init() and _fini() to NOTES

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

dlopen.3: Remove reference to ld.so info page

The command "info ld.so" simply shows the man page...

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

dlopen.3: Note some dlmopen() restrictions

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

dlopen.3: tfix

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

elf.5: wfix

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

elf.5: tfix

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

ldd.1, sprof.1, execve.2, dlopen.3, ld.so.8: Prefer "shared object" over "shared library"

The man pages variously use "shared library" or "shared object".
Try to more consistently use one term ("shared object"), while
also pointing out on a few pages that the terms are synonymous.

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

ld.so.8: tfix

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

dlopen.3: Improvements after input from Carlos O'Donell

Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

dlmopen.3: New link to dlopen.3

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

dlopen.3: Document dlmopen(3)

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

dladdr.3: SEE ALSO: add dlinfo(3)

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

dlopen.3: SEE ALSO: add dlinfo(3)

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

dlinfo.3: New page describing dlinfo(3)

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

dl_iterate_phdr.3: SEE ALSO: add dladdr(3)

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

dlopen.3: SEE ALSO: add dladdr(3)

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

dladdr1.3: New link to (new) dladdr(3) page

dladdr.3: New page documenting dladdr() and dladdr1()

Relocate/rewrite dladdr() text formerly contained in dlopen(3).

Add documentation of dladdr1().

Peter Baudis's "caveat text" was moved from dlopen() into
this page.

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

dlopen.3: Integrate dlvsym() discussion into main page text

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

dlopen.3: Minor fix: remind reader that _init() and _fini() are obsolete

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

dlopen.3: Remove dladdr() content

This content will be migrated to a new page.

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

dlopen.3: tfix

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

dlopen.3: Minor wording fix

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

dlopen.3: Add VERSIONS section

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

dl_iterate_phdr.3: ffix

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

dl_iterate_phdr.3: CONFORMING TO: note that this function appears on some other systems

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

dl_iterate_phdr.3: Note that 'size' allows callback() to discover structure extensions

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

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

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

seccomp.2: SEE ALSO: mention libseccomp pages

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

mktemp.3: Reference mkdtemp(3) in addition to mkstemp(3)

Mention mkdtemp(3) as another secure alternative to mktemp(3).

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

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