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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

181

182

183

184

185

186

187

188

189

190

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 component

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