Note: This is a public test instance of Red Hat Bugzilla. The data contained within is a snapshot of the live data so any changes you make will not be reflected in the production Bugzilla. Email is disabled so feel free to test any aspect of the site that you want. File any problems you find or give feedback at bugzilla.redhat.com.

Bug 1337039

Summary: setfacl.1 man page is incomplete
Product: Red Hat Enterprise Linux 7 Reporter: wibrown <wibrown>
Component: man-pages-overridesAssignee: Nikola Forró <nforro>
Status: CLOSED ERRATA QA Contact: Iveta Wiedermann <isenfeld>
Severity: low Docs Contact:
Priority: low    
Version: 7.2CC: isenfeld, jkejda, nforro, ovasik, redhat
Target Milestone: rcKeywords: ManPageChange, Patch
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: man-pages-overrides-7.3.0-1.el7 Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-11-04 07:32:08 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1349841    
Attachments:
Description Flags
[PATCH] setfacl.1: document the meaning of '-' in perms none

Description wibrown@redhat.com 2016-05-18 06:23:29 UTC
Description of problem:

Man setfacl states:

"""
       The  perms  field  is  a combination of characters that indicate the permissions: read (r), write (w), execute (x), execute only if the file is a directory or already has execute
       permission for some user (X).  Alternatively, the perms field can be an octal digit (0-7).
"""

This is missing the parameter for perms "-" which means "no permission allowed".

Comment 2 Kamil Dudka 2016-05-18 18:13:10 UTC
Thank you for reporting it!  I will submit a patch upstream to fix it...

Comment 3 Kamil Dudka 2016-05-19 08:32:36 UTC
fix proposed upstream:

http://lists.nongnu.org/archive/html/acl-devel/2016-05/msg00000.html

Comment 4 Kamil Dudka 2016-05-19 10:30:18 UTC
upstream commit:

http://git.savannah.gnu.org/cgit/acl.git/commit/?id=ea3c6bb7

Comment 5 Kamil Dudka 2016-05-19 11:14:58 UTC
Created attachment 1159380 [details]
[PATCH] setfacl.1: document the meaning of '-' in perms

Comment 15 errata-xmlrpc 2016-11-04 07:32:08 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://rhn.redhat.com/errata/RHBA-2016-2485.html

Comment 16 Fedora Update System 2017-06-22 07:25:58 UTC
acl-2.2.52-13.fc25 has been submitted as an update to Fedora 25. https://bodhi.fedoraproject.org/updates/FEDORA-2017-c71743bffc

Comment 17 Fedora Update System 2017-06-22 07:26:11 UTC
acl-2.2.52-15.fc26 has been submitted as an update to Fedora 26. https://bodhi.fedoraproject.org/updates/FEDORA-2017-2028746562

Comment 18 Fedora Update System 2017-06-23 14:20:22 UTC
acl-2.2.52-15.fc26 has been pushed to the Fedora 26 stable repository. If problems still persist, please make note of it in this bug report.

Comment 19 Fedora Update System 2017-06-25 21:22:33 UTC
acl-2.2.52-13.fc25 has been pushed to the Fedora 25 stable repository. If problems still persist, please make note of it in this bug report.