Commit Graph

13954 Commits

Author SHA1 Message Date
Zeng Linggang 9927122be4 getservent.3: ATTRIBUTES: Note functions that aren't thread-safe
The marking matches glibc marking.
markings of functions in glibc are:
- getservent:    MT-Unsafe race:servent race:serventbuf locale

- getservbyname: MT-Unsafe race:servbyname locale

- getservbyport: MT-Unsafe race:servbyport locale

- setservent:    MT-Unsafe race:servent locale
- endservent:    MT-Unsafe race:servent locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 21:26:45 +02:00
Zeng Linggang bd1725063f getrpcport.3: ATTRIBUTES: Note function that is thread-safe
After research, We think getrpcport() is thread-safe. But, there
is not marking of getrpcport() in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 21:26:25 +02:00
Zeng Linggang 18813d7b52 getprotoent.3: ATTRIBUTES: Note functions that aren't thread-safe
The marking matches glibc marking.
markings of functions in glibc are:
- getprotoent:      MT-Unsafe race:protoent race:protoentbuf locale

- getprotobyname:   MT-Unsafe race:protobyname locale

- getprotobynumber: MT-Unsafe race:protobynumber locale

- setprotoent:      MT-Unsafe race:protoent locale
- endprotoent:      MT-Unsafe race:protoent locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 21:26:17 +02:00
Zeng Linggang a9e30c8c12 getnameinfo.3: ATTRIBUTES: Note function that is thread-safe
After research, We think getnameinfo() is thread-safe. But, there
is not marking of getnameinfo() in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 21:25:54 +02:00
Zeng Linggang bb89d1ef8f getaddrinfo.3: ATTRIBUTES: Note functions that are thread-safe
After research, We think getaddrinfo(), freeaddrinfo() and
gai_strerror() are thread-safe. But, there are not markings
of them in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 21:25:28 +02:00
Zeng Linggang 1ee2274c39 dl_iterate_phdr.3: ATTRIBUTES: Note function that is thread-safe
After research, We think dl_iterate_phdr() is thread-safe. But, there
is not marking of dl_iterate_phdr() in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 21:25:10 +02:00
Michael Kerrisk 332d685555 xcrypt.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 21:18:06 +02:00
Michael Kerrisk e2d7e8a112 key_setsecret.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 21:16:16 +02:00
Zeng Linggang 8d2cf26d8b xcrypt.3: ATTRIBUTES: Note functions that are thread-safe
After research, We think passwd2des(), xencrypt() and xdecrypt() are
thread-safe. But, there are not markings of them in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 21:13:47 +02:00
Zeng Linggang 45932f13d9 putgrent.3: ATTRIBUTES: Note function that is thread-safe
After research, We think putgrent() is thread-safe. But, there
is not marking of putgrent() in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 21:13:47 +02:00
Zeng Linggang 672a9903d3 pthread_tryjoin_np.3: ATTRIBUTES: Note functions that are thread-safe
After research, We think pthread_tryjoin_np() and
pthread_timedjoin_np() are thread-safe. But, there
are not markings of them in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 21:13:47 +02:00
Zeng Linggang 5effafa2f6 pthread_getattr_np.3: ATTRIBUTES: Note function that is thread-safe
After research, We think pthread_getattr_np() is thread-safe. But,
there is not marking of pthread_getattr_np() in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 21:13:47 +02:00
Zeng Linggang 598445e0a5 pthread_cleanup_push.3: ATTRIBUTES: Note functions that are thread-safe
After research, We think pthread_cleanup_push() and
pthread_cleanup_pop() are thread-safe. But, there
are not markings of them in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 21:13:43 +02:00
Zeng Linggang 5b911d96f8 pthread_attr_setaffinity_np.3: ATTRIBUTES: Note functions that are thread-safe
After research, We think pthread_attr_setaffinity_np() and
pthread_attr_getaffinity_np() are thread-safe. But, there are not
markings of them in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 21:12:27 +02:00
Zeng Linggang f8f22117d0 key_setsecret.3: ATTRIBUTES: Note functions that are thread-safe
After research, We think key_decryptsession(), key_setsecret(),
key_encryptsession(), key_gendes() and key_secretkey_is_set() are
thread-safe. But, there are not markings of them in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 21:10:03 +02:00
Zeng Linggang 91a7c37560 getpw.3: ATTRIBUTES: Note function that is thread-safe
After research, We think getpw() is thread-safe. But, there
is not marking of getpw() in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 21:09:46 +02:00
Zeng Linggang 8eb0dd50e5 getnetent_r.3: ATTRIBUTES: Note functions that are thread-safe
After research, We think getnetent_r(), getnetbyname_r() and
getnetbyaddr_r() are thread-safe. But, there are not markings
of them in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 21:09:02 +02:00
Andries E. Brouwer 981fffea98 fread.3: Clarify terminology
In the "RETURN VALUE" section the word item is in italics
as if it were one of the function parameters. But the word
"item" occurs here for the first time, earlier the text
uses "element". [Patch improves this.]

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 20:56:13 +02:00
Jann Horn 7353fc544c listxattr.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 20:16:16 +02:00
Michael Kerrisk c93b25f996 gettid.2: s/getpid()/gettid()/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 19:01:14 +02:00
Julian Orth c838fc75c7 capget.2: Clarify that hdrp->pid==0 is equivalent gettid() not getpid()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:58:24 +02:00
Michael Kerrisk 4a8f718576 gettid.2: Note that for a thread group leader, gettid() == getpid()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:56:24 +02:00
Marko Myllynen ca48cef151 locale.1: A minor output format clarification
A minor clarification for the locale output format which was
brought up at
https://sourceware.org/bugzilla/show_bug.cgi?id=18516.

