Commit Graph

4672 Commits

Author SHA1 Message Date
Michael Kerrisk d954cea8fd ftw.3: Reorganize the page to give primacy to nftw()
nftw() is the better API, and POSIX.1-2008 marks ftw() obsolete.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:40 +02:00
Michael Kerrisk 3591ce3e19 ftw.3: ftw() and nftw() differ for the non-stat-able symlink case
The POSIX specification of ftw() says that an un-stat-able
symlink may yield either FTW_NS or FTW_SL. The specification
of nftw() does not carry this statement.

Reported-by: Felix Sedlmeier <sedlmeier@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:40 +02:00
Michael Kerrisk f6c19db018 ftw.3: Update POSIX version references in NOTES
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:40 +02:00
Michael Kerrisk 3dd43f24b3 ftw.3: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:40 +02:00
Michael Kerrisk c47fe813bb ftw.3: CONFORMING TO: add POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:40 +02:00
Michael Kerrisk bdbe038293 ftw.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:40 +02:00
Michael Kerrisk 67de1cc92e exec.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:39 +02:00
Michael Kerrisk 2a3bc44ea7 exec.3: SYNOPSIS: Clarify calling signature for execl() and execlp()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:39 +02:00
Michael Kerrisk 5f3dafbf06 exec.3: Correct prototype for execle()
Make the prototype shown into correct C.

Reported-by: Andreas Baak <andreas.baak@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:39 +02:00
Michael Kerrisk 5600f73afd acos.3, acosh.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, cabs.3, cacos.3, cacosh.3, casin.3, casinh.3, catan.3, catanh.3, cbrt.3, cexp.3, cimag.3, conj.3, copysign.3, cos.3, cosh.3, cpow.3, creal.3, erf.3, erfc.3, exp.3, exp10.2, exp2.3, expm1.3, fma.3, fmod.3, frexp.3, hypot.3, ldexp.3, lgamma.3, log.3, log10.3, log1p.3, log2.3, modf.3, pow.3, pow10.3, remainder.3, significand.3, sin.3, sinh.3, sqrt.3, tan.3, tanh.3, tgamma.3: wfix: use consistent wording to describe functions
exp10.3, lgamma.3, modf.3, pow10.3, remainder.3, significand.3:dd
Where a page describes multiple math functions with float, double,
and long double variants, just describe them as "These functions"
rather than describing in terms of just the double variant.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:58 +02:00
Michael Kerrisk 4f337c124b ctanh.3: Add introductory sentence explaining what these functions calculate
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:58 +02:00
Michael Kerrisk ca9f5e079d ctan.3: Add introductory sentence explaining what these functions calculate
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:58 +02:00
Michael Kerrisk b0b0c4db8b csqrt.3: Simplify description of what these functions calculate
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:58 +02:00
Michael Kerrisk b571cae4d1 csinh.3: Add introductory sentence explaining what these functions calculate
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:58 +02:00
Michael Kerrisk 2feb67afc8 csin.3: Add introductory sentence explaining what these functions calculate
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:58 +02:00
Michael Kerrisk defcc3383a clog.3: Add introductory sentence explaining what these functions calculate
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:58 +02:00
Michael Kerrisk f0a0305b38 ccosh.3: Add introductory sentence explaining what these functions calculate
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:58 +02:00
Michael Kerrisk a6899b9509 ccos.3: Add introductory sentence explaining what these functions calculate
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:58 +02:00
Michael Kerrisk 8fd531f3f4 carg.3: Add introductory sentence explaining what these functions calculate
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:57 +02:00
Michael Kerrisk 9a74e0188a acos.3, acosh.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, cabs.3, cacos.3, cacosh.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cexp.3, cimag.3, clog.3, conj.3, copysign.3, cos.3, cosh.3, cpow.3, cproj.3, creal.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, erf.3, erfc.3, exp.3, exp2.3, expm1.3, fabs.3, fdim.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, frexp.3, hypot.3, ilogb.3, ldexp.3, log.3, log10.3, log1p.3, log2.3, logb.3, lrint.3, lround.3, modf.3, nan.3, nextafter.3, pow.3, remquo.3, rint.3, round.3, scalbln.3, sin.3, sinh.3, sqrt.3, tan.3, tanh.3, tgamma.3, trunc.3: These functions are also in POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:57 +02:00
Michael Kerrisk e05e36354c acos.3, acosh.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, ceil.3, cos.3, cosh.3, erf.3, erfc.3, exp.3, exp2.3, fabs.3, floor.3, fmod.3, frexp.3, hypot.3, ldexp.3, log.3, log10.3, log2.3, modf.3, pow.3, sin.3, sinh.3, sqrt.3, tan.3, tanh.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:57 +02:00
Michael Kerrisk 9a0216acae j0.3, lgamma.3, remainder.3, y0.3: CONFORMING TO: note functions that are also in POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:57 +02:00
Michael Kerrisk 674546eff6 sincos.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:57 +02:00
Michael Kerrisk 6cf65aa66f clog10.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:57 +02:00
Michael Kerrisk 553dbcef8c cabs.3, cacos.3, cacosh.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, ccos.3, ccosh.3, cexp.3, cimag.3, clog.3, conj.3, cpow.3, cproj.3, creal.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3: These C99 math functions are also in POSIX.1-2001
POSIX.1-2001 includes all of the C99 APIs

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:57 +02:00
Michael Kerrisk ae9b41ac79 gethostbyname.3: Add some detail for NO_DATA
Text consistent with POSIX and FreeBSD's gethostbyname() man page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:57 +02:00
Michael Kerrisk 491e87a59d gethostbyname.3: Clarify the NO_ADDRESS and NO_DATA are synonyms
Reported-by: Jonny Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 15:49:57 +02:00
Michael Kerrisk e20476d370 strcasecmp.3: Clarify that strcasecmp() does a byte-wise comparison
Reported-0by: Jonny Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 09:58:24 +02:00
Michael Kerrisk cad62ef6ab strcasecmp.3: CONFORMING TO: add POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 09:58:24 +02:00
Michael Kerrisk d25d8988ed strcasecmp.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 09:58:24 +02:00
Michael Kerrisk b739e8e108 strcat.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 09:58:24 +02:00
Michael Kerrisk 1892fceef3 realpath.3: Add ENOMEM error
Reported-by: Jon Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 09:58:24 +02:00
Michael Kerrisk 28e8ce31e7 getcwd.3: Add ENOMEM error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 09:58:24 +02:00
Michael Kerrisk afd6bcb8d9 malloc.3: Add ENOMEM error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 09:58:24 +02:00
Walter Harms 30e3ba675c printf.3: Simplify the example code
(Minor tweaks by mtk)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 09:34:05 +02:00
Zeng Linggang 3d597ecab1 wcrtomb.3: ATTRIBUTES: Note function that isn't thread-safe
The marking matches glibc marking.

