etc/NEWS: Separate post-23.3 entries.
[emacs.git] / src / filemode.c
blobb36e363f3f8bd5e088c11da78fcc2466da23766f
1 /* filemode.c -- make a string describing file modes
2 Copyright (C) 1985, 1990, 1993, 2001, 2002, 2003, 2004,
3 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc.
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 3, or (at your option)
8 any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
18 USA. */
20 #ifdef HAVE_CONFIG_H
21 #include <config.h>
22 #endif
24 #include <sys/types.h>
25 #include <sys/stat.h>
27 #if !S_IRUSR
28 # if S_IREAD
29 # define S_IRUSR S_IREAD
30 # else
31 # define S_IRUSR 00400
32 # endif
33 #endif
35 #if !S_IWUSR
36 # if S_IWRITE
37 # define S_IWUSR S_IWRITE
38 # else
39 # define S_IWUSR 00200
40 # endif
41 #endif
43 #if !S_IXUSR
44 # if S_IEXEC
45 # define S_IXUSR S_IEXEC
46 # else
47 # define S_IXUSR 00100
48 # endif
49 #endif
51 #ifdef STAT_MACROS_BROKEN
52 #undef S_ISBLK
53 #undef S_ISCHR
54 #undef S_ISDIR
55 #undef S_ISFIFO
56 #undef S_ISLNK
57 #undef S_ISMPB
58 #undef S_ISMPC
59 #undef S_ISNWK
60 #undef S_ISREG
61 #undef S_ISSOCK
62 #endif /* STAT_MACROS_BROKEN. */
64 #if !defined(S_ISBLK) && defined(S_IFBLK)
65 #define S_ISBLK(m) (((m) & S_IFMT) == S_IFBLK)
66 #endif
67 #if !defined(S_ISCHR) && defined(S_IFCHR)
68 #define S_ISCHR(m) (((m) & S_IFMT) == S_IFCHR)
69 #endif
70 #if !defined(S_ISDIR) && defined(S_IFDIR)
71 #define S_ISDIR(m) (((m) & S_IFMT) == S_IFDIR)
72 #endif
73 #if !defined(S_ISREG) && defined(S_IFREG)
74 #define S_ISREG(m) (((m) & S_IFMT) == S_IFREG)
75 #endif
76 #if !defined(S_ISFIFO) && defined(S_IFIFO)
77 #define S_ISFIFO(m) (((m) & S_IFMT) == S_IFIFO)
78 #endif
79 #if !defined(S_ISLNK) && defined(S_IFLNK)
80 #define S_ISLNK(m) (((m) & S_IFMT) == S_IFLNK)
81 #endif
82 #if !defined(S_ISSOCK) && defined(S_IFSOCK)
83 #define S_ISSOCK(m) (((m) & S_IFMT) == S_IFSOCK)
84 #endif
85 #if !defined(S_ISMPB) && defined(S_IFMPB) /* V7 */
86 #define S_ISMPB(m) (((m) & S_IFMT) == S_IFMPB)
87 #define S_ISMPC(m) (((m) & S_IFMT) == S_IFMPC)
88 #endif
89 #if !defined(S_ISNWK) && defined(S_IFNWK) /* HP/UX */
90 #define S_ISNWK(m) (((m) & S_IFMT) == S_IFNWK)
91 #endif
93 void mode_string ();
94 static char ftypelet ();
95 static void rwx ();
96 static void setst ();
98 /* filemodestring - fill in string STR with an ls-style ASCII
99 representation of the st_mode field of file stats block STATP.
100 10 characters are stored in STR; no terminating null is added.
101 The characters stored in STR are:
103 0 File type. 'd' for directory, 'c' for character
104 special, 'b' for block special, 'm' for multiplex,
105 'l' for symbolic link, 's' for socket, 'p' for fifo,
106 '-' for regular, '?' for any other file type
108 1 'r' if the owner may read, '-' otherwise.
110 2 'w' if the owner may write, '-' otherwise.
112 3 'x' if the owner may execute, 's' if the file is
113 set-user-id, '-' otherwise.
114 'S' if the file is set-user-id, but the execute
115 bit isn't set.
117 4 'r' if group members may read, '-' otherwise.
119 5 'w' if group members may write, '-' otherwise.
121 6 'x' if group members may execute, 's' if the file is
122 set-group-id, '-' otherwise.
123 'S' if it is set-group-id but not executable.
125 7 'r' if any user may read, '-' otherwise.
127 8 'w' if any user may write, '-' otherwise.
129 9 'x' if any user may execute, 't' if the file is "sticky"
130 (will be retained in swap space after execution), '-'
131 otherwise.
132 'T' if the file is sticky but not executable. */
134 void
135 filemodestring (statp, str)
136 struct stat *statp;
137 char *str;
139 mode_string (statp->st_mode, str);
142 /* Like filemodestring, but only the relevant part of the `struct stat'
143 is given as an argument. */
145 void
146 mode_string (mode, str)
147 unsigned short mode;
148 char *str;
150 str[0] = ftypelet ((long) mode);
151 rwx ((mode & 0700) << 0, &str[1]);
152 rwx ((mode & 0070) << 3, &str[4]);
153 rwx ((mode & 0007) << 6, &str[7]);
154 setst (mode, str);
157 /* Return a character indicating the type of file described by
158 file mode BITS:
159 'd' for directories
160 'b' for block special files
161 'c' for character special files
162 'm' for multiplexor files
163 'l' for symbolic links
164 's' for sockets
165 'p' for fifos
166 '-' for regular files
167 '?' for any other file type. */
169 static char
170 ftypelet (bits)
171 long bits;
173 #ifdef S_ISBLK
174 if (S_ISBLK (bits))
175 return 'b';
176 #endif
177 if (S_ISCHR (bits))
178 return 'c';
179 if (S_ISDIR (bits))
180 return 'd';
181 if (S_ISREG (bits))
182 return '-';
183 #ifdef S_ISFIFO
184 if (S_ISFIFO (bits))
185 return 'p';
186 #endif
187 #ifdef S_ISLNK
188 if (S_ISLNK (bits))
189 return 'l';
190 #endif
191 #ifdef S_ISSOCK
192 if (S_ISSOCK (bits))
193 return 's';
194 #endif
195 #ifdef S_ISMPC
196 if (S_ISMPC (bits))
197 return 'm';
198 #endif
199 #ifdef S_ISNWK
200 if (S_ISNWK (bits))
201 return 'n';
202 #endif
203 return '?';
206 /* Look at read, write, and execute bits in BITS and set
207 flags in CHARS accordingly. */
209 static void
210 rwx (bits, chars)
211 unsigned short bits;
212 char *chars;
214 chars[0] = (bits & S_IRUSR) ? 'r' : '-';
215 chars[1] = (bits & S_IWUSR) ? 'w' : '-';
216 chars[2] = (bits & S_IXUSR) ? 'x' : '-';
219 /* Set the 's' and 't' flags in file attributes string CHARS,
220 according to the file mode BITS. */
222 static void
223 setst (bits, chars)
224 unsigned short bits;
225 char *chars;
227 #ifdef S_ISUID
228 if (bits & S_ISUID)
230 if (chars[3] != 'x')
231 /* Set-uid, but not executable by owner. */
232 chars[3] = 'S';
233 else
234 chars[3] = 's';
236 #endif
237 #ifdef S_ISGID
238 if (bits & S_ISGID)
240 if (chars[6] != 'x')
241 /* Set-gid, but not executable by group. */
242 chars[6] = 'S';
243 else
244 chars[6] = 's';
246 #endif
247 #ifdef S_ISVTX
248 if (bits & S_ISVTX)
250 if (chars[9] != 'x')
251 /* Sticky, but not executable by others. */
252 chars[9] = 'T';
253 else
254 chars[9] = 't';
256 #endif
259 /* arch-tag: 4340830c-15a5-47d2-b45f-1d43c45a91bb
260 (do not change this comment) */