]> git.ipfire.org Git - thirdparty/man-pages.git/log
thirdparty/man-pages.git
9 years agoLIST_EMPTY.3, LIST_FIRST.3, LIST_FOREACH.3, LIST_HEAD_INITIALIZER.3, LIST_INSERT_BEFO...
Michael Kerrisk [Sat, 7 Feb 2015 23:11:18 +0000 (00:11 +0100)] 
LIST_EMPTY.3, LIST_FIRST.3, LIST_FOREACH.3, LIST_HEAD_INITIALIZER.3, LIST_INSERT_BEFORE.3, LIST_NEXT.3, SLIST_EMPTY.3, SLIST_ENTRY.3, SLIST_FIRST.3, SLIST_FOREACH.3, SLIST_HEAD.3, SLIST_HEAD_INITIALIZER.3, SLIST_INIT.3, SLIST_INSERT_AFTER.3, SLIST_INSERT_HEAD.3, SLIST_NEXT.3, SLIST_REMOVE.3, SLIST_REMOVE_HEAD.3, STAILQ_CONCAT.3, STAILQ_EMPTY.3, STAILQ_ENTRY.3, STAILQ_FIRST.3, STAILQ_FOREACH.3, STAILQ_HEAD.3, STAILQ_HEAD_INITIALIZER.3, STAILQ_INIT.3, STAILQ_INSERT_AFTER.3, STAILQ_INSERT_HEAD.3, STAILQ_INSERT_TAIL.3, STAILQ_NEXT.3, STAILQ_REMOVE.3, STAILQ_REMOVE_HEAD.3, TAILQ_CONCAT.3, TAILQ_EMPTY.3, TAILQ_FIRST.3, TAILQ_FOREACH.3, TAILQ_FOREACH_REVERSE.3, TAILQ_HEAD_INITIALIZER.3, TAILQ_INSERT_BEFORE.3, TAILQ_LAST.3, TAILQ_NEXT.3, TAILQ_PREV.3, TAILQ_SWAP.3: New link to queue.3

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoqueue.3: srcfix: Add license marker tags
Michael Kerrisk [Sat, 7 Feb 2015 07:26:27 +0000 (08:26 +0100)] 
queue.3: srcfix: Add license marker tags

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoqueue.3: Use real hyphens in code samples
Michael Kerrisk [Sat, 7 Feb 2015 07:15:24 +0000 (08:15 +0100)] 
queue.3: Use real hyphens in code samples

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoqueue.3: Update timestamp
Michael Kerrisk [Sat, 7 Feb 2015 07:14:26 +0000 (08:14 +0100)] 
queue.3: Update timestamp

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoqueue.3: Replace HISTORY with CONFORMING TO
Michael Kerrisk [Sat, 7 Feb 2015 07:11:04 +0000 (08:11 +0100)] 
queue.3: Replace HISTORY with CONFORMING TO

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoqueue.3: Remove SEE ALSO reference to nonexistent tree(3)
Michael Kerrisk [Sat, 7 Feb 2015 07:09:48 +0000 (08:09 +0100)] 
queue.3: Remove SEE ALSO reference to nonexistent tree(3)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoqueue.3: Use subsections in DESCRIPTION
Michael Kerrisk [Sat, 7 Feb 2015 07:08:17 +0000 (08:08 +0100)] 
queue.3: Use subsections in DESCRIPTION

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoqueue.3: Comment out text for functions not in glibc
Michael Kerrisk [Sat, 7 Feb 2015 07:05:23 +0000 (08:05 +0100)] 
queue.3: Comment out text for functions not in glibc

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoqueue.3: Reimport from latest FreeBSD page
Michael Kerrisk [Sat, 7 Feb 2015 06:39:47 +0000 (07:39 +0100)] 
queue.3: Reimport from latest FreeBSD page

Long ago, Doug Klima noted that many macros were not
documented in the queue(3) page. Fix by reimporting from
latest [1] FreeBSD man page.

[1] Revision 263142, Modified Fri Mar 14 03:07:51 2014 UTC

This also fixes https://sourceware.org/bugzilla/show_bug.cgi?id=1506

This time, I'll learn from past mistakes and not convert
from 'mdoc' to 'man' macros.

Reported-by: David Leppik <dleppik@vocalabs.com>
Reported-by: Doug Klima <cardoe@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agolocale.5: document era keywords
Marko Myllynen [Thu, 25 Jun 2015 07:42:15 +0000 (10:42 +0300)] 
locale.5: document era keywords

This patch completes the LC_TIME section - since these era
keywords are so tightly coupled, I'm providing them as a
single patch.

Based on
http://pubs.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap07.html
http://www.open-std.org/jtc1/SC22/WG20/docs/n972-14652ft.pdf

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoxdr.3: ATTRIBUTES: Note functions that are thread-safe
Zeng Linggang [Wed, 24 Jun 2015 09:28:39 +0000 (17:28 +0800)] 
xdr.3: ATTRIBUTES: Note functions that are thread-safe

After research, We think
xdr_array(), xdr_bool(),
xdr_bytes(), xdr_char(),
xdr_destroy(), xdr_double(),
xdr_enum(), xdr_float(),
xdr_free(), xdr_getpos(),
xdr_inline(), xdr_int(),
xdr_long(), xdrmem_create(),
xdr_opaque(), xdr_pointer(),
xdrrec_create(), xdrrec_eof(),
xdrrec_endofrecord(),
xdrrec_skiprecord(),
xdr_reference(), xdr_setpos(),
xdr_short(), xdrstdio_create(),
xdr_string(), xdr_u_char(),
xdr_u_int(), xdr_u_long(),
xdr_u_short(), xdr_union(),
xdr_vector(), xdr_void(),
xdr_wrapstring(),
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>
9 years agorpc.3: ATTRIBUTES: Note functions that are thread-safe
Zeng Linggang [Wed, 24 Jun 2015 09:28:38 +0000 (17:28 +0800)] 
rpc.3: ATTRIBUTES: Note functions that are thread-safe

After research, We think
auth_destroy(), authnone_create(),
authunix_create(), authunix_create_default(),
callrpc(), clnt_broadcast(),
clnt_call(), clnt_destroy(),
clnt_create(), clnt_control(),
clnt_freeres(), clnt_geterr(),
clnt_pcreateerror(), clnt_perrno(),
clnt_perror(), clnt_spcreateerror(),
clnt_sperrno(), clnt_sperror(),
clntraw_create(), clnttcp_create(),
clntudp_create(), clntudp_bufcreate(),
get_myaddress(), pmap_getmaps(),
pmap_getport(), pmap_rmtcall(),
pmap_set(), pmap_unset(),
registerrpc(), svc_destroy(),
svc_freeargs(), svc_getargs(),
svc_getcaller(), svc_getreqset(),
svc_getreq(), svc_register(),
svc_run(), svc_sendreply(),
svc_unregister(), svcerr_auth(),
svcerr_decode(), svcerr_noproc(),
svcerr_noprog(), svcerr_progvers(),
svcerr_systemerr(), svcerr_weakauth(),
svcfd_create(), svcraw_create(),
svctcp_create(), svcudp_bufcreate(),
svcudp_create(), xdr_accepted_reply(),
xdr_authunix_parms(), xdr_callhdr(),
xdr_callmsg(), xdr_opaque_auth(),
xdr_pmap(), xdr_pmaplist(),
xdr_rejected_reply(), xdr_replymsg(),
xprt_register(), xprt_unregister(),
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>
9 years agogetauxval.3: File capabilities also trigger AT_SECURE
Michael Kerrisk [Wed, 15 Jul 2015 14:36:02 +0000 (16:36 +0200)] 
getauxval.3: File capabilities also trigger AT_SECURE

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoseccomp.2: wfix
Michael Kerrisk [Mon, 13 Jul 2015 12:06:24 +0000 (14:06 +0200)] 
seccomp.2: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agouselib.2: srcfix
Michael Kerrisk [Fri, 10 Jul 2015 18:00:22 +0000 (20:00 +0200)] 
uselib.2: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agogetauxval.3: (Briefly) document AT_HWCAP2
Michael Kerrisk [Wed, 8 Jul 2015 09:04:49 +0000 (11:04 +0200)] 
getauxval.3: (Briefly) document AT_HWCAP2

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agomemcpy.3: NOTES: describe the glibc 2.13 changes that revealed buggy applications
Michael Kerrisk [Fri, 3 Jul 2015 11:08:04 +0000 (13:08 +0200)] 
memcpy.3: NOTES: describe the glibc 2.13 changes that revealed buggy applications

