HP-UX Reference (11i v1 05/09) - 2 System Calls (vol 5)

fstat(2) fstat(2)

write(2)). The touch command (see touch(1) can be used to explicitly control the

times of a ﬁle.

st_mode The value returned in this ﬁeld is the bit-wise inclusive OR of a value indicating the

ﬁle’s type, attribute bits, and a value summarizing its access permission. See

mknod(2). For ordinary users, the least signiﬁcant nine bits consist of the ﬁle’s per-

mission bits modiﬁed to reﬂect the access granted or denied to the caller by optional

entries in the ﬁle’s access control list. For users with appropriate privileges the least

signiﬁcant nine bits are the ﬁle’s access permission bits. In addition, the

S_IXUSR

(execute by owner) mode bit is set if the following conditions are met:

• The ﬁle is a regular ﬁle,

• No permission execute bits are set, and

• An execute bit is set in one or more of the ﬁle’s optional access control list entries.

The write bit is not cleared for a ﬁle on a read-only ﬁle system or a shared-text pro-

gram ﬁle that is being executed. However,

getaccess() clears this bit under these

conditions (see getaccess(2).

ERRORS

[EFAULT] buf or path points to an invalid address. The reliable detection of this error is

implementation-dependent.

[EOVERFLOW]

The ﬁle size in bytes or the number of blocks allocated to the ﬁle cannot be

represented correctly in the structure pointed to by buf.

NFS

The st_basemode, st_acl and st_aclv ﬁelds are zero on ﬁles accessed remotely. The st_acl ﬁeld is applicable

to HFS File Systems only. The st_aclv ﬁeld is applicable to JFS File Systems only.

WARNINGS

Access Control Lists - HFS and JFS File Systems only

Access control list descriptions in this entry apply only to HFS and JFS ﬁle systems on standard HP-UX

operating systems.

DEPENDENCIES

CD-ROM

The st_uid and st_gid ﬁelds are set to −1 if they are not speciﬁed on the disk for a given ﬁle.

AUTHOR

stat() and fstat() were developed by AT&T. lstat() was developed by the University of Califor-

nia, Berkeley.