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>

unshare.2: tfix: fix unbalanced parentheses

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

sendfile.2: tfix

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

nl_langinfo.3: NOTES: note undefined behavior for nl_langinfo_l()

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

nl_langinfo.3: POSIX specifies that the caller may not modify the returned string

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

nl_langinfo.3: Enhance RETURN VALUE description

Note some further cases where returned string may be
invalidated or overwritten.

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

nl_langinfo.3: Explicitly describe the return value on success

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

nl_langinfo.3: ffix

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

nl_langinfo.3: Clarify details of nl_langinfo_l() return value

setlocale() does not come into play for nl_langinfo_l(),
as far as I can tell.

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

nl_langinfo.3: Minor wording improvements

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

nl_langinfo.3: wfix

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

nl_langinfo_l.3: New link to nl_langinfo.3

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

nl_langinfo.3: Add documentation for nl_langinfo_l(3)

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

bpf.2: Minor tweaks after comments from Daniel Borkmann

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

socketpair.2: Clarify use of SOOCK_* flags in 'type' argument

See http://bugs.debian.org/794217

Reported-by: Goswin von Brederlow <goswin-v-b@web.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

fanotify.7: Clarify effects of file moves

If files or directories are moved to other mounts, the inode is
deleted. Fanotify marks are lost.

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

bpf(2): ffix: Fix formatting in function signature

Also add a missing period in the errno section.

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

__ppc_set_ppr_med.3: Various minor tweaks

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

__ppc_set_ppr_med_low.3: New link to __ppc_set_ppr_med.3

Signed-off-by: Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

__ppc_set_ppr_low.3: New link to __ppc_set_ppr_med.3

Signed-off-by: Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

__ppc_set_ppr_med.3: Document PPC functions providing access to PPR

GNU C Library 2.18 adds functions (__ppc_set_ppr_low(3),
__ppc_set_ppr_med(3), __ppc_set_ppr_med_low(3)) that provide
access to the Program Priority Register (PPR).

Signed-off-by: Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

__ppc_yield.3: Minor tweaks

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

__ppc_mdoio.3: New link to __ppc_yield.3

Signed-off-by: Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

__ppc_mdoom.3: New link to __ppc_yield.3

Signed-off-by: Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

__ppc_yield.3: Document PPC performance-hint functions

GNU C Library 2.18 adds functions __ppc_yield(3), __ppc_mdoio(3),
and __ppc_mdoom(3) that can be used provide a hint that
performance could be improved if shared resources are released
for use by other processors.

Signed-off-by: Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

vmsplice.2: Minor wording fixes

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

splice.2: tfix

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

tee.2: wfix

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

tee.2: wfix

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

bpf.2: Minor tweaks to Daniel Borkmann's patch

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