Adding a note on this point seems worthwhile as a way of
emphasizing the point that the buffers must not overlap.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agofcntl.2: ffix
Michael Kerrisk [Wed, 1 Jul 2015 10:08:05 +0000 (12:08 +0200)] 
fcntl.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoseccomp.2: srcfix
Michael Kerrisk [Tue, 30 Jun 2015 13:35:19 +0000 (15:35 +0200)] 
seccomp.2: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoprctl.2, seccomp.2: Clarify that SECCOMP_SET_MODE_STRICT disallows exit_group(2)
Michael Kerrisk [Tue, 30 Jun 2015 11:39:39 +0000 (13:39 +0200)] 
prctl.2, seccomp.2: Clarify that SECCOMP_SET_MODE_STRICT disallows exit_group(2)

These days, glibc implements _exit() as a wrapper around
exit_group(2). (When seccomp was originally introduced, this was
not the case.) Give the reader a clue that, despite what glibc is
doing, what SECCOMP_SET_MODE_STRICT permits is the true _exit(2)
system call, and not exit_group(2).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoseccomp.2: tfix
Michael Kerrisk [Tue, 30 Jun 2015 11:29:23 +0000 (13:29 +0200)] 
seccomp.2: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoseccomp.2: ffix
Michael Kerrisk [Tue, 30 Jun 2015 11:28:42 +0000 (13:28 +0200)] 
seccomp.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoseccomp.2: tfix
Michael Kerrisk [Tue, 30 Jun 2015 11:28:10 +0000 (13:28 +0200)] 
seccomp.2: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agotruncate.2: ERRORS: ftruncate() can fail if the file descriptor is not writable
Michael Kerrisk [Tue, 30 Jun 2015 09:57:40 +0000 (11:57 +0200)] 
truncate.2: ERRORS: ftruncate() can fail if the file descriptor is not writable

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agosched.7: tfix
Michael Kerrisk [Sat, 27 Jun 2015 09:04:28 +0000 (11:04 +0200)] 
sched.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agosched.7: Remove ancient, wildly optimistic prediction about future of RT patches
Michael Kerrisk [Sat, 27 Jun 2015 08:56:29 +0000 (10:56 +0200)] 
sched.7: Remove ancient, wildly optimistic prediction about future of RT patches

It seems the patches were not merged by 2.6.30...

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agosched.7: tfix
Michael Kerrisk [Fri, 26 Jun 2015 09:04:44 +0000 (11:04 +0200)] 
sched.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agocore.5: Mention 'coredump_filter' boot option
Michael Kerrisk [Thu, 25 Jun 2015 10:07:27 +0000 (12:07 +0200)] 
core.5: Mention 'coredump_filter' boot option

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agosched_setaffinity.2: Mention the use of the 'isolcpus' kernel boot option
Michael Kerrisk [Thu, 25 Jun 2015 09:53:00 +0000 (11:53 +0200)] 
sched_setaffinity.2: Mention the use of the 'isolcpus' kernel boot option

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agogetpriority.2: tfix
Michael Kerrisk [Wed, 24 Jun 2015 12:33:19 +0000 (14:33 +0200)] 
getpriority.2: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agohosts.equiv.5: Improve explanation in EXAMPLE
Michael Kerrisk [Thu, 18 Jun 2015 19:19:38 +0000 (21:19 +0200)] 
hosts.equiv.5: Improve explanation in EXAMPLE

Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agogsignal.3: ATTRIBUTES: Note functions that are thread-safe
Zeng Linggang [Thu, 18 Jun 2015 05:36:51 +0000 (13:36 +0800)] 
gsignal.3: ATTRIBUTES: Note functions that are thread-safe

