yield: Implement for OS/2 kLIBC.
[gnulib.git] / doc / acl-resources.txt
blob8b6c537cd7d02c915aab30274ac04150e40544d0
1 General introduction:
2   http://www.suse.de/~agruen/acl/linux-acls/online/
5 POSIX ACLs
7 Documents from POSIX.1e (headers & functions) and POSIX.2c (utilities):
8   http://wt.tuxomania.net/publications/posix.1e/download.html
11 Linux ACLs
13 Introduction:
14   http://www.suse.de/~agruen/acl/linux-acls/online/
15 Hands-on tutorial:
16   http://www.vanemery.com/Linux/ACL/linux-acl.html
18 Manual pages:
19   https://www.kernel.org/doc/man-pages/
20 Includes:
21   <sys/acl.h>
22   <acl/libacl.h>
23 Library:
24   -lacl
25 Functions:
26   acl_add_perm
27   acl_calc_mask
28   acl_check
29   acl_clear_perms
30   acl_cmp
31   acl_copy_entry
32   acl_copy_ext
33   acl_copy_int
34   acl_create_entry
35   acl_delete_def_file
36   acl_delete_entry
37   acl_delete_perm
38   acl_dup
39   acl_entries
40   acl_equiv_mode
41   acl_error
42   acl_extended_fd
43   acl_extended_file
44   acl_free
45   acl_from_mode
46   acl_from_text
47   acl_get_entry
48   acl_get_fd
49   acl_get_file
50   acl_get_perm
51   acl_get_permset
52   acl_get_qualifier
53   acl_get_tag_type
54   acl_init
55   acl_set_fd
56   acl_set_file
57   acl_set_permset
58   acl_set_qualifier
59   acl_set_tag_type
60   acl_size
61   acl_to_any_text
62   acl_to_text
63   acl_valid
64 Utilities:
65   getfacl
66   setfacl
69 Solaris ACLs
71 Introductions:
72   http://www.softpanorama.org/Solaris/ACL/index.shtml
73   https://www.cs.duke.edu/csl/faqs/solaris-acls.php
74 Manual pages:
75   https://docs.oracle.com/cd/E23823_01/html/816-5167/acl-2.html
76   https://docs.oracle.com/cd/E23823_01/html/816-5165/getfacl-1.html
77   https://docs.oracle.com/cd/E23823_01/html/816-5165/setfacl-1.html
78   https://docs.oracle.com/cd/E23823_01/html/816-5167/pathconf-2.html
79 Includes:
80   <sys/acl.h>
81 Library:
82   -lsec
83 Functions:
84   acl
85   facl
86 Functions in libsec:
87   aclcheck
88   aclfrommode
89   aclfromtext
90   aclsort
91   acltomode
92   acltotext
93 Additionally in Solaris 10 patch 118833-17 (<sys/acl.h> version 1.15):
94   acl_t type
95   ACL_NO_TRIVIAL macro
96   ACE_OTHER macro replaced with ACE_EVERYONE macro
97   ACE_OWNER, ACE_GROUP changed their values(!)
98   ALLOW, DENY macros removed(!)
99   acl_check
100   acl_free
101   acl_fromtext
102   acl_get
103   acl_set
104   acl_strip
105   acl_totext
106   acl_trivial
107   facl_get
108   facl_set
109 Utilities:
110   getfacl
111   setfacl
112   chmod
115 FreeBSD ACLs
117 Introduction:
118   https://www.freebsd.org/doc/en/books/handbook/fs-acl.html
119   http://www.onlamp.com/pub/a/bsd/2005/09/22/FreeBSD_Basics.html
120 Manual pages:
121   https://www.freebsd.org/cgi/man.cgi
122   https://www.freebsd.org/cgi/man.cgi?query=acl&apropos=0&sektion=0&manpath=FreeBSD+7.0-RELEASE&format=html
123 Includes:
124   <sys/acl.h>
125 Library:
126   none needed
127 Functions:
128   acl_add_perm
129   acl_calc_mask
130   acl_clear_perms
131   acl_copy_entry
132   acl_copy_ext
133   acl_copy_int
134   acl_create_entry
135   acl_delete_entry
136   acl_delete_fd_np
137   acl_delete_file_np
138   acl_delete_link_np
139   acl_delete_def_file
140   acl_delete_def_link_np
141   acl_delete_perm
142   acl_dup
143   acl_free
144   acl_from_text
145   acl_get
146   acl_get_entry
147   acl_get_fd
148   acl_get_fd_np
149   acl_get_file
150   acl_get_link_np
151   acl_get_perm_np
152   acl_get_permset
153   acl_get_qualifier
154   acl_get_tag_type
155   acl_init
156   acl_set
157   acl_set_fd
158   acl_set_fd_np
159   acl_set_file
160   acl_set_link_np
161   acl_set_permset
162   acl_set_qualifier
163   acl_set_tag_type
164   acl_size
165   acl_to_text
166   acl_valid
167   acl_valid_fd_np
168   acl_valid_file_np
169   acl_valid_link_np
170 Utilities:
171   getfacl
172   setfacl
175 NetBSD ACLs
177 Not available.
180 OpenBSD ACLs
182 Not available.
185 Mac OS X ACLs
187 Manual pages:
188   https://developer.apple.com/legacy/library/documentation/Darwin/Reference/ManPages/man3/acl.3.html
189 Includes:
190   <sys/acl.h>
191 Library:
192   none needed
193 Functions:
194   acl_add_flag_np
195   acl_add_perm
196   acl_calc_mask
197   acl_clear_flags_np
198   acl_clear_perms
199   acl_copy_entry
200   acl_copy_ext
201   acl_copy_ext_native
202   acl_copy_int
203   acl_copy_int_native
204   acl_create_entry
205   acl_create_entry_np
206   acl_delete_def_file
207   acl_delete_fd_np (undeclared?)
208   acl_delete_file_np (undeclared?)
209   acl_delete_flag_np
210   acl_delete_link_np (undeclared?)
211   acl_delete_entry
212   acl_delete_perm
213   acl_dup
214   acl_free
215   acl_from_text
216   acl_get_entry
217   acl_get_fd
218   acl_get_fd_np
219   acl_get_file
220   acl_get_flag_np
221   acl_get_flagset_np
222   acl_get_link_np
223   acl_get_perm_np
224   acl_get_permset
225   acl_get_qualifier
226   acl_get_tag_type
227   acl_init
228   acl_set_fd
229   acl_set_fd_np
230   acl_set_file
231   acl_set_flagset_np
232   acl_set_link_np
233   acl_set_permset
234   acl_set_qualifier
235   acl_set_tag_type
236   acl_size
237   acl_to_text
238   acl_valid
239   acl_valid_fd_np
240   acl_valid_file_np
241   acl_valid_link_np
242 Utilities:
243   chmod
246 HP-UX 11.00 ACLs
248 Present in HP-UX >= 11.00. On some machines, yields ENOSYS always.
249 Manual pages:
250   getacl, fgetacl: https://nixdoc.net/man-pages/hp-ux/man2/getacl.2.html
251   setacl, fsetacl: https://nixdoc.net/man-pages/hp-ux/man2/setacl.2.html
252   lsacl: https://nixdoc.net/man-pages/hp-ux/man1/lsacl.1.html
253   chacl: https://nixdoc.net/man-pages/hp-ux/man1/chacl.1.html
254 Includes:
255   <acl.h> or <sys/acl.h>
256 Library:
257   none needed
258 Functions:
259   getacl
260   fgetacl
261   fsetacl
262   setacl
263 Utilities:
264   lsacl
265   chacl
266   chmod
269 HP-UX 11.11 ACLs
271 Present in HP-UX >= 11.11.
272 Manual pages:
273   acl: https://nixdoc.net/man-pages/hp-ux/man2/acl.2.html
274   aclsort: https://docstore.mik.ua/manuals/hp-ux/en/B2355-60130/aclsort.3C.html?
275   getacl: https://nixdoc.net/man-pages/hp-ux/man1/getacl.1.html
276   setacl: https://nixdoc.net/man-pages/hp-ux/man1/setacl.1.html
277 Includes:
278   <aclv.h>
279 Library:
280   none needed
281 Functions:
282   acl
283   aclsort
284 Utilities:
285   getacl
286   setacl
289 IRIX ACLs
291 Manual pages:
292   http://techpubs.sgi.com/library/tpl/cgi-bin/browse.cgi?cmd=search&db=man&srch=acl&coll=0650&range=0,133
293   http://techpubs.sgi.com/library/tpl/cgi-bin/getdoc.cgi?coll=0650&db=man&fname=/usr/share/catman/p_man/cat4/acl.z
294 Includes:
295   <sys/acl.h>
296 Library:
297   none needed
298 Functions:
299   acl_add_perm
300   acl_calc_mask
301   acl_clear_perms
302   acl_copy_entry
303   acl_copy_ext
304   acl_copy_int
305   acl_create_entry
306   acl_delete_def_file
307   acl_delete_entry
308   acl_delete_perm
309   acl_dup
310   acl_free
311   acl_from_text
312   acl_get_entry
313   acl_get_fd
314   acl_get_file
315   acl_get_permset
316   acl_get_qualifier
317   acl_get_tag_type
318   acl_init
319   acl_set_fd
320   acl_set_file
321   acl_set_permset
322   acl_set_qualifier
323   acl_set_tag_type
324   acl_size
325   acl_to_short_text
326   acl_to_text
327   acl_valid
328 Utilities:
329   chacl
332 Tru64 ACLs
334 Manual pages:
335   https://backdrift.org/man/tru64/man4/acl.4.html
336   https://backdrift.org/man/tru64/man3/acl_add_perm.3.html
337   https://backdrift.org/man/tru64/man3/acl_clear_perm.3.html
338   https://backdrift.org/man/tru64/man3/acl_copy_entry.3.html
339   https://backdrift.org/man/tru64/man3/acl_copy_ext.3.html
340   https://backdrift.org/man/tru64/man3/acl_copy_int.3.html
341   https://backdrift.org/man/tru64/man3/acl_create_entry.3.html
342   https://backdrift.org/man/tru64/man3/acl_delete_def_fd.3.html
343   https://backdrift.org/man/tru64/man3/acl_delete_def_file.3.html
344   https://backdrift.org/man/tru64/man3/acl_delete_entry.3.html
345   https://backdrift.org/man/tru64/man3/acl_delete_perm.3.html
346   https://backdrift.org/man/tru64/man3/acl_dup.3.html
347   https://backdrift.org/man/tru64/man3/acl_first_entry.3.html
348   https://backdrift.org/man/tru64/man3/acl_free.3.html
349   https://backdrift.org/man/tru64/man3/acl_free_qualifier.3.html
350   https://backdrift.org/man/tru64/man3/acl_free_text.3.html
351   https://backdrift.org/man/tru64/man3/acl_from_text.3.html
352   https://backdrift.org/man/tru64/man3/acl_get_entry.3.html
353   https://backdrift.org/man/tru64/man3/acl_get_fd.3.html
354   https://backdrift.org/man/tru64/man3/acl_get_file.3.html
355   https://backdrift.org/man/tru64/man3/acl_get_permset.3.html
356   https://backdrift.org/man/tru64/man3/acl_get_qualifier.3.html
357   https://backdrift.org/man/tru64/man3/acl_get_tag_type.3.html
358   https://backdrift.org/man/tru64/man3/acl_init.3.html
359   https://backdrift.org/man/tru64/man3/acl_set_fd.3.html
360   https://backdrift.org/man/tru64/man3/acl_set_file.3.html
361   https://backdrift.org/man/tru64/man3/acl_set_permset.3.html
362   https://backdrift.org/man/tru64/man3/acl_set_qualifier.3.html
363   https://backdrift.org/man/tru64/man3/acl_set_tag_type.3.html
364   https://backdrift.org/man/tru64/man3/acl_size.3.html
365   https://backdrift.org/man/tru64/man3/acl_to_text.3.html
366   https://backdrift.org/man/tru64/man3/acl_valid.3.html
367 Includes:
368   <sys/acl.h>
369 Library:
370   -lpacl
371 Functions:
372   acl_add_perm
373   acl_clear_perm
374   acl_copy_entry
375   acl_copy_ext
376   acl_copy_int
377   acl_create_entry
378   acl_delete_def_fd
379   acl_delete_def_file
380   acl_delete_entry
381   acl_delete_perm
382   acl_dup
383   acl_first_entry
384   acl_free
385   acl_free_qualifier
386   acl_free_text
387   acl_from_text
388   acl_get_entry
389   acl_get_fd
390   acl_get_file
391   acl_get_permset
392   acl_get_qualifier
393   acl_get_tag_type
394   acl_init
395   acl_set_fd
396   acl_set_file
397   acl_set_permset
398   acl_set_qualifier
399   acl_set_tag_type
400   acl_size
401   acl_to_text
402   acl_valid
403 Unportable functions:
404   acl_add_entry
405   acl_delete_access_fd
406   acl_delete_access_file
407   acl_delete_def_dir_fd
408   acl_delete_def_dir_file
409   acl_ext_to_text
410   acl_find_entry
411   acl_get
412   acl_mod_perm
413   acl_set
414   acl_to_fmt_text
415   allocate_acl_entry
416   convert_to_er
417   isaclprop
418 Utilities:
419   getacl
420   setacl
423 AIX ACLs
425 Documentation:
426   https://www.ibm.com/support/knowledgecenter/en/ssw_aix_72/com.ibm.aix.security/access_control_list.htm
427 Introduction:
428   http://www1.uni-hamburg.de/RRZ/Software/AIX/ACL.htm
429 Includes:
430   <acl.h> or <sys/acl.h>
431   <sys/access.h>
432 Library:
433   none needed
434 Functions:
435   acl_chg
436   acl_fchg
437   acl_fget
438   acl_fput
439   acl_fset
440   acl_get
441   acl_put
442   acl_set
443   chacl
444   fchacl
445   fstatacl
446   statacl
447 Function in AIX 5.3:
448   aclx_convert
449   aclx_fget
450   aclx_fput
451   aclx_get
452   aclx_gettypeinfo
453   aclx_gettypes
454   aclx_print
455   aclx_printStr
456   aclx_put
457   aclx_scan
458   aclx_scanStr
459 Utilities:
460   aclget
461   aclput
462   acledit
465 NonStop Kernel ACLs
467 Documentation:
468   http://bizsupport1.austin.hp.com/bc/docs/support/SupportManual/c02492445/c02492445.pdf p. 249..260
469   http://bizsupport1.austin.hp.com/bc/docs/support/SupportManual/c02128649/c02128649.pdf
470   http://bizsupport2.austin.hp.com/bc/docs/support/SupportManual/c02128680/c02128680.pdf
471 Includes:
472   <sys/acl.h>
473 Library:
474   none needed
475 Functions:
476   acl
477   aclsort
478 Utilities:
479   getacl
480   setacl
483 Cygwin ACLs
485 Documentation:
486   https://cygwin.com/cygwin-ug-net/ntsec.html#ntsec-aclfuncs
487   acl-cygwin.txt
488 Includes:
489   <sys/acl.h>
490 Library:
491   none needed
492 Functions:
493   acl
494   aclcheck
495   aclfrommode
496   aclfrompbits
497   aclfromtext
498   aclsort
499   acltomode
500   acltopbits
501   acltotext
502   facl
503   lacl
504 Utilities:
505   getfacl
506   setfacl
509 Native Windows ACLs
511 Introduction:
512   https://helgeklein.com/blog/2009/03/permissions-a-primer-or-dacl-sacl-owner-sid-and-ace-explained/
513 Manual pages:
514   https://docs.microsoft.com/en-us/windows/desktop/SecAuthZ/access-control-lists
515   https://docs.microsoft.com/en-us/windows/desktop/SecAuthZ/getting-information-from-an-acl
516   https://docs.microsoft.com/en-us/windows/desktop/api/winnt/ns-winnt-_acl
517   https://en.wikipedia.org/wiki/Cacls
518 Library:
519   ?
520 Functions:
521   GetAclInformation
522   SetAclInformation
523   ...
524 Utilities:
525   cacls
528 Copyright 2008-2021 Free Software Foundation, Inc.
530 Permission is granted to copy, distribute and/or modify this document
531 under the terms of the GNU Free Documentation License, Version 1.3
532 or any later version published by the Free Software Foundation;
533 with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
534 Texts.  A copy of the license is included in the "GNU Free
535 Documentation License" file as part of this distribution.