fstat(2)
_________________________________________________________________
fstat System Call
Get file status.
_________________________________________________________________
SYNTAX
#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.
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
fstat(2)
-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 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).
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)