lstat.2 (2010 09)

lstat(2) lstat(2)

RETURN VALUE

Upon successful completion, lstat() returns 0. Otherwise, it returns

− 1 and sets errno to indicate

the error.

ERRORS

The

lstat() function will fail if:

[EACCES] A component of the path preﬁx denies search permission.

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

[ENAMETOOLONG] The length of a pathname exceeds

{PATH_MAX}, or the pathname com-

ponent is longer than

{NAME_MAX}.

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

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

string.

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

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

mentation dependent.

The

lstat() function may fail if:

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

with a length exceeding

{PATH_MAX}.

NETWORKING FEATURES

NFS

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

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