OSDN Git Service

(split) LDP: Update release pages based on LDP 3.54 release
[linuxjm/LDP_man-pages.git] / release / man3 / unlocked_stdio.3
index 6f21e3d..0b0080c 100644 (file)
@@ -1,5 +1,6 @@
 .\" Copyright (C) 2001 Andries Brouwer <aeb@cwi.nl>.
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
+.\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
 .\"
 .\" Japanese Version Copyright (c) 2001 Akihiro MOTOKI
 .\"         all rights reserved.
 .\" Translated Fri Nov 2 23:08:42 2001
 .\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
 .\"
-.TH UNLOCKED_STDIO 3  2008-08-29 "" "Linux Programmer's Manual"
-.SH Ì¾Á°
-getc_unlocked, getchar_unlocked, putc_unlocked,
-putchar_unlocked \- ¥í¥Ã¥¯¤ò¹Ô¤ï¤º¤Ëɸ½àÆþ½ÐÎϤò¹Ô¤¦´Ø¿ô·²
-.SH ½ñ¼°
+.TH UNLOCKED_STDIO 3 2008\-08\-29 "" "Linux Programmer's Manual"
+.SH 名前
+getc_unlocked, getchar_unlocked, putc_unlocked, putchar_unlocked \-
+ロックを行わずに標準入出力を行う関数群
+.SH 書式
 .nf
-.B #include <stdio.h>
+\fB#include <stdio.h>\fP
 .sp
-.BI "int getc_unlocked(FILE *" stream );
-.B "int getchar_unlocked(void);"
-.BI "int putc_unlocked(int " c ", FILE *" stream );
-.BI "int putchar_unlocked(int " c );
+\fBint getc_unlocked(FILE *\fP\fIstream\fP\fB);\fP
+\fBint getchar_unlocked(void);\fP
+\fBint putc_unlocked(int \fP\fIc\fP\fB, FILE *\fP\fIstream\fP\fB);\fP
+\fBint putchar_unlocked(int \fP\fIc\fP\fB);\fP
 .sp
-.BI "void clearerr_unlocked(FILE *" stream );
-.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 fgetc_unlocked(FILE *" stream );
-.BI "int fputc_unlocked(int " c ", FILE *" stream );
-.BI "size_t fread_unlocked(void *" ptr ", size_t " size ", size_t " n ,
-.BI "                      FILE *" stream );
-.BI "size_t fwrite_unlocked(const void *" ptr ", size_t " size ", size_t " n ,
-.BI "                      FILE *" stream );
+\fBvoid clearerr_unlocked(FILE *\fP\fIstream\fP\fB);\fP
+\fBint feof_unlocked(FILE *\fP\fIstream\fP\fB);\fP
+\fBint ferror_unlocked(FILE *\fP\fIstream\fP\fB);\fP
+\fBint fileno_unlocked(FILE *\fP\fIstream\fP\fB);\fP
+\fBint fflush_unlocked(FILE *\fP\fIstream\fP\fB);\fP
+\fBint fgetc_unlocked(FILE *\fP\fIstream\fP\fB);\fP
+\fBint fputc_unlocked(int \fP\fIc\fP\fB, FILE *\fP\fIstream\fP\fB);\fP
+\fBsize_t fread_unlocked(void *\fP\fIptr\fP\fB, size_t \fP\fIsize\fP\fB, size_t \fP\fIn\fP\fB,\fP
+\fB                      FILE *\fP\fIstream\fP\fB);\fP
+\fBsize_t fwrite_unlocked(const void *\fP\fIptr\fP\fB, size_t \fP\fIsize\fP\fB, size_t \fP\fIn\fP\fB,\fP
+\fB                      FILE *\fP\fIstream\fP\fB);\fP
 .sp
