Commit Graph

3503 Commits

Author SHA1 Message Date
Michael Kerrisk 4e0344e4a2 j0.3: Reword to avoid clumsy use of "etc."
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-18 23:50:32 +13:00
Michael Kerrisk c1234a3ba5 mq_receive.3, mq_send.3: SYNOPSIS: s/unsigned/unsigned int/
Reported-by: Simone Piccardi <piccardi@truelite.it>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-18 23:50:32 +13:00
Michael Kerrisk 85908442e0 rand.3: s/unsigned/unsigned int/ in example
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-18 23:50:32 +13:00
Michael Kerrisk 5a6194a405 execve.2, get_robust_list.2, getunwind.2, pipe.2, quotactl.2, clock_getcpuclockid.3, endian.3, fmemopen.3, getgrouplist.3, getservent_r.3, mq_notify.3, qsort.3, rtime.3, mailaddr.7: ffix: replace tabs with white space in code examples
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-18 20:47:47 +13:00
Michael Kerrisk b458e1bfa7 getdate.3, strptime.3, locale.5: Replace "weekday" with less ambiguous language
Notwithstanding POSIX's use of the term "weekday", in everyday
English, "weekday" is commonly understood to mean a day in the
set [Monday..Friday] (vs one of the "weekend" days).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-17 21:08:16 +13:00
Brandon Edens 32afd19741 strftime.3: Change "week day" to "day of week"
See https://bugzilla.kernel.org/show_bug.cgi?id=68861

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-17 20:59:04 +13:00
Michael Kerrisk bc9d68d53e printf.3: Samll reorganization of text in EXAMPLE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-17 20:46:49 +13:00
Michael Kerrisk f76e404e3d ferror.3: CONFORMING TO: add fileno()
Reported-by: Reuben Thomas <rrt@sc3d.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-16 17:12:57 +13:00
Michael Kerrisk 28d286ed66 ferror.3: clearerr(), feof(), and ferror() are also POSIX-conformant
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-16 17:06:32 +13:00
Michael Kerrisk 23c9c56419 dlopen.3: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-16 12:43:53 +13:00
Peng Haitao d51899bba0 strstr.3: ATTRIBUTES: Note function that is thread safe with exceptions
The function strstr() is thread safe.
The function strcasestr() is thread safe with exceptions.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-16 12:16:20 +13:00
Yuri Kozlov fac55da599 recno.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-15 17:17:55 +13:00
Yuri Kozlov cd4e22e8b7 recno.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-15 17:16:44 +13:00
Ian Abbott e0368396c0 gets.3: SEE ALSO: add fgets(3)
Signed-off-by: Ian Abbott <abbotti@mev.co.uk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-15 17:13:13 +13:00
Michael Kerrisk ca5d006fec wcpncpy.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-13 21:49:49 +13:00
Michael Kerrisk d75efe7376 wcstombs.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-13 21:48:03 +13:00
Michael Kerrisk 4bd05f8fe0 wcsncpy.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-13 21:47:45 +13:00
Michael Kerrisk 05766b0234 mbstowcs.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-13 21:47:35 +13:00
Peng Haitao 61a70efcfc mq_receive.3: tfix
Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-13 21:41:33 +13:00
Peng Haitao f27f40b7e8 stpncpy.3: ATTRIBUTES: Note function that is thread-safe
The function stpncpy() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-13 21:41:09 +13:00
Peng Haitao 1a10d985a1 stpcpy.3: ATTRIBUTES: Note function that is thread-safe
The function stpcpy() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-13 21:41:05 +13:00
Peng Haitao 87a77f93a8 tcgetsid.3: ATTRIBUTES: Note function that is thread-safe
The function tcgetsid() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-13 21:40:59 +13:00
Peng Haitao 8f9d0619d3 tcgetpgrp.3: ATTRIBUTES: Note functions that are thread-safe
The functions tcgetpgrp() and tcsetpgrp() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-13 21:40:53 +13:00
Peng Haitao 0d2eda1a16 stpncpy.3: wfix
Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-13 21:40:45 +13:00
Michael Kerrisk d7f093e95d gets.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-12 06:22:31 +13:00
Michael Kerrisk d35326474f Removed trailing white space at end of lines 2014-01-11 08:04:54 +13:00
Michael Kerrisk babc6dd47b syscall.2, syscalls.2, ftw.3, getauxval.3, mcheck.3, puts.3, scanf.3, strftime.3, libc.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-11 06:44:42 +13:00
Michael Kerrisk f14ae16e57 accept.2, clock_getres.2, mkdir.2, request_key.2, wait.2, printf.3, bootparam.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-11 06:25:02 +13:00
Michael Kerrisk 76c637e18c getcpu.2, getunwind.2, kcmp.2, mmap.2, perf_event_open.2, perfmonctl.2, quotactl.2, restart_syscall.2, btree.3, dbopen.3, hash.3, recno.3, sched_getcpu.3, elf.5, bootparam.7, hier.7, netdevice.7, rtnetlink.7: wfix: "xxxx specific" ==> "xxxx-specific" 2014-01-11 06:16:28 +13:00
Michael Kerrisk f2cc5c88c2 pthread_setname_np.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-11 06:06:57 +13:00
Michael Kerrisk 6d42f0dc9c dlopen.3: Fix description of dli_sname
See https://sourceware.org/bugzilla/show_bug.cgi?id=16262

