(split) LDP: Update the version to 3.53 in PO files

[linuxjm/LDP_man-pages.git] / draft / man2 / write.2

diff --git a/draft/man2/write.2 b/draft/man2/write.2
index 4e1518c..80f7e5d 100644 (file)
--- a/draft/man2/write.2
+++ b/draft/man2/write.2
@@ -1,9 +1,8 @@
-.\" Hey Emacs! This file is -*- nroff -*- source.
-.\"

 .\" This manpage is Copyright (C) 1992 Drew Eckhardt;
 .\" This manpage is Copyright (C) 1992 Drew Eckhardt;

-.\"                               1993 Michael Haardt, Ian Jackson.
+.\"             and Copyright (C) 1993 Michael Haardt, Ian Jackson.

 .\" and Copyright (C) 2007 Michael Kerrisk <mtk.manpages@gmail.com>
 .\"
 .\" and Copyright (C) 2007 Michael Kerrisk <mtk.manpages@gmail.com>
 .\"

+.\" %%%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.
 .\" 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.


@@ -23,6 +22,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.

+.\" %%%LICENSE_END

 .\"
 .\" Modified Sat Jul 24 13:35:59 1993 by Rik Faith <faith@cs.unc.edu>
 .\" Modified Sun Nov 28 17:19:01 1993 by Rik Faith <faith@cs.unc.edu>
 .\"
 .\" Modified Sat Jul 24 13:35:59 1993 by Rik Faith <faith@cs.unc.edu>
 .\" Modified Sun Nov 28 17:19:01 1993 by Rik Faith <faith@cs.unc.edu>


@@ -41,15 +41,15 @@
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************

-.TH WRITE 2 2010\-08\-29 Linux "Linux Programmer's Manual"
+.TH WRITE 2 2013\-01\-27 Linux "Linux Programmer's Manual"

 .SH 名前
 .SH 名前

-write \- ã\83\95ã\82¡ã\82¤ã\83«ã\83»ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ (file descriptor) ã\81«æ\9b¸ã\81\8dè¾¼ã\82\80
+write \- ファイルディスクリプタ (file descriptor) に書き込む

 .SH 書式
 \fB#include <unistd.h>\fP
 .sp
 \fBssize_t write(int \fP\fIfd\fP\fB, const void *\fP\fIbuf\fP\fB, size_t \fP\fIcount\fP\fB);\fP
 .SH 説明
 .SH 書式
 \fB#include <unistd.h>\fP
 .sp
 \fBssize_t write(int \fP\fIfd\fP\fB, const void *\fP\fIbuf\fP\fB, size_t \fP\fIcount\fP\fB);\fP
 .SH 説明

-\fBwrite\fP()  ã\81¯ã\80\81 \fIbuf\fP ã\81\8cæ\8c\87ã\81\99ã\83\90ã\83\83ã\83\95ã\82¡ã\81\8bã\82\89ã\80\81ã\83\95ã\82¡ã\82¤ã\83«ã\83»ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ \fIfd\fP ã\81\8cå\8f\82ç\85§ã\81\99ã\82\8bã\83\95ã\82¡ã\82¤ã\83«ã\81¸ã\80\81æ\9c\80大 \fIcount\fP
+\fBwrite\fP()  は、 \fIbuf\fP が指すバッファから、ファイルディスクリプタ \fIfd\fP が参照するファイルへ、最大 \fIcount\fP

 バイトを書き込む。
 
 書き込まれるバイト数は \fIcount\fP よりも小さくなることがある。 例えば、書き込み対象の物理メディアに十分な領域がない場合、 リソース上限
 バイトを書き込む。
 
 書き込まれるバイト数は \fIcount\fP よりも小さくなることがある。 例えば、書き込み対象の物理メディアに十分な領域がない場合、 リソース上限


@@ -57,12 +57,12 @@ write \- ファイル・ディスクリプタ (file descriptor) に書き込む
 呼び出しがシグナルハンドラにより割り込まれた場合、 などである。 (\fBpipe\fP(7)  も参照のこと。)
 
 seek 可能なファイル (つまり \fBlseek\fP(2)  が適用できるファイル、例えば通常のファイル) では、
 呼び出しがシグナルハンドラにより割り込まれた場合、 などである。 (\fBpipe\fP(7)  も参照のこと。)
 
 seek 可能なファイル (つまり \fBlseek\fP(2)  が適用できるファイル、例えば通常のファイル) では、

