LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity
16,827 Commits 1 Branch 197 Tags 93 MiB
Commit Graph

5542 Commits

Author SHA1 Message Date
Michael Kerrisk 493e0eb3c2 fmemopen.3: srcfix: update copyright 
Little or no text remains from Walters initial version
10 years ago.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 11:41:58 +01:00
Michael Kerrisk 8190a9eeac open_memstream.3: srcfix: Update copyright info 
The open_memstream() text was jsut by me.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 11:41:24 +01:00
Michael Kerrisk b5a636d650 fmemopen.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 05:20:12 +01:00
Michael Kerrisk e3d1b1b740 open_memstream.3: Rework text describing dynamic allocation 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 05:12:56 +01:00
Michael Kerrisk 31a3c48847 open_memstream.3: Add some details on current buffer position 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 05:12:56 +01:00
Michael Kerrisk a6bd38c621 fopen.3: SEE ALSO: add open_memstream(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 05:12:56 +01:00
Michael Kerrisk 8e23ae0316 open_wmemstream.3: Update link to point to new open_memstream(2) page 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 05:12:56 +01:00
Michael Kerrisk 09ffd9ca50 fmemopen.3, open_memstream.3: Split open_memstream() and open_wmemstream() out to separate page 
The current fmemopen(3) page documents too many functions.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:55:07 +01:00
Michael Kerrisk 551c427e75 fmemopen.3: srcfix: copyright date 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:36:48 +01:00
Michael Kerrisk 36ad378145 fmemopen.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:34:31 +01:00
Michael Kerrisk d779692dc7 fmemopen.3: Small clarification to the discussion of write errors 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:31:40 +01:00
Michael Kerrisk 82aa5cf962 fmemopen.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:20:13 +01:00
Michael Kerrisk f29c8cd8e9 fmemopen.3: Minor fix: reorder a paragraph 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:19:52 +01:00
Michael Kerrisk f39842ae12 fmemopen.3: ffix: add a subheading 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:18:33 +01:00
Michael Kerrisk 0b54423fb5 fmemopen.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:15:13 +01:00
Michael Kerrisk c7de29d451 fmemopen.3: Expand discussion of "current position" for fmemopen() stream 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:15:13 +01:00
Michael Kerrisk 1e9eb6c1b6 fmemopen.3: Rework discussion of the (obsolete) binary mode 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:15:13 +01:00
Michael Kerrisk 2841079cd0 fmemopen.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:15:13 +01:00
Michael Kerrisk 9c8b5ebfc4 fmemopen.3: Rework description of 'buf' and 'len' arguments 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:15:13 +01:00
Michael Kerrisk 58c55bb87b fmemopen.3: Greatly expand description of 'mode' argument 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 03:42:26 +01:00
Michael Kerrisk 02989b144e fmemopen.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 03:09:36 +01:00
Michael Kerrisk 93bb19b18c fmemopen.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 03:09:36 +01:00
Michael Kerrisk 0edb356c58 fmemopen.3: Small improvements to the description of open_memstream() 
Make it a little more evident that the caller should not
pass a previously allocated buffer to open_memstream().

Reported-by: Rasmus Villemoes <Rasmus.Villemoes@decode.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 02:49:57 +01:00
Michael Kerrisk d9b4881f64 fmemopen.3: Fix "Usage" message 
Reported-by: Rasmus Villemoes <Rasmus.Villemoes@decode.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 02:33:45 +01:00
Michael Kerrisk 852d92f7ae getnameinfo.3: Update FTM requirements 
The FTM requirements changed in glibc 2.22

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 02:28:38 +01:00
Michael Kerrisk 5358a2546d getaddrinfo.3: Update FTM requirements for glibc 2.22 
Since glibc 2.22 getaddrinfo() etc. are only declared for
POSIX.1-2001 or later.

Reported-by: Andreas Schwab <schwab@suse.de>
Reported-by: Orion Poplawski <orion@cora.nwra.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 02:19:11 +01:00
Michael Kerrisk c50730b607 gamma.3: gamma() was documented in SVID 2 
Reported-by: Alan Cox <etchedpixels@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 01:05:16 +01:00
Michael Kerrisk f1e369b09f ntp_adjtime.3: New link to adjtimex(2) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 00:36:16 +01:00
Jérémie Galarneau 4d70ca99ed posix_fallocate.3: ERRORS: add EINTR 
The glibc implementation of posix_fallocate(), which calls
fallocate(), may be interrupted. The fallocate() emulation
also makes use of pread()/pwrite(), which may also be
interrupted.

Signed-off-by: Jérémie Galarneau <jeremie.galarneau@efficios.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 00:34:48 +01:00
Michael Kerrisk 85c30f7eab ntp_gettime.3: Add ATTRIBUTES section 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-07 11:15:18 +01:00
Michael Kerrisk 39ad98a088 sysconf.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-07 11:15:18 +01:00
Michael Kerrisk b5133e9ad9 ntp_gettime.3: Note that these APIs always succeed 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-07 11:15:18 +01:00
Michael Kerrisk cfb9b2f966 ntp_gettimex.3: New link to ntp_gettime.3 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-07 01:36:29 +01:00
Michael Kerrisk 6d78bc966a ntp_gettime.3: New page describing ntp_gettime(3) and ntp_gettimex(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-07 01:34:55 +01:00
Michael Kerrisk 82b43a7692 posix_spawn.3: Tweak a few more details 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-05 10:26:32 +01:00
Michael Kerrisk 5356204785 posix_spawn.3: Add note on "posix_fspawn" functionality 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-05 10:26:32 +01:00
Michael Kerrisk 7b5e3ad522 posix_spawn.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-05 10:26:32 +01:00
Michael Kerrisk c0d82fb9cb posix_spawnp.3: New link to new posix_spawn.3 page 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-05 10:26:32 +01:00
Michael Kerrisk 10069ed030 posix_spawn.3: Major reworking of and additions to contributed page 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-05 10:26:32 +01:00
Bill O. Gallmeister a5458d4938 posix_spawn.3: New man page for posix_spawn(3) and posix_spawnp(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-05 10:26:32 +01:00
Michael Kerrisk df383cdf95 posix_memalign.3: Note posix_memalign()'s treatment of 'memptr' on error 
Reported-by: Eric Blake <eblake@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-05 08:52:29 +01:00
Michael Kerrisk 9c048ec195 fmemopen.3: Note one more memory stream bug that was fixed in glibc 2.22 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-02 16:23:19 +01:00
Michael Kerrisk 39ef79baad fmemopen.3: Note various fmemopen() bugs that were fixed in glibc 2.22 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-02 16:23:19 +01:00
Michael Kerrisk f435db47cd opendir.3: Help the reader by explicitly mentioning the use of readdir(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-02 12:32:04 +01:00
Michael Kerrisk 0fdfbd140d readdir.3: Minor tweaks to 'd_name' text 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-02 12:30:32 +01:00
Michael Kerrisk 307b34a803 readdir.3: Add a lot more detail on portable use of the 'd_name' field 
Include also some information from comments by Florian Weimer,
Paul Eggert, and Rich Felker.

Reported-by: Florian Weimer <fweimer@redhat.com>
Reported-by: Rich Felker <dalias@aerifal.cx>
Reported-by: Paul Eggert <eggert@cs.ucla.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-02 12:30:32 +01:00
Michael Kerrisk 6550b8275b readdir.3: Near complete restructuring of the page and add some further details 
The mixture of information across DESCRIPTION and NOTES did
not lend itself to easy reading...

While we're at it, add some missing details as well.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-02 12:30:32 +01:00
Michael Kerrisk df7a8fc91e readdir.3: Explain how to distinguish end of stream from an error 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-02 08:41:26 +01:00
Michael Kerrisk 96604453fd readdir.3, readdir_r.3: Split readdir_r() content into separate page 
As suggested by Florian Weimer:

    It may make sense to move this documentation to a separate
    manual page, specific to readdir_r.  This will keep the
    readdir() documentation nice and crisp.  Most programmers
    will never have to consult all these details.

Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 21:07:01 +01:00
Michael Kerrisk c48f13805c readdir.3: Remove misleading code example using pathconf() 
As noted by Florian:

    The kernel does not return valid values for _PC_NAME_MAX and
    some file systems (such as CIFS, and CD-ROMs with Joliet
    extensions once a kernel bug is fixed).  The CIFS limit is
    somewhere around 765, and not 255 as reported by the kernel.
    If I recall correctly, Windows SMB servers can actually
    exceed the 255 byte limit.  The reason is that Windows NTFS
    has a limit based on 16-bit UCS-2 characters, and after
    UTF-8 conversion, the maximum length is more than 255 bytes.

Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:31:56 +01:00
Michael Kerrisk 0c52f6d623 readdir.3: Explain why readdir_r() is deprecated and readdir() is preferred 
Based on Florian Weimer's text that was added to the glibc manual;
relicensed for use in this man page by permission of Florian.
See http://www.austingroupbugs.net/view.php?id=696
and https://sourceware.org/bugzilla/show_bug.cgi?id=14699

Cowritten-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:25:51 +01:00
Michael Kerrisk cff459dea2 kill.2, sigaction.2, sigpending.2, sigprocmask.2, sigsuspend.2, ctermid.3, ferror.3, fopen.3, getaddrinfo.3, getnameinfo.3, longjmp.3, rand.3, setjmp.3, sigsetops.3, sigwait.3, tzset.3: Simply FTM requirements 
_XOPEN_SOURCE implies _POSIX_C_SOURCE >=2, so simplify FTM
requirements in various pages.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:05 +01:00
Michael Kerrisk d59161f912 ctime.3, ffs.3, finite.3, flockfile.3, gethostbyname.3, getnameinfo.3, getw.3, insque.3, isalpha.3, popen.3, printf.3, siginterrupt.3, strdup.3, strtok.3, toascii.3, tzset.3, unlocked_stdio.3: Update FTM requirements (mostly _DEFAULT_SOURCE) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:05 +01:00
Michael Kerrisk 97ff735155 tmpnam.3: Remove mention od _BSD_SOURCE and _SVID_SOURCE 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:04 +01:00
Michael Kerrisk 6b8b0e500c strtok.3: grfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:04 +01:00
Michael Kerrisk 9db90c7cc9 getgrent.3, getgrnam.3, getpwent.3, getpwnam.3: Updaye FTM requirements (mostly _DEFAULT_SOURCE) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:04 +01:00
Michael Kerrisk c1016e8767 kill.2, sigaction.2, sigpending.2, sigprocmask.2, sigsuspend.2, ctermid.3, ctime.3, ferror.3, flockfile.3, fopen.3, getaddrinfo.3, getgrnam.3, getnameinfo.3, getpwnam.3, rand.3, sigsetops.3, sigwait.3, strtok.3, tzset.3, unlocked_stdio.3, feature_test_macros.7: Remove mention of the obsolete _POSIX_SOURCE macro from SYNOPSIS 
_POSIX_SOURCE was a POSIX.1-1990 creation that was soon made
obsolete bu _POSIX_C_SOURCE. Retaining mention of it
in the feature test macro requirements section of the
SYNOPSIS doesn't contain important information, and may
mislead readers into actually trying to use this macro.
A few mentions of it a maintained in a some pages where
defining _POSIX_SOURCE inhibits some behavior.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:04 +01:00
Michael Kerrisk c4a256e267 strerror.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:04 +01:00
Michael Kerrisk a30128b4cc dirfd.3, readdir.3, scandir.3, seekdir.3, telldir.3: Update FTM requirements (mostly _DEFAULT_SOURCE) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:04 +01:00
Michael Kerrisk 2b1b042487 a64l.3, atoi.3, clearenv.3, drand48.3, drand48_r.3, ecvt.3, ecvt_r.3, gcvt.3, mkstemp.3, mktemp.3, posix_memalign.3, putenv.3, random.3, random_r.3, realpath.3, setenv.3, strtol.3, strtoul.3: Update FTM requirements (mostly _DEFAULT_SOURCE) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:04 +01:00
Michael Kerrisk 6e0869f758 getcwd.3, getdtablesize.3, getpass.3, lockf.3, ualarm.3, usleep.3: Update FTM requirements (mainly _DEFAULT_SOURCE) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:04 +01:00
Michael Kerrisk e0a68e13d9 acosh.3, asinh.3, atanh.3: Update FTM requirements (_DEFAULT_SOURCE) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:04 +01:00
Michael Kerrisk 827cdae3f1 _exit.2, abs.3, acos.3, acosh.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, atoi.3, cbrt.3, ceil.3, copysign.3, cos.3, cosh.3, div.3, erf.3, erfc.3, exp.3, exp2.3, expm1.3, fabs.3, fdim.3, finite.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, fpclassify.3, frexp.3, fwide.3, hypot.3, ilogb.3, isalpha.3, isgreater.3, iswblank.3, ldexp.3, lgamma.3, log.3, log10.3, log1p.3, log2.3, logb.3, lrint.3, lround.3, modf.3, nan.3, nextafter.3, pow.3, printf.3, remainder.3, remquo.3, rint.3, round.3, scalbln.3, scanf.3, signbit.3, sin.3, sinh.3, sqrt.3, strtod.3, strtol.3, strtoul.3, tan.3, tanh.3, tgamma.3, trunc.3, wprintf.3: Remove "or 'cc -std=c99'" from SYNOPSIS 
Under the FTM requirements all of these pages document the
requirement for _ISOC99_SOURCE. And feature_test_macros(7) now
documents that "cc -std=c99" produces the same effect as defining
_ISOC99_SOURCE. So, all of these pages don't additionally need
to specify "or 'cc -std=c99'" under the FTM requirements
in the SYNOPSIS. Removing that redundant text also simplifies
the SYNOPSIS a little.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:04 +01:00
Michael Kerrisk cd2d5ec163 exp2.3, finite.3, fwide.3, log2.3, nextafter.3, printf.3, rint.3, wprintf.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:04 +01:00
Michael Kerrisk 636ed4d58d acosh.3, asinh.3, atanh.3, cbrt.3, erf.3, erfc.3, expm1.3, fpclassify.3, gamma.3, hypot.3, ilogb.3, j0.3, lgamma.3, log1p.3, logb.3, matherr.3, nextafter.3, remainder.3, rint.3, scalb.3, scalbln.3, significand.3, y0.3: Update FTM requirements (_DEFAULT_SOURCE) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:04 +01:00
Michael Kerrisk e9d91bcf4c acos.3, asin.3, atan.3, atan2.3, ceil.3, copysign.3, cos.3, cosh.3, exp.3, fabs.3, floor.3, fmod.3, frexp.3, ldexp.3, log.3, log10.3, modf.3, pow.3, sin.3, sinh.3, sqrt.3, tan.3, tanh.3: Update FTM requirements (_DEFAULT_SOURCE) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:04 +01:00
Michael Kerrisk aa573adabf dirfd.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:03 +01:00
Michael Kerrisk 51c612fb9f getgroups.2, gettimeofday.2, mincore.2, readv.2, stime.2, wait4.2, addseverity.3, adjtime.3, cfree.3, dysize.3, fgetgrent.3, fgetpwent.3, futimes.3, getdirentries.3, getgrent_r.3, getgrouplist.3, getmntent.3, getnetent_r.3, getprotoent_r.3, getpwent_r.3, getrpcent_r.3, getservent_r.3, getspnam.3, gsignal.3, initgroups.3, mkdtemp.3, on_exit.3, perror.3, psignal.3, putpwent.3, rcmd.3, rpmatch.3, setbuf.3, setnetgrent.3, sigvec.3, strsep.3, syslog.3, tempnam.3, termios.3, timegm.3, timeradd.3: Update FTM requirements (_DEFAULT_SOURCE) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:03 +01:00
Michael Kerrisk 3dd87b7c99 setjmp.3: Remove reference to obsolete _XOPEN_SOURCE_EXTENDED 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:03 +01:00
Michael Kerrisk b40ec4cbf8 ttyslot.3: Update FTM requirements (_DEFAULT_SOURCE) 
And remove mention of obsolete _XOPEN_SOURCE_EXTENDED

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:03 +01:00
Michael Kerrisk cf7fa0a179 brk.2, chdir.2, chmod.2, chown.2, chroot.2, getpagesize.2, getsid.2, killpg.2, mknod.2, readlink.2, setpgid.2, setreuid.2, sigaltstack.2, stat.2, symlink.2, sync.2, truncate.2, vfork.2, wait.2, wait4.2, a64l.3, acosh.3, asinh.3, atanh.3, cbrt.3, ecvt.3, expm1.3, gcvt.3, getcwd.3, getdate.3, getdtablesize.3, getgrent.3, gethostid.3, getpass.3, getpwent.3, getsubopt.3, ilogb.3, insque.3, lockf.3, log1p.3, logb.3, mkstemp.3, mktemp.3, nextafter.3, posix_memalign.3, random.3, realpath.3, remainder.3, rint.3, scalb.3, siginterrupt.3, sigset.3, strdup.3, ualarm.3, usleep.3: Remove references to _XOPEN_SOURCE_EXTENDED in SYNOPSIS 
_XOPEN_SOURCE_EXTENDED is obsolete (it existed in SUSv1, but not
subsequent standards). _XOPEN_SOURCE >= 500 produces the same
effects as (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED). Modifying
the SYNOPSIS of various ages that contain:

    _XOPEN_SOURCE\ >=\ 500 ||
        _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED

to just:

    _XOPEN_SOURCE\ >=\ 500

This has the following benefits:

a) Simplifying the SYNOPSIS by removing ancient
   historical information.

b) Preventing users from being misled into using
   _XOPEN_SOURCE_EXTENDED in new source code.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:03 +01:00
Michael Kerrisk 7f0ec8eed6 endian.3, getloadavg.3, getutent.3, inet.3, makedev.3, rexec.3: Update FTM requirements (_DEFAULT_SOURCE) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:03 +01:00
Michael Kerrisk e1d0532862 scandir.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:03 +01:00
Michael Kerrisk b0da7b8b76 access.2, chmod.2, chown.2, link.2, mkdir.2, open.2, readlink.2, rename.2, stat.2, symlink.2, unlink.2, utimensat.2, vfork.2, dirfd.3, fexecve.3, ffs.3, fmemopen.3, getcwd.3, gethostbyname.3, getline.3, mbsnrtowcs.3, mkdtemp.3, mkfifo.3, opendir.3, printf.3, psignal.3, qecvt.3, scandir.3, stpcpy.3, stpncpy.3, strdup.3, strnlen.3, strsignal.3, ualarm.3, usleep.3, wcpcpy.3, wcpncpy.3, wcscasecmp.3, wcsdup.3, wcsncasecmp.3, wcsnlen.3, wcsnrtombs.3: Simply FTM requirements 
Looking at <features.h> (or feature_test_macros(7)), one can
see that when _XOPEN_SOURCE is defined with the value 700
(or greater), then _POSIX_C_SOURCE is defined with the value
200809L (or greater). Therefore, terms in the man pages such as

    _XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L

can be simpified to:

    _POSIX_C_SOURCE\ >=\ 200809L

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:03 +01:00
Michael Kerrisk e464f0546d _exit.2, brk.2, abs.3, acos.3, acosh.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, atoi.3, cbrt.3, ceil.3, copysign.3, cos.3, cosh.3, div.3, erf.3, erfc.3, exp.3, expm1.3, fabs.3, fdim.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, fpclassify.3, frexp.3, hypot.3, ilogb.3, isalpha.3, isgreater.3, iswblank.3, ldexp.3, lgamma.3, log.3, log10.3, log1p.3, logb.3, lrint.3, lround.3, modf.3, nan.3, nextafter.3, posix_memalign.3, pow.3, remainder.3, remquo.3, round.3, scalbln.3, scanf.3, signbit.3, sin.3, sinh.3, sqrt.3, strtod.3, strtol.3, strtoul.3, tan.3, tanh.3, tgamma.3, trunc.3: Simplify FTM requirements 
Looking at <features.h> (or feature_test_macros(7)), one can
see that when _XOPEN_SOURCE is defined with the value 600
(or greater), then _POSIX_C_SOURCE is defined with the value
200112L (or greater). Therefore, terms in the man pages such as

    _XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L

can be simplified to:

    _POSIX_C_SOURCE\ >=\ 200112L

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

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:03 +01:00
Michael Kerrisk a446ac0c68 brk.2, chroot.2, clock_nanosleep.2, getpagesize.2, posix_fadvise.2, select.2, select_tut.2, seteuid.2, clock_getcpuclockid.3, ecvt.3, exp2.3, fseeko.3, gcvt.3, getdtablesize.3, getpass.3, getw.3, log2.3, mktemp.3, mq_receive.3, mq_send.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, pthread_attr_setstack.3, rint.3, sem_wait.3, setenv.3, sockatmark.3, strerror.3: Simplify FTM requirements 
Looking at <features.h> (or feature_test_macros(7)), one can
see that when _XOPEN_SOURCE is defined with the value 600
(or greater), then _POSIX_C_SOURCE is defined with the value
200112L (or greater). Therefore, terms in the man pages such as

    _XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L

can be simpified to:

    _POSIX_C_SOURCE\ >=\ 200112L

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:03 +01:00
Michael Kerrisk d054453419 acct.2, getdomainname.2, gethostname.2, vhangup.2, daemon.3, gethostid.3, getusershell.3, profil.3: Update feature test macro requirements 
Update to use _DEFAULT_SOURCE, and also changes brought by
glibc commit 266865c0e7b79d4196e2cc393693463f03c90bd8.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 20:01:03 +01:00
Michael Kerrisk b105252461 readdir.3: Reorder text describing readdir_r() 
(This is done in preparation for discussing glibc 2.23 changes.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 11:01:27 +01:00
Michael Kerrisk 119cb943f0 readdir.3: srcfix: add missing 2008 copyright note 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 11:01:27 +01:00
Michael Kerrisk cefcfd92d5 backtrace.3: Minor reworking in example program 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-01 11:01:27 +01:00
Jakub Wilk 40da0793a6 getaddrinfo.3: tfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-28 14:39:01 +01:00
Michael Kerrisk a222234619 backtrace.3: Small fixes to example program 
Reported-by: Martin Gebert <Murphy.Gebert@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-26 16:45:17 +01:00
Michael Kerrisk 271ee1bf63 termios.3: SEE ALSO: add tty(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-26 13:20:09 +01:00
Michael Kerrisk 23ec905b42 setbuf.3: SEE ALSO: add stdbuf(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-26 12:58:44 +01:00
Michael Kerrisk 9bfa6a8427 sleep.3: SEE ALSO: add sleep(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-26 12:32:13 +01:00
Michael Kerrisk b936906ac9 getcwd.3: SEE ALSO: add pwd(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-26 12:30:10 +01:00
Michael Kerrisk 06cdf61aca fts.3: BUGS: glibc-2.23 now has LFS support for the fts functions 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-22 09:21:45 +01:00
Michael Kerrisk c66649c835 clearenv.3: Clarify the use and effect of clearenv() 
See http://bugs.debian.org/679323

Reported-by: Matt Zimmerman <mdz@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-19 13:07:58 +01:00
Michael Kerrisk e44a70d63b clearenv.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-19 13:07:58 +01:00
Michael Kerrisk f34269b6ed clearenv.3: Variables can be added to the environment after calling clearenv() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-19 13:07:58 +01:00
Michael Kerrisk e8f9c18c31 clearenv.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-19 13:07:57 +01:00
Michael Kerrisk d2229a2b2f clog10.3: Show an alternative equivalence for clog10() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-19 13:07:57 +01:00
Michael Kerrisk d8334b03a5 clog10.3: Update CONFORMING TO 
Fix grammar error and add C11.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-19 13:07:57 +01:00
Michael Kerrisk 5c6de1fc37 strnlen.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-18 14:17:29 +01:00
Michael Kerrisk 5af40309cc strlen.3: CONFORMING TO: add C11 
Reported-by: Alan Aversa <alan.aversa@cox.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-18 14:10:15 +01:00
Michael Kerrisk b357f2c97c strlen.3: wfix 
Reported-by: Alan Aversa <alan.aversa@cox.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-18 14:09:49 +01:00
Michael Kerrisk 2ddb74c035 strlen.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-18 13:27:02 +01:00
Michael Kerrisk 988c4c4263 termios.3: Further improvements to recent tweaks of canonical mode 4096 char limit 
Reported-by: Peter Hurley <peter@hurleysoftware.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-18 12:23:21 +01:00
Michael Kerrisk 4a66305922 printf.3: tfix 
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=756599

Reported-by: Jakub Wilk <jwilk@debian.org>
Reported-by: Stéphane Aulery <lkppo@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-17 13:10:37 +01:00
Michael Kerrisk 332aaf19ff setjmp.3: wfix 
Reported-by: Stephan Bergmann <sbergman@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-17 12:08:38 +01:00
Michael Kerrisk 082efcce8b signal.7: Note the interactions of longjmp() and non-async-signal-safe functions 
See http://austingroupbugs.net/view.php?id=516#c1195.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-16 15:48:36 +01:00
Michael Kerrisk f1d6ee6211 setjmp.3: Note the interactions of longjmp() and non-async-signal-safe functions 
POSIX.1-2008 TC2 adds explicit text on this point.
See http://austingroupbugs.net/view.php?id=516#c1195

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-16 15:48:36 +01:00
Michael Kerrisk b51ef507b8 longjmp.3: Replace page with link to setjmp(3), which now incorporates longjmp() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-16 15:48:36 +01:00
Michael Kerrisk a26c590b88 siglongjmp.3: Rewire link to point to setjmp(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-16 15:48:36 +01:00
Michael Kerrisk efc626f8f5 setjmp.3: Rewrite and merge longjmp()/siglongjmp() discussion into this page 
The discussion of nonlocal gotos is much easier to read if
setjmp() and longjmp() are discussed in the same page. While
we're at it, rework almost the entire text and add several
more details.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-16 15:48:30 +01:00
Michael Kerrisk 84d75c06d5 longjmp.3: Refer the reader to NOTES in setjmp(3) 
There the reader will see the just expanded discussion of
why nonlocal gotos can make code harder to maintain.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-16 15:48:30 +01:00
Michael Kerrisk 405180660c setjmp.3: Explain why nonlocal gotos make code harder to maintain 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-16 15:48:26 +01:00
Michael Kerrisk 57f79036a4 setjmp.3: Reword warning on longjmp() to function that has already returned 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-16 12:55:08 +01:00
Michael Kerrisk fa03b85f87 longjmp.3: Remove redundant warning 
The warning that nonlocal gotos make a program hard to maintain
is also given in setjmp(3). No need to repeat it here.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-16 12:50:19 +01:00
Michael Kerrisk 7a727dc4ab termios.3: Tweaks to Tobias's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-15 16:24:50 +01:00
Dr. Tobias Quathamer 5ad8a9d73b termios.3: Document line length in canonical mode 
See https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/drivers/tty/n_tty.c#n1673
See https://bugs.debian.org/797479

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-15 16:18:13 +01:00
Dr. Tobias Quathamer 45a2419dac queue.3: Remove double CONFORMING TO section 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-15 16:16:59 +01:00
Dr. Tobias Quathamer 4cf9fe6b53 sigpause.3: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-15 13:34:44 +01:00
Michael Kerrisk 88cc4cb6cc perror.3: Suggest use of strerror(3) in place of deprecated 'sys_errlist' 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-08 16:23:13 +01:00
Michael Kerrisk f1b7532ba7 isgreater.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-08 16:11:58 +01:00
Michael Kerrisk 24a31d632b accept.2, bind.2, connect.2, getpeername.2, getsockname.2, recv.2, recvmmsg.2, select_tut.2, send.2, sendmmsg.2, getaddrinfo.3, getnameinfo.3, epoll.7, unix.7: Use consistent argument/variable names for socket addresses and lengths 
As noted by Carlos, there's quite a bit of inconsistency across
pages. Use 'addr' and 'addrlen' consistently in variables and
function arguments.

Cowritten-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-03 14:08:29 +01:00
Michael Kerrisk 787dd4ad3a membarrier.2, crypt.3, dladdr.3, duplocale.3, fmemopen.3, gethostbyname.3, mallopt.3, newlocale.3, resolver.3, sigsetops.3, strfmon.3, tzset.3, console_ioctl.4, lirc.4, loop.4, vcs.4, dir_colors.5, locale.5, proc.5, tzfile.5, attributes.7, bootparam.7, capabilities.7, feature_test_macros.7, icmp.7, man-pages.7, netlink.7, path_resolution.7, pipe.7, socket.7, unix.7, vdso.7: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-03 09:14:22 +01:00
Michael Kerrisk b353ceb4a0 basename.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-03 08:46:35 +01:00
Michael Kerrisk def04e1ccf chown.2, futex.2, membarrier.2, memfd_create.2, mount.2, msgop.2, open.2, open_by_handle_at.2, perf_event_open.2, readv.2, sched_setscheduler.2, syslog.2, basename.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-03 08:46:16 +01:00
Michael Kerrisk 254f636a4c exp.3: SEE ALSO: add expm1(3) 
Reported-by: Joachim Wuttke <j.wuttke@fz-juelich.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-02-01 15:30:45 +01:00
Michael Kerrisk c72249c562 fork.2, read.2, sendfile.2, splice.2, write.2, aio_read.3, aio_write.3, proc.5: Wording fix: "current file offset" ==> "file offset" 
"File offset" is the preferred POSIX terminology.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-01-26 10:13:47 +01:00
Jakub Wilk 99bf434550 mcheck.3: tfix 
Remove duplicated word.

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-01-25 14:33:30 +01:00
Michael Kerrisk 00e295fb10 system.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-01-20 22:04:22 +01:00
Alexander Miller 7e16fc97b2 perror.3: tfix 
Signed-off-by: Alexander Miller <alex.miller@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-01-19 12:52:04 +01:00
Nikola Forró c32f10a179 rcmd.3: Add missing condition concerning .rhosts file 
The list of conditions determining if iruserok() and ruserok()
functions automatically fail is incomplete. According to glibc
source code, the functions also fail if the .rhosts file
is hard linked anywhere.

[Information verified from iruserfopen() function in inet/rcmd.c]

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-01-17 17:05:24 +01:00
Jakub Wilk 1cd9229c06 mq_close.3: tfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-01-16 11:19:31 +01:00
Michael Kerrisk 6c15ab2dd1 exec.3: SEE ALSO: add system(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-01-16 10:37:37 +01:00
Michael Kerrisk fb7a9afd3b system.3: SEE ALSO: add execve(2) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-01-16 10:36:07 +01:00
Michael Kerrisk bb2e799782 system.3: Minor fix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-01-16 10:35:51 +01:00
Jakub Wilk bb492d9dc2 toupper.3: tfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-01-08 20:19:17 +01:00
Michael Kerrisk 9f895e62e5 errno.3: Add some explanation of ENOENT error 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-01-01 13:33:13 +01:00
Michael Kerrisk bb14af394e clock_nanosleep.2, fallocate.2, nanosleep.2, request_key.2, sigsuspend.2, statfs.2, getgrent.3, getgrnam.3, getpwent.3, getpwnam.3, lio_listio.3, statvfs.3, tmpfile.3, ualarm.3: ERRORS: add reference to signal(7) in description of EINTR 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-01-01 13:15:06 +01:00
Michael Kerrisk d9cb0d7d3f Various pages: Word "descriptor" more precisely 
Use either "file descriptor" or message queue descriptor".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-01-01 12:29:37 +01:00
Michael Kerrisk 3eec7952d6 bindresvport.3: Minor wording fix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-01-01 12:28:37 +01:00
Michael Kerrisk 39d5f56976 undocumented.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-30 16:08:33 +01:00
Michael Kerrisk 4b7c4868dc strerror_l.3: New link to strerror.3 
Fix missing link

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-30 16:07:24 +01:00
Michael Kerrisk 325d0d830d isalpha_l.3: New link to isalpha.3 
Fix missing link.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-30 16:06:06 +01:00
Michael Kerrisk e24fbf1098 Removed trailing white space at end of lines 2015-12-29 13:51:32 +01:00
Michael Kerrisk 29b41e747f accept.2, acct.2, bind.2, clock_getres.2, connect.2, dup.2, epoll_create.2, eventfd.2, execve.2, fanotify_init.2, fcntl.2, fork.2, futex.2, get_robust_list.2, getcpu.2, getpeername.2, getrlimit.2, getsockname.2, getsockopt.2, gettimeofday.2, inotify_init.2, listen.2, membarrier.2, memfd_create.2, mlock.2, mmap.2, personality.2, pipe.2, poll.2, recv.2, send.2, sendfile.2, shmget.2, shutdown.2, sigreturn.2, socket.2, socketcall.2, socketpair.2, spu_create.2, swapon.2, time.2, timerfd_create.2, uselib.2, dlerror.3, dlopen.3, drand48.3, errno.3, fnmatch.3, getgrent.3, getgrnam.3, getlogin.3, getpwent.3, getpwnam.3, iconv.3, mq_open.3, opendir.3, random_r.3, sem_open.3, shm_open.3, tmpfile.3, tzset.3, random.4, fanotify.7, futex.7, vdso.7, ld.so.8: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-29 13:48:42 +01:00
Pádraig Brady b664d38dd5 fnmatch.3: Describe the FNM_EXTMATCH flag and pattern syntax 
Signed-off-by: Pádraig Brady <P@draigBrady.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-27 17:14:55 +01:00
Michael Kerrisk e258766bf4 accept.2, acct.2, epoll_create.2, execve.2, futex.2, inotify_init.2, mmap.2, open.2, pipe.2, shmget.2, socket.2, socketpair.2, spu_create.2, swapon.2, uselib.2, getgrent.3, getgrnam.3, getlogin.3, getpwent.3, getpwnam.3, mq_open.3, opendir.3, sem_open.3, shm_open.3, tmpfile.3, fanotify.7: ERRORS: standardize text for ENFILE error 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-27 17:10:23 +01:00
Michael Kerrisk 4a5c6f9f2c errno.3: Note probable cause of ENFILE error 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-27 17:03:41 +01:00
Michael Kerrisk 26c32fabec accept.2, dup.2, eventfd.2, execve.2, fcntl.2, memfd_create.2, open.2, perf_event_open.2, pipe.2, signalfd.2, socket.2, socketpair.2, spu_create.2, timerfd_create.2, getgrent.3, getgrnam.3, getlogin.3, getpwent.3, getpwnam.3, mq_open.3, opendir.3, sem_open.3, shm_open.3, tmpfile.3: ERRORS: standardize text for EMFILE error 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-27 16:37:03 +01:00
Michael Kerrisk ea1127509f scanf.3: Minor wording tweaks in RETURN VALUE 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-27 16:00:29 +01:00
Michael Kerrisk aeb4ba7602 dlerror.3: Clarify that the string returned by dlerror() is null terminated 
Reported-by: Jonny Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-26 16:58:46 +01:00
Michael Kerrisk 77227d3697 CPU_SET.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-19 06:05:09 +01:00
Michael Kerrisk b62ea03aa4 drand48.3: Correct descriptions of ranges returned by these functions 
See http://bugs.debian.org/803459

Reported-by: Vincent Lefevre <vincent@vinc17.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-17 15:02:52 +01:00
Michael Kerrisk 61f6d1af1c random_r.3: Clarify need to use initstate_r() 
As noted by Archie Cobbs:

I was trying to use srandom_() and initstate_r() and fell into
the exact same trap this this fellow did:
http://stackoverflow.com/questions/18569523/segfault-at-srandom-r,
resulting in a segfault.

The man page is really unclear here. It leads one to believe
(falsely) that invoking setrandom_r() is sufficient to initialize
a struct random_data, but this is not the case. In fact
srandom_r() is not like srandom() at all in this respect.

Reported-by: Archie Cobbs <archie.cobbs@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-17 09:36:37 +01:00
Carlos O'Donell 17e9724a2e tzset.3: Clarify "daylight" and remove erroneous note 
When tzset is run the value of daylight is computed
by looking at all available rules for the application
of daylight savings. This includes reading the tzdata
files to determine if there is a transition or not for
the current timezone. It also includes parsing TZ env
to see if it specifies custom rules which are used in
precedence to any tzdata rules. Therefore daylight is
going to be set if there is a daylight saving rule past,
present, or future that indicates a transition. We clarify
that in the man page.

Lastly, the note about tz_dsttime is not correct and is
removed. The earlier paragraph about daylight makes it
clear that it doesn't mean "daylight saving rule applies
now", and the interaction with tz_dsttime is not correct
for glibc on Linux (as outlined in my gettimeofday.3 patch
sent here: http://marc.info/?l=linux-man&m=144977768703615&w=2).

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-16 16:43:45 +01:00
Andries E. Brouwer c89ca4366c iconv.3: NOTES: describe correct usage for flushing partially buffered input 
The following came up yesterday on the wget list.
The iconv.3 man page says

"... 2. The input byte sequence has been entirely converted,
 i.e. *inbytesleft has gone down to 0."

and

"A  different  case is when inbuf is NULL or *inbuf is NULL,
 but outbuf is not NULL and *outbuf is not NULL. In this case,
 the iconv function attempts to set cd's conversion state to the
 initial state and store  a  corresponding shift sequence at
 *outbuf."

The POSIX page says

"For state-dependent encodings, the conversion descriptor cd is
 placed into its initial shift state by a call for which inbuf
 is a null pointer, or for which inbuf points to a null pointer.
 When iconv() is called in this way, and if outbuf is not a null
 pointer or a pointer to a null pointer, and outbytesleft points
 to a positive value, iconv() shall place, into the output buffer,
 the byte sequence to change the output buffer to its initial
shift state."

These texts are slightly misleading, in the sense that, in the
present implementation, iconv() may implement conversion
from an encoding that is not state-dependent in a way that
uses an artificial shift state to store lookahead bytes.
That means that after conversion, when *inbytesleft has gone
down to 0, it may be that contrary to what iconv.3 suggests not
all output has been stored, and a final flushing call is needed.

Maybe this violates POSIX.

A minimal warning is added by this patch.

--- man-pages-4.03/man3/iconv.3 2015-12-05 10:45:25.000000000 +0100
+++ ./iconv.3   2015-12-16 01:41:38.253049938 +0100
@@ -161,6 +161,11 @@
 .SH CONFORMING TO
 POSIX.1-2001, POSIX.1-2008.
 .SH NOTES
+In each series of calls to
+.BR iconv (),
+the last should be one with \fIinbuf\fP or \fI*inbuf\fP equal to NULL,
+in order to flush out any partially converted input.
+
 Although
 .I inbuf
 and

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-16 11:27:36 +01:00
Jakub Wilk 17a4e35b1d pthread_rwlockattr_setkind_np.3: tfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-07 08:13:27 +01:00
Jakub Wilk ccbdce6ed9 dlerror.3: tfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-07 08:09:47 +01:00
Jakub Wilk 7dffdbbd05 clog.3: tfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-07 08:09:42 +01:00
Jakub Wilk a423ef7cd1 cbrt.3: tfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-07 08:09:33 +01:00
Michael Kerrisk 6f3c74a8b9 mremap.2, open.2, perf_event_open.2, prctl.2, ptrace.2, reboot.2, seccomp.2, signalfd.2, syscalls.2, __ppc_set_ppr_med.3, daemon.3, dirfd.3, fgetgrent.3, fgetpwent.3, getauxval.3, getspnam.3, mallinfo.3, mallopt.3, posix_fallocate.3, termios.3, tty_ioctl.4, core.5, nsswitch.conf.5, proc.5, aio.7, capabilities.7, path_resolution.7, pipe.7, rtld-audit.7, signal.7, tcp.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-05 10:46:28 +01:00
Michael Kerrisk 2e056718fc dlopen.3: Include a shell session showing build/run in EXAMPLE 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-05 10:46:28 +01:00
Michael Kerrisk 4373ccc072 dlopen.3: Change arguments to main() to "void" in EXAMPLE 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-05 10:46:22 +01:00
Michael Kerrisk b44cf4bcd4 dlopen.3: Correct the pathname used in EXAMPLE 
Quoting Florian:

    This does not work because libm.so can be a linker script:

           handle = dlopen("libm.so", RTLD_LAZY);

    The proper way to do this is to include <gnu/lib-names.h>
    and use LIBM_SO.

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

Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-05 10:40:31 +01:00
Michael Kerrisk 614e5d137a daemon.3: Minor wording fix 
As noted by Florian Weimer:

    The manual daemon(3) manual page talks about the "calling
    process's current working directory".  I think this is
    misleading because the function exits the calling process
    before changing the current directory.

Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-05 10:40:31 +01:00
Michael Kerrisk dd1d112d2f scanf.3: Minor wording fix in %s description 
Reported-by: Stefan Tauner <tauner@technikum-wien.at>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-05 10:40:31 +01:00
Michael Kerrisk 6e8ccc0d6c termios.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-02 20:21:09 +01:00
Michael Kerrisk a0262e270d termios.3: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-02 20:17:30 +01:00
Olivier TARTROU 2d7c8f1f78 termios.3: Add missing details on behaviour of PARMRK 
For a serial terminal, with a specific configuration, input bytes
with value 0377 are passed to the program as two bytes, 0377 0377.

This (correct) behaviour is described in the documentation of the
GNU C Library
(https://www.gnu.org/software/libc/manual/html_node/Input-Modes.html#Input-Modes)
but not in the termios.3 man page.

Problematic configuration: INPCK set, IGNPAR not set, PARMRK set,
ISTRIP not set.

This man page problem affects several users. Examples:
* http://sourceforge.net/p/ftdi-usb-sio/mailman/message/4079724/
* http://mailman.uclinux.org/pipermail/uclinux-dev/2006-November/040984.html
* ...

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-02 20:09:25 +01:00
Michael Kerrisk 1a08b97b56 dlopen.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-12-02 14:03:49 +01:00
Michael Kerrisk 8dbd75b8ba dlopen.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-11-17 10:36:03 +01:00
Michael Kerrisk 50008330de dlopen.3: Make it more explicit that LD_BIND_NOW overrides RTLD_LAZY 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-11-17 10:31:56 +01:00
Michael Kerrisk 630551b9f9 daemon.3: Note that damon is buggy with respect to controlling tty acquisition 
Reported-by: Johannes Stüttgen <Johannes.Stuettgen@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-10-16 21:24:55 +02:00
Gabriel F. T. Gomes a9a3390a4e __ppc_set_ppr_very_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>
 2015-10-08 22:07:29 +01:00
Gabriel F. T. Gomes 97ad561735 __ppc_set_ppr_med_high.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>
 2015-10-08 21:22:11 +01:00
Michael Kerrisk 42f014d3f7 __ppc_set_ppr_med.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-10-08 21:21:26 +01:00
Michael Kerrisk e65b3f0d2d __ppc_set_ppr_med.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-10-08 21:19:47 +01:00
Gabriel F. T. Gomes eb6b6909a7 __ppc_set_ppr_med.3: Document PPC functions providing access to PPR 
GNU C Library commit 1747fcda4902a3b46183d93fb16ed9b436b2608b
extends the priorities that can be set to the Program Priority
Register (PPR), with the functions: __ppc_set_ppr_very_low(3)
and __ppc_set_ppr_med_high(3).

Signed-off-by: Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-10-08 21:16:38 +01:00
Jonathan Wakely 03ffcdae22 dirfd.3: Remove outdated NOTES 
As stated in the SYNOPSIS, since glibc 2.10 this function is also
declared by the relevant X/Open and POSIX macros.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-10-05 10:09:57 +01:00
Michael Kerrisk 624fbe44d9 posix_fallocate.3: Clarify text relating to MT-safety 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-10-05 10:00:29 +01:00
Michael Kerrisk 141c1d0547 posix_fallocate.3: ffix + wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-10-05 10:00:29 +01:00
Carlos O'Donell a74bc4c9e4 posix_fallocate.3: Mention glibc emulation caveats 
When the glibc implementation of posix_fallocate detects
that the underlying filesystem does not support fallocate()
it uses an emulation function to attempt to allocate the
space requested. The most common case is calling
posix_fallocatei() for a file that is on NFS where the
NFS server is not new enough to support the recent fallocate
extensions. This emulation has various serious caveats that
must be understood in order to use posix_fallocate robustly
on all filesystems. The change documents the caveats in the
glibc implementation.

Lastly, we expand the meaning of EINVAL to match POSIX
2013 (Issue 7). If the underlying filesystem doesn't support
posix_fallocate()i, the implementation can return EINVAL, but
glibc does not do this, it emulates the operation instead.

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-10-05 09:47:47 +01:00
Michael Kerrisk 422dd47fd8 getauxval.3: Add some details for AT_SECURE 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-09-13 11:59:48 +02:00
Michael Kerrisk 6912d54fe2 getauxval.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-09-13 11:58:25 +02:00
Michael Kerrisk 3a09fae856 getspnam.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-09-11 12:09:57 +02:00
Zeng Linggang b6c73e0bdf termios.3: srcfix: add FIXME 
Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-09-11 12:07:24 +02:00
Zeng Linggang eabb7166a9 sigpause.3: srcfix: add FIXME 
Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-09-11 12:07:02 +02:00
Zeng Linggang c32cf2684a 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>
 2015-09-11 12:06:44 +02:00
Zeng Linggang 557d7d9682 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>
 2015-09-11 12:06:23 +02:00
Zeng Linggang 1ec27c36ff 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>
 2015-09-11 12:06:08 +02:00
Zeng Linggang 098cd28bbf 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>
 2015-09-11 12:05:11 +02:00
Michael Kerrisk b72bd8d1c0 mallopt.3: Minor wording fixes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-30 05:02:25 -07:00
Michael Kerrisk bb1ee72e6f mallopt.3: Minor tweaks to Carlos's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-30 05:02:25 -07:00
Carlos O'Donell 9d116bd272 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>
 2015-08-30 03:09:38 -07:00
Michael Kerrisk 30ea59e720 Removed trailing white space at end of lines 2015-08-08 18:23:54 +02:00
Michael Kerrisk d6dcb338fc mktemp.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 18:22:46 +02:00
Michael Kerrisk 460495ca58 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>
 2015-08-08 18:21:22 +02:00
Michael Kerrisk 80bf84f684 nl_langinfo.3: srcfix (copyright) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:59:17 +02:00
Michael Kerrisk 3fc0259556 dlinfo.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:38:51 +02:00
Michael Kerrisk 78f2bf20fb dlinfo.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:38:37 +02:00
Michael Kerrisk 0fdbc11423 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>
 2015-08-08 17:35:45 +02:00
Michael Kerrisk 6fd1b6ebb7 dlopen.3: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:45 +02:00
Michael Kerrisk 438168a249 dlopen.3: wfix 
Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:45 +02:00
Michael Kerrisk ce65f81e7a dladdr.3: Minor wording fixes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:45 +02:00
Michael Kerrisk 51f796a450 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>
 2015-08-08 17:35:45 +02:00
Michael Kerrisk e8a1758ca3 dlopen.3: Reorganize conformance information for 'flags' 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:45 +02:00
Michael Kerrisk 6962fdf954 dlopen.3: srcfix: FIXME 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:45 +02:00
Michael Kerrisk 39720f03eb 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>
 2015-08-08 17:35:45 +02:00
Michael Kerrisk b23510e5db 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>
 2015-08-08 17:35:45 +02:00
Michael Kerrisk eab0df1736 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>
 2015-08-08 17:35:44 +02:00
Zeng Linggang 06c0008da9 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>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk 92bade29b9 atexit.3: SEE ALSO: add dlopen(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk b198e0ae76 dlopen.3: Move atexit() discussion under "Initialization and Finalization" 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk 6ceba646b4 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>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk 747b2b0a98 dlopen.3: dlclose() will unload the object when all references have been released 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk 9ebcbe1377 dlopen.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk c72bea436f dlerror.3: Note that the returned string does not include a trailing newline 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk c85226feb3 dlerror.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk 78978ec9a7 dlerror.3: Note that the returned message may be in a statically allocated buffer 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk 982eac0dba 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>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk 374b34d32e dlopen.3: Remove dlerror() content that was migrated to dlerror(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk 936b64f661 dlsym.3: SEE ALSO: add dlerror(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk da9356be20 dlinfo.3: SEE ALSO: add dlerror(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk 75b7da85c3 dlerror.3: Migrate dlerror(3) to a separate man page 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk b6779d1d8f dlopen.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk e83ed17d21 dlopen.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk 7766185cf8 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>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk 896c71d0bd dlopen.3: Remove content migrated to new dlsym() page 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk 273b4e247c dlinfo.3: SEE ALSO: add dlysm(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk de7d051d35 dladdr.3: SEE ALSO: add dlysm(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk efe8c6fd04 dlvsym.3: Adjust link to point to new self-contained dlsym(3) page 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk 15e1b31b8e dlsym.3: Move dlsym() and dlvsym3() content to their own page 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk c7c01315dc 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>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk e8290357ce dlopen.3: Move discussion of _init() and _fini() to NOTES 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk 7e936c2917 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>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk 65175b1d2a dlopen.3: Note some dlmopen() restrictions 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk fe854f153e dlopen.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk 43151de329 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>
 2015-08-08 17:35:44 +02:00
Michael Kerrisk 9c1697549f 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>
 2015-08-08 17:35:43 +02:00
Michael Kerrisk 020fed6aba dlmopen.3: New link to dlopen.3 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:43 +02:00
Michael Kerrisk efdd68a5b2 dlopen.3: Document dlmopen(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:43 +02:00
Michael Kerrisk 9987012c0c dladdr.3: SEE ALSO: add dlinfo(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:43 +02:00
Michael Kerrisk 46db2df163 dlopen.3: SEE ALSO: add dlinfo(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:43 +02:00
Michael Kerrisk 2b8adcef3d dlinfo.3: New page describing dlinfo(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:43 +02:00
Michael Kerrisk a7634f0141 dl_iterate_phdr.3: SEE ALSO: add dladdr(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:43 +02:00
Michael Kerrisk 6c46d3bc43 dlopen.3: SEE ALSO: add dladdr(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:43 +02:00
Michael Kerrisk 10b22cd92b dladdr1.3: New link to (new) dladdr(3) page 2015-08-08 17:35:43 +02:00
Michael Kerrisk affaa041c3 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>
 2015-08-08 17:35:43 +02:00
Michael Kerrisk 3f4c09d0d3 dlopen.3: Integrate dlvsym() discussion into main page text 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:43 +02:00
Michael Kerrisk 705e06be7f dlopen.3: Minor fix: remind reader that _init() and _fini() are obsolete 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:43 +02:00
Michael Kerrisk 6445992d72 dlopen.3: Remove dladdr() content 
This content will be migrated to a new page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:43 +02:00
Michael Kerrisk 8ac45f42e7 dlopen.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:43 +02:00
Michael Kerrisk 0a78ab7b0a dlopen.3: Minor wording fix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:43 +02:00
Michael Kerrisk adb1cfab52 dlopen.3: Add VERSIONS section 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:43 +02:00
Michael Kerrisk 48a11e1d6e dl_iterate_phdr.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:43 +02:00
Michael Kerrisk c9629ff8c0 dl_iterate_phdr.3: CONFORMING TO: note that this function appears on some other systems 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-08-08 17:35:43 +02:00