.
[gnulib.git] / lib / modechange.h
1 /* modechange.h -- definitions for file mode manipulation
2    Copyright (C) 1989, 1990 Free Software Foundation, Inc.
3
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 2, or (at your option)
7    any later version.
8
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.
13
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 Foundation,
16    Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
17
18 /* Masks for the `flags' field in a `struct mode_change'. */
19
20 /* Affect the execute bits only if at least one execute bit is set already,
21    or if the file is a directory. */
22 #define MODE_X_IF_ANY_X 01
23
24 /* If set, copy some existing permissions for u, g, or o onto the other two.
25    Which of u, g, or o is copied is determined by which bits are set in the
26    `value' field. */
27 #define MODE_COPY_EXISTING 02
28
29 struct mode_change
30 {
31   char op;                      /* One of "=+-". */
32   char flags;                   /* Special operations. */
33   unsigned short affected;      /* Set for u/g/o/s/s/t, if to be affected. */
34   unsigned short value;         /* Bits to add/remove. */
35   struct mode_change *next;     /* Link to next change in list. */
36 };
37
38 /* Masks for mode_compile argument. */
39 #define MODE_MASK_EQUALS 1
40 #define MODE_MASK_PLUS 2
41 #define MODE_MASK_MINUS 4
42
43 /* Error return values for mode_compile. */
44 #define MODE_INVALID (struct mode_change *) 0
45 #define MODE_MEMORY_EXHAUSTED (struct mode_change *) 1
46
47 #ifndef __P
48 # if defined (__GNUC__) || (defined (__STDC__) && __STDC__)
49 #  define __P(Args) Args
50 # else
51 #  define __P(Args) ()
52 # endif
53 #endif
54
55 struct mode_change *mode_compile __P ((const char *, unsigned));
56 unsigned short mode_adjust __P ((unsigned, const struct mode_change *));
57 void mode_free __P ((struct mode_change *));