For reference, see
https://sourceware.org/bugzilla/show_bug.cgi?id=18516
http://pubs.opengroup.org/onlinepubs/9699919799/utilities/locale.html

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:47:21 +02:00
Marko Myllynen 2a9e359eda localedef.1: tfix
Hi Michael,

the subject says it all.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:46:30 +02:00
Marko Myllynen be1e94afe1 strfmon.3: Rewrite the example
I think the example is more accurate when we use the exact
locale names and also the Euro sign where appropriate.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:45:56 +02:00
Marko Myllynen 88b801ec78 strfmon.3: Document strfmon_l(3)
Describe strfmon_l(3).

http://pubs.opengroup.org/onlinepubs/9699919799/functions/strfmon.html

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:45:53 +02:00
Marko Myllynen af1eec3c8a strfmon.3: Fix CONFORMING TO
AFAICS strfmon(3) is now defined in POSIX and the glibc
implementation is as specified there.

http://pubs.opengroup.org/onlinepubs/9699919799/functions/strfmon.html

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:45:53 +02:00
Michael Kerrisk 4839256aff locale.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:45:53 +02:00
Michael Kerrisk 7bc58733c5 locale.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:45:53 +02:00
Marko Myllynen 861c753ae3 locale.5: tfix / minor clarification
The subject says it all, for reference see e.g. ja_JP.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:45:53 +02:00
Marko Myllynen b3834a454f locale.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:45:50 +02:00
Marko Myllynen e4bcd97145 locale.5: Sort according to the standard
Sort the options so that those defined in POSIX are listed first,
then followed by those defined in ISO/IEC TR 14652 in the order
of common convention in many widely used glibc locales.

Actual descriptions are unchanged.

http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap07.html

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:31:19 +02:00
Marko Myllynen cc7279ff2e locale.5: Remove the FIXME for timezone
The timezone of LC_TIME is not in POSIX, only 6 (out of ~300)
glibc locales define it, the glibc code comment below from
glibc.git/programs/ld-time.c seems to suggest it's not a good
idea, and there's been a proposal in upstream [1] to remove the
existing timezone definitions from glibc locales so I think
it's actually better to leave this one undocumented:

/* XXX We don't perform any tests on the timezone value since this is
   simply useless, stupid $&$!@...  */

1) https://sourceware.org/ml/libc-alpha/2015-06/msg00098.html