wcrtomb: MT-Unsafe race:wcrtomb/!ps

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:50:03 +02:00
Zeng Linggang 4aefbee837 unlocked_stdio.3: ATTRIBUTES: Note functions that aren't thread-safe
The markings match glibc markings.

getc_unlocked:     MT-Safe race:stream
putc_unlocked:     MT-Safe race:stream
clearerr_unlocked: MT-Safe race:stream
fflush_unlocked:   MT-Safe race:stream
fgetc_unlocked:    MT-Safe race:stream
fputc_unlocked:    MT-Safe race:stream
fread_unlocked:    MT-Safe race:stream
fwrite_unlocked:   MT-Safe race:stream
fgets_unlocked:    MT-Safe race:stream
fputs_unlocked:    MT-Safe race:stream
getwc_unlocked:    MT-Safe race:stream
fgetwc_unlocked:   MT-Safe race:stream
fputwc_unlocked:   MT-Safe race:stream
putwc_unlocked:    MT-Safe race:stream
fgetws_unlocked:   MT-Safe race:stream
fputws_unlocked:   MT-Safe race:stream

getchar_unlocked:  MT-Unsafe race:stdin
getwchar_unlocked: MT-Unsafe race:stdin

putchar_unlocked:  MT-Unsafe race:stdout
putwchar_unlocked: MT-Unsafe race:stdout

