manページ  — WRITE

write, writev, pwrite – 出力の書込み

ライブラリ 書式 解説 戻り値 エラー 関連項目 規格 歴史

Standard C Library (libc, -lc)

#include <sys/types.h>

#include <sys/uio.h>

#include <unistd.h>

ssize_t
write(int d, const void *buf, size_t nbytes);

ssize_t
writev(int d, const struct iovec *iov, int iovcnt);

ssize_t
pwrite(int d, const void *buf, size_t nbytes, off_t offset);

処理が正常に完了すると、書き込まれたバイト数が返されます。 そうでない場合は -1 が返され、エラーを示すためにグローバル変数 errno が設定されます。

write(), writev() および pwrite() システムコールは、以下の場合にエラーとなり、 ファイルポインタは変更されずに残ります:

[EBADF]
	d 引数が、書込み用に開かれた有効な記述子ではありません。
[EPIPE]
	プロセスによる読取り用に開かれていないパイプに書き込もうとしました。
[EPIPE]
	通信相手のソケットに接続していないタイプ SOCK_STREAM のソケットに書き込もうとしました。
[EFBIG]
	プロセスのファイルサイズ制限か最大ファイルサイズを越えたファイルに 書き込もうとしました。
[EFAULT]
	iov の一部、またはファイルに書き込むデータは、 プロセスに割り当てられたアドレス空間の範囲外を指しています。
[EINVAL]
	d に関連するポインタが負になっています。
[ENOSPC]
	ファイルを含むファイルシステムに、充分なスペースが残っていません。
[EDQUOT]
	ファイルを含むファイルシステムのユーザのディスクブロック割当量が 使い尽くされています。
[EIO]	ファイルシステムに読み書きしている間に入出力エラーが発生しました。
[EINTR]
	書込みが完了する前にシグナルが割り込みました。
[EAGAIN]
	ファイルは非ブロッキング入出力の印がついた状態で、しかも、 すぐにデータを書き込める状態ではありません。
[EROFS]
	スライスの先頭にあるディスクラベル領域に書込みを行おうとしました。 ディスクラベル領域への書込みを有効にするには disklabel(8) -W を参照してください。

writev() は、以下のエラーを戻すことがあります:

[EDESTADDRREQ]
	connect(2) を使用して書込み先アドレスを設定した Unix ドメインデータグラムソケットに書き込む場合に、書込み先が使用できません。
[EINVAL]
	iovcnt 引数が 0 以下になっているか、 IOV_MAX より、大きくなっています。
[EINVAL]
	iov 配列 iov_len 値の 1 つが負になっています。
[EINVAL]
	iov 配列 iov_len 値の合計が、32 ビット整数をオーバフローしました。
[ENOBUFS]
	ソケットに書き出している時に mbuf のプールを使い尽くしました。

pwrite() システムコールは、以下のエラーを戻すことがあります:

[EINVAL]
	offset の値が負です。
[ESPIPE]
	ファイル記述子が、パイプ、ソケット、FIFO に関連しています。

write() システムコールは、 IEEE Std 1003.1-90 ("POSIX.1") に適合しています。 writev() システムコールと pwrite() システムコールは、 -xpg4.2 に適合しています。

pwrite() 関数は、 AT&T V.4 で登場しました。 writev() システムコールは、 BSD 4.2 で登場しました。 write() 関数は、 AT&T v6 で登場しました。