-.BI "char *fgets_unlocked(char *" s ", int " n ", FILE *" stream );
-.BI "int fputs_unlocked(const char *" s ", FILE *" stream );
+\fBchar *fgets_unlocked(char *\fP\fIs\fP\fB, int \fP\fIn\fP\fB, FILE *\fP\fIstream\fP\fB);\fP
+\fBint fputs_unlocked(const char *\fP\fIs\fP\fB, FILE *\fP\fIstream\fP\fB);\fP
 .sp
-.B #include <wchar.h>
+\fB#include <wchar.h>\fP
 .sp
-.BI "wint_t getwc_unlocked(FILE *" stream );
-.B "wint_t getwchar_unlocked(void);"
-.BI "wint_t fgetwc_unlocked(FILE *" stream );
-.BI "wint_t fputwc_unlocked(wchar_t " wc ", FILE *" stream );
-.BI "wint_t putwc_unlocked(wchar_t " wc ", FILE *" stream );
-.BI "wint_t putwchar_unlocked(wchar_t " wc );
-.BI "wchar_t *fgetws_unlocked(wchar_t *" ws ", int " n ", FILE *" stream );
-.BI "int fputws_unlocked(const wchar_t *" ws ", FILE *" stream );
+\fBwint_t getwc_unlocked(FILE *\fP\fIstream\fP\fB);\fP
+\fBwint_t getwchar_unlocked(void);\fP
+\fBwint_t fgetwc_unlocked(FILE *\fP\fIstream\fP\fB);\fP
+\fBwint_t fputwc_unlocked(wchar_t \fP\fIwc\fP\fB, FILE *\fP\fIstream\fP\fB);\fP
+\fBwint_t putwc_unlocked(wchar_t \fP\fIwc\fP\fB, FILE *\fP\fIstream\fP\fB);\fP
+\fBwint_t putwchar_unlocked(wchar_t \fP\fIwc\fP\fB);\fP
+\fBwchar_t *fgetws_unlocked(wchar_t *\fP\fIws\fP\fB, int \fP\fIn\fP\fB, FILE *\fP\fIstream\fP\fB);\fP
+\fBint fputws_unlocked(const wchar_t *\fP\fIws\fP\fB, FILE *\fP\fIstream\fP\fB);\fP
 .fi
 .sp
 .in -4n
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
-.RB ( feature_test_macros (7)
-»²¾È):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .ad l
 .in
 .sp
-.BR getc_unlocked (),
-.BR getchar_unlocked (),
-.BR putc_unlocked (),
-.BR putchar_unlocked ():
+\fBgetc_unlocked\fP(), \fBgetchar_unlocked\fP(), \fBputc_unlocked\fP(),
+\fBputchar_unlocked\fP():
 .RS 4
-_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE ||
-_BSD_SOURCE || _SVID_SOURCE
+_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE || _BSD_SOURCE
+|| _SVID_SOURCE
 .RE
 .sp
-.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 ():
+\fBclearerr_unlocked\fP(), \fBfeof_unlocked\fP(), \fBferror_unlocked\fP(),
+\fBfileno_unlocked\fP(), \fBfflush_unlocked\fP(), \fBfgetc_unlocked\fP(),
+\fBfputc_unlocked\fP(), \fBfread_unlocked\fP(), \fBfwrite_unlocked\fP():
 .RS 4
 _BSD_SOURCE || _SVID_SOURCE
 .RE
 .sp
-.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 ():
+\fBfgets_unlocked\fP(), \fBfputs_unlocked\fP(), \fBgetwc_unlocked\fP(),
+\fBgetwchar_unlocked\fP(), \fBfgetwc_unlocked\fP(), \fBfputwc_unlocked\fP(),
+\fBputwchar_unlocked\fP(), \fBfgetws_unlocked\fP(), \fBfputws_unlocked\fP():
 .RS 4
 _GNU_SOURCE
 .RE
 .ad b