The markings match glibc markings.
markings of functions in glibc are:
- gsignal: MT-Safe
- ssignal: MT-Safe sigintr

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agogetpwent_r.3: ATTRIBUTES: Note functions that are/aren't thread-safe
Zeng Linggang [Thu, 18 Jun 2015 05:36:50 +0000 (13:36 +0800)] 
getpwent_r.3: ATTRIBUTES: Note functions that are/aren't thread-safe

The markings match glibc markings.
markings of functions in glibc are:
- getpwent_r:  MT-Unsafe race:pwent locale
- fgetpwent_r: MT-Safe

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agogetgrent_r.3: ATTRIBUTES: Note functions that are/aren't thread-safe
Zeng Linggang [Thu, 18 Jun 2015 05:36:49 +0000 (13:36 +0800)] 
getgrent_r.3: ATTRIBUTES: Note functions that are/aren't thread-safe

The markings match glibc markings.
markings of functions in glibc are:
- getgrent_r:  MT-Unsafe race:grent locale
- fgetgrent_r: MT-Safe

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoclearenv.3: ATTRIBUTES: Note function that is not thread-safe
Zeng Linggang [Thu, 18 Jun 2015 05:36:48 +0000 (13:36 +0800)] 
clearenv.3: ATTRIBUTES: Note function that is not thread-safe

The marking matches glibc marking.
The marking of functions in glibc is:
- clearenv: MT-Unsafe const:env

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agosetsid.2: tfix
Tobias Stoeckmann [Wed, 17 Jun 2015 20:31:37 +0000 (22:31 +0200)] 
setsid.2: tfix

it -> its

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agopacket.7: ffix
Michael Kerrisk [Thu, 18 Jun 2015 06:41:21 +0000 (08:41 +0200)] 
packet.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoproc.5: Document /proc/sys/kernel/sysctl_writes_strict
Michael Kerrisk [Fri, 8 May 2015 14:52:55 +0000 (16:52 +0200)] 
proc.5: Document /proc/sys/kernel/sysctl_writes_strict

Based on text in Documentation/sysctl/kernel.txt.

Cowritten-by: Kees Cook <keescook@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agohosts.equiv.5: Improve explanation in EXAMPLE
Michael Kerrisk [Thu, 18 Jun 2015 06:29:52 +0000 (08:29 +0200)] 
hosts.equiv.5: Improve explanation in EXAMPLE

Reported-by: Arjun Shankar <arjun@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agohosts.equiv.5: wfix
Michael Kerrisk [Thu, 18 Jun 2015 06:29:15 +0000 (08:29 +0200)] 
hosts.equiv.5: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agohosts.equiv.5: Tweak's to Carlos's patch
Michael Kerrisk [Wed, 17 Jun 2015 08:46:06 +0000 (10:46 +0200)] 
hosts.equiv.5: Tweak's to Carlos's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agohosts.equiv.5: Fix format, clarify IdM needs, and provide examples.
Carlos O'Donell [Sun, 24 May 2015 04:58:25 +0000 (00:58 -0400)] 
hosts.equiv.5: Fix format, clarify IdM needs, and provide examples.

In some recent work with a Red Hat customer I had the opportunity
to discuss the fine nuances of the ruserok() function and related
API which are used to implement rlogin and rsh.