Reported-by: Stephen Kell <srk31@srcf.ucam.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-08 14:07:34 +13:00
Michael Kerrisk d72a31c6f0 adjtime.3, getw.3: srcfix: Start new sentence on new source line
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-08 13:54:41 +13:00
Michael Kerrisk dbb73b9a3d setjmp.3: BSD setjmp() semantics go away in glibc 2.19
Reviewed-by: Joseph S. Myers <joseph@codesourcery.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-08 12:14:21 +13:00
Michael Kerrisk 0588c9a30f sigpause.3: BSD sigpause() goes away in glibc 2.19
Reviewed-by: Joseph S. Myers <joseph@codesourcery.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-08 12:14:21 +13:00
Michael Kerrisk 38029932e7 sigpause.3: Correct feature text macro requirements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-08 12:14:14 +13:00
Michael Kerrisk b60327309b scanf.3: Improve discussion of obsolete 'a' dynamic allocation modifier
Reported-by: Ondřej Bílka <neleai@seznam.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-08 11:57:45 +13:00
Michael Kerrisk ac16fdff8a getline.3: Correct description of how '*n' is used when '*lineptr' == NULL
See https://sourceware.org/bugzilla/show_bug.cgi?id=5468

Reported-by: Luke Hutchison <luke.hutch@mit.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-08 10:02:50 +13:00
Peng Haitao 38d62724b2 tanh.3: ATTRIBUTES: Note functions that are thread-safe
The functions tanh(), tanhf() and tanhl() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-07 22:42:44 +13:00
Peng Haitao 7501f871fd tan.3: ATTRIBUTES: Note functions that are thread-safe
The functions tan(), tanf() and tanl() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-07 00:48:47 +13:00
Peng Haitao 2b2d07c0c7 sysv_signal.3: ATTRIBUTES: Note function that is thread-safe
The function sysv_signal() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-07 00:48:40 +13:00
Peng Haitao c15158e2e8 towupper.3: ATTRIBUTES: Note function that is thread safe with exceptions
The function towupper() is thread safe with exceptions.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-07 00:48:33 +13:00
Peng Haitao 1c9b2a60ff towlower.3: ATTRIBUTES: Note function that is thread safe with exceptions
The function towlower() is thread safe with exceptions.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-07 00:48:24 +13:00
Michael Kerrisk 7020f14d3e regex.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-07 00:47:47 +13:00
Yuri Kozlov 75cd78ea10 regex.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-07 00:47:15 +13:00
Michael Kerrisk 476d2ddea6 getauxval.3: Added FIXME for AT_HWCAP2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-06 19:40:30 +13:00
Michael Kerrisk 3487d63b4c dlopen.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 14:59:13 +13:00
Michael Kerrisk f7a6a3b42b pthread_getcpuclockid.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 13:30:44 +13:00
Michael Kerrisk 68ed9d7228 if_nameindex.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 13:30:41 +13:00
Michael Kerrisk f30b741526 chown.2, clone.2, mmap.2, pipe.2, ftw.3, mq_notify.3: Add "Program source" subheading under EXAMPLE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 13:30:41 +13:00
Michael Kerrisk 3d6efadb2c rtime.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 13:22:12 +13:00
Michael Kerrisk 2ba8b63e9f hsearch.3: Add "static" to global variable in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 13:20:09 +13:00
Michael Kerrisk 57b1aaa4a7 getsubopt.3: ffix (K&R style in example program)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 13:19:04 +13:00
Michael Kerrisk 0d89715efc tsearch.3: Add "static" to global variables and functions in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 13:08:57 +13:00
Michael Kerrisk 94daa6cf33 strftime.3: Add "Program source" subsection heading
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 13:07:30 +13:00
Michael Kerrisk 722d8902ef stpcpy.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 13:06:45 +13:00
Michael Kerrisk 5c91a6243a rtime.3: Add "static" qualifier to global variable in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 13:04:30 +13:00
Michael Kerrisk 872127dd8d rtime.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 13:03:27 +13:00
Michael Kerrisk 65b1e0ed19 strstr.3: Clarify RETURN VALUE: s/substring/located substring/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 00:34:01 +13:00
Michael Kerrisk 4d9fbd4e6e strsep.3: Clarify description
The use of "symbols" in the existing description is confusing;
it's "bytes". Other fixes as well.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 00:34:01 +13:00
Michael Kerrisk dd827c27b0 string.3: Fixes and enhancements to Moritz Str?be's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 00:34:01 +13:00
Moritz 'Morty' Strübe 0612e12ee7 string.3: Add short description of the functions
It is helpful to have a short description about what the different
functions in string.h do.

Signed-off-by: Moritz 'Morty' Strübe <morty@gmx.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-04 23:20:02 +13:00
Michael Kerrisk b437fdd90a epoll_ctl.2, execve.2, recv.2, timer_create.2, wait.2, argz_add.3, basename.3, dlopen.3, exec.3, fopencookie.3, fts.3, getaddrinfo.3, getcwd.3, gethostbyname.3, getifaddrs.3, getipnodebyname.3, getlogin.3, getnetent.3, getprotoent.3, getrpcent.3, getservent.3, getusershell.3, glob.3, if_nameindex.3, inet_ntop.3, lio_listio.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mq_notify.3, ptsname.3, realpath.3, setnetgrent.3, sigvec.3, strsignal.3, strtok.3, wcrtomb.3, wcsnrtombs.3, wcsrtombs.3, wcstombs.3, xdr.3: Global fix of "NULL pointer"
Change "NULL pointer: to "NUL " or null pointer".
POSIX uses the term "null pointer", not "NULL pointer".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 15:47:06 +13:00
Michael Kerrisk efb12489de exec.3, fts.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 15:47:06 +13:00
Michael Kerrisk 03407e3388 termios.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 15:47:05 +13:00
Michael Kerrisk 246414a67a mtrace.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 15:47:05 +13:00
Michael Kerrisk 3a935ca8a4 fts.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 15:47:05 +13:00
Michael Kerrisk fa797358b5 INFINITY.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 10:29:37 +13:00
Michael Kerrisk 1b0892e8c3 mallopt.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 10:16:54 +13:00
Michael Kerrisk 4318a7d0f5 dlopen.3: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 09:58:37 +13:00
Michael Kerrisk 5e0622bad2 dlopen.3: srcfix: add a reference to Austin "Pointer Types" issue
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 23:14:28 +13:00
Michael Kerrisk daf28a2b22 dlopen.3: Tweaks to previous patch
Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 22:34:20 +13:00
Michael Kerrisk 299653455f dlopen.3: Update remarks on cast needed when assigning dlsym() return value
POSIX.1-2013 eases life when casting the dlsym() return value to a
function pointer

Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 14:42:09 +13:00
Mike Frysinger 951ae9c063 syscall.2, syscalls.2, getauxval.3: Add references to new vdso(7) page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk 10850212d0 uselib.2, getfsent.3, regex.3, nsswitch.conf.5, inotify.7, man-pages.7, symlink.7: Replace uses of "e.g." in main text with "for example" or similar
Usual man-pages style is to use "e.g." only within
    parenthetical expressions.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk 88879aebdd eventfd.2, set_mempolicy.2, timerfd_create.2, fwide.3, resolver.3, spufs.7, symlink.7, udplite.7, unicode.7: Replace uses of "i.e.," in main text with "that is" or similar
