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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

411

412

413

414

415

416

417

418

419

420

stat(2) stat(2)

NAME

stat - get ﬁle status

SYNOPSIS

#include <sys/types.h>

#include <sys/stat.h>

int stat(const char *path, struct stat *buf);

DESCRIPTION

The stat() function obtains information about the named ﬁle and writes it to the area pointed to by the

buf argument. The path argument points to a pathname naming a ﬁle. Read, write or execute permission of

the named ﬁle is not required, but all directories listed in the pathname leading to the ﬁle must be search-

able. An implementation that provides additional or alternate ﬁle access control mechanisms may, under

implementation-dependent conditions, cause

stat() to fail. In particular, the system may deny the

existence of the ﬁle speciﬁed by path.

The buf argument is a pointer to a

stat structure, as deﬁned in the header <sys/stat.h> , into which

information is placed concerning the ﬁle.

The

stat() function updates any time-related ﬁelds (as described in the deﬁnition of File Times Update

in the XBD speciﬁcation), before writing into the stat structure.

The structure members st_mode, st_ino, st_dev, st_uid, st_gid, st_atime, st_ctime , and st_mtime will have

meaningful values for all ﬁle types deﬁned in this document. The value of the member st_nlink will be set

to the number of links to the ﬁle.

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.

[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

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

The stat() function may fail if:

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

whose length exceeds {PATH_MAX}.

[EOVERFLOW] A value to be stored would overﬂow one of the members of the stat struc-

ture.