It came to my attention after working with QE on some automated
internal testing that there were no good examples in the hosts.equiv
manual page showing how the format was supposed to work for this
file and for ~/.rhosts, worse the "format" line showed that there
should be spaces between arguments when that would clearly lead
to incorrect behaviour. In addition some things that the format
allows you to write are just wrong like "-host -user" which makes
no sense since the host is already rejected, and should be written
as "host -user" instead. I added notes in the example to make it
clear that "-host -user" is invalid.

I fixed three things:

(a) The format line.
- Either +, or [-]hostname, or +@netgrp or -@netgrp.
- Either +, or [-]username, or +@netgrp or -@netgrp.
- You must specify something in the hostname portion so remove
  optional brackets.

(b) Clarify language around credentials
- If the host is not trusted you must provide credentials to
  the login system and that could be anything really and it
  depends on your configuration e.g. PAM or whatever IdM you have.

(c) Provide real-world examples
- Provide several real world examples and some corner case
  examples for how you would write something. Hopefully others
  can add examples as they see fit.

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agohost.conf.5: Wording fix: s/resolv+/the resolver library/
Michael Kerrisk [Tue, 16 Jun 2015 11:20:54 +0000 (13:20 +0200)] 
host.conf.5: Wording fix: s/resolv+/the resolver library/

The term "resolv+" seems to be historical cruft.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agochroot.2: Minor fixes
Michael Kerrisk [Tue, 16 Jun 2015 11:20:47 +0000 (13:20 +0200)] 
chroot.2: Minor fixes

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agosocket.2: Update documentation reference for AF_ALG
Stephan Mueller [Sun, 14 Jun 2015 13:01:08 +0000 (15:01 +0200)] 
socket.2: Update documentation reference for AF_ALG

Signed-off-by: Stephan Mueller <stephan.mueller@atsec.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agochroot.2: chroot() is not intended for security; document attack
Jann Horn [Sun, 14 Jun 2015 11:25:04 +0000 (13:25 +0200)] 
chroot.2: chroot() is not intended for security; document attack

It is unfortunate that this discourages this use of chroot(2)
without pointing out alternative solutions - for example,
OpenSSH and vsftpd both still rely on chroot(2) for security.

Bind mounts should theoretically be usable as a replacement, but
currently, they have a similar problem (CVE-2015-2925) that hasn't
been fixed in ~6 months, so I'd rather not add it to the manpage
as a solution before a fix lands.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agofexecve.3: ATTRIBUTES: Note function that is thread-safe
Zeng Linggang [Wed, 27 May 2015 10:12:55 +0000 (18:12 +0800)] 
fexecve.3: ATTRIBUTES: Note function that is thread-safe

After research, We think fexecve() is thread-safe. But, there
is not marking of fexecve() in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoresolver.3: ffix
Michael Kerrisk [Fri, 12 Jun 2015 19:46:36 +0000 (21:46 +0200)] 
resolver.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agorcmd.3: ffix
Michael Kerrisk [Fri, 12 Jun 2015 19:45:08 +0000 (21:45 +0200)] 
rcmd.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agogetrpcent.3: ffix
Michael Kerrisk [Fri, 12 Jun 2015 19:44:09 +0000 (21:44 +0200)] 
getrpcent.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agogetprotoent_r.3: ffix
Michael Kerrisk [Fri, 12 Jun 2015 19:42:44 +0000 (21:42 +0200)] 
getprotoent_r.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agosetaliasent.3: ATTRIBUTES: Note functions that are/aren't thread-safe
Zeng Linggang [Thu, 11 Jun 2015 02:04:30 +0000 (10:04 +0800)] 
setaliasent.3: ATTRIBUTES: Note functions that are/aren't thread-safe

After research, We think
* setaliasent(),
* endaliasent(),
* getaliasent_r(),
* getaliasbyname_r(),
are thread-safe. And
* getaliasent(),
* getaliasbyname(),
are not 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>
9 years agoresolver.3: ATTRIBUTES: Note functions that are thread-safe
Zeng Linggang [Thu, 11 Jun 2015 02:04:29 +0000 (10:04 +0800)] 
resolver.3: ATTRIBUTES: Note functions that are thread-safe

