1 /* filemode.c -- make a string describing file modes
3 Copyright (C) 1985, 1990, 1993, 1998-2000, 2004, 2006 Free Software
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software Foundation,
18 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */
26 #include "stat-macros.h"
28 /* The following is for Cray DMF (Data Migration Facility), which is a
29 HSM file system. A migrated file has a `st_dm_mode' that is
30 different from the normal `st_mode', so any tests for migrated
31 files should use the former. */
33 # define IS_MIGRATED_FILE(statp) \
34 (S_ISOFD (statp->st_dm_mode) || S_ISOFL (statp->st_dm_mode))
36 # define IS_MIGRATED_FILE(statp) 0
39 #if ! HAVE_DECL_STRMODE
41 /* Return a character indicating the type of file described by
44 'b' block special file
45 'c' character special file
46 'C' high performance ("contiguous data") file
50 'm' multiplexed file (7th edition Unix; obsolete)
51 'n' network special file (HP-UX)
56 '?' some other file type */
59 ftypelet (mode_t bits)
61 /* These are the most common, so test for them first. */
67 /* Other letters standardized by POSIX 1003.1-2004. */
77 /* Other file types (though not letters) standardized by POSIX. */
81 /* Nonstandard file types. */
86 if (S_ISMPB (bits) || S_ISMPC (bits))
98 /* Like filemodestring, but rely only on MODE. */
101 strmode (mode_t mode, char *str)
103 str[0] = ftypelet (mode);
104 str[1] = mode & S_IRUSR ? 'r' : '-';
105 str[2] = mode & S_IWUSR ? 'w' : '-';
106 str[3] = (mode & S_ISUID
107 ? (mode & S_IXUSR ? 's' : 'S')
108 : (mode & S_IXUSR ? 'x' : '-'));
109 str[4] = mode & S_IRGRP ? 'r' : '-';
110 str[5] = mode & S_IWGRP ? 'w' : '-';
111 str[6] = (mode & S_ISGID
112 ? (mode & S_IXGRP ? 's' : 'S')
113 : (mode & S_IXGRP ? 'x' : '-'));
114 str[7] = mode & S_IROTH ? 'r' : '-';
115 str[8] = mode & S_IWOTH ? 'w' : '-';
116 str[9] = (mode & S_ISVTX
117 ? (mode & S_IXOTH ? 't' : 'T')
118 : (mode & S_IXOTH ? 'x' : '-'));
123 #endif /* ! HAVE_DECL_STRMODE */
125 /* filemodestring - fill in string STR with an ls-style ASCII
126 representation of the st_mode field of file stats block STATP.
127 12 characters are stored in STR.
128 The characters stored in STR are:
130 0 File type, as in ftypelet above, except that other letters are used
131 for files whose type cannot be determined solely from st_mode:
134 'M' migrated file (Cray DMF)
136 'S' shared memory object
137 'T' typed memory object
139 1 'r' if the owner may read, '-' otherwise.
141 2 'w' if the owner may write, '-' otherwise.
143 3 'x' if the owner may execute, 's' if the file is
144 set-user-id, '-' otherwise.
145 'S' if the file is set-user-id, but the execute
148 4 'r' if group members may read, '-' otherwise.
150 5 'w' if group members may write, '-' otherwise.
152 6 'x' if group members may execute, 's' if the file is
153 set-group-id, '-' otherwise.
154 'S' if it is set-group-id but not executable.
156 7 'r' if any user may read, '-' otherwise.
158 8 'w' if any user may write, '-' otherwise.
160 9 'x' if any user may execute, 't' if the file is "sticky"
161 (will be retained in swap space after execution), '-'
163 'T' if the file is sticky but not executable.
165 10 ' ' for compatibility with 4.4BSD strmode,
166 since this interface does not support ACLs.
171 filemodestring (struct stat const *statp, char *str)
173 strmode (statp->st_mode, str);
175 if (S_TYPEISSEM (statp))
177 else if (IS_MIGRATED_FILE (statp))
179 else if (S_TYPEISMQ (statp))
181 else if (S_TYPEISSHM (statp))
183 else if (S_TYPEISTMO (statp))