lstat - get file state information
Standard C Library (libc, -lc)
#include <sys/stat.h>
int
lstat(const char *pathname,
struct stat *statbuf);
lstat retrieves status information about the file referred to by pathname and stores it in the stat structure pointed to by statbuf.
If pathname refers to a symbolic link, information about the link is retrieved rather than about the object the link points to.
The call (like all system calls) should be atomic; that is, the information retrieved should come from a single point in time.
On success, lstat returns 0. On error, -1 is returned, and errno is set according to the error encountered.
The following error codes should be returned under the conditions given. Other error codes may be returned for other cases not mentioned here.
| ENODEV | The device prefix of filename did not exist. | |
| ENOTDIR | A non-final component of pathname was not a directory. | |
| ENOENT | The named file does not exist. | |
| EIO | A hard I/O error occurred. | |
| EFAULT | statbuf points to an invalid address. |