WRITE.2
上传用户:jnzhq888
上传日期:2007-01-18
资源大小:51694k
文件大小:3k
源码类别:

操作系统开发

开发平台:

WINDOWS

  1. WRITE(2)                  Minix Programmer's Manual                   WRITE(2)
  2. NAME
  3.      write - write output
  4. SYNOPSIS
  5.      #include <sys/types.h>
  6.      #include <unistd.h>
  7.      ssize_t write(int d, const void *buf, size_t nbytes)
  8. DESCRIPTION
  9.      Write attempts to write nbytes of data to the object  referenced  by  the
  10.      descriptor d from the buffer pointed to by buf.
  11.      On objects capable of seeking, the write starts at a  position  given  by
  12.      the pointer associated with d, see lseek(2).  Upon return from write, the
  13.      pointer is incremented by the number of bytes actually written.
  14.      Objects that are not capable of seeking always  write  from  the  current
  15.      position.   The  value  of  the pointer associated with such an object is
  16.      undefined.
  17.      When using non-blocking I/O on objects such as TCP/IP channels  that  are
  18.      subject  to flow control, write may write fewer bytes than requested; the
  19.      return value must be noted, and the remainder of the operation should  be
  20.      retried when possible.
  21. RETURN VALUE
  22.      Upon successful completion  the  number  of  bytes  actually  written  is
  23.      returned.   Otherwise  a  -1 is returned and the global variable errno is
  24.      set to indicate the error.
  25. ERRORS
  26.      Write will fail and the file pointer will remain unchanged if one or more
  27.      of the following are true:
  28.      [EBADF]        D is not a valid descriptor open for writing.
  29.      [EPIPE]        An attempt is made to write to a pipe that is not open for
  30.                     reading by any process.
  31.      [EPIPE]        An attempt is made to write to a TCP channel that  is  not
  32.                     connected to a peer socket.
  33.      [EFBIG]        An attempt was made to  write  a  file  that  exceeds  the
  34.                     process's file size limit or the maximum file size.
  35.      [EFAULT]       Part of the data to be written to the file points  outside
  36.                     the process's allocated address space.
  37. 4BSD                              May 14, 1986                               1
  38. WRITE(2)                  Minix Programmer's Manual                   WRITE(2)
  39.      [ENOSPC]       There is no  free  space  remaining  on  the  file  system
  40.                     containing the file.
  41.      [EIO]          An I/O error occurred while reading from or writing to the
  42.                     file system.
  43.      [EAGAIN]       The file was marked for  non-blocking  I/O,  and  no  data
  44.                     could be written immediately.
  45. SEE ALSO
  46.      fcntl(2), lseek(2), open(2), pipe(2), read(2).
  47. 4BSD                              May 14, 1986                               2