doc/acl-resources.txt

   1 General introduction:
   2   http://www.suse.de/~agruen/acl/linux-acls/online/
   3
   4
   5 POSIX ACLs
   6
   7 Documents from POSIX.1e (headers & functions) and POSIX.2c (utilities):
   8   http://wt.tuxomania.net/publications/posix.1e/download.html
   9
  10
  11 Linux ACLs
  12
  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
  17
  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
  67
  68
  69 Solaris ACLs
  70
  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
 113
 114
 115 FreeBSD ACLs
 116
 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
 173
 174
 175 NetBSD ACLs
 176
 177 Not available.
 178
 179
 180 OpenBSD ACLs
 181
 182 Not available.
 183
 184
 185 Mac OS X ACLs
 186
 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
 244
 245
 246 HP-UX 11.00 ACLs
 247
 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
 267
 268
 269 HP-UX 11.11 ACLs
 270
 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
 287
 288
 289 IRIX ACLs
 290
 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
 330
 331
 332 Tru64 ACLs
 333
 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
 421
 422
 423 AIX ACLs
 424
 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
 463
 464
 465 NonStop Kernel ACLs
 466
 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
 481
 482
 483 Cygwin ACLs
 484
 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
 507
 508
 509 Native Windows ACLs
 510
 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
 526
 527
 528 Copyright 2008-2020 Free Software Foundation, Inc.
 529
 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.