After research, We think
* res_ninit(),
* res_nquery(),
* res_nsearch(),
* res_nquerydomain(),
* res_nmkquery(),
* res_nsend(),
* dn_comp(),
* dn_expand()
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>
9 years agorcmd.3: ATTRIBUTES: Note functions that are/aren't thread-safe
Zeng Linggang [Thu, 11 Jun 2015 02:04:28 +0000 (10:04 +0800)] 
rcmd.3: ATTRIBUTES: Note functions that are/aren't thread-safe

After research, We think
* rresvport(),
* iruserok(),
* ruserok(),
* rresvport_af(),
* iruserok_af(),
* ruserok_af(),
are thread-safe. And
* rcmd(),
* rcmd_af(),
are not 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>
9 years agoprofil.3: ATTRIBUTES: Note function that is not thread-safe
Zeng Linggang [Thu, 11 Jun 2015 02:04:27 +0000 (10:04 +0800)] 
profil.3: ATTRIBUTES: Note function that is not thread-safe

After research, We think profil() is not thread-safe. But,
there is not marking of profil() in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agogetservent_r.3: ATTRIBUTES: Note functions that are thread-safe
Zeng Linggang [Thu, 11 Jun 2015 02:04:26 +0000 (10:04 +0800)] 
getservent_r.3: ATTRIBUTES: Note functions that are thread-safe

After research, We think
* getservent_r(),
* getservbyname_r(),
* getservbyport_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>
9 years agogetrpcent_r.3: ATTRIBUTES: Note functions that are thread-safe
Zeng Linggang [Thu, 11 Jun 2015 02:04:25 +0000 (10:04 +0800)] 
getrpcent_r.3: ATTRIBUTES: Note functions that are thread-safe

After research, We think
* getrpcent_r(),
* getrpcbyname_r(),
* getrpcbynumber_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>
9 years agogetrpcent.3: ATTRIBUTES: Note functions that are/aren't thread-safe
Zeng Linggang [Thu, 11 Jun 2015 02:04:24 +0000 (10:04 +0800)] 
getrpcent.3: ATTRIBUTES: Note functions that are/aren't thread-safe

After research, We think
* setrpcent(),
* endrpcent(),
are thread-safe. And
* getrpcent(),
* getrpcbyname(),
* getrpcbynumber(),
are not 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>
9 years agogetprotoent_r.3: ATTRIBUTES: Note functions that are thread-safe
Zeng Linggang [Thu, 11 Jun 2015 02:04:23 +0000 (10:04 +0800)] 
getprotoent_r.3: ATTRIBUTES: Note functions that are thread-safe

After research, We think
* getprotoent_r(),
* getprotobyname_r(),
* getprotobynumber_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>
9 years agogetaddrinfo_a.3: ATTRIBUTES: Note functions that are thread-safe
Zeng Linggang [Thu, 11 Jun 2015 02:04:22 +0000 (10:04 +0800)] 
getaddrinfo_a.3: ATTRIBUTES: Note functions that are thread-safe

After research, We think
* getaddrinfo_a(),
* gai_suspend(),
* gai_error(),
* gai_cancel(),
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>
9 years agofts.3: ATTRIBUTES: Note functions that are/aren't thread-safe
Zeng Linggang [Thu, 11 Jun 2015 02:04:21 +0000 (10:04 +0800)] 
fts.3: ATTRIBUTES: Note functions that are/aren't thread-safe

After research, We think
* fts_open(),
* fts_set(),
* fts_close(),
are thread-safe. And
* fts_read(),
* fts_children(),
are not 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>
9 years agosem_close.3: ATTRIBUTES: Note function that is thread-safe
Zeng Linggang [Wed, 3 Jun 2015 10:16:34 +0000 (18:16 +0800)] 
sem_close.3: ATTRIBUTES: Note function that is thread-safe

