annotate lib/modechange.h @ 971:1099024dc505

(mode_create_from_ref): Add prototype. (MODE_MASK_ALL): New define. (MODE_BAD_REFERENCE): New define.
author Jim Meyering <jim@meyering.net>
date Sun, 06 Jul 1997 21:27:44 +0000
parents 693765a213f2
children 8de2d981b46f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
1 /* modechange.h -- definitions for file mode manipulation
971
1099024dc505 (mode_create_from_ref): Add prototype.
Jim Meyering <jim@meyering.net>
parents: 762
diff changeset
2 Copyright (C) 1989, 1990, 1997 Free Software Foundation, Inc.
5
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
3
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
4 This program is free software; you can redistribute it and/or modify
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
5 it under the terms of the GNU General Public License as published by
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
6 the Free Software Foundation; either version 2, or (at your option)
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
7 any later version.
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
8
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
9 This program is distributed in the hope that it will be useful,
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
12 GNU General Public License for more details.
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
13
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
14 You should have received a copy of the GNU General Public License
650
b4ef1c1a0171 update FSF address in copyright
Jim Meyering <jim@meyering.net>
parents: 610
diff changeset
15 along with this program; if not, write to the Free Software Foundation,
b4ef1c1a0171 update FSF address in copyright
Jim Meyering <jim@meyering.net>
parents: 610
diff changeset
16 Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
5
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
17
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
18 /* Masks for the `flags' field in a `struct mode_change'. */
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
19
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
20 /* Affect the execute bits only if at least one execute bit is set already,
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
21 or if the file is a directory. */
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
22 #define MODE_X_IF_ANY_X 01
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
23
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
24 /* If set, copy some existing permissions for u, g, or o onto the other two.
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
25 Which of u, g, or o is copied is determined by which bits are set in the
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
26 `value' field. */
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
27 #define MODE_COPY_EXISTING 02
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
28
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
29 struct mode_change
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
30 {
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
31 char op; /* One of "=+-". */
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
32 char flags; /* Special operations. */
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
33 unsigned short affected; /* Set for u/g/o/s/s/t, if to be affected. */
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
34 unsigned short value; /* Bits to add/remove. */
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
35 struct mode_change *next; /* Link to next change in list. */
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
36 };
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
37
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
38 /* Masks for mode_compile argument. */
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
39 #define MODE_MASK_EQUALS 1
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
40 #define MODE_MASK_PLUS 2
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
41 #define MODE_MASK_MINUS 4
971
1099024dc505 (mode_create_from_ref): Add prototype.
Jim Meyering <jim@meyering.net>
parents: 762
diff changeset
42 #define MODE_MASK_ALL (MODE_MASK_EQUALS | MODE_MASK_PLUS | MODE_MASK_MINUS)
5
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
43
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
44 /* Error return values for mode_compile. */
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
45 #define MODE_INVALID (struct mode_change *) 0
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
46 #define MODE_MEMORY_EXHAUSTED (struct mode_change *) 1
971
1099024dc505 (mode_create_from_ref): Add prototype.
Jim Meyering <jim@meyering.net>
parents: 762
diff changeset
47 #define MODE_BAD_REFERENCE (struct mode_change *) 2
5
41c9d08b09d7 Initial revision
Jim Meyering <jim@meyering.net>
parents:
diff changeset
48
610
8f1f8754d803 Update prototypes.
Jim Meyering <jim@meyering.net>
parents: 5
diff changeset
49 #ifndef __P
653
b63f146fd963 indent cpp-directives
Jim Meyering <jim@meyering.net>
parents: 650
diff changeset
50 # if defined (__GNUC__) || (defined (__STDC__) && __STDC__)
761
Jim Meyering <jim@meyering.net>
parents: 653
diff changeset
51 # define __P(Args) Args
653
b63f146fd963 indent cpp-directives
Jim Meyering <jim@meyering.net>
parents: 650
diff changeset
52 # else
761
Jim Meyering <jim@meyering.net>
parents: 653
diff changeset
53 # define __P(Args) ()
971
1099024dc505 (mode_create_from_ref): Add prototype.
Jim Meyering <jim@meyering.net>
parents: 762
diff changeset
54 # endif
1099024dc505 (mode_create_from_ref): Add prototype.
Jim Meyering <jim@meyering.net>
parents: 762
diff changeset
55 #endif
610
8f1f8754d803 Update prototypes.
Jim Meyering <jim@meyering.net>
parents: 5
diff changeset
56
8f1f8754d803 Update prototypes.
Jim Meyering <jim@meyering.net>
parents: 5
diff changeset
57 struct mode_change *mode_compile __P ((const char *, unsigned));
971
1099024dc505 (mode_create_from_ref): Add prototype.
Jim Meyering <jim@meyering.net>
parents: 762
diff changeset
58 struct mode_change *mode_create_from_ref __P ((const char *));
610
8f1f8754d803 Update prototypes.
Jim Meyering <jim@meyering.net>
parents: 5
diff changeset
59 unsigned short mode_adjust __P ((unsigned, const struct mode_change *));
8f1f8754d803 Update prototypes.
Jim Meyering <jim@meyering.net>
parents: 5
diff changeset
60 void mode_free __P ((struct mode_change *));