feof_unlocked:     MT-Safe
ferror_unlocked:   MT-Safe
fileno_unlocked:   MT-Safe

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:50:03 +02:00
Zeng Linggang 9534c08c80 wprintf.3: ATTRIBUTES: Note functions that are thread-safe
The markings match glibc markings.

wprintf:   MT-Safe locale
fwprintf:  MT-Safe locale
swprintf:  MT-Safe locale
vwprintf:  MT-Safe locale
vfwprintf: MT-Safe locale
vswprintf: MT-Safe locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:28 +02:00
Zeng Linggang 652318eefe wcsrtombs.3: ATTRIBUTES: Note function that isn't thread-safe
The marking matches glibc marking.

wcsrtombs: MT-Unsafe race:wcsrtombs/!ps

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:28 +02:00
Zeng Linggang 6d4209dec5 wcsnrtombs.3: ATTRIBUTES: Note function that isn't thread-safe
The marking matches glibc marking.

wcsnrtombs: MT-Unsafe race:wcsnrtombs/!ps

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Zeng Linggang bec786289f scanf.3: ATTRIBUTES: Note functions that are thread-safe
The markings match glibc markings.

scanf:   MT-Safe locale
fscanf:  MT-Safe locale
sscanf:  MT-Safe locale
vscanf:  MT-Safe locale
vsscanf: MT-Safe locale
vfscanf: MT-Safe locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Zeng Linggang 9ec9e8274e scandir.3: ATTRIBUTES: Note functions that are thread-safe
The markings match glibc markings.

scandir:     MT-Safe
scandirat:   MT-Safe

alphasort:   MT-Safe locale
versionsort: MT-Safe locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Zeng Linggang 1567901b96 printf.3: ATTRIBUTES: Note functions that are thread-safe
The markings match glibc markings.

printf:    MT-Safe locale
fprintf:   MT-Safe locale
sprintf:   MT-Safe locale
snprintf:  MT-Safe locale
vprintf:   MT-Safe locale
vfprintf:  MT-Safe locale
vsprintf:  MT-Safe locale
vsnprintf: MT-Safe locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Zeng Linggang 80563762a2 perror.3: ATTRIBUTES: Note function that is thread-safe
The marking matches glibc marking.

perror: MT-Safe race:stderr

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Zeng Linggang 03c07cb1e5 mbsrtowcs.3: ATTRIBUTES: Note function that isn't thread-safe
The marking matches glibc marking.

mbsrtowcs: MT-Unsafe race:mbsrtowcs/!ps

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Zeng Linggang adad095fc6 mbsnrtowcs.3: ATTRIBUTES: Note function that isn't thread-safe
The marking matches glibc marking.

mbsnrtowcs: MT-Unsafe race:mbsnrtowcs/!ps

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Zeng Linggang a5047c38da getutent.3: ATTRIBUTES: Note functions that aren't thread-safe
The markings match glibc markings.

getutent:  MT-Unsafe init race:utent race:utentbuf sig:ALRM timer

getutid:   MT-Unsafe init race:utent sig:ALRM timer
getutline: MT-Unsafe init race:utent sig:ALRM timer

pututline: MT-Unsafe race:utent sig:ALRM timer

setutent:  MT-Unsafe race:utent
endutent:  MT-Unsafe race:utent
utmpname:  MT-Unsafe race:utent

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Zeng Linggang 08da409ade get_nprocs_conf.3: ATTRIBUTES: Note functions that are thread-safe
The markings match glibc markings.

get_nprocs:      MT-Safe
get_nprocs_conf: MT-Safe

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Zeng Linggang d476c6315a getnetent.3: ATTRIBUTES: Note functions that aren't thread-safe
The markings match glibc markings.

getnetent:    MT-Unsafe race:netent race:netentbuf env locale

getnetbyname: MT-Unsafe race:netbyname env locale

getnetbyaddr: MT-Unsafe race:netbyaddr locale

setnetent:    MT-Unsafe race:netent env locale
endnetent:    MT-Unsafe race:netent env locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Zeng Linggang c7bd50f134 gethostbyname.3: ATTRIBUTES: Note functions that aren't thread-safe
The markings match glibc markings.

