fstat(2)                   DG/UX 4.30                    fstat(2)



     NAME
          fstat - Get file status.

     SYNOPSIS
          #include <sys/types.h>
          #include <sys/stat.h>

          int   fstat  (fildes, buffer_ptr)
          int             fildes;
          struct stat *   buffer_ptr;

     PARAMETERS
          fildes         A valid, active file descriptor.


          buffer_ptr     Address of a stat buffer to fill.

     DESCRIPTION
          Fstat returns the current attributes of the file referenced
          by <fildes> into the status buffer at the location specified
          by <buffer_ptr>.

          The interpretation of the file's attributes depends on the
          file's type (see stat(5) for details).  The subject file
          must be of type `ordinary-disk-file', `directory', `block-
          special-file', `character-special-file', `fifo-special-file'
          `pipe', or `socket'.

          If fstat fails, the contents of the stat buffer are
          undefined.

     ACCESS CONTROL
          Read, write, or execute permission of the file is not
          required.  However, for <fildes> to be active, the file must
          be open for reading or writing.

     RETURN VALUE
          0              The fstat operation was successful.


          -1             An error occurred.  Errno is set to indicate
                         the error.

     EXCEPTIONS
          Errno may be set to one of the following error codes:


          EBADF          <Fildes> is not a valid, active file
                         descriptor.


          EFAULT         <buffer_pointer> points to an invalid



     Licensed material--property of copyright holder(s)         Page 1

     fstat(2)                   DG/UX 4.30                    fstat(2)



                         address.

     SEE ALSO
          The related manual sections:  chmod(2), chown(2), creat(2),
          dg_mstat(2), fchmod(2), fchown(2), link(2), lstat(2),
          mknod(2), pipe(2), read(2), stat(2), time(2), unlink(2),
          utime(2), utimes(2), write(2).
















































     Licensed material--property of copyright holder(s)         Page 2