After research, We think sem_close() is thread-safe. But, there
is not marking of sem_close() in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agorpmatch.3: ATTRIBUTES: Note function that is thread-safe
Zeng Linggang [Wed, 3 Jun 2015 10:16:33 +0000 (18:16 +0800)] 
rpmatch.3: ATTRIBUTES: Note function that is thread-safe

The marking matches glibc marking.
The marking of functions in glibc is:
- rpmatch: MT-Safe locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agomalloc_trim.3: ATTRIBUTES: Note function that is thread-safe
Zeng Linggang [Wed, 3 Jun 2015 10:16:32 +0000 (18:16 +0800)] 
malloc_trim.3: ATTRIBUTES: Note function that is thread-safe

After research, We think malloc_trim() is thread-safe. But, there
is not marking of malloc_trim() in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agomalloc_get_state.3: ATTRIBUTES: Note functions that are thread-safe
Zeng Linggang [Wed, 3 Jun 2015 10:16:31 +0000 (18:16 +0800)] 
malloc_get_state.3: ATTRIBUTES: Note functions that are thread-safe

After research, We think malloc_get_state() and malloc_set_state() 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>
9 years agogetservent.3: ATTRIBUTES: Note functions that aren't thread-safe
Zeng Linggang [Wed, 3 Jun 2015 10:16:30 +0000 (18:16 +0800)] 
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>
9 years agogetrpcport.3: ATTRIBUTES: Note function that is thread-safe
Zeng Linggang [Wed, 3 Jun 2015 10:16:29 +0000 (18:16 +0800)] 
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>
9 years agogetprotoent.3: ATTRIBUTES: Note functions that aren't thread-safe
Zeng Linggang [Wed, 3 Jun 2015 10:16:28 +0000 (18:16 +0800)] 
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>
9 years agogetnameinfo.3: ATTRIBUTES: Note function that is thread-safe
Zeng Linggang [Wed, 3 Jun 2015 10:16:27 +0000 (18:16 +0800)] 
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>
9 years agogetaddrinfo.3: ATTRIBUTES: Note functions that are thread-safe
Zeng Linggang [Wed, 3 Jun 2015 10:16:26 +0000 (18:16 +0800)] 
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>
9 years agodl_iterate_phdr.3: ATTRIBUTES: Note function that is thread-safe
Zeng Linggang [Wed, 3 Jun 2015 10:16:25 +0000 (18:16 +0800)] 
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>
9 years agoxcrypt.3: ffix
Michael Kerrisk [Fri, 12 Jun 2015 19:17:02 +0000 (21:17 +0200)] 
xcrypt.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agokey_setsecret.3: ffix
Michael Kerrisk [Fri, 12 Jun 2015 19:16:16 +0000 (21:16 +0200)] 
key_setsecret.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agoxcrypt.3: ATTRIBUTES: Note functions that are thread-safe
Zeng Linggang [Wed, 27 May 2015 10:13:04 +0000 (18:13 +0800)] 
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>
9 years agoputgrent.3: ATTRIBUTES: Note function that is thread-safe
Zeng Linggang [Wed, 27 May 2015 10:13:03 +0000 (18:13 +0800)] 
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>
9 years agopthread_tryjoin_np.3: ATTRIBUTES: Note functions that are thread-safe
Zeng Linggang [Wed, 27 May 2015 10:13:02 +0000 (18:13 +0800)] 
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>
9 years agopthread_getattr_np.3: ATTRIBUTES: Note function that is thread-safe
Zeng Linggang [Wed, 27 May 2015 10:13:01 +0000 (18:13 +0800)] 
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>
9 years agopthread_cleanup_push.3: ATTRIBUTES: Note functions that are thread-safe
Zeng Linggang [Wed, 27 May 2015 10:13:00 +0000 (18:13 +0800)] 
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>
9 years agopthread_attr_setaffinity_np.3: ATTRIBUTES: Note functions that are thread-safe
Zeng Linggang [Wed, 27 May 2015 10:12:59 +0000 (18:12 +0800)] 
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>
9 years agokey_setsecret.3: ATTRIBUTES: Note functions that are thread-safe
Zeng Linggang [Wed, 27 May 2015 10:12:58 +0000 (18:12 +0800)] 
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>
9 years agogetpw.3: ATTRIBUTES: Note function that is thread-safe
Zeng Linggang [Wed, 27 May 2015 10:12:57 +0000 (18:12 +0800)] 
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>
9 years agogetnetent_r.3: ATTRIBUTES: Note functions that are thread-safe
Zeng Linggang [Wed, 27 May 2015 10:12:56 +0000 (18:12 +0800)] 
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>
9 years agofread.3: Clarify terminology
Andries E. Brouwer [Fri, 12 Jun 2015 18:56:13 +0000 (20:56 +0200)] 
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>
9 years agolistxattr.2: tfix
Jann Horn [Sat, 6 Jun 2015 17:11:54 +0000 (19:11 +0200)] 
listxattr.2: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agogettid.2: s/getpid()/gettid()/
Michael Kerrisk [Fri, 12 Jun 2015 17:01:14 +0000 (19:01 +0200)] 
gettid.2: s/getpid()/gettid()/

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agocapget.2: Clarify that hdrp->pid==0 is equivalent gettid() not getpid()
Julian Orth [Wed, 10 Jun 2015 19:56:33 +0000 (21:56 +0200)] 
capget.2: Clarify that hdrp->pid==0 is equivalent gettid() not getpid()

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agogettid.2: Note that for a thread group leader, gettid() == getpid()
Michael Kerrisk [Fri, 12 Jun 2015 16:56:24 +0000 (18:56 +0200)] 
gettid.2: Note that for a thread group leader, gettid() == getpid()

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agolocale.1: A minor output format clarification
Marko Myllynen [Fri, 12 Jun 2015 13:31:53 +0000 (16:31 +0300)] 
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>
9 years agolocaledef.1: tfix
Marko Myllynen [Tue, 9 Jun 2015 14:19:01 +0000 (17:19 +0300)] 
localedef.1: tfix