gethostbyname:    MT-Unsafe race:hostbyname env locale

gethostbyaddr:    MT-Unsafe race:hostbyaddr env locale

sethostent:       MT-Unsafe race:hostent env locale
endhostent:       MT-Unsafe race:hostent env locale
gethostent_r:     MT-Unsafe race:hostent env locale

herror:           MT‐Safe
hstrerror:        MT‐Safe

gethostent:       MT-Unsafe race:hostent race:hostentbuf env locale

gethostbyname2:   MT-Unsafe race:hostbyname2 env locale

gethostbyaddr_r:  MT-Safe env locale
gethostbyname_r:  MT-Safe env locale
gethostbyname2_r: MT-Safe env locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Zeng Linggang c8b6813699 ctime.3: ATTRIBUTES: Note functions that aren't thread-safe
The markings match glibc markings.

asctime:     MT-Unsafe race:asctime locale

asctime_r:   MT-Safe locale

ctime:       MT-Unsafe race:tmbuf race:asctime env locale

ctime_r:     MT-Safe env locale
gmtime_r:    MT-Safe env locale
localtime_r: MT-Safe env locale
mktime:      MT-Safe env locale

gmtime:      MT-Unsafe race:tmbuf env locale
localtime:   MT-Unsafe race:tmbuf env locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Zeng Linggang 0f6cf80d74 asprintf.3: ATTRIBUTES: Note functions that are thread-safe
The markings match glibc markings.

asprintf:  MT-Safe locale
vasprintf: MT-Safe locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Ma Shimiao 8716ac0756 ctanh.3: ATTRIBUTES: Note functions that are thread-safe
The markings match glibc markings.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Ma Shimiao 96fb9f0b27 ctan.3: ATTRIBUTES: Note functions that are thread-safe
The markings match glibc markings.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Ma Shimiao 551dcfd58c csqrt.3: ATTRIBUTES: Note functions that are thread-safe
The markings match glibc markings.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Ma Shimiao 31652f0b15 csinh.3: ATTRIBUTES: Note functions that are thread-safe
The markings match glibc markings.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Ma Shimiao 212127d17f csin.3: ATTRIBUTES: Note functions that are thread-safe
Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Ma Shimiao 71557c6da5 cexp.3: ATTRIBUTES: Note functions that are thread-safe
The markings match glibc markings.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Ma Shimiao a597364f3e ccos.3: ATTRIBUTES: Note functions that are thread-safe
The markings match glibc markings.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Michael Kerrisk b981bf291e lseek64.3: Clarify details with respect to 32-bit and 64-bit systems
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Michael Kerrisk 2d5b086a03 lseek64.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Michael Kerrisk 7824ab2333 lseek64.3: wfix
Reported-by: Jonny Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:26 +02:00
William Woodruff 83685d1e91 getcwd.3: ffix - make EINVAL and ENAMETOOLONG bold
Neither EINVAL nor ENAMETOOLONG were bolded in the ERRORS section.

Signed-off-by: William Woodruff <william@tuffbizz.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:26 +02:00
Michael Kerrisk 2b1f1a35b5 getcwd.3: Add kernel version/commit details to Jann Horn's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:55 +02:00
Michael Kerrisk de0dd42776 getcwd.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:55 +02:00
Jann Horn a2ac97c78b getcwd.3: Note behavior for unreachable current working directory
For the code that does this, see fs/dcache.c, search for
"prepend_unreachable".

Test case to demonstrate:

$ cat getcwd.c

int main(void) {
  unshare(CLONE_NEWUSER | CLONE_NEWNS);
  chdir("/usr");
  chroot("bin");

  printf("current directory: \"%s\"\n", get_current_dir_name());

  char *real = realpath(".", NULL);
  printf("realpath of .: \"%s\"\n", real ? real : "{none}");
  real = realpath("../home/jann/.ssh", NULL);
  printf("realpath of path: \"%s\"\n", real ? real : "{none}");

  return 0;
}
$ cat getcwd_test.c

