[PATCH] getifaddrs.3: ATTRIBUTES: Note functions that are thread-safe

[PATCH] getifaddrs.3: ATTRIBUTES: Note functions that are thread-safe

[Zeng Linggang]

After research, We think getifaddrs() and freeifaddrs() are not
thread-safe. But, there is not markings of getifaddrs() and
freeifaddrs() in glibc document.
- getifaddrs:  MT-Safe
- freeifaddrs: MT-Safe

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/getifaddrs.3 | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/man3/getifaddrs.3 b/man3/getifaddrs.3
index ae6ac8e..0437b08 100644
--- a/man3/getifaddrs.3
+++ b/man3/getifaddrs.3
@@ -167,6 +167,20 @@ the implementation supported only IPv4 addresses;
 IPv6 support was added in glibc 2.3.3.
 Support of address families other than IPv4 is available only
 on kernels that support netlink.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw27 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR getifaddrs (),
+.BR freeifaddrs ()
+T}	Thread safety	MT-Safe
+.TE
+
 .SH CONFORMING TO
 Not in POSIX.1-2001.
 This function first appeared in BSDi and is
-- 
1.8.4.2

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH] getrlimit.2: ATTRIBUTES: Note functions that are thread-safe

[Zeng Linggang]

After research, We think prlimit() is thread-safe. But, there
is not marking of prlimit() in glibc document.
getrlimit() and setrlimit() match glibc markings.
- getrlimit: MT-Safe
- setrlimit: MT-Safe
- prlimit:   MT-Safe

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man2/getrlimit.2 | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/man2/getrlimit.2 b/man2/getrlimit.2
index 211ff69..ec464fe 100644
--- a/man2/getrlimit.2
+++ b/man2/getrlimit.2
@@ -508,6 +508,21 @@ The
 .BR prlimit ()
 system call is available since Linux 2.6.36.
 Library support is available since glibc 2.13.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw35 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR getrlimit (),
+.BR setrlimit (),
+.BR prlimit ()
+T}	Thread safety	MT-Safe
+.TE
+
 .SH CONFORMING TO
 .BR getrlimit (),
 .BR setrlimit ():
-- 
1.8.4.2

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH] getrusage.2: ATTRIBUTES: Note function that is thread-safe

[Zeng Linggang]

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

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man2/getrusage.2 | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/man2/getrusage.2 b/man2/getrusage.2
index 07dcc03..5e8e35e 100644
--- a/man2/getrusage.2
+++ b/man2/getrusage.2
@@ -199,6 +199,19 @@ points outside the accessible address space.
 .B EINVAL
 .I who
 is invalid.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR getrusage ()
+T}	Thread safety	MT-Safe
+.TE
+
 .SH CONFORMING TO
 SVr4, 4.3BSD.
 POSIX.1-2001 specifies
-- 
1.8.4.2

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH] malloc_info.3: ATTRIBUTES: Note function that is thread-safe

[Zeng Linggang]

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

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/malloc_info.3 | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/man3/malloc_info.3 b/man3/malloc_info.3
index 0374e2e..580d0e9 100644
--- a/man3/malloc_info.3
+++ b/man3/malloc_info.3
@@ -60,6 +60,19 @@ was nonzero.
 .SH VERSIONS
 .BR malloc_info ()
 was added to glibc in version 2.10.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR malloc_info ()
+T}	Thread safety	MT-Safe
+.TE
+
 .SH CONFORMING TO
 This function is a GNU extension.
 .SH NOTES
-- 
1.8.4.2

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH] malloc_stats.3: ATTRIBUTES: Note function that is thread-safe

[Zeng Linggang]

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

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/malloc_stats.3 | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/man3/malloc_stats.3 b/man3/malloc_stats.3
index 8621c8c..49f97f8 100644
--- a/man3/malloc_stats.3
+++ b/man3/malloc_stats.3
@@ -52,6 +52,19 @@ allocated using
 .BR mmap (2).
 .\" .SH VERSIONS
 .\" Available already in glibc 2.0, possibly earlier
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR malloc_stats ()
+T}	Thread safety	MT-Safe
+.TE
+
 .SH CONFORMING TO
 This function is a GNU extension.
 .SH NOTES
