write() - ファイルまたはソケットへのデータの書き込み

#define _XOPEN_SOURCE_EXTENDED 1
#include <unistd.h>

ssize_t write(int fs, const void *buf, ssize_t N);

#define _OE_SOCKETS
#include <unistd.h>

ssize_t write(int fs, const void *buf, ssize_t N);

• write() がまだデータを書き込んでいない場合には、-1 を戻し、errno を EINTR に設定します。
• write() が正常に一部のデータを書き込んだ場合には、割り込まれる前に書き込んだバイト数を戻します。

• パイプには関連したファイル・オフセットがないので、すべての書き込みはパイプの終わりに追加されます。
• N が PIPE_BUF より小さいか等しい場合には、出力は同じパイプに書き込み中の他のプロセスによって書き込まれた データとインターリーブしません。N が PIPE_BUF バイトより大きい場合には、出力は (fcntl.h ヘッダー・ファイルに定義されている、O_NONBLOCK の設定値と関係なく) 他のデータとインターリーブ できます。パイプに対する書き込みは、データを転送した場合には errno を EINTR に設定しても戻りません。
• (fcntl.h ヘッダー・ファイルに定義されている) O_NONBLOCK が 設定されていない場合には、write() は正規に完了するまでプロセス の実行をブロックすることがあります。
• O_NONBLOCK が設定されると、write() は、プロセスの実行をブロックしません。N が PIPE_BUF より小さいか等しい場合には、write() は完全に成功し、N の値を戻すか、または何も書き込まないで、errno を EAGAIN に設定してから、-1 を戻します。N が PIPE_BUF より大きい場合には、write() は、できるだけ多くのバイトを書き込み、この数をその結果として戻すか、または何も書き込まないで、errno を EAGAIN に設定してから、-1 を戻します。

• O_NONBLOCK が設定されていない場合には、write() は データの書き込みが可能になるまでブロックします。
• O_NONBLOCK が設定されると、write() はプロセスをブロックしません。プロセスをブロックしないで一部のデータを書き込める場合には、write() は書き込めるものを書き込み、書き込まれたバイト数を戻します。 そうでない場合には、errno を EAGAIN に設定して、-1 を戻します。

• プロセスがその制御端末に書き込みを試みていて、TOSTOP が 端末属性として設定されている。
• プロセスがバックグラウンド・プロセス・グループで実行して いて、SIGTTOU シグナルがブロックまたは無視されていない。
• プロセスが孤立していない。

パラメーター

説明

fs

ファイルまたはソケットの記述子。

buf

書き込まれるデータを保留するバッファーを指すポインター。

N

buf パラメーターが指すバッファーの 長さ (バイト単位)。

• FNDELAY または O_NONBLOCK が設定されていない限り、write() は、ソケットでデータの受け入れが可能になるまでブロックします。
• FNDELAY が設定されると、write() は、0 を戻します。
• O_NONBLOCK が設定されると、write() はプロセスをブロックしません。プロセスをブロックしないで一部のデータを書き込める場合には、write() は書き込めるものを書き込み、書き込まれたバイト数を戻します。そうでない場合には、writev() は、エラー・コードを EAGAIN に設定し、-1 を戻します。

エラー・コード

説明

EAGAIN

リソースは一時的に使用できません。以降の要求は正常に 完了できます。

EBADF

fs が、有効なファイルまたはソケット記述子ではあり ません。

ECONNRESET

接続はピアによって強制的にクローズされました。

EDESTADDRREQ

ソケットは接続目的でないため、ピア・アドレスは設定されません。

EFAULT

buf および N パラメーターを使用すると、呼び出し元のアドレス・スペースの外側のストレージへのアクセスを試みる結果になります。

EFBIG

出力ファイルに書き込むと、インプリメンテーションによって サポートされる最大ファイル・サイズを超えることがあります。

システム設定の最大ファイル・サイズ、またはプロセスのファイル・サイズ制限を超えるファイルを書き込もうとしました。

ファイルは通常のファイルであり、nbyte は 0 より大きく、開始位置は、フィールドに関連したオープン・ファイル記述で設定されたオフセットの最大値より 大きいかまたは等しくなっています。

EINTR

出力を書き込む前に write() にシグナルが割り込みました。

EINVAL

要求が無効か、またはサポートされていません。fs が 参照する STREAM またはマルチプレクサーは、マルチプレクサーから ダウンストリームへ (直接または間接に) リンクされます。

EIO

プロセスはバックグラウンド・プロセス・グループに入って いて、制御端末に書き込もうとしていますが、(termios.h ヘッダー・ファイルに定義されている) TOSTOP が 設定され、プロセスは SIGTTOU シグナルを無視もブロックもしていなく、プロセスのプロセス・グループは孤立しています。入出力エラーが発生しました。

EMSGSIZE

メッセージが大きすぎて、1 つのデータグラムとして送信されませんでした。

ENOBUFS

メッセージの送信にバッファー・スペースを使用することができません。

ENOSPC

出力装置には使用可能なスペースが残っていません。

ENOTCONN

ソケットが接続していません。

ENXIO

書き込もうとしている STREAM でハングアップが発生しました。

EPIPE

write() は、他のプロセスが読み取るためにオープンして いないパイプに書き込もうとしています。このエラーは SIGPIPE シグナルも生成します。接続されたストリーム・ソケットの場合には、ピア・ソケット との接続が失われています。

ERANGE

転送要求サイズは、fs と 関連した STREAMS ファイルによってサポートされた範囲を超えて いました。

EWOULDBLOCK

socket は非ブロック・モードであり、使用可能なデータ・バッファーがないか、バッファーが使用可能になる前に SO_SNDTIMEO タイムアウト値に達しました。

⁄* CELEBW35

   This example writes a certain amount of bytes to a file, using write().

 *⁄
#define _POSIX_SOURCE
#include <fcntl.h>
#include <sys⁄stat.h>
#include <sys⁄types.h>
#include <unistd.h>
#undef _POSIX_SOURCE
#include <stdlib.h>
#include <stdio.h>

#define mega_string_len 1000000

main() {
  char *mega_string;
  int  fd, ret;
  char fn[]="write.file";

  if ((mega_string = (char*) malloc(mega_string_len)) == NULL)
    perror("malloc() error");
  else if ((fd = creat(fn, S_IWUSR)) < 0)
    perror("creat() error");
  else {
    memset(mega_string, '0', mega_string_len);
    if ((ret = write(fd, mega_string, mega_string_len)) == -1)
      perror("write() error");
    else printf("write() wrote %d bytes¥n", ret);
    close(fd);
    unlink(fn);
  }
}

write() wrote 1000000 bytes