## stat

#### OS/161 Reference Manual

### Name

stat - get file state information

### Library

Standard C Library (libc, -lc)

### Synopsis

`#include <sys/stat.h>`
`int`
`stat(const char *`pathname`, struct stat *`statbuf`);`

### Description

`stat` retrieves status information about the file referred to by pathname and stores it in the stat structure pointed to by statbuf.

The call (like all system calls) should be atomic; that is, the information retrieved should come from a single point in time.

### Return Values

On success, `stat` returns 0. On error, -1 is returned, and errno is set according to the error encountered.

### Errors

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.

### See Also

fstat, lstat