Move the remaining LC_COLLATE FIXMEs together while at it.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:30:09 +02:00
Marko Myllynen ea7208a6aa locale.5: Refer to strftime(3) where appropriate
The relationship between the locale time format syntax
and strftime() cannot be considered as obvious.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:27:55 +02:00
Marko Myllynen ab601e67b9 locale.5: Refer to locale(7) more prominently
It's probably a good idea to refer to locale(7) so that a reader
can check what a category is about before describing them in
detail.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:27:14 +02:00
Marko Myllynen 5f756e5ba5 setlocale.3: Update CONFORMING TO
http://pubs.opengroup.org/onlinepubs/9699919799/functions/setlocale.html

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:27:09 +02:00
Marko Myllynen 9ce8a1e00e setlocale.3: Tweak C/POSIX locale portability description
As discussed earlier, the current description might be a little
bit too stringent, let's avoid the issue by describing the
portability aspect on a slightly higher level.

References:

http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap06.html
http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap07.html
http://pubs.opengroup.org/onlinepubs/9699919799/functions/setlocale.html

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:24:46 +02:00
Michael Kerrisk 29c4533cd3 _exit.2: Open stdio frames are not flushed, temporary files are deleted
Many years ago, text was added to the page saying that it is
implementation-dependent whether stdio streams are flushed and
whether temporary are removed. In part, this change appears to
be because POSIX.1-2001 added text related to this point.
However, that seems to have been an error in POSIX, and the
text was subsequently removed for POSIX.1-2008. See
https://collaboration.opengroup.org/austin/interps/documents/9984/AI-085.txt
Austin Group Interpretation reference 1003.1-2001 #085

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-10 12:55:49 +02:00
Nathan Lynch ebfc361134 vdso.7: Update for ARM
The 32-bit ARM architecture in Linux has gained a vDSO as of the
4.1 release.  (I was the primary author.)

Document the symbols exported by the ARM VDSO.

Accepted kernel submission:
http://lists.infradead.org/pipermail/linux-arm-kernel/2015-March/332573.html

Acked-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Nathan Lynch <nathan_lynch@mentor.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-05 09:25:00 +02:00
Michael Kerrisk be6b243ae2 epoll.7: tfix
See http://bugs.debian.org/787625

Reported-by: Uwe Kleine-König <uwe+debian@kleine-koenig.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-05 09:24:20 +02:00
Michael Kerrisk a41c3eccb2 elf.5: wfix
Reported-by: Hack NDo <hackndo@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-29 20:31:41 +02:00
Michael Kerrisk 70a9fec73b __ppc_get_timebase.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-27 10:32:12 +02:00
Michael Kerrisk 56aa9a9535 __ppc_get_timebase.3: Minor tweaks to example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-27 10:31:58 +02:00
Tulio Magno Quites Machado Filho 1e6e376298 __ppc_get_timebase_freq.3: Document the Power-specific __ppc_get_timebase_freq(3)
Glibc 2.17 adds a function to read the frequency at which the Time
Base Register of Power processors is updated.

Signed-off-by: Tulio Magno Quites Machado Filho <tuliom@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-27 10:23:15 +02:00
Michael Kerrisk 1290b94b1c llseek.2: tfix
Reported-by: Namhyung Kim <namhyung@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-27 10:16:59 +02:00
Michael Kerrisk 728aff57dd fcntl.2: OFD locks are proposed for inclusion in the next POSIX revision
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-20 16:38:09 +02:00
Zeng Linggang 47f06c7567 utimensat.2: ATTRIBUTES: Note functions that are thread-safe
After research, We think utimensat() and futimens() are thread-safe.
But, there are not markings of utimensat() and futimens() in glibc
document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-20 16:13:32 +02:00
Zeng Linggang 412793f9ff pthread_setname_np.3: ATTRIBUTES: Note functions that are thread-safe
After research, We think pthread_setname_np() and pthread_getname_np()
are thread-safe. But, there are not markings of pthread_setname_np()
and pthread_getname_np() in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-20 16:13:27 +02:00
Zeng Linggang acc271be11 pthread_join.3: ATTRIBUTES: Note function that is thread-safe
After research, We think pthread_join() is thread-safe. But, there
is not marking of pthread_join() in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-20 16:13:22 +02:00
Zeng Linggang bf0fbbcdd2 pthread_detach.3: ATTRIBUTES: Note function that is thread-safe
After research, We think pthread_detach() is thread-safe. But, there
is not marking of pthread_detach() in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-20 16:13:17 +02:00