lstat.2 (2010 09)

l
lstat(2) lstat(2)
NAME
lstat - get symbolic link status
SYNOPSIS
#include <sys/stat.h>
int lstat(
const char *path ,
struct stat *buf
);
PARAMETERS
The parameters for the lstat() function are as follows:
path is a pointer to a path name of any file within the mounted file system. All directories
listed in the path name must be searchable.
buf is a pointer to a
stat
structure where the file status information is stored.
DESCRIPTION
The
lstat() function has the same effect as
stat(), except when path refers to a symbolic link. In
that case
lstat() returns information about the link, while stat() returns information about the file
the link references.
For symbolic links, the st_mode member will contain meaningful information when used with the file type
macros, and the st_size member will contain the length of the pathname contained in the symbolic link.
File mode bits and the contents of the remaining members of the
stat structure are unspecified. The
value returned in the st_size member is the length of the contents of the symbolic link, and does not count
any trailing null. If the chosen path name or file descriptor refers to a Multi-Level Directory (MLD), and
the process does not have the multilevel effective privilege, the i-node number returned in st_ino is the
i-node of the MLD itself.
The
stat structure contains the following members:
dev_t st_dev; /* ID of device containing a */
/* directory entry for this file */
ino_t st_ino; /* Inode number */
short st_fstype; /* Type of filesystem this file */
/* is in; see sysfs(2) */
ushort st_mode; /* File type, attributes, and */
/* access control summary */
ushort st_basemode /* Permission bits (see chmod(1)) */
ushort st_nlink; /* Number of links */
uid_t st_uid; /* User ID of file owner */
gid_t st_gid; /* Group ID of file group */
dev_t st_rdev; /* Device ID; this entry defined */
/* only for char or blk spec files */
off_t st_size; /* File size (bytes) */
time_t st_atime; /* Time of last access */
time_t st_mtime; /* Last modification time */
time_t st_ctime; /* Last file status change time */
/* Measured in secs since */
/* 00:00:00 GMT, Jan 1, 1970 */
long st_blksize; /* File system block size */
uint st_acl:1; /* Set if the file has optional */
/* access control list entries */
/* HFS File Systems only */
uint st_aclv:1; /* Set if the file has optional */
/* access control list entries */
/* JFS File Systems only */
(Note that the position of items in this list does not necessarily reflect the order of the members in the
structure.)
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1