-æ\9b¸ã\81\8dè¾¼ã\81¿ã\81¯ç\8f¾å\9c¨ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\83»ã\82ªã\83\95ã\82»ã\83\83ã\83\88ã\81\8bã\82\89è¡\8cã\82\8fã\82\8cã\80\81 ã\83\95ã\82¡ã\82¤ã\83«ã\83»ã\82ªã\83\95ã\82»ã\83\83ã\83\88ã\81¯å®\9fé\9a\9bã\81«æ\9b¸ã\81\8dè¾¼ã\81¿ã\81\8cè¡\8cã\82\8fã\82\8cã\81\9fã\83\90ã\82¤ã\83\88æ\95°å\88\86 å\8a ç®\97ã\81\95ã\82\8cã\82\8bã\80\82ã\83\95ã\82¡ã\82¤ã\83«ã\81\8c
-\fBO_APPEND\fP で \fBopen\fP(2)  された場合、ファイル・オフセットは書き込み前に ファイルの末尾に設定される。
-ã\83\95ã\82¡ã\82¤ã\83«ã\83»ã\82ªã\83\95ã\82»ã\83\83ã\83\88ã\81®èª¿æ\95´ã\81¨æ\9b¸ã\81\8dè¾¼ã\81¿æ\93\8dä½\9cã\81¯ã\82¢ã\83\88ã\83\9fã\83\83ã\82¯ã\81ªå\87¦ç\90\86ã\81¨ã\81\97ã\81¦ å®\9fè¡\8cã\81\95ã\82\8cã\82\8bã\80\82
+æ\9b¸ã\81\8dè¾¼ã\81¿ã\81¯ç\8f¾å\9c¨ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\82ªã\83\95ã\82»ã\83\83ã\83\88ã\81\8bã\82\89è¡\8cã\82\8fã\82\8cã\80\81 ã\83\95ã\82¡ã\82¤ã\83«ã\82ªã\83\95ã\82»ã\83\83ã\83\88ã\81¯å®\9fé\9a\9bã\81«æ\9b¸ã\81\8dè¾¼ã\81¿ã\81\8cè¡\8cã\82\8fã\82\8cã\81\9fã\83\90ã\82¤ã\83\88æ\95°å\88\86 å\8a ç®\97ã\81\95ã\82\8cã\82\8bã\80\82ã\83\95ã\82¡ã\82¤ã\83«ã\81\8c \fBO_APPEND\fP
+で \fBopen\fP(2)  された場合、ファイルオフセットは書き込み前に ファイルの末尾に設定される。
+ファイルオフセットの調整と書き込み操作はアトミックな処理として 実行される。

 
 POSIX は \fBwrite\fP()  が行なわれた後に実行した \fBread\fP(2)  が 新しいデータを返すことを要求している。
 
 POSIX は \fBwrite\fP()  が行なわれた後に実行した \fBread\fP(2)  が 新しいデータを返すことを要求している。

-å\85¨ã\81¦ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\83»ã\82·ã\82¹ã\83\86ã\83 ã\81\8c POSIX æº\96æ\8b ã\81§ã\81¯ã\81ªã\81\84ç\82¹ã\81«æ³¨æ\84\8fã\81\99ã\82\8bã\81\93ã\81¨ã\80\82
+全てのファイルシステムが POSIX 準拠ではない点に注意すること。

 .SH 返り値
 成功した場合、書き込まれたバイト数が返される (ゼロは何も書き込まれなかったことを示す)。 エラーならば \-1 が返され、\fIerrno\fP
 が適切に設定される。
 .SH 返り値
 成功した場合、書き込まれたバイト数が返される (ゼロは何も書き込まれなかったことを示す)。 エラーならば \-1 が返され、\fIerrno\fP
 が適切に設定される。


@@ -73,21 +73,24 @@ POSIX は \fBwrite\fP()  が行なわれた後に実行した \fBread\fP(2)  が
 .SH エラー
 .TP 
 \fBEAGAIN\fP
 .SH エラー
 .TP 
 \fBEAGAIN\fP

