stat.2 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

stat(2) stat(2)

be set to the number of links to the ﬁle.

Note: The st_natime , st_nmtime , and st_nctime ﬁelds are currently reserved. To avoid compatibility

problems, these ﬁelds should not be used.

RETURN VALUE

Upon successful completion, 0 is returned. Otherwise, −1 is returned and

errno is set to indicate the

error.

ERRORS

The

stat() function will fail if:

[EACCES] Search permission is denied for a component of the path preﬁx.

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

is implementation dependent.

[EIO] An error occurred while reading from the ﬁle system.

[ELOOP] Too many symbolic links were encountered in resolving path.

[ENAMETOOLONG] The length of the path argument exceeds

{PATH_MAX}

or a pathname com-

ponent is longer than

{NAME_MAX}.

[ENOENT] A component of path does not name an existing ﬁle or path is an empty

string.

[ENOTDIR] A component of the path preﬁx is not a directory.

[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 .

The

stat() function may fail if:

[ENAMETOOLONG] Pathname resolution of a symbolic link produced an intermediate result

whose length exceeds

{PATH_MAX}.

[EOVERFLOW] A 32-bit application is making this call on a ﬁle where the

st_size or other

ﬁeld(s) would need to hold a 64-bit value. Use stat64() instead.

NETWORKING FEATURES

NFS

The st_basemode is equal to st_mode and st_acl and the 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 Sys-

tems 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.

For 32-bit applications, st_ino will be truncated to its least signiﬁcant 32-bits for ﬁlesystems that use

64-bit values.

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.