From 96dea201cdbec68618b477cdabcdd0afbcafe166 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Sat, 22 Apr 2017 21:40:47 +0200 Subject: [PATCH] stat.2: Minor edits Signed-off-by: Michael Kerrisk --- man2/stat.2 | 33 ++++++++++++++++++--------------- 1 file changed, 18 insertions(+), 15 deletions(-) diff --git a/man2/stat.2 b/man2/stat.2 index 55f2656b9..bba843170 100644 --- a/man2/stat.2 +++ b/man2/stat.2 @@ -140,23 +140,23 @@ structure, which contains the following fields: .nf struct stat { dev_t st_dev; /* ID of device containing file */ - ino_t st_ino; /* inode number */ - mode_t st_mode; /* file type and mode */ - nlink_t st_nlink; /* number of hard links */ - uid_t st_uid; /* user ID of owner */ - gid_t st_gid; /* group ID of owner */ - dev_t st_rdev; /* device ID (if special file) */ - off_t st_size; /* total size, in bytes */ - blksize_t st_blksize; /* blocksize for filesystem I/O */ - blkcnt_t st_blocks; /* number of 512B blocks allocated */ + ino_t st_ino; /* Inode number */ + mode_t st_mode; /* File type and mode */ + nlink_t st_nlink; /* Number of hard links */ + uid_t st_uid; /* User ID of owner */ + gid_t st_gid; /* Group ID of owner */ + dev_t st_rdev; /* Device ID (if special file) */ + off_t st_size; /* Total size, in bytes */ + blksize_t st_blksize; /* Block size for filesystem I/O */ + blkcnt_t st_blocks; /* Number of 512B blocks allocated */ /* Since Linux 2.6, the kernel supports nanosecond precision for the following timestamp fields. For the details before Linux 2.6, see NOTES. */ - struct timespec st_atim; /* time of last access */ - struct timespec st_mtim; /* time of last modification */ - struct timespec st_ctim; /* time of last status change */ + struct timespec st_atim; /* Time of last access */ + struct timespec st_mtim; /* Time of last modification */ + struct timespec st_ctim; /* Time of last status change */ #define st_atime st_atim.tv_sec /* Backward compatibility */ #define st_mtime st_mtim.tv_sec @@ -179,7 +179,7 @@ if you need to know the details. .\" Background: inode attributes are modified with i_mutex held, but .\" read by stat() without taking the mutex. .IR Note : -For performance and simplicity reasons, different fields in the +f performance and simplicity reasons, different fields in the .I stat structure may contain state information from different moments during the execution of the system call. @@ -241,7 +241,7 @@ The size of a symbolic link is the length of the pathname it contains, without a terminating null byte. .TP .I st_blksize -This field gives the "preferred" blocksize for efficient filesystem I/O. +This field gives the "preferred" block size for efficient filesystem I/O. .TP .I st_blocks This field indicates the number of blocks allocated to the file, @@ -387,7 +387,10 @@ A component of .I pathname does not exist, or .I pathname -is an empty string and AT_EMPTY_PATH was not specified. +is an empty string and +.B AT_EMPTY_PATH +was not specified in +.IR flags . .TP .B ENOMEM Out of memory (i.e., kernel memory).