Commit Graph

3703 Commits

Author SHA1 Message Date
Christoph Hellwig 350fcda8d7 fts.3: The fts(3) does not work with LFS builds
As pointed out during a recent discussion on libc-hacker the
fts(3) APIs can't be used with large file offsets:

    https://sourceware.org/bugzilla/show_bug.cgi?id=15838

Signed-off-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 12:37:18 +01:00
Michael Kerrisk 3b7aa6b116 cacosh.3: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-17 08:46:34 +01:00
Michael Kerrisk e9f22b0ac0 Removed trailing white space at end of lines 2014-03-11 22:33:19 +01:00
Michael Kerrisk 4ab0a73af9 gethostbyname.3: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 22:33:01 +01:00
Michael Kerrisk 9ac2ee45bb qecvt.3: Recommend snprintf(3) not sprintf(3)
Reported-by: Joseph S. Myers <joseph@codesourcery.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 22:32:14 +01:00
Michael Kerrisk bb49fd9492 gethostbyname.3: Remove redundant FTM requirements
_GNU_SOURCE implies _SVID_SOURCE and _BSD_SOURCE, so

    _BSD_SOURCE || _SVID_SOURCE || _GNU_SOURCE

is the same as

    _BSD_SOURCE || _SVID_SOURCE

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 07:29:33 +01:00
Peng Haitao daecb330df memchr.3: ATTRIBUTES: Note functions that are thread-safe
The functions memchr(), memrchr() and rawmemchr() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:09:22 +01:00
Peng Haitao a69b2a64f1 memccpy.3: ATTRIBUTES: Note function that is thread-safe
The function memccpy() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:09:14 +01:00
Peng Haitao 3e722e9e75 raise.3: ATTRIBUTES: Note function that is thread-safe
The function raise() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:09:08 +01:00
Peng Haitao aaff622e8c remove.3: ATTRIBUTES: Note function that is thread-safe
The function remove() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:09:01 +01:00
Peng Haitao 24bd2288e4 sem_init.3: ATTRIBUTES: Note function that is thread-safe
The function sem_init() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:06:58 +01:00
Michael Kerrisk 392a12b215 getutmp.3: SEE ALSO: add utmpdump(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
Peng Haitao 044738b4b0 sem_getvalue.3: ATTRIBUTES: Note function that is thread-safe
The function sem_getvalue() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
Peng Haitao 4ef41a4117 sem_destroy.3: ATTRIBUTES: Note function that is thread-safe
The function sem_destroy() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
Michael Kerrisk 3f89ae779f strcpy.3: Fix a bug, and improve discussion of forcing termination with strncpy()
Reported-by: Rick Stanley <rstanley@rsiny.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:50 +01:00
Simon Paillard fa16a05de3 crypt.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-03 05:50:54 +01:00
Peng Haitao d05cb848ba log1p.3: ATTRIBUTES: Note functions that are thread-safe
The functions log1p(), log1pf() and log1pl() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-02 07:21:28 +01:00
Peng Haitao 31d47454db logb.3: ATTRIBUTES: Note functions that are thread-safe
The functions logb(), logbf() and logbl() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-02 07:21:14 +01:00
Peng Haitao 662c4b2ab4 sockatmark.3: ATTRIBUTES: Note function that is thread-safe
The function sockatmark() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-02 07:21:01 +01:00
Peng Haitao 6e16c20399 strspn.3: ATTRIBUTES: Note functions that are thread-safe
The functions strspn() and strcspn() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-02 07:20:44 +01:00
Peng Haitao 21b4924075 strcpy.3: ATTRIBUTES: Note functions that are thread-safe
The functions strcpy() and strncpy() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-02 07:20:18 +01:00
Michael Kerrisk 3fd22afaaa mktemp.3: Make warning not to use this function more prominent
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-27 15:40:14 +01:00
Michael Kerrisk fa90334dcb tmpnam.3: Recommend use mkstemp(3) or tmpfile(3) instead
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-27 15:38:33 +01:00
Michael Kerrisk 47ce47ea89 tempnam.3: Make warning not to use this function more prominent
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-27 15:34:49 +01:00
Michael Kerrisk 778fcac982 getifaddrs.3, iswctype.3, sem_post.3, sem_unlink.3, sem_wait.3, packet.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 18:29:17 +01:00
Michael Kerrisk 17b028d622 crypt.3: ERRORS: Add EINVAL and EPERM errors
See https://bugzilla.kernel.org/show_bug.cgi?id=69771

Cowritten-by: KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:43:00 +01:00
Peng Haitao 99c2f1a20f strpbrk.3: ATTRIBUTES: Note function that is thread-safe
The function strpbrk() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:43:00 +01:00
Peng Haitao 0f5df2aa8c strnlen.3: ATTRIBUTES: Note function that is thread-safe
The function strnlen() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:43:00 +01:00
Peng Haitao be5d0c873e strlen.3: ATTRIBUTES: Note function that is thread-safe
The function strlen() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:43:00 +01:00
Peng Haitao 178c91f42a strsep.3: ATTRIBUTES: Note function that is thread-safe
The function strsep() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:43:00 +01:00
Peng Haitao 4cdb057777 swab.3: ATTRIBUTES: Note function that is thread-safe
The function swab() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:43:00 +01:00
Simon Paillard d0aa87206d scandir.3: tfix
Introduced in cadd38ba

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:43:00 +01:00
Michael Kerrisk 83a1c50ffe getifaddrs.3: Enhance example program
Print statistics for AF_PACKET interfaces.
Add missing feature test macro definition.
Reformat output.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:43:00 +01:00
Peng Haitao cd78e7f29b setbuf.3: ATTRIBUTES: Note functions that are thread-safe
The functions setbuf(), setbuffer(), setlinebuf() and setvbuf()
are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:42:59 +01:00
Peng Haitao ef0a5e7333 sem_unlink.3: ATTRIBUTES: Note function that is thread-safe
The function sem_unlink() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:42:59 +01:00
Peng Haitao 498b329f7d sem_wait.3: ATTRIBUTES: Note functions that are thread-safe
The functions sem_wait(), sem_trywait() and sem_timedwait() are
thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:42:59 +01:00
Peng Haitao c27b616f65 sem_post.3: ATTRIBUTES: Note function that is thread-safe
The function sem_post() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:42:59 +01:00
Peng Haitao 07ddb3aebb iswctype.3: ATTRIBUTES: Note function that is thread-safe
The function iswctype() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:42:59 +01:00
Michael Kerrisk cadd38ba1b access.2, chmod.2, chown.2, link.2, mkdir.2, open.2, readlink.2, rename.2, stat.2, symlink.2, unlink.2, mkfifo.3, scandir.3: Minor fix: remove section numbers in references to functions inside page
With the page merges, we now have some references to functions
within the page that have section numbers. Remove those.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:52:53 +01:00
Michael Kerrisk 1548b9a4b1 mkfifoat.3: Convert to link to mkfifo.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:52:53 +01:00
Michael Kerrisk 94810bd7a6 mkfifo.3: tfix: s/mknod/mknodat/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:52:53 +01:00
Michael Kerrisk 64b7542e54 mkfifo.3: CONFORMING TO: mkfifo() is in POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:52:53 +01:00
Michael Kerrisk 464bbf04de mkfifo.3: Merge text of mkfifoat(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:52:53 +01:00
Michael Kerrisk 586792e86e scandirat.3: Convert to link to scandir.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:52:53 +01:00
Michael Kerrisk 4046f0e0fe scandir.3: Remove libc4/libc5note under CONFORMING TO
No-one much cares about Linux libc these days.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:52:53 +01:00
Michael Kerrisk 6f695bc0dd scandir.3: Put detail about alphasort under a NOTES heading
This text was under CONFORMING TO, which made no sense.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:52:53 +01:00
Michael Kerrisk b86e869fe0 scandir.3: Rework CONFORMING TO text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:52:53 +01:00
Michael Kerrisk 668676b082 scandir.3: Remove repetitious text in CONFORMING TO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:52:48 +01:00
Michael Kerrisk 78e3b45859 scandir.3: wfix: scandirat() is a library function, not a system call
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:41:05 +01:00
Michael Kerrisk ef097103d1 scandir.3: Merge text of scandirat(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:41:05 +01:00
Michael Kerrisk 4a8961c3d5 scandir.3: Update feature test macro requirements
The FTM requirements changed in glibc 2.10.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-20 10:17:41 +01:00
Michael Kerrisk 2e5a86ddf2 sigvec.3: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-18 14:16:06 +01:00
Michael Kerrisk cce74b269c intro.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-16 10:09:02 +01:00
Simon Paillard f781a5b1be endian.3: ffix
ffd4dec0f7 and
7a9d6ddece fix were not the appropriate
ones.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-16 10:09:02 +01:00
Michael Kerrisk 7100862185 sigvec.3: Fix error in code snippet
s/sigpause/sigmask/

Reported-by: Kalle Olavi Niemitalo <kon@iki.fi>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-16 10:09:02 +01:00
Michael Kerrisk e00c3a0754 close.2, getdomainname.2, getrlimit.2, madvise.2, sysinfo.2, umask.2, encrypt.3, fclose.3, fflush.3, lockf.3, rand.3, strtok.3, toupper.3, updwtmp.3, utmp.5, environ.7, hier.7, suffixes.7: Convert pages contain non-ASCII in source code comments to use UTF-8
Done using a slightly modified version of Peter Schiffer's
convert_to_utf_8.sh script. The script was modified so as *not*
a "coding:" marker to the groff source. For now, we'll only put
that marker on pages that contain non-ASCII characters in the
rendered text.

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

Reported-by: Weizhou Pan <cs.wzpan@gmail.com>
Co-written-by: Peter Schiffer <pschiffe@redhat.com
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-16 08:21:18 +01:00
Michael Kerrisk 7a9d6ddece Removed trailing white space at end of lines 2014-02-11 12:17:35 +01:00
Michael Kerrisk 3bab9a5117 gettid.2, restart_syscall.2, lockf.3, passwd.5, socket.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-11 11:43:48 +01:00
Peng Haitao 65126e6141 iswcntrl.3: ATTRIBUTES: Note function that is thread safe with exceptions
The function iswcntrl() is thread safe with exceptions.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 11:06:49 +01:00
Peng Haitao 314be66b03 iswblank.3: ATTRIBUTES: Note function that is thread safe with exceptions
The function iswblank() is thread safe with exceptions.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 11:06:20 +01:00
Michael Kerrisk ffd4dec0f7 perf_event_open.2, endian.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 11:03:45 +01:00
Michael Kerrisk 8ac89fb6a6 string.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 10:16:23 +01:00
Michael Kerrisk 0e88a19ef0 basename.3: srcfix
Fix diagnostic from:

    groff -Tascii -wmac -mman

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 09:43:15 +01:00
Michael Kerrisk 0ae31c567c init_module.2, kcmp.2, getutent.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 09:34:32 +01:00
Michael Kerrisk 42069c2bd7 clone.2, pthread_attr_setstack.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 09:13:21 +01:00
Michael Kerrisk d067764a99 pthread_cancel.3, string.3, cpuset.7, tcp.7: ffix (mark up page xfrefs using .BR, not .IR)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 08:32:33 +01:00
Simon Paillard 7f4cd55dad ffix: add space between function and () if BR or IR
Detected through the regex:
	git grep -P '^\.(BR|IR) [\w]*\([\d]*\)$'

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 08:03:16 +01:00
Simon Paillard c367cd59b1 ffix: add space between word and punctuation if BR or IR
Detected through the regex:
	git grep -P '^\.(BR|IR) [^ ]*[,\.]$'

Could probably be extended to match more cases and fix in perl.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 08:00:35 +01:00
Michael Kerrisk de76dacfda lockf.3: Fix incorrect argument mentioned under EINVAL error
Reported-by: Simone Piccardi <piccardi@truelite.it>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-07 14:38:33 +01:00
Michael Kerrisk a797afac4e fcntl.2, msgget.2, ptrace.2, request_key.2, shmget.2, sigaction.2, syscalls.2, dbopen.3, euidaccess.3, getgrnam.3, getpwnam.3, strfmon.3, strtol.3, strtoul.3, cciss.4, hpsa.4, mouse.4, termcap.5, charsets.7, iso_8859-16.7, iso_8859-2.7, koi8-r.7, unicode.7, utf-8.7: Use Oxford comma
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-05 16:09:11 +01:00
Michael Kerrisk dec985f92c create_module.2, inotify_add_watch.2, mmap2.2, spu_run.2, aio_fsync.3, aio_read.3, aio_write.3, getnameinfo.3, getutent.3, tty_ioctl.4: grfix (Add a comma)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-04 14:42:17 +01:00
Michael Kerrisk 23261f305b pthread_kill.3, pthread_sigmask.3: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-04 13:52:11 +01:00
Michael Kerrisk c5b2fa15ed mkfifoat.3: s/system call/function/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-04 13:51:21 +01:00
Michael Kerrisk fc1d1e69ed pthread_sigmask.3: Add feature test macro requirements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-04 13:25:42 +01:00
Michael Kerrisk d488abd613 pthread_kill.3: Add feature test macro requirements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-04 13:24:08 +01:00
Michael Kerrisk 99878f2714 pthread_kill.3: Revert "pthread_kill.3: Inclusion of pthread.h instead of signal.h"
This reverts the erroneous commit fe541ffe54.
2014-02-04 12:39:11 +01:00
Ola Olsson fe541ffe54 pthread_kill.3: Inclusion of pthread.h instead of signal.h
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-04 10:10:48 +01:00
David Prévot 5d4708c3b0 getauxval.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-04 09:07:40 +01:00
David Prévot a896b35336 setjmp.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-30 09:12:20 +01:00
Peng Haitao 79ea169903 iswalpha.3: ATTRIBUTES: Note function that is thread safe with exceptions
The function iswalpha() 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-29 13:51:22 +01:00
Peng Haitao 0c3ad9eac2 iswalnum.3: ATTRIBUTES: Note function that is thread safe with exceptions
The function iswalnum() 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-29 13:51:21 +01:00
Peng Haitao dd733b11fb isgreater.3: ATTRIBUTES: Note macros that are thread-safe
The macros isgreater(), isgreaterequal(), isless(),
islessequal(), islessgreater() and isunordered() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-29 13:51:21 +01:00
Peng Haitao 8532fe6441 isatty.3: ATTRIBUTES: Note function that is thread-safe
The function isatty() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-29 13:51:21 +01:00
Peng Haitao f2eb5b9c83 isalpha.3: ATTRIBUTES: Note functions that are thread-safe
The functions isalnum(), isalpha(), isascii(), isblank(),
iscntrl(), isdigit(), isgraph(), islower(), isprint(),
ispunct(), isspace(), isupper() and isxdigit() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-29 13:51:21 +01:00
Peng Haitao 232ea96ea7 strtoul.3: ATTRIBUTES: Note functions that are thread safe with exceptions
The functions strtoul(), strtoull() and strtouq() are thread safe
with exceptions.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-29 13:51:21 +01:00
Michael Kerrisk edcf162e3f perf_event_open.2, printf.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-29 13:51:21 +01:00
Michael Kerrisk add5f3b10b epoll_wait.2, fallocate.2, gets.3, core.5, man-pages.7, netdevice.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-24 12:05:49 +01:00
Peng Haitao ca74032e89 strtol.3: ATTRIBUTES: Note functions that are thread safe with exceptions
The functions strtol(), strtoll() and strtoq() are thread safe
with exceptions.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-24 11:13:48 +01:00
Peng Haitao e4ecdf3614 atof.3, atoi.3, strstr.3, strtod.3, toupper.3, towlower.3, towupper.3, wcscasecmp.3, wcsncasecmp.3, wcstoimax.3, wcswidth.3, wctrans.3, wctype.3, wcwidth.3: Make wording around thread-safety and setlocale() more precise
Reported-by: Andre Majorel <aym-xunil@teaser.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-23 16:06:27 +01:00
Peng Haitao 88576984f2 strtoimax.3: ATTRIBUTES: Note functions that are thread safe with exceptions
The functions strtoimax() and strtoumax() are thread safe with
exceptions.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-23 16:06:27 +01:00
Simon Paillard 7d4d1f8a33 pthread_setname_np.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-21 07:17:32 +01:00
Peng Haitao 89a0ffe3fa strtod.3: ATTRIBUTES: Note functions that are thread safe with exceptions
The functions strtod(), strtof() and strtold() are thread safe
with exceptions.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-20 13:22:52 +01:00
Peng Haitao b5afa8086f strcmp.3: ATTRIBUTES: Note functions that are thread-safe
The functions strcmp() and strncmp() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-20 13:22:21 +01:00
Peng Haitao 5745405b63 strchr.3: ATTRIBUTES: Note functions that are thread-safe
The functions strchr(), strrchr() and strchrnul() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-20 13:22:05 +01:00
Peng Haitao 9a55cdebde strcat.3: ATTRIBUTES: Note functions that are thread-safe
The functions strcat() and strncat() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-20 13:21:55 +01:00
Michael Kerrisk f78ed33a65 madvise.2, perf_event_open.2, query_module.2, stat.2, sem_init.3, hpsa.4, rtc.4, st.4, elf.5, filesystems.5, proc.5, environ.7, man-pages.7, regex.7, units.7: Reword to avoid use of "etc."
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-18 23:58:39 +13:00
Michael Kerrisk 14d7071359 lround.3, proc.5: Reword to avoid use of "etc." 2014-01-18 23:58:12 +13:00
Michael Kerrisk 8001742129 y0.3: Reword to avoid clumsy use of "etc."
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-18 23:56:55 +13:00
Michael Kerrisk 6f9ea7787e lrint.3: Reword to avoid clumsy use of "etc."
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-18 23:51:48 +13:00
Michael Kerrisk 853a2abafe lgamma.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 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