Hi Michael,

the subject says it all.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agostrfmon.3: Rewrite the example
Marko Myllynen [Tue, 9 Jun 2015 14:18:40 +0000 (17:18 +0300)] 
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>
9 years agostrfmon.3: Document strfmon_l(3)
Marko Myllynen [Tue, 9 Jun 2015 14:18:36 +0000 (17:18 +0300)] 
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>
9 years agostrfmon.3: Fix CONFORMING TO
Marko Myllynen [Tue, 9 Jun 2015 14:18:29 +0000 (17:18 +0300)] 
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>
9 years agolocale.5: tfix
Michael Kerrisk [Fri, 12 Jun 2015 16:35:42 +0000 (18:35 +0200)] 
locale.5: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agolocale.5: wfix
Michael Kerrisk [Fri, 12 Jun 2015 16:35:17 +0000 (18:35 +0200)] 
locale.5: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agolocale.5: tfix / minor clarification
Marko Myllynen [Tue, 9 Jun 2015 14:20:10 +0000 (17:20 +0300)] 
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>
9 years agolocale.5: tfix
Marko Myllynen [Tue, 9 Jun 2015 14:20:01 +0000 (17:20 +0300)] 
locale.5: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
9 years agolocale.5: Sort according to the standard
Marko Myllynen [Tue, 9 Jun 2015 14:19:53 +0000 (17:19 +0300)] 
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>
9 years agolocale.5: Remove the FIXME for timezone
Marko Myllynen [Tue, 9 Jun 2015 14:19:14 +0000 (17:19 +0300)] 
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>
9 years agolocale.5: Refer to strftime(3) where appropriate
Marko Myllynen [Tue, 9 Jun 2015 14:18:48 +0000 (17:18 +0300)] 
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>
9 years agolocale.5: Refer to locale(7) more prominently
Marko Myllynen [Tue, 9 Jun 2015 14:18:24 +0000 (17:18 +0300)] 
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>