Project

General

Profile

Bug #4192

acl(5): issues in the man page

Added by Marcel Telka over 7 years ago. Updated about 6 years ago.

Status:
Closed
Priority:
Normal
Assignee:
Category:
manpage - manual pages
Start date:
2013-10-09
Due date:
% Done:

100%

Estimated time:
Difficulty:
Bite-size
Tags:
needs-triage
Gerrit CR:

Description

Double 'created':

     inherit_only (i)
                               Placed on a  directory,  but  does
                               not apply to the directory itself,
                               only  to  newly  created   created
                               files  and  directories. This flag
                               requires   file_inherit   and   or
                               dir_inherit  to  indicate  what to
                               inherit.

Extra ')':

     successful_access (S))
                               Indicates if  an  alarm  or  audit
                               record  should  be  initiated upon
                               successful  accesses.  Used   with
                               audit/alarm ACE types.

Missing <perms> for user and group (the chmod(1) man page lists also usersid, groupsid, and sid entries; they should be added here too):

       acl_entry[,acl_entry]...

           owner@:<perms>[:inheritance flags]:<allow|deny>
           group@:<perms>[:inheritance flags]:<allow|deny>
           everyone@:<perms>[:inheritance flags]:<allow|deny>
           user:<username>[:inheritance flags]:<allow|deny>
           group:<groupname>[:inheritance flags]:<allow|deny>

"and or" should be changed to "and/or" here:

     inherit_only (i)
                               Placed on a  directory,  but  does
                               not apply to the directory itself,
                               only  to  newly  created   created
                               files  and  directories. This flag
                               requires   file_inherit   and   or
                               dir_inherit  to  indicate  what to
                               inherit.

and here:

     no_propagate (n)
                               Placed on  directories  and  indi-
                               cates that ACL entries should only
                               be  inherited  one  level  of  the
                               tree.     This    flag    requires
                               file_inherit and or dir_inherit to
                               indicate what to inherit.

Missing spaces after commas:

     acl(2),stat(2),acl_get(3SEC),                 aclsort(3SEC),

Missing space after the colon (maybe we should also change "the Solaris release" to "illumos"):

     tories. Two  different  ACL  models  are  supported  in  the
     Solaris release:POSIX-draft ACLs and NFSv4 ACLs.
#1

Updated by Marcel Telka about 6 years ago

  • Status changed from New to In Progress
  • Assignee set to Marcel Telka
#2

Updated by Marcel Telka about 6 years ago

  • Status changed from In Progress to Pending RTI
#3

Updated by Electric Monk about 6 years ago

  • Status changed from Pending RTI to Closed
  • % Done changed from 0 to 100

git commit 229fca2669c724519f75f27dbd16b96f35b82589

commit  229fca2669c724519f75f27dbd16b96f35b82589
Author: Marcel Telka <marcel.telka@nexenta.com>
Date:   2014-11-24T21:40:54.000Z

    4192 acl(5): issues in the man page
    Reviewed by: Richard Lowe <richlowe@richlowe.net>
    Reviewed by: Gordon Ross <gordon.ross@nexenta.com>
    Reviewed by: Yuri Pankov <yuri.pankov@nexenta.com>
    Approved by: Dan McDonald <danmcd@omniti.com>

Also available in: Atom PDF