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

操作系统开发

开发平台:

WINDOWS

  1. READ(2)                   Minix Programmer's Manual                    READ(2)
  2. NAME
  3.      read - read input
  4. SYNOPSIS
  5.      #include <sys/types.h>
  6.      #include <unistd.h>
  7.      ssize_t read(int d, void *buf, size_t nbytes)
  8. DESCRIPTION
  9.      Read attempts to read nbytes of data from the object  referenced  by  the
  10.      descriptor d into the buffer pointed to by buf.
  11.      On objects capable of seeking, the read starts at a position given by the
  12.      pointer  associated  with  d  (see lseek(2)).  Upon return from read, the
  13.      pointer is incremented by the number of bytes actually read.
  14.      Objects that are not capable of seeking  always  read  from  the  current
  15.      position.   The  value  of  the pointer associated with such an object is
  16.      undefined.
  17.      Upon successful completion, read return the number of bytes actually read
  18.      and  placed  in  the buffer.  The system guarantees to read the number of
  19.      bytes requested if the descriptor references a normal file that has  that
  20.      many bytes left before the end-of-file, but in no other case.
  21.      If the returned value is 0, then end-of-file has been reached.
  22. RETURN VALUE
  23.      If successful, the number of bytes actually read is returned.  Otherwise,
  24.      a  -1  is  returned  and the global variable errno is set to indicate the
  25.      error.
  26. ERRORS
  27.      Read will fail if one or more of the following are true:
  28.      [EBADF]        D is not a valid descriptor open for reading.
  29.      [EFAULT]       Buf points outside the allocated address space.
  30.      [EIO]          An I/O error occurred while reading from the file system.
  31.      [EINTR]        A read from a slow device was interrupted before any  data
  32.                     arrived by the delivery of a signal.
  33.      [EAGAIN]       The file was marked for non-blocking I/O, and no data were
  34.                     ready to be read.
  35. 4BSD                              May 23, 1986                               1
  36. READ(2)                   Minix Programmer's Manual                    READ(2)
  37. SEE ALSO
  38.      dup(2), fcntl(2), open(2), pipe(2), write(2).
  39. 4BSD                              May 23, 1986                               2