dg_fstat(2)                    DG/UX 5.4R3.00                    dg_fstat(2)


NAME
       dgfstat - get extended file status information

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

       int    dgfstat (fildes, bufferptr, version)
       int    fildes;
       struct dgstat * bufferptr;
       unsigned short version;

   where:
       fildes         A valid, active file descriptor

       bufferptr     Address of a dgstat buffer to fill

       version        Version of the struct dgstat packet that bufferptr
                      refers to; should be set to DG_STAT_VERSION_NUMBER

DESCRIPTION
       Dgfstat(2) returns the current extended attributes of the file
       referenced by fildes into the dgstat buffer at the location
       specified by bufferptr.  If dgfstat fails, the contents of the
       buffer are undefined.

       The size and composition of the structure referred to by bufferptr
       is determined by the version parameter.  All calls to this function
       should use DG_STAT_VERSION_NUMBER for this parameter.  version allows
       for future revisions of struct dgstat to be handled in a compatible
       way.

       The interpretation of the file's attributes depends on the file's
       type (see dgstat(5) and stat(5)).

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

RETURN VALUE
       0      The dgfstat operation was successful.

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

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

       EINVAL    version is not a supported version of struct dg_stat.

       EFAULT    bufferptr points to an invalid address.

       EBADF     Fildes is not a valid, active file descriptor.




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

dg_fstat(2)                    DG/UX 5.4R3.00                    dg_fstat(2)


SEE ALSO
       chmod(2), chown(2), creat(2), dgmstat(2), dgstat(2), fchmod(2),
       fchown(2), fstat(2), link(2), lstat(2), mknod(2), pipe(2), read(2),
       stat(2), time(2), unlink(2), utime(2), utimes(2), write(2),
       dgstat(5), stat(5).




















































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