int main(void) {
  unshare(CLONE_NEWUSER | CLONE_NEWNS);
  chdir("/usr");
  chroot("bin");
  printf("current directory: \"%s\"\n", get_current_dir_name());
  return 0;
}
$ gcc -o getcwd_test getcwd_test.c -Wall
$ ./getcwd_test
current directory: "(unreachable)/usr"

realpath.3 doesn't currently seem to handle this
case in a sane way, so I'm not going to document
its behavior yet. I'll report that as a bug instead.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:55 +02:00
Michael Kerrisk c5aee02706 mq_notify.3: Add "C library/kernel ABI differences" subsection
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:54 +02:00
Michael Kerrisk 5eeca37ce1 mq_open.3: NOTES: explain differences from the underlying system call
The check for the slash at the start of a pathname is done in glibc

Reported-by: Fabien Pichot <fpichot@bouledef.eu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:31 +02:00
Michael Kerrisk 1e64c86bbf intro.1, ldd.1, clone.2, getgroups.2, getpid.2, getsockopt.2, ioctl_list.2, msgop.2, open.2, seccomp.2, setgid.2, setresuid.2, setreuid.2, setuid.2, sigaction.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, socket.2, syscall.2, syscalls.2, umount.2, clock.3, dlopen.3, fmemopen.3, fpathconf.3, fputwc.3, fputws.3, fseek.3, fseeko.3, gcvt.3, getline.3, getwchar.3, hypot.3, if_nameindex.3, initgroups.3, popen.3, resolver.3, strcoll.3, strdup.3, tzset.3, ulimit.3, wcstombs.3, wctob.3, xdr.3, console_codes.4, random.4, filesystems.5, host.conf.5, hosts.5, proc.5, resolv.conf.5, securetty.5, credentials.7, feature_test_macros.7, hier.7, ipv6.7, packet.7, pthreads.7, raw.7, signal.7, tcp.7, user_namespaces.7, ld.so.8, ldconfig.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-29 22:30:09 +02:00
Michael Kerrisk 3f1982b218 sigsetops.3: Note treatment of signals used internally by NPTL
The glibc sigfillset() function excludes the two real-time
signals used by NPTL.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-28 23:58:04 +01:00
Michael Kerrisk 59526510f2 pthread_sigqueue.3: Note treatment of signals used internally by NPTL
The glibc pthread_sigqueue() function gives an error on attempts
to send either of the real-time signals used by NPTL.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-28 23:58:04 +01:00
Michael Kerrisk 4ea239b05e pthread_kill.3: Note treatment of signals used internally by NPTL
The glibc pthread_kill() function gives an error on attempts
to send either of the real-time signals used by NPTL.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-28 23:58:04 +01:00
Michael Kerrisk bce38798d0 pthread_sigmask.3: Note treatment of signals used internally by NPTL
The glibc implementation silently ignores attempts to block the two
real-time signals used by NPTL.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-28 23:58:04 +01:00
Michael Kerrisk 4ff3769fff sigwait.3: Note treatment of signals used internally by NPTL
The glibc sigwait() silently ignore attempts to wait for
signals used by NPTL.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-28 23:58:04 +01:00
Michael Kerrisk a7676884c4 printf.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-27 12:21:19 +01:00
Matt Turner 526c53f04b rint.3: Document that halfway cases are rounded to even
Per IEEE-754 rounding rules.

The round(3) page describes the behavior of rint and nearbyint
in the halfway cases by saying:

    These functions round x to the nearest integer, but round
    halfway cases away from zero [...], instead of to the
    nearest even integer like rint(3)

