[PATCH] toupper.3: ATTRIBUTES: Note functions that are thread safe with exceptions

[PATCH] toupper.3: ATTRIBUTES: Note functions that are thread safe with exceptions

[Peng Haitao]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain; charset=UTF-8, Size: 1507 bytes --]

The functions toupper() and tolower() are thread safe with
exceptions.

Signed-off-by: Peng Haitao <penght-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/toupper.3 | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/man3/toupper.3 b/man3/toupper.3
index 7a9ba2c..f592495 100644
--- a/man3/toupper.3
+++ b/man3/toupper.3
@@ -24,7 +24,7 @@
 .\"
 .\" Modified Sat Jul 24 17:45:39 1993 by Rik Faith (faith-+5Oa3zvhR2o3uPMLIKxrzw@public.gmane.org)
 .\" Modified 2000-02-13 by Nicolás Lichtmaier <nick-8fiUuRrzOP0dnm+yROfE0A@public.gmane.org>
-.TH TOUPPER 3  1993-04-04 "GNU" "Linux Programmer's Manual"
+.TH TOUPPER 3  2013-12-24 "GNU" "Linux Programmer's Manual"
 .SH NAME
 toupper, tolower \- convert letter to upper or lower case
 .SH SYNOPSIS
@@ -58,6 +58,17 @@ is undefined.
 The value returned is that of the converted letter, or
 .I c
 if the conversion was not possible.
+.SH ATTRIBUTES
+.SS Multithreading (see pthreads(7))
+The
+.BR toupper ()
+and
+.BR tolower ()
+functions are thread-safe with exceptions.
+These functions can be safely used in multithreaded applications,
+as long as
+.BR setlocale (3)
+is not called to change the locale.
 .SH CONFORMING TO
 C89, C99, 4.3BSD.
 .SH BUGS
-- 
1.8.3.1

--
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] toupper.3: ATTRIBUTES: Note functions that are thread safe with exceptions

[Michael Kerrisk (man-pages)]

On 12/24/13 15:16, Peng Haitao wrote:
> The functions toupper() and tolower() are thread safe with
> exceptions.

Thanks. Applied!

Cheers,

Michael


> Signed-off-by: Peng Haitao <penght-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/toupper.3 | 13 ++++++++++++-
>  1 file changed, 12 insertions(+), 1 deletion(-)
> 
> diff --git a/man3/toupper.3 b/man3/toupper.3
> index 7a9ba2c..f592495 100644
> --- a/man3/toupper.3
> +++ b/man3/toupper.3
> @@ -24,7 +24,7 @@
>  .\"
>  .\" Modified Sat Jul 24 17:45:39 1993 by Rik Faith (faith-+5Oa3zvhR2o3uPMLIKxrzw@public.gmane.org)
>  .\" Modified 2000-02-13 by Nicol�s Lichtmaier <nick@debian.org>
> -.TH TOUPPER 3  1993-04-04 "GNU" "Linux Programmer's Manual"
> +.TH TOUPPER 3  2013-12-24 "GNU" "Linux Programmer's Manual"
>  .SH NAME
>  toupper, tolower \- convert letter to upper or lower case
>  .SH SYNOPSIS
> @@ -58,6 +58,17 @@ is undefined.
>  The value returned is that of the converted letter, or
>  .I c
>  if the conversion was not possible.
> +.SH ATTRIBUTES
> +.SS Multithreading (see pthreads(7))
> +The
> +.BR toupper ()
> +and
> +.BR tolower ()
> +functions are thread-safe with exceptions.
> +These functions can be safely used in multithreaded applications,
> +as long as
> +.BR setlocale (3)
> +is not called to change the locale.
>  .SH CONFORMING TO
>  C89, C99, 4.3BSD.
>  .SH BUGS
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
--
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