salacl(8) — bsd

SALACL(8)                       Domain/OS BSD                        SALACL(8)




NAME
     salacl - salvage an access control list

SYNOPSIS
     /etc/salacl [options]  [volume]

DESCRIPTION
     salacl salvages the (Access Control List (ACL) structure on the volume
     you specify.  It merges duplicate ACLs into a single copy, and deletes
     unused ACLs, those to which no file or directory refers. You should run
     salacl once a week or so unless no acls are being merged and and no acls
     are being "garbage collected."  ("Garbage collecting" refers to salacl
     reclaiming unused ACLs.)

     volume (optional)
                    Specify the entry directory pathname for the volume whose
                    acls you intend to salvage.  Note that salacl cannot
                    salvage a volume mounted on a remote node.

                    Default if omitted:  "/" node entry directory

OPTIONS
     -n[o_]s[ummary]
                    Suppress summary information.

     -v[erify]      Verify only; do not delete or merge any ACLs.

     -n[o_]m[erge]  Do not merge duplicate ACLs into a single copy.

     -l[ist]        List the UIDs of the ACLs that are being combined.

     -u             This option causes salacl to list references to ACLs from
                    files and directories.  Each reference appears as a line
                    containing the UID of the ACL, followed by the UID of the
                    file or directory.  The line also indicates the type of
                    ACL, file or directory, and whether it is an initial ACL
                    or not.

EXAMPLES
     $ /etc/salacl
     ACL objects found:                  24
     ACLs merged with equivalents:       12
     ACLs garbage collected               0


     Salvage the ACLs of the current volume.

     $ /etc/salacl -v
     ACL objects found:                 24
     ACLs which could be merged:        12

     $ /etc/salacl -l
     3A39A9F3.4000CBD6 39A77EF0.4000CBD6 (equiv acl)
     3A75D6C2.E000CBD6 39A77EF0.4000CBD6 (equiv acl)
     3AEE67CA.7000CBD6 39A77EF0.4000CBD6 (equiv acl)
     3AEF69EE.E000CBD6 39A77EF0.4000CBD6 (equiv acl)
     3AEFA618.7000CBD6 382E6E87.A000CBD6 (equiv acl)
     ACL objects found:                  43
     ACLs merged with equivalents:        5
     ACLs garbage collected               0

     $ /etc/salacl -v -u
     3AE41FE2.D000CBD6 393D4261.B000CBD6 (dir)
     3AE41F4B.5000CBD6 380A1479.1000CBD6 (dir)
     3A39A9F3.4000CBD6 3A39A9F2.3000CBD6 (file)
     3AE41F85.0000CBD6 380A1472.F000CBD6 (dir)
     3AE41F84.F000CBD6 380A1472.F000CBD6 (dir def)
     3AE41F81.E000CBD6 380A1472.F000CBD6 (file def)
     ACL objects found:                   6
     ACLs merged with equivalents:        0

Museum