-.SH ÀâÌÀ
-¤³¤ì¤é¤Î´Ø¿ô¤Ï¡¢ËöÈø¤Ë "_unlocked" ¤¬¤Ä¤¤¤Æ¤¤¤Ê¤¤´Ø¿ô¤ÈƱ¤¸Æ°ºî¤ò¤¹¤ë¤¬¡¢
-¥Õ¥¡¥¤¥ë¤Î¥í¥Ã¥¯¤ò»ÈÍѤ·¤Ê¤¤ÅÀ¤¬°Û¤Ê¤ë¡£(¤³¤ì¤é¤Î´Ø¿ô¼«¿È¤Ï¥Õ¥¡¥¤¥ë¤Î¥í¥Ã¥¯
-¤ò¥»¥Ã¥È¤»¤º¡¢Â¾¤Î´Ø¿ô¤Ë¤è¤Ã¤Æ¥í¥Ã¥¯¤¬¥»¥Ã¥È¤µ¤ì¤Æ¤¤¤ë¤«¤É¤¦¤«¤Î¥Á¥§¥Ã¥¯¤â
-¹Ô¤ï¤Ê¤¤) ¤½¤ì¤æ¤¨¡¢¥¹¥ì¥Ã¥É(thread)¤Ç°ÂÁ´¤Ë»ÈÍѤ¹¤ë¤³¤È¤¬¤Ç¤­¤Ê¤¤¡£
-.BR flockfile (3)
-¤ò»²¾È¤Î¤³¤È¡£
-.SH ½àµò
-.BR getc_unlocked (),
-.BR getchar_unlocked (),
-.BR putc_unlocked (),
-.BR putchar_unlocked ()
-¤Î 4 ¤Ä¤Î´Ø¿ô¤Ï
-POSIX.1-2001 ¤Ëµ¬Äꤵ¤ì¤Æ¤¤¤ë¡£
+.SH 説明
+これらの関数は、末尾に "_unlocked" がついていない関数と同じ動作をするが、
+ファイルのロックを使用しない点が異なる。(これらの関数自身はファイルのロック をセットせず、他の関数によってロックがセットされているかどうかのチェックも
+行わない) それゆえ、スレッド(thread)で安全に使用することができない。 \fBflockfile\fP(3)  を参照のこと。
+.SH 準拠
+\fBgetc_unlocked\fP(), \fBgetchar_unlocked\fP(), \fBputc_unlocked\fP(),
+\fBputchar_unlocked\fP()  の 4 つの関数は POSIX.1\-2001 に規定されている。
 
-Èóɸ½à¤Î
-.BR *_unlocked ()
-¤ÎÃç´Ö¤Ï 2¡¢3 ¤Î UNIX ¥·¥¹¥Æ¥à¤ÇÄêµÁ¤µ¤ì¤Æ¤ª¤ê¡¢
-ºÇ¶á¤Î glibc ¤Ç¤Ï»ÈÍѲÄǽ¤Ç¤¢¤ë¤¬¡¢
 .\" 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,
@@ -137,8 +118,11 @@ POSIX.1-2001 
 .\" putchar_unlocked, puts_unlocked, putws_unlocked, putw_unlocked,
 .\" putwc_unlocked, putwchar_unlocked, rewind_unlocked, setvbuf_unlocked,
 .\" ungetc_unlocked, ungetwc_unlocked.
-¤³¤ì¤é¤Î´Ø¿ô¤Ï»È¤ï¤Ê¤¤Êý¤¬¤è¤¤¤À¤í¤¦¡£
-.SH ´ØÏ¢¹àÌÜ
-.BR flockfile (3),
-.BR stdio (3),
-.BR feature_test_macros (7)
+非標準の \fB*_unlocked\fP()  の仲間は 2、3 の UNIX システムで定義されており、 最近の glibc では使用可能であるが、
+これらの関数は使わない方がよいだろう。
+.SH 関連項目
+\fBflockfile\fP(3), \fBstdio\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.54 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。