Print this page
12288 getfacl and setfacl could stand improvement
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man3sec/acltotext.3sec.man.txt
+++ new/usr/src/man/man3sec/acltotext.3sec.man.txt
1 1 ACLTOTEXT(3SEC) File Access Control Library Functions ACLTOTEXT(3SEC)
2 2
3 3
4 4
5 5 NAME
6 6 acltotext, aclfromtext - convert internal representation to or from
7 7 external representation
8 8
9 9 SYNOPSIS
10 10 cc [ flag... ] file... -lsec [ library... ]
11 11 #include <sys/acl.h>
12 12
|
↓ open down ↓ |
12 lines elided |
↑ open up ↑ |
13 13 char *acltotext(aclent_t *aclbufp, int aclcnt);
14 14
15 15
16 16 aclent_t *aclfromtext(char *acltextp, int *aclcnt);
17 17
18 18
19 19 DESCRIPTION
20 20 The acltotext() function converts an internal ACL representation
21 21 pointed to by aclbufp into an external ACL representation. The space
22 22 for the external text string is obtained using malloc(3C). The caller
23 - is responsible for freeing the space upon completion..
23 + is responsible for freeing the space upon completion.
24 24
25 25
26 26 The aclfromtext() function converts an external ACL representation
27 27 pointed to by acltextp into an internal ACL representation. The space
28 28 for the list of ACL entries is obtained using malloc(3C). The caller is
29 29 responsible for freeing the space upon completion. The aclcnt argument
30 30 indicates the number of ACL entries found.
31 31
32 32
33 33 An external ACL representation is defined as follows:
34 34
35 35
36 36 <acl_entry>[,<acl_entry>]...
37 37
38 38
39 39 Each <acl_entry> contains one ACL entry. The external representation of
40 40 an ACL entry contains two or three colon-separated fields. The first
41 41 field contains the ACL entry tag type. The entry type keywords are
42 42 defined as:
43 43
44 44 user
45 45 This ACL entry with no UID specified in the ACL entry
46 46 ID field specifies the access granted to the owner of
47 47 the object. Otherwise, this ACL entry specifies the
48 48 access granted to a specific user-name or user-id
49 49 number.
50 50
51 51
52 52 group
53 53 This ACL entry with no GID specified in the ACL entry
54 54 ID field specifies the access granted to the owning
55 55 group of the object. Otherwise, this ACL entry
56 56 specifies the access granted to a specific group-name
57 57 or group-id number.
58 58
59 59
60 60 other
61 61 This ACL entry specifies the access granted to any
62 62 user or group that does not match any other ACL entry.
63 63
64 64
65 65 mask
66 66 This ACL entry specifies the maximum access granted to
67 67 user or group entries.
68 68
69 69
70 70 default:user
71 71 This ACL entry with no uid specified in the ACL entry
72 72 ID field specifies the default access granted to the
73 73 owner of the object. Otherwise, this ACL entry
74 74 specifies the default access granted to a specific
75 75 user-name or user-ID number.
76 76
77 77
78 78 default:group
79 79 This ACL entry with no gid specified in the ACL entry
80 80 ID field specifies the default access granted to the
81 81 owning group of the object. Otherwise, this ACL entry
82 82 specifies the default access granted to a specific
83 83 group-name or group-ID number.
84 84
85 85
86 86 default:other
87 87 This ACL entry specifies the default access for other
88 88 entry.
89 89
90 90
91 91 default:mask
92 92 This ACL entry specifies the default access for mask
93 93 entry.
94 94
95 95
96 96
97 97 The second field contains the ACL entry ID, as follows:
98 98
99 99 uid
100 100 This field specifies a user-name, or user-ID if there is no
101 101 user-name associated with the user-ID number.
102 102
103 103
104 104 gid
105 105 This field specifies a group-name, or group-ID if there is no
106 106 group-name associated with the group-ID number.
107 107
108 108
109 109 empty
110 110 This field is used by the user and group ACL entry types.
111 111
112 112
113 113
114 114 The third field contains the following symbolic discretionary access
115 115 permissions:
116 116
117 117 r
118 118 read permission
119 119
120 120
121 121 w
122 122 write permission
123 123
124 124
125 125 x
126 126 execute/search permission
127 127
128 128
129 129 -
130 130 no access
131 131
132 132
133 133 RETURN VALUES
134 134 Upon successful completion, the acltotext() function returns a pointer
135 135 to a text string. Otherwise, it returns NULL.
136 136
137 137
138 138 Upon successful completion, the aclfromtext() function returns a
139 139 pointer to a list of ACL entries. Otherwise, it returns NULL.
140 140
141 141 ATTRIBUTES
142 142 See attributes(5) for descriptions of the following attributes:
143 143
144 144
145 145
146 146
147 147 +--------------------+-----------------+
148 148 | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
149 149 +--------------------+-----------------+
150 150 |Interface Stability | Evolving |
151 151 +--------------------+-----------------+
152 152 |MT-Level | Unsafe |
153 153 +--------------------+-----------------+
154 154
155 155 SEE ALSO
156 156 acl(2), malloc(3C), attributes(5)
157 157
158 158
159 159
160 160 December 10, 2001 ACLTOTEXT(3SEC)
|
↓ open down ↓ |
127 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX