9.17 fstat ¶

struct stat {
    dev_t           st_dev;
    ino_t           st_ino;
    mode_t          st_mode;
    nlink_t         st_nlink;
    uid_t           st_uid;
    gid_t           st_gid;
    dev_t           st_rdev;
    off_t           st_size;
    struct timespec st_atim;
    struct timespec st_mtim;
    struct timespec st_ctim;
    struct timespec st_btim;
    blksize_t       st_blksize;
    blkcnt_t        st_blocks;
};

int fstat(int dir_fd, char *path, int len, struct stat *buf, int flags);

This syscalls return information about a file, be it an already opened one with dir_fd and AT_EMPTY_PATH in flags, or by relatively opening, either following or not following symlinks with AT_SYMLINK_NOFOLLOW.

0 is returned on success, -1 on failure, with the following errno:

• EBADF: The passed path or file descriptor is not valid.
• ENOENT: The file pointed by path does not exist.
• EFAULT: The passed address for the path or stat buffer is not valid.

This syscalls return information about a file, be it an already opened one with dir_fd and AT_EMPTY_PATH in flags, or by relatively opening, either following or not following symlinks with AT_SYMLINK_NOFOLLOW.

0 is returned on success, -1 on failure, with the following errno:

• EBADF: The passed path or file descriptor is not valid.
• ENOENT: The file pointed by path does not exist.
• EFAULT: The passed address for the path or stat buffer is not valid.