Signed-off-by: Matt Turner <mattst88@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 20:39:44 +01:00
Michael Kerrisk 4e701e41a5 sigsetops.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 19:25:22 +01:00
J William Piggott 4faf9583af tzset.3: Add 'std' quoting information
Signed-off-by: J William Piggott <elseifthen@gmx.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 19:25:22 +01:00
Stéphane Aulery e914e480fe aio_return.3: Document the return value on error
Reported by Alexander Holler <holler@ahsoftware.de>
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 19:25:22 +01:00
Ma Shimiao 498c5acf61 gcvt.3: ATTRIBUTES: Note function that is thread-safe
The marking matches glibc marking.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 19:25:22 +01:00
Ma Shimiao 9eb64fabc9 ulimit.3: ATTRIBUTES: Note function that is thread-safe
The marking matches glibc marking.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 19:25:22 +01:00
Ma Shimiao c49cfc4f32 fmemopen.3: ATTRIBUTES: Note functions that are thread-safe
The markings match glibc markings.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 19:25:21 +01:00
Ma Shimiao 90f1e9c5a8 fpathconf.3: ATTRIBUTES: Note functions that are thread-safe
The marking matches glibc marking.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 19:25:21 +01:00
Ma Shimiao 83613756c8 fputwc.3: ATTRIBUTES: Note functions that are thread-safe
The marking matches glibc marking.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 19:25:21 +01:00
Ma Shimiao 65317e7884 getline.3: ATTRIBUTES: Note functions that are thread-safe
The marking matches glibc marking.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 19:25:21 +01:00
Ma Shimiao 938b70a16b fputws.3: ATTRIBUTES: Note function that is thread-safe
The marking matches glibc marking.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 19:25:21 +01:00
Ma Shimiao 147916a269 if_nameindex.3: ATTRIBUTES: Note functions that are thread-safe
The markings match glibc markings.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 19:25:21 +01:00
Ma Shimiao 9a8b397fd3 iconv_open.3: ATTRIBUTES: Note function that is thread-safe
The marking matches glibc marking.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 19:25:21 +01:00
Ma Shimiao 5baaaa1cdc initgroups.3: ATTRIBUTES: Note function that is thread-safe
The markings match glibc markings.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 19:25:21 +01:00
Michael Kerrisk d7f6957756 sigqueue.3: Clarify version info (mention rt_sigqueueinfo())
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 11:18:17 +01:00
Michael Kerrisk 4fd2f449ca sigqueue.3: NOTES: add "C library/kernel ABI differences" subheading
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 11:18:17 +01:00
Michael Kerrisk b6fe25f722 dlopen.3: RTLD_NEXT works for symbols generally, not just functions
The common use case is for functions, but RTLD_NEXT
also applies to variable symbols.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 08:24:07 +01:00
Michael Kerrisk 99175a5826 dlopen.3: Add some details for RTLD_DEFAULT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 08:24:07 +01:00
Michael Kerrisk 4251757a3a dlopen.3: Add some details on RTLD_NEXT and preloading
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 08:24:07 +01:00
Michael Kerrisk fad3d64efc dlopen.3: Reformat text on RTLD_DEFAULT and RTLD_NEXT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 08:24:02 +01:00
Michael Kerrisk cc2ddf2fd5 dlopen.3: dlclose() recursively closes dependent libraries
Note that dlclose() recursively closes dependent libraries
that were loaded by dlopen()

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-15 09:53:02 +01:00
Michael Kerrisk 4a1af09bd1 dlopen.3: Amend error in description of dlclose() behavior
The current text says that unloading depends on whether
the reference count falls to zero *and no other libraries
are using symbols in this library*. That latter text has
been there since man-pages-1.29, but it seems rather dubious.
How could the implementation know whether other libraries
are still using symbols in this library? Furthermore, no
other implementation's man page mentions this point.
Seems best to drop this point.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-15 09:53:02 +01:00
Michael Kerrisk cf2789f1c2 dlopen.3: Rename second dlopen() argument from "flag" to "flags"
This is more consistent with other such arguments

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-15 09:53:02 +01:00
Stéphane Aulery eb10542fde resolver.3: RES_IGNTC is implemented
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-15 09:51:52 +01:00
Stéphane Aulery ffb9f8b3df resolver.3: Document missing options used by _res structure indicate defaults
Missing options: RES_INSECURE1, RES_INSECURE2, RES_NOALIASES,
USE_INET6, ROTATE, NOCHECKNAME, RES_KEEPTSIG, BLAST, USEBSTRING,
NOIP6DOTINT, USE_EDNS0, SNGLKUP, SNGLKUPREOP, RES_USE_DNSSEC,
NOTLDQUERY, DEFAULT

Written from the glibc source and resolv.conf.5.

See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=527136

Reported-by: Jakub Wilk <ubanus@users.sf.net>
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-10 08:18:49 +01:00