diff options
| author | Alejandro Colomar <alx.manpages@gmail.com> | 2022-07-22 02:26:15 +0200 |
|---|---|---|
| committer | Alejandro Colomar <alx.manpages@gmail.com> | 2022-07-22 02:26:15 +0200 |
| commit | 49821a6adbcd9c8db0593b3ad070882ece01edd2 (patch) | |
| tree | 039920cea0e0ee3f70e9e9921d7be89799bca5c2 /man7 | |
| parent | dfbd950c90a7f4df9a3dff8c8d011e692e8526ee (diff) | |
| download | man-pages-49821a6adbcd9c8db0593b3ad070882ece01edd2.tar.gz | |
stat.3type, system_data_types.7: Move stat to a separate page
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Diffstat (limited to 'man7')
| -rw-r--r-- | man7/system_data_types.7 | 140 |
1 files changed, 0 insertions, 140 deletions
diff --git a/man7/system_data_types.7 b/man7/system_data_types.7 index 29a2fc770b..b16b5632c1 100644 --- a/man7/system_data_types.7 +++ b/man7/system_data_types.7 @@ -290,146 +290,6 @@ in this page. .\"------------------------------------- socklen_t --------------------/ .\"------------------------------------- ssize_t ----------------------/ .\"------------------------------------- stat -------------------------/ -.TP -.I stat -.RS -.IR Include : -.IR <sys/stat.h> . -Alternatively, -.IR <ftw.h> . -.PP -.EX -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; /* Block size for filesystem I/O */ - blkcnt_t st_blocks; /* Number of 512 B blocks allocated */ - - /* Since POSIX.1-2008, this structure supports nanosecond - precision for the following timestamp fields. - For the details before POSIX.1-2008, 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 */ - -#define st_atime st_atim.tv_sec /* Backward compatibility */ -#define st_mtine st_mtim.tv_sec -#define st_ctime st_ctim.tv_sec -}; -.EE -.PP -Describes information about a file. -.PP -The fields are as follows: -.TP -.I st_dev -This field describes the device on which this file resides. -(The -.BR major (3) -and -.BR minor (3) -macros may be useful to decompose the device ID in this field.) -.TP -.I st_ino -This field contains the file's inode number. -.TP -.I st_mode -This field contains the file type and mode. -See -.BR inode (7) -for further information. -.TP -.I st_nlink -This field contains the number of hard links to the file. -.TP -.I st_uid -This field contains the user ID of the owner of the file. -.TP -.I st_gid -This field contains the ID of the group owner of the file. -.TP -.I st_rdev -This field describes the device that this file (inode) represents. -.TP -.I st_size -This field gives the size of the file (if it is a regular -file or a symbolic link) in bytes. -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" block size for efficient filesystem I/O. -.TP -.I st_blocks -This field indicates the number of blocks allocated to the file, -in 512-byte units. -(This may be smaller than -.IR st_size /512 -when the file has holes.) -.TP -.I st_atime -This is the time of the last access of file data. -.TP -.I st_mtime -This is the time of last modification of file data. -.TP -.I st_ctime -This is the file's last status change timestamp -(time of last change to the inode). -.PP -For further information on the above fields, see -.BR inode (7). -.\" -.PP -.IR "Conforming to" : -POSIX.1-2001 and later (see Notes). -.PP -.IR Notes : -Old kernels and old standards did not support nanosecond timestamp fields. -Instead, there were three timestamp -.RI fields\(em st_atime , -.IR st_mtime , -and -.IR st_ctime \(emtyped -as -.I time_t -that recorded timestamps with one-second precision. -.PP -Since Linux 2.5.48, the -.I stat -structure supports nanosecond resolution for the three file timestamp fields. -The nanosecond components of each timestamp are available -via names of the form -.IR st_atim.tv_nsec , -if suitable test macros are defined. -Nanosecond timestamps were standardized in POSIX.1-2008, -and, starting with version 2.12, -glibc exposes the nanosecond component names if -.B _POSIX_C_SOURCE -is defined with the value 200809L or greater, or -.B _XOPEN_SOURCE -is defined with the value 700 or greater. -Up to and including glibc 2.19, -the definitions of the nanoseconds components are also defined if -.B _BSD_SOURCE -or -.B _SVID_SOURCE -is defined. -If none of the aforementioned macros are defined, -then the nanosecond values are exposed with names of the form -.IR st_atimensec . -.PP -.IR "See also" : -.BR stat (2), -.BR inode (7) -.RE .\"------------------------------------- suseconds_t ------------------/ .\"------------------------------------- time_t -----------------------/ .\"------------------------------------- timer_t ----------------------/ |