-- 
1.8.4.2

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH] mq_notify.3: ATTRIBUTES: Note function that is thread-safe

[Zeng Linggang]

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

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/mq_notify.3 | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/man3/mq_notify.3 b/man3/mq_notify.3
index 9709e19..e1a7c2f 100644
--- a/man3/mq_notify.3
+++ b/man3/mq_notify.3
@@ -171,6 +171,19 @@ error if
 is NULL, and the caller is not currently registered to receive
 notifications for the queue
 .IR mqdes .
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR mq_notify ()
+T}	Thread safety	MT-Safe
+.TE
+
 .SH CONFORMING TO
 POSIX.1-2001.
 .SH NOTES
-- 
1.8.4.2

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH] psignal.3: ATTRIBUTES: Note functions that are thread-safe

[Zeng Linggang]

After research, We think psiginfo() is thread-safe. But, there
is not marking of psiginfo() in glibc document.
psignal() matches glibc marking.
- psignal:  MT-Safe locale
- psiginfo: MT-Safe locale

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/psignal.3 | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/man3/psignal.3 b/man3/psignal.3
index 12124be..3ded4b0 100644
--- a/man3/psignal.3
+++ b/man3/psignal.3
@@ -96,6 +96,20 @@ functions return no value.
 The
 .BR psiginfo ()
 function was added to glibc in version 2.10.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw21 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR psignal (),
+.BR psiginfo ()
+T}	Thread safety	MT-Safe locale
+.TE
+
 .SH CONFORMING TO
 POSIX.1-2008, 4.3BSD.
 .SH BUGS
-- 
1.8.4.2

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH] sem_open.3: ATTRIBUTES: Note function that is thread-safe

[Zeng Linggang]

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

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/sem_open.3 | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/man3/sem_open.3 b/man3/sem_open.3
index b5363c7..8f5b5b6 100644
--- a/man3/sem_open.3
+++ b/man3/sem_open.3
@@ -167,6 +167,19 @@ wasn't well formed.
 .TP
 .B ENOMEM
 Insufficient memory.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR sem_open ()
+T}	Thread safety	MT-Safe
+.TE
+
 .SH CONFORMING TO
 POSIX.1-2001.
 .SH SEE ALSO
-- 
1.8.4.2

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH] shm_open.3: ATTRIBUTES: Note functions that are thread-safe

[Zeng Linggang]

The marking matches glibc marking.
markings of functions in glibc are:
- shm_open:   MT-Safe locale
- shm_unlink: MT-Safe locale

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/shm_open.3 | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/man3/shm_open.3 b/man3/shm_open.3
index 3ad7592..a4eb22a 100644
--- a/man3/shm_open.3
+++ b/man3/shm_open.3
@@ -248,6 +248,20 @@ a
 that does not exist.
 .SH VERSIONS
 These functions are provided in glibc 2.2 and later.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw24 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR shm_open (),
+.BR shm_unlink ()
+T}	Thread safety	MT-Safe locale
+.TE
+
 .SH CONFORMING TO
 POSIX.1-2001.
 .LP
-- 
1.8.4.2

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH] sigaltstack.2: ATTRIBUTES: Note function that is thread-safe

[Zeng Linggang]

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

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man2/sigaltstack.2 | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/man2/sigaltstack.2 b/man2/sigaltstack.2
index fb58593..a33d59b 100644
--- a/man2/sigaltstack.2
+++ b/man2/sigaltstack.2
@@ -155,6 +155,19 @@ was less than
 An attempt was made to change the alternate signal stack while
 it was active (i.e., the process was already executing
 on the current alternate signal stack).
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR sigaltstack ()
+T}	Thread safety	MT-Safe
+.TE
+
 .SH CONFORMING TO
 SUSv2, SVr4, POSIX.1-2001.
 .SH NOTES
-- 
1.8.4.2

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] getifaddrs.3: ATTRIBUTES: Note functions that are thread-safe

[Michael Kerrisk (man-pages)]

Hello Zeng Linggang,

