Provided by: manpages-ja-dev_0.5.0.0.20210215+dfsg-1_all 
名前
write - ファイルディスクリプター (file descriptor) に書き込む
書式
#include <unistd.h>
ssize_t write(int fd, const void *buf, size_t count);
説明
write() は、 buf が指すバッファーから、ファイルディスクリプター fd が参照するファイル
へ、最大 count バイトを書き込む。
書き込まれるバイト数は count よりも小さくなることがある。 例えば、書き込み対象の物理メディ
アに十分な領域がない場合、 リソース上限 RLIMIT_FSIZE に達した場合 (setrlimit(2) 参照)、
count バイト未満の書き込みが行われた後で 呼び出しがシグナルハンドラーにより割り込まれた場
合、 などである。 (pipe(7) も参照のこと。)
seek 可能なファイル (つまり lseek(2) が適用できるファイル、例えば通常のファイル) では、
書き込みは現在のファイルオフセットから行われ、 ファイルオフセットは実際に書き込みが行われ
たバイト数分 加算される。ファイルが O_APPEND で open(2) された場合、ファイルオフセットは
書き込み前に ファイルの末尾に設定される。 ファイルオフセットの調整と書き込み操作はアトミッ
クな処理として 実行される。
POSIX は write() が行なわれた後に実行した read(2) が 新しいデータを返すことを要求してい
る。 全てのファイルシステムが POSIX 準拠ではない点に注意すること。
返り値
成功した場合、書き込まれたバイト数が返される (ゼロは何も書き込まれなかったことを示す)。 エ
ラーならば -1 が返され、errno が適切に設定される。
count が 0 で、 fd が通常のファイル (regular file) を参照している場合、 write() は後述のエ
ラーのいずれかを検出した場合、失敗を返すことがある。 エラーが検出されなかった場合は、 0 を
返し、他に何の影響も与えない。 count が 0 で、 fd が通常のファイル以外のファイルを参照して
いる場合、 その結果は規定されていない。
エラー
EAGAIN ファイルディスクリプター fd がソケット以外のファイルを参照していて、 非停止
(nonblocking) モード (O_NONBLOCK) に設定されており、書き込みを行うと停止する状況に
ある。
EAGAIN または EWOULDBLOCK
ファイルディスクリプター fd がソケットを参照していて、非停止 (nonblocking) モード
(O_NONBLOCK) に設定されており、書き込みを行うと停止する状況にある。 POSIX.1-2001
は、この場合にどちらのエラーを返すことも認めており、 これら 2 つの定数が同じ値を持
つことも求めていない。 したがって、移植性が必要なアプリケーションでは、両方の可能性
を 確認すべきである。
EBADF fd が有効なファイルディスクリプターでないか書き込みのためにオープン (open) されてい
ない。
EDESTADDRREQ
fd が、 connect(2) を使って通信相手のアドレスが設定されていないデータグラムソケッ
トを 参照している。
EDQUOT fd が参照するファイルを含むファイルシステムのディスクブロックのユーザークォータの上
限に達している。
EFAULT buf がアクセス可能なアドレス空間の外にある。
EFBIG 実装定義の最大ファイルサイズまたはプロセスのファイルサイズ制限を 超えてファイルに書
き込もうとした。 または許可されたオフセット値の限界を超えた先の位置に 書き込もうと
した。
EINTR 何のデータも書かない間にシグナルにより割り込まれた (interrupt)。 signal(7) 参照。
EINVAL fd が書き込みが不適切なオブジェクトを参照している。 もしくは、ファイルが O_DIRECT
フラグを指定してオープンされているが、 buf に指定されたアドレス、 count に指定され
た値、 現在のファイルオフセットのいずれかの アラインメントが不適切である。
EIO inode の修正中に低レべル (low-level) I/O エラーが発生した。
ENOSPC fd によって参照されるファイルを含むデバイス (device) に十分な空きがない。
EPERM 操作が file seal により禁止されている。 fcntl(2) 参照。
EPIPE fd がパイプ (pipe) かソケット (socket) に接続されており、 その反対側 (読み込み側)
がクローズ (close) されている。 これが発生した場合には、書き込みを行なうプロセスは
SIGPIPE シグナル (signal)も受ける。 (したがって、プログラムがこのシグナルを捕獲
(catch)、停止 (block)、無視 (ignore) した場合のみ、write の返り値を参照できる。)
fd に接続されたオブジェクトによっては、他のエラーが起こるかもしれない。
準拠
SVr4, 4.3BSD, POSIX.1-2001.
SVr4 では write が割り込まれると、データが書き込まれる直前ではなく、 その時点で EINTR が返
る。
注意
write() が成功して返ってきても、データがディスクに記録されたことを 保証するものではない。
実際、データのためのスペースが確保されたことすら保証されないという バグっぽい実装もある。
これを確実にする唯一の方法は、 全てのデータを write した後に fsync(2) を呼び出すことであ
る。
write() が 1 バイトも書き込まないうちにシグナルハンドラーにより割り込まれた場合、 write()
はエラー EINTR で失敗する。 1バイトでも書き込んだ後で割り込まれた場合には、 write() は成
功し、書き込んだバイト数を返す。
バグ
POSIX.1-2008/SUSv4 セクション XSI 2.9.7 ("Thread Interactions with Regular File
Operations") によると、
以下のすべての関数では、 通常ファイルもしくはシンボリックリンクに対する操作では
POSIX.1-2008 で規定された効果が互いにアトミックに行われなければならない: ...
この後に書かれている API の中に write() と writev(2) である。 スレッド（やプロセス) 間でア
トミックに適用することが求められる効果の一つとして、 ファイルオフセットの更新がある。 しか
しながら、 バージョン 3.14 より前の Linux では、 この限りではない。 オープンファイル記述
(open file description) を共有する 2 つのプロセスが同時に write() (や writev(2)) を実行し
た場合、 この I/O 操作ではファイルオフセットの更新に関してはアトミックではなく、 2 つのプ
ロセスから出力されるデータブロックが (間違って) 重なる可能性がある。 この問題は Linux 3.14
で修正された。
関連項目
close(2), fcntl(2), fsync(2), ioctl(2), lseek(2), open(2), pwrite(2), read(2), select(2),
writev(2), fwrite(3)
この文書について
この man ページは Linux man-pages プロジェクトのリリース 3.79 の一部 である。プロジェクト
の説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。