-ã\83\95ã\82¡ã\82¤ã\83«ã\83»ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ \fIfd\fP ã\81\8cã\82½ã\82±ã\83\83ã\83\88以å¤\96ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\82\92å\8f\82ç\85§ã\81\97ã\81¦ã\81\84ã\81¦ã\80\81 é\9d\9eå\81\9cæ­¢ (nonblocking) ã\83¢ã\83¼ã\83\89
-(\fBO_NONBLOCK\fP)  に設定されており、書き込みを行うと停止する状況にある。
+ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ \fIfd\fP ã\81\8cã\82½ã\82±ã\83\83ã\83\88以å¤\96ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\82\92å\8f\82ç\85§ã\81\97ã\81¦ã\81\84ã\81¦ã\80\81 é\9d\9eå\81\9cæ­¢ (nonblocking) ã\83¢ã\83¼ã\83\89 (\fBO_NONBLOCK\fP)
+に設定されており、書き込みを行うと停止する状況にある。

 .TP 
 \fBEAGAIN\fP または \fBEWOULDBLOCK\fP
 .\" Actually EAGAIN on Linux
 .TP 
 \fBEAGAIN\fP または \fBEWOULDBLOCK\fP
 .\" Actually EAGAIN on Linux

-ã\83\95ã\82¡ã\82¤ã\83«ã\83»ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ \fIfd\fP ã\81\8cã\82½ã\82±ã\83\83ã\83\88ã\82\92å\8f\82ç\85§ã\81\97ã\81¦ã\81\84ã\81¦ã\80\81é\9d\9eå\81\9cæ­¢ (nonblocking) ã\83¢ã\83¼ã\83\89 (\fBO_NONBLOCK\fP)
+ファイルディスクリプタ \fIfd\fP がソケットを参照していて、非停止 (nonblocking) モード (\fBO_NONBLOCK\fP)

 に設定されており、書き込みを行うと停止する状況にある。 POSIX.1\-2001 は、この場合にどちらのエラーを返すことも認めており、 これら 2
 つの定数が同じ値を持つことも求めていない。 したがって、移植性が必要なアプリケーションでは、両方の可能性を 確認すべきである。
 .TP 
 \fBEBADF\fP
 に設定されており、書き込みを行うと停止する状況にある。 POSIX.1\-2001 は、この場合にどちらのエラーを返すことも認めており、 これら 2
 つの定数が同じ値を持つことも求めていない。 したがって、移植性が必要なアプリケーションでは、両方の可能性を 確認すべきである。
 .TP 
 \fBEBADF\fP

-\fIfd\fP ã\81\8cæ\9c\89å\8a¹ã\81ªã\83\95ã\82¡ã\82¤ã\83«ã\83»ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\81§ã\81ªã\81\84ã\81\8bæ\9b¸ã\81\8dè¾¼ã\81¿ã\81®ã\81\9fã\82\81ã\81«ã\82ªã\83¼ã\83\97ã\83³ (open) ã\81\95ã\82\8cã\81¦ã\81\84ã\81ªã\81\84ã\80\82
+\fIfd\fP が有効なファイルディスクリプタでないか書き込みのためにオープン (open) されていない。

 .TP 
 \fBEDESTADDRREQ\fP
 \fIfd\fP が、 \fBconnect\fP(2)  を使って通信相手のアドレスが設定されていないデータグラムソケットを 参照している。
 .TP 
 .TP 
 \fBEDESTADDRREQ\fP
 \fIfd\fP が、 \fBconnect\fP(2)  を使って通信相手のアドレスが設定されていないデータグラムソケットを 参照している。
 .TP 

+\fBEDQUOT\fP
+\fIfd\fP が参照するファイルを含むファイルシステムのディスクブロックのユーザクォータの上限に達している。
+.TP 

 \fBEFAULT\fP
 \fIbuf\fP がアクセス可能なアドレス空間の外にある。
 .TP 
 \fBEFAULT\fP
 \fIbuf\fP がアクセス可能なアドレス空間の外にある。
 .TP 


@@ -131,3 +134,7 @@ SVr4 では write が割り込まれると、データが書き込まれる直
 .SH 関連項目
 \fBclose\fP(2), \fBfcntl\fP(2), \fBfsync\fP(2), \fBioctl\fP(2), \fBlseek\fP(2), \fBopen\fP(2),
 \fBpwrite\fP(2), \fBread\fP(2), \fBselect\fP(2), \fBwritev\fP(2), \fBfwrite\fP(3)
 .SH 関連項目
 \fBclose\fP(2), \fBfcntl\fP(2), \fBfsync\fP(2), \fBioctl\fP(2), \fBlseek\fP(2), \fBopen\fP(2),
 \fBpwrite\fP(2), \fBread\fP(2), \fBselect\fP(2), \fBwritev\fP(2), \fBfwrite\fP(3)

+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。