stat.2: Split discussion of 'st_mode' fields into type and permissions

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/stat.2 b/man2/stat.2
index 6120d59383c81232ce600d0f7af186f92a8bc8e7..1647e55951c2303d376f7cdef501a1de3f7e3c1e 100644 (file)
--- a/man2/stat.2
+++ b/man2/stat.2
@@ -291,13 +291,14 @@ symbolic link?  (Not in POSIX.1-1996.)
 socket?  (Not in POSIX.1-1996.)
 .RE
 .PP
-The following flags are defined for the
+The following mask values are defined for the file type component of the
 .I st_mode
 field:
 .in +4n
 .TS
 lB l l.
 S_IFMT 0170000 bit mask for the file type bit fields
+
 S_IFSOCK       0140000 socket
 S_IFLNK        0120000 symbolic link
 S_IFREG        0100000 regular file
@@ -305,17 +306,30 @@ S_IFBLK   0060000 block device
 S_IFDIR        0040000 directory
 S_IFCHR        0020000 character device
 S_IFIFO        0010000 FIFO
+.TE
+.in
+.PP
+The following mask values are defined for
+the file permissions component of the
+.I st_mode
+field:
+.in +4n
+.TS
+lB l l.
 S_ISUID        0004000 set-user-ID bit
 S_ISGID        0002000 set-group-ID bit (see below)
 S_ISVTX        0001000 sticky bit (see below)
+
 S_IRWXU          00700 mask for file owner permissions
 S_IRUSR          00400 owner has read permission
 S_IWUSR          00200 owner has write permission
 S_IXUSR          00100 owner has execute permission
+
 S_IRWXG          00070 mask for group permissions
 S_IRGRP          00040 group has read permission
 S_IWGRP          00020 group has write permission
 S_IXGRP          00010 group has execute permission
+
 S_IRWXO          00007 T{
 mask for permissions for others (not in group)
 T}