On 05/13/2015 08:53 AM, Zeng Linggang wrote:
> After research, We think getifaddrs() and freeifaddrs() are not
> thread-safe. But, there is not markings of getifaddrs() and
> freeifaddrs() in glibc document.

In cases such as this, it's good to tell me that there is no marking
in the glibc manual, but in that case you can skip omit the next two lines:

> - getifaddrs:  MT-Safe
> - freeifaddrs: MT-Safe

Patch applied. Thanks!

Cheers,

Michael


> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/getifaddrs.3 | 14 ++++++++++++++
>  1 file changed, 14 insertions(+)
> 
> diff --git a/man3/getifaddrs.3 b/man3/getifaddrs.3
> index ae6ac8e..0437b08 100644
> --- a/man3/getifaddrs.3
> +++ b/man3/getifaddrs.3
> @@ -167,6 +167,20 @@ the implementation supported only IPv4 addresses;
>  IPv6 support was added in glibc 2.3.3.
>  Support of address families other than IPv4 is available only
>  on kernels that support netlink.
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lbw27 lb lb
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR getifaddrs (),
> +.BR freeifaddrs ()
> +T}	Thread safety	MT-Safe
> +.TE
> +
>  .SH CONFORMING TO
>  Not in POSIX.1-2001.
>  This function first appeared in BSDi and is
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] getrlimit.2: ATTRIBUTES: Note functions that are thread-safe

[Michael Kerrisk (man-pages)]

On 05/13/2015 08:53 AM, Zeng Linggang wrote:
> After research, We think prlimit() is thread-safe. But, there
> is not marking of prlimit() in glibc document.
> getrlimit() and setrlimit() match glibc markings.
> - getrlimit: MT-Safe
> - setrlimit: MT-Safe

The following line would best be omitted. All I'd like to see here is 
what's in the glibc manual.

> - prlimit:   MT-Safe

Thanks, Zeng Linggang. Patch applied.

Cheers,

Michael


> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man2/getrlimit.2 | 15 +++++++++++++++
>  1 file changed, 15 insertions(+)
> 
> diff --git a/man2/getrlimit.2 b/man2/getrlimit.2
> index 211ff69..ec464fe 100644
> --- a/man2/getrlimit.2
> +++ b/man2/getrlimit.2
> @@ -508,6 +508,21 @@ The
>  .BR prlimit ()
>  system call is available since Linux 2.6.36.
>  Library support is available since glibc 2.13.
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lbw35 lb lb
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR getrlimit (),
> +.BR setrlimit (),
> +.BR prlimit ()
> +T}	Thread safety	MT-Safe
> +.TE
> +
>  .SH CONFORMING TO
>  .BR getrlimit (),
>  .BR setrlimit ():
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] getrusage.2: ATTRIBUTES: Note function that is thread-safe

[Michael Kerrisk (man-pages)]

On 05/13/2015 08:53 AM, Zeng Linggang wrote:
> The marking matches glibc marking.
> The marking of functions in glibc is:
> - getrusage: MT-Safe


Thanks, Zeng Linggang. Patch applied.

Cheers,

Michael


> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man2/getrusage.2 | 13 +++++++++++++
>  1 file changed, 13 insertions(+)
> 
> diff --git a/man2/getrusage.2 b/man2/getrusage.2
> index 07dcc03..5e8e35e 100644
> --- a/man2/getrusage.2
> +++ b/man2/getrusage.2
> @@ -199,6 +199,19 @@ points outside the accessible address space.
>  .B EINVAL
>  .I who
>  is invalid.
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lb lb lb
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR getrusage ()
> +T}	Thread safety	MT-Safe
> +.TE
> +
>  .SH CONFORMING TO
>  SVr4, 4.3BSD.
>  POSIX.1-2001 specifies
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] malloc_info.3: ATTRIBUTES: Note function that is thread-safe

[Michael Kerrisk (man-pages)]

On 05/13/2015 08:53 AM, Zeng Linggang wrote:
> After research, We think malloc_info() is thread-safe. But, there
> is not marking of malloc_info() in glibc document.


XXX > - malloc_info: MT-Safe


Thanks, Zeng Linggang. Patch applied.

Cheers,

Michael


> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/malloc_info.3 | 13 +++++++++++++
>  1 file changed, 13 insertions(+)
> 
> diff --git a/man3/malloc_info.3 b/man3/malloc_info.3
> index 0374e2e..580d0e9 100644
> --- a/man3/malloc_info.3
> +++ b/man3/malloc_info.3
> @@ -60,6 +60,19 @@ was nonzero.
>  .SH VERSIONS
>  .BR malloc_info ()
>  was added to glibc in version 2.10.
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lb lb lb
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR malloc_info ()
> +T}	Thread safety	MT-Safe
> +.TE
> +
>  .SH CONFORMING TO
>  This function is a GNU extension.
>  .SH NOTES
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] malloc_stats.3: ATTRIBUTES: Note function that is thread-safe

[Michael Kerrisk (man-pages)]

On 05/13/2015 08:53 AM, Zeng Linggang wrote:
> After research, We think malloc_stats() is thread-safe. But, there
> is not marking of malloc_stats() in glibc document.

XXXX > - malloc_stats: MT-Safe


Thanks, Zeng Linggang. Patch applied.

Cheers,

Michael


> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/malloc_stats.3 | 13 +++++++++++++
>  1 file changed, 13 insertions(+)
> 
> diff --git a/man3/malloc_stats.3 b/man3/malloc_stats.3
> index 8621c8c..49f97f8 100644
> --- a/man3/malloc_stats.3
> +++ b/man3/malloc_stats.3
> @@ -52,6 +52,19 @@ allocated using
>  .BR mmap (2).
>  .\" .SH VERSIONS
>  .\" Available already in glibc 2.0, possibly earlier
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lb lb lb
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR malloc_stats ()
> +T}	Thread safety	MT-Safe
> +.TE
> +
>  .SH CONFORMING TO
>  This function is a GNU extension.
>  .SH NOTES
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] mq_notify.3: ATTRIBUTES: Note function that is thread-safe

[Michael Kerrisk (man-pages)]

On 05/13/2015 08:53 AM, Zeng Linggang wrote:
> After research, We think mq_notify() is thread-safe. But, there
> is not marking of mq_notify() in glibc document.

XXX > - mq_notify: MT-Safe

Thanks, Zeng Linggang. Patch applied.

Cheers,

Michael


> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/mq_notify.3 | 13 +++++++++++++
>  1 file changed, 13 insertions(+)
> 
> diff --git a/man3/mq_notify.3 b/man3/mq_notify.3
> index 9709e19..e1a7c2f 100644
> --- a/man3/mq_notify.3
> +++ b/man3/mq_notify.3
> @@ -171,6 +171,19 @@ error if
>  is NULL, and the caller is not currently registered to receive
>  notifications for the queue
>  .IR mqdes .
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lb lb lb
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR mq_notify ()
> +T}	Thread safety	MT-Safe
> +.TE
> +
>  .SH CONFORMING TO
>  POSIX.1-2001.
>  .SH NOTES
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] psignal.3: ATTRIBUTES: Note functions that are thread-safe

[Michael Kerrisk (man-pages)]

On 05/13/2015 08:53 AM, Zeng Linggang wrote:
> After research, We think psiginfo() is thread-safe. But, there
> is not marking of psiginfo() in glibc document.
> psignal() matches glibc marking.
> - psignal:  MT-Safe locale

XXX > - psiginfo: MT-Safe locale


Thanks, Zeng Linggang. Patch applied.

Cheers,

Michael


> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/psignal.3 | 14 ++++++++++++++
>  1 file changed, 14 insertions(+)
> 
> diff --git a/man3/psignal.3 b/man3/psignal.3
> index 12124be..3ded4b0 100644
> --- a/man3/psignal.3
> +++ b/man3/psignal.3
> @@ -96,6 +96,20 @@ functions return no value.
>  The
>  .BR psiginfo ()
>  function was added to glibc in version 2.10.
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lbw21 lb lb
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR psignal (),
> +.BR psiginfo ()
> +T}	Thread safety	MT-Safe locale
> +.TE
> +
>  .SH CONFORMING TO
>  POSIX.1-2008, 4.3BSD.
>  .SH BUGS
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] sem_open.3: ATTRIBUTES: Note function that is thread-safe

[Michael Kerrisk (man-pages)]

On 05/13/2015 08:53 AM, Zeng Linggang wrote:
> The marking matches glibc marking.
> The marking of functions in glibc is:
> - sem_open: MT-Safe


Thanks, Zeng Linggang. Patch applied.

Cheers,

Michael


> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/sem_open.3 | 13 +++++++++++++
>  1 file changed, 13 insertions(+)
> 
> diff --git a/man3/sem_open.3 b/man3/sem_open.3
> index b5363c7..8f5b5b6 100644
> --- a/man3/sem_open.3
> +++ b/man3/sem_open.3
> @@ -167,6 +167,19 @@ wasn't well formed.
>  .TP
>  .B ENOMEM
>  Insufficient memory.
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lb lb lb
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR sem_open ()
> +T}	Thread safety	MT-Safe
> +.TE
> +
>  .SH CONFORMING TO
>  POSIX.1-2001.
>  .SH SEE ALSO
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] shm_open.3: ATTRIBUTES: Note functions that are thread-safe

[Michael Kerrisk (man-pages)]

On 05/13/2015 08:53 AM, Zeng Linggang wrote:
> The marking matches glibc marking.
> markings of functions in glibc are:
> - shm_open:   MT-Safe locale
> - shm_unlink: MT-Safe locale


Thanks, Zeng Linggang. Patch applied.

Cheers,

Michael


> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/shm_open.3 | 14 ++++++++++++++
>  1 file changed, 14 insertions(+)
> 
> diff --git a/man3/shm_open.3 b/man3/shm_open.3
> index 3ad7592..a4eb22a 100644
> --- a/man3/shm_open.3
> +++ b/man3/shm_open.3
> @@ -248,6 +248,20 @@ a
>  that does not exist.
>  .SH VERSIONS
>  These functions are provided in glibc 2.2 and later.
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lbw24 lb lb
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR shm_open (),
> +.BR shm_unlink ()
> +T}	Thread safety	MT-Safe locale
> +.TE
> +
>  .SH CONFORMING TO
>  POSIX.1-2001.
>  .LP
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] sigaltstack.2: ATTRIBUTES: Note function that is thread-safe

[Michael Kerrisk (man-pages)]

On 05/13/2015 08:53 AM, Zeng Linggang wrote:
> The marking matches glibc marking.
> The marking of functions in glibc is:
> - sigaltstack: MT-Safe


Thanks, Zeng Linggang. Patch applied.

Cheers,

Michael


> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man2/sigaltstack.2 | 13 +++++++++++++
>  1 file changed, 13 insertions(+)
> 
> diff --git a/man2/sigaltstack.2 b/man2/sigaltstack.2
> index fb58593..a33d59b 100644
> --- a/man2/sigaltstack.2
> +++ b/man2/sigaltstack.2
> @@ -155,6 +155,19 @@ was less than
>  An attempt was made to change the alternate signal stack while
>  it was active (i.e., the process was already executing
>  on the current alternate signal stack).
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lb lb lb
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR sigaltstack ()
> +T}	Thread safety	MT-Safe
> +.TE
> +
>  .SH CONFORMING TO
>  SUSv2, SVr4, POSIX.1-2001.
>  .SH NOTES
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] getrlimit.2: ATTRIBUTES: Note functions that are thread-safe

[Zeng Linggang]

Hi,

On Wed, 2015-05-13 at 17:17 +0200, Michael Kerrisk (man-pages) wrote:
> On 05/13/2015 08:53 AM, Zeng Linggang wrote:
> > After research, We think prlimit() is thread-safe. But, there
> > is not marking of prlimit() in glibc document.
> > getrlimit() and setrlimit() match glibc markings.
> > - getrlimit: MT-Safe
> > - setrlimit: MT-Safe
> 
> The following line would best be omitted. All I'd like to see here is 
> what's in the glibc manual.
> 

OK.

Thank you.

Best regards,
Zeng

> > - prlimit:   MT-Safe
> 
> Thanks, Zeng Linggang. Patch applied.
> 
> Cheers,
> 
> Michael

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html