diff options
Diffstat (limited to 'man3/unlocked_stdio.3')
-rw-r--r-- | man3/unlocked_stdio.3 | 101 |
1 files changed, 59 insertions, 42 deletions
diff --git a/man3/unlocked_stdio.3 b/man3/unlocked_stdio.3 index 148e01da7..a74e6b2aa 100644 --- a/man3/unlocked_stdio.3 +++ b/man3/unlocked_stdio.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH unlocked_stdio 3 2023-02-05 "Linux man-pages 6.03" +.TH unlocked_stdio 3 2023-07-30 "Linux man-pages 6.05.01" .SH NAME getc_unlocked, getchar_unlocked, putc_unlocked, putchar_unlocked \- nonlocking stdio functions @@ -23,7 +23,7 @@ Standard C library .BI "int feof_unlocked(FILE *" stream ); .BI "int ferror_unlocked(FILE *" stream ); .BI "int fileno_unlocked(FILE *" stream ); -.BI "int fflush_unlocked(FILE *" stream ); +.BI "int fflush_unlocked(FILE *_Nullable " stream ); .PP .BI "int fgetc_unlocked(FILE *" stream ); .BI "int fputc_unlocked(int " c ", FILE *" stream ); @@ -58,48 +58,44 @@ Standard C library .RS -4 Feature Test Macro Requirements for glibc (see .BR feature_test_macros (7)): -.nh .RE -.ad l .PP -.BR getc_unlocked (), -.BR getchar_unlocked (), -.BR putc_unlocked (), -.BR putchar_unlocked (): +.BR \%getc_unlocked (), +.BR \%getchar_unlocked (), +.BR \%putc_unlocked (), +.BR \%putchar_unlocked (): .nf /* glibc >= 2.24: */ _POSIX_C_SOURCE >= 199309L || /* glibc <= 2.23: */ _POSIX_C_SOURCE || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .fi .PP -.BR clearerr_unlocked (), -.BR feof_unlocked (), -.BR ferror_unlocked (), -.BR fileno_unlocked (), -.BR fflush_unlocked (), -.BR fgetc_unlocked (), -.BR fputc_unlocked (), -.BR fread_unlocked (), -.BR fwrite_unlocked (): +.BR \%clearerr_unlocked (), +.BR \%feof_unlocked (), +.BR \%ferror_unlocked (), +.BR \%fileno_unlocked (), +.BR \%fflush_unlocked (), +.BR \%fgetc_unlocked (), +.BR \%fputc_unlocked (), +.BR \%fread_unlocked (), +.BR \%fwrite_unlocked (): .nf /* glibc >= 2.19: */ _DEFAULT_SOURCE || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .fi .PP -.BR fgets_unlocked (), -.BR fputs_unlocked (), -.BR getwc_unlocked (), -.BR getwchar_unlocked (), -.BR fgetwc_unlocked (), -.BR fputwc_unlocked (), -.BR putwchar_unlocked (), -.BR fgetws_unlocked (), -.BR fputws_unlocked (): +.BR \%fgets_unlocked (), +.BR \%fputs_unlocked (), +.BR \%getwc_unlocked (), +.BR \%getwchar_unlocked (), +.BR \%fgetwc_unlocked (), +.BR \%fputwc_unlocked (), +.BR \%putwchar_unlocked (), +.BR \%fgetws_unlocked (), +.BR \%fputws_unlocked (): .nf _GNU_SOURCE .fi -.hy -.ad .SH DESCRIPTION Each of these functions has the same behavior as its counterpart without the "_unlocked" suffix, except that they do not use locking @@ -110,14 +106,14 @@ See .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). -.ad l -.nh .TS allbox; lb lb lbx l l l. Interface Attribute Value T{ +.na +.nh .BR getc_unlocked (), .BR putc_unlocked (), .BR clearerr_unlocked (), @@ -135,40 +131,62 @@ T{ .BR fgetws_unlocked (), .BR fputws_unlocked () T} Thread safety T{ +.na +.nh MT-Safe race:stream T} T{ +.na +.nh .BR getchar_unlocked (), .BR getwchar_unlocked () T} Thread safety T{ +.na +.nh MT-Unsafe race:stdin T} T{ +.na +.nh .BR putchar_unlocked (), .BR putwchar_unlocked () T} Thread safety T{ +.na +.nh MT-Unsafe race:stdout T} T{ +.na +.nh .BR feof_unlocked (), .BR ferror_unlocked (), .BR fileno_unlocked () T} Thread safety MT-Safe .TE -.hy -.ad .sp 1 .SH STANDARDS -The four functions -.BR getc_unlocked (), -.BR getchar_unlocked (), -.BR putc_unlocked (), +.TP +.BR getc_unlocked () +.TQ +.BR getchar_unlocked () +.TQ +.BR putc_unlocked () +.TQ .BR putchar_unlocked () -are in POSIX.1-2001 and POSIX.1-2008. -.PP -The nonstandard -.BR *_unlocked () -variants occur on a few UNIX systems, and are available in recent glibc. +POSIX.1-2008. +.TP +Others: +None. +.SH HISTORY +.TP +.BR getc_unlocked () +.TQ +.BR getchar_unlocked () +.TQ +.BR putc_unlocked () +.TQ +.BR putchar_unlocked () +POSIX.1-2001. .\" E.g., in HP-UX 10.0. In HP-UX 10.30 they are called obsolescent, and .\" moved to a compatibility library. .\" Available in HP-UX 10.0: clearerr_unlocked, fclose_unlocked, @@ -180,7 +198,6 @@ variants occur on a few UNIX systems, and are available in recent glibc. .\" putchar_unlocked, puts_unlocked, putws_unlocked, putw_unlocked, .\" putwc_unlocked, putwchar_unlocked, rewind_unlocked, setvbuf_unlocked, .\" ungetc_unlocked, ungetwc_unlocked. -They should probably not be used. .SH SEE ALSO .BR flockfile (3), .BR stdio (3) |