HP-UX Reference (11i v3 07/02) - 2 System Calls (vol 5)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

451

452

453

454

455

456

457

458

459

460

stat(2) stat(2)

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

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.