Usual man-pages style is to use "i.e." only within
parenthetical expressions.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk 5aecfe9017 puts.3: SEE ALSO: replace reference to gets(3) with fgets(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk d098e934d0 getline.3: Remove SEE ALSO reference to unsafe gets(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk d4df4e8ad4 fgetc.3: Minor fix to ordering in SEE ALSO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk 7e2b0db30f gets.3: Tweaks to David Malcolm's patch
Reported-by: Andre Majorel <aym-xunil@teaser.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk a5539262a5 gets.3: Tweaks to David Malcolm's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk 42818f2072 fgetc.3, gets.3: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk 845f05b519 fgets.3, getc.3, getchar.3, ungetc.3: Adjust links to gets(3) to point to fgetc(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
David Malcolm beef277092 fgetc.3, gets.3: Split gets(3) to isolate unsafe gets(3) to a page on its own
Currently man3/gets.3 documents various safe I/O functions, along
with the toxic "gets" function.

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

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

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

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

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk 8a7ac774ba strspn.3: Improve description in NAME
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=723659

Reported-by: Mathieu Malaterre <malat@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Michael Kerrisk aefd6f899d select_tut.2, dlopen.3, err.3, printf.3: Stylistic changes to code example
For ease of reading, don't embed assignments inside if().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Michael Kerrisk b0e6462a0b printf.3: Fix memory link in snprintf() example
See http://stackoverflow.com/questions/19933479/snprintf-man-page-example-memory-leak

Reported-by: Arif Zaman <arifz@lums.edu.pk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Michael Kerrisk 213d25801a ctime.3: grfix: add some commas
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Michael Kerrisk 3dd08d1d72 strptime.3: grfix: add some commas
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Michael Kerrisk 77f48c37e0 strptime.3: Some rewording and reorganization
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Michael Kerrisk 652d08e1fd strptime.3: Point to ctime(3) for more details on 'tm' structure
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Michael Kerrisk 290bb720cd strptime.3: Add number ranges to comments in 'tm' structure
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=729570

Reported-by: Mathieu Malaterre <malat@debian.org>
Reported-by: Simon Paillard <spaillard@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Michael Kerrisk 0566afc5af pthread_kill.3: POSIX.1-2008 removes ESRCH
POSIX.1-2001 mistakenly documented an ESRCH error, and
POSIX.1-2008 removes this error. Glibc does return
this error in cases where it can determine that a thread ID
is invalid, but equally, the use of an invalid thread ID
can cause a segmentation fault.

See http://thread.gmane.org/gmane.comp.lib.glibc.alpha/35598
Subject: Race and segmentation fault in pthread_kill() vs thread teardown
Newsgroups: gmane.comp.lib.glibc.alpha
Date: 2013-10-02 04:06:04 GMT

See http://udrepper.livejournal.com/16844.html

Reported-by: Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Shawn Landden e8785f3de4 cmsg.3: tfix: be not --> not be
Signed-off-by: Shawn Landden <shawn@churchofgit.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Michael Kerrisk b87b8bd088 mkstemp.3: Better describe 'flags' that can be specified for mkostemp()
As reported by Janne Blomqvist:

currently the man page for mkostemp/mkostemps says:

    The mkostemp() function is like mkstemp(), with the
    difference that flags as for open(2) may be specified
    in flags (e.g., O_APPEND, O_SYNC).

To be more precise, the implementation massages the flags argument
as follows:

(flags & ~O_ACCMODE) | O_RDWR | O_CREAT | O_EXCL

That is, there is no need to explicitly include O_RDWR | O_CREAT |
O_EXCL in flags, as it's added implicitly.

So I suggest that the manpage should instead state that
*additional* flags may be specified in the flags argument.

This issue is a potential portability problem. FreeBSD 10+ also
has mkostemp{s}, but generates an error if O_RDWR | O_CREAT |
O_EXCL is present instead of silently accepting it. While
annoying, this difference in behavior seems Ok by the proposed
addition of mkostemp to some future POSIX standard, see

http://austingroupbugs.net/view.php?id=411

    The mkostemp() function shall be equivalent to the mkstemp()
    function, except that the flag argument may contain
    additional flags (from <fcntl.h>) to be used as if by open().
    Behavior is unspecified if the flag argument contains more
    than the following flags:

    O_APPEND Set append mode.

    O_CLOEXEC Set the FD_CLOEXEC file descriptor flag.

    <SIO>O_DSYNC Write according to the synchronized I/O data
    integrity completion.</SIO>

    <SIO>O_RSYNC Synchronized read I/O operations.</SIO>

    <XSI|SIO>O_SYNC Write according to synchronized I/O file
    integrity completion.</XSI|SIO>

Reported-by: Janne Blomqvist <blomqvist.janne@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Peng Haitao 8cceed6998 sin.3: ATTRIBUTES: Note functions that are thread-safe
The functions sin(), sinf() and sinl() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:14 +13:00
Peng Haitao 598a7a2d14 sigwait.3: ATTRIBUTES: Note function that is thread-safe
The function sigwait() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:14 +13:00
Peng Haitao 19d5bec94f sigqueue.3: ATTRIBUTES: Note function that is thread-safe
The function sigqueue() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:14 +13:00
Peng Haitao 9840d4da1e sigpause.3: ATTRIBUTES: Note function that is thread-safe
The function sigpause() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:14 +13:00
Peng Haitao 31c861cf30 wcpncpy.3: ATTRIBUTES: Note function that is thread-safe
The function wcpncpy() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:14 +13:00
David Prévot 8fec36298f ftw.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:14 +13:00