All of lore.kernel.org
 help / color / mirror / Atom feed
From: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
To: mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org
Cc: linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
Subject: [PATCH] unlocked_stdio.3: ATTRIBUTES: Note functions that aren't thread-safe
Date: Wed, 8 Apr 2015 10:56:24 +0800	[thread overview]
Message-ID: <1428461788-7518-14-git-send-email-zenglg.jy@cn.fujitsu.com> (raw)
In-Reply-To: <1428461788-7518-1-git-send-email-zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>

The markings match glibc markings.

getc_unlocked:     MT-Safe race:stream
putc_unlocked:     MT-Safe race:stream
clearerr_unlocked: MT-Safe race:stream
fflush_unlocked:   MT-Safe race:stream
fgetc_unlocked:    MT-Safe race:stream
fputc_unlocked:    MT-Safe race:stream
fread_unlocked:    MT-Safe race:stream
fwrite_unlocked:   MT-Safe race:stream
fgets_unlocked:    MT-Safe race:stream
fputs_unlocked:    MT-Safe race:stream
getwc_unlocked:    MT-Safe race:stream
fgetwc_unlocked:   MT-Safe race:stream
fputwc_unlocked:   MT-Safe race:stream
putwc_unlocked:    MT-Safe race:stream
fgetws_unlocked:   MT-Safe race:stream
fputws_unlocked:   MT-Safe race:stream

getchar_unlocked:  MT-Unsafe race:stdin
getwchar_unlocked: MT-Unsafe race:stdin

putchar_unlocked:  MT-Unsafe race:stdout
putwchar_unlocked: MT-Unsafe race:stdout

feof_unlocked:     MT-Safe
ferror_unlocked:   MT-Safe
fileno_unlocked:   MT-Safe

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

diff --git a/man3/unlocked_stdio.3 b/man3/unlocked_stdio.3
index d5aada7..24bd179 100644
--- a/man3/unlocked_stdio.3
+++ b/man3/unlocked_stdio.3
@@ -110,6 +110,47 @@ without the "_unlocked" suffix, except that they do not use locking
 of locks set by others) and hence are thread-unsafe.
 See
 .BR flockfile (3).
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw20 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR getc_unlocked (),
+.BR putc_unlocked (),
+.BR clearerr_unlocked (),
+.BR fflush_unlocked (),
+.BR fgetc_unlocked (),
+.BR fputc_unlocked (),
+.BR fread_unlocked (),
+.BR fwrite_unlocked (),
+.BR fgets_unlocked (),
+.BR fputs_unlocked (),
+.BR getwc_unlocked (),
+.BR fgetwc_unlocked (),
+.BR fputwc_unlocked (),
+.BR putwc_unlocked (),
+.BR fgetws_unlocked (),
+.BR fputws_unlocked ()
+T}	Thread safety	MT-Safe race:stream
+T{
+.BR getchar_unlocked (),
+.BR getwchar_unlocked ()
+T}	Thread safety	MT-Unsafe race:stdin
+T{
+.BR putchar_unlocked (),
+.BR putwchar_unlocked ()
+T}	Thread safety	MT-Unsafe race:stdout
+T{
+.BR feof_unlocked (),
+.BR ferror_unlocked (),
+.BR fileno_unlocked ()
+T}	Thread safety	MT-Safe
+.TE
+
 .SH CONFORMING TO
 The four functions
 .BR getc_unlocked (),
-- 
1.9.3

--
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

  parent reply	other threads:[~2015-04-08  2:56 UTC|newest]

Thread overview: 20+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2015-04-08  2:56 [PATCH ] ATTRIBUTES: new correct versions Zeng Linggang
     [not found] ` <1428461788-7518-1-git-send-email-zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
2015-04-08  2:56   ` [PATCH] asprintf.3: ATTRIBUTES: Note functions that are thread-safe Zeng Linggang
2015-04-08  2:56   ` [PATCH] ctime.3: ATTRIBUTES: Note functions that aren't thread-safe Zeng Linggang
2015-04-08  2:56   ` [PATCH] gethostbyname.3: " Zeng Linggang
2015-04-08  2:56   ` [PATCH] getnetent.3: " Zeng Linggang
2015-04-08  2:56   ` [PATCH] get_nprocs_conf.3: ATTRIBUTES: Note functions that are thread-safe Zeng Linggang
2015-04-08  2:56   ` [PATCH] getutent.3: ATTRIBUTES: Note functions that aren't thread-safe Zeng Linggang
2015-04-08  2:56   ` [PATCH] mbsnrtowcs.3: ATTRIBUTES: Note function that isn't thread-safe Zeng Linggang
2015-04-08  2:56   ` [PATCH] mbsrtowcs.3: " Zeng Linggang
2015-04-08  2:56   ` [PATCH] perror.3: ATTRIBUTES: Note function that is thread-safe Zeng Linggang
2015-04-08  2:56   ` [PATCH] printf.3: ATTRIBUTES: Note functions that are thread-safe Zeng Linggang
2015-04-08  2:56   ` [PATCH] scandir.3: " Zeng Linggang
2015-04-08  2:56   ` [PATCH] scanf.3: " Zeng Linggang
2015-04-08  2:56   ` Zeng Linggang [this message]
2015-04-08  2:56   ` [PATCH] wcrtomb.3: ATTRIBUTES: Note function that isn't thread-safe Zeng Linggang
2015-04-08  2:56   ` [PATCH] wcsnrtombs.3: " Zeng Linggang
2015-04-08  2:56   ` [PATCH] wcsrtombs.3: " Zeng Linggang
2015-04-08  2:56   ` [PATCH] wprintf.3: ATTRIBUTES: Note functions that are thread-safe Zeng Linggang
2015-04-11  6:53   ` [PATCH ] ATTRIBUTES: new correct versions Michael Kerrisk (man-pages)
     [not found]     ` <5528C4DC.6000006-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2015-04-13  1:32       ` Zeng Linggang

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=1428461788-7518-14-git-send-email-zenglg.jy@cn.fujitsu.com \
    --to=zenglg.jy-bthxqxjhjhxqfuhtdcdx3a@public.gmane.org \
    --cc=linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
    --cc=mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.