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. You should run salacl once a week or so unless you never
     receive reports that reference counts need repairing (that is, everything
     is perfect).

     salacl cannot merge duplicate ACLs on files that are currently in use
     (locked) (for example, library files).  This is not especially serious,
     as the duplication consumes very little disk space.  To merge all
     possible ACLs on a node, including things like libraries, bring the node
     up diskless, mount the volume using mtvol, and then run salacl on the
     mounted volume.

     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 salvol to scan for files and
                    directories with ACLs.  When it encounters one, it puts
                    out a line with UID of the ACL, followed by the UID of the
                    file or directory. It also indicates the type of ACL,
                    whether file or directory, and whether initial or not.

EXAMPLES
     $ /etc/salacl
     Warning: unable to merge two equivalent ACLs:
     //grover/sys/node_data/boot_shell -
     object is in use  (OS/file server)
     acl objects found:                  24
     acls merged with equivalents:       12

     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

     $ /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)

Museum