1 /* filemode.c -- make a string describing file modes
2 Copyright (C) 1985-2022 Free Software Foundation, Inc.
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 3, or (at your option)
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA
23 static char ftypelet (unsigned long);
24 static void setst (unsigned long, char *);
26 /* filemodestring - fill in string STR with an ls-style ASCII
27 representation of the st_mode field of file stats block STATP.
28 10 characters are stored in STR; no terminating null is added.
29 The characters stored in STR are:
31 0 File type. 'd' for directory, 'c' for character
32 special, 'b' for block special, 'm' for multiplex,
33 'l' for symbolic link, 's' for socket, 'p' for fifo,
34 '-' for any other file type
36 1 'r' if the owner may read, '-' otherwise.
38 2 'w' if the owner may write, '-' otherwise.
40 3 'x' if the owner may execute, 's' if the file is
41 set-user-id, '-' otherwise.
42 'S' if the file is set-user-id, but the execute
45 4 'r' if group members may read, '-' otherwise.
47 5 'w' if group members may write, '-' otherwise.
49 6 'x' if group members may execute, 's' if the file is
50 set-group-id, '-' otherwise.
51 'S' if it is set-group-id but not executable.
53 7 'r' if any user may read, '-' otherwise.
55 8 'w' if any user may write, '-' otherwise.
57 9 'x' if any user may execute, 't' if the file is "sticky"
58 (will be retained in swap space after execution), '-'
60 'T' if the file is sticky but not executable. */
62 /* Get definitions for the file permission bits. */
103 /* Like filemodestring, but only the relevant part of the `struct stat'
104 is given as an argument. */
107 mode_string (unsigned long mode
, char *str
)
109 str
[0] = ftypelet ((unsigned long) mode
);
110 str
[1] = (mode
& S_IRUSR
) != 0 ? 'r' : '-';
111 str
[2] = (mode
& S_IWUSR
) != 0 ? 'w' : '-';
112 str
[3] = (mode
& S_IXUSR
) != 0 ? 'x' : '-';
113 str
[4] = (mode
& S_IRGRP
) != 0 ? 'r' : '-';
114 str
[5] = (mode
& S_IWGRP
) != 0 ? 'w' : '-';
115 str
[6] = (mode
& S_IXGRP
) != 0 ? 'x' : '-';
116 str
[7] = (mode
& S_IROTH
) != 0 ? 'r' : '-';
117 str
[8] = (mode
& S_IWOTH
) != 0 ? 'w' : '-';
118 str
[9] = (mode
& S_IXOTH
) != 0 ? 'x' : '-';
119 setst ((unsigned long) mode
, str
);
122 /* Return a character indicating the type of file described by
125 'b' for block special files
126 'c' for character special files
127 'm' for multiplexer files
128 'l' for symbolic links
131 '-' for any other file type. */
135 #define S_ISDIR(i) (((i) & S_IFMT) == S_IFDIR)
136 #else /* ! defined (S_IFDIR) */
137 #define S_ISDIR(i) (((i) & 0170000) == 040000)
138 #endif /* ! defined (S_IFDIR) */
139 #endif /* ! defined (S_ISDIR) */
143 #define S_ISBLK(i) (((i) & S_IFMT) == S_IFBLK)
144 #else /* ! defined (S_IFBLK) */
146 #endif /* ! defined (S_IFBLK) */
147 #endif /* ! defined (S_ISBLK) */
151 #define S_ISCHR(i) (((i) & S_IFMT) == S_IFCHR)
152 #else /* ! defined (S_IFCHR) */
154 #endif /* ! defined (S_IFCHR) */
155 #endif /* ! defined (S_ISCHR) */
159 #define S_ISFIFO(i) (((i) & S_IFMT) == S_IFIFO)
160 #else /* ! defined (S_IFIFO) */
161 #define S_ISFIFO(i) 0
162 #endif /* ! defined (S_IFIFO) */
163 #endif /* ! defined (S_ISFIFO) */
167 #define S_ISSOCK(i) (((i) & S_IFMT) == S_IFSOCK)
168 #else /* ! defined (S_IFSOCK) */
169 #define S_ISSOCK(i) 0
170 #endif /* ! defined (S_IFSOCK) */
171 #endif /* ! defined (S_ISSOCK) */
175 #define S_ISLNK(i) (((i) & S_IFMT) == S_IFLNK)
176 #else /* ! defined (S_IFLNK) */
178 #endif /* ! defined (S_IFLNK) */
179 #endif /* ! defined (S_ISLNK) */
182 ftypelet (unsigned long bits
)
199 if ((bits
& S_IFMT
) == S_IFMPC
200 || (bits
& S_IFMT
) == S_IFMPB
)
204 if ((bits
& S_IFMT
) == S_IFNWK
)
212 /* Set the 's' and 't' flags in file attributes string CHARS,
213 according to the file mode BITS. */
216 setst (unsigned long bits ATTRIBUTE_UNUSED
, char *chars ATTRIBUTE_UNUSED
)
222 /* Set-uid, but not executable by owner. */
232 /* Set-gid, but not executable by group. */
242 /* Sticky, but not executable by others. */