[HADOOP-16443] Improve help text for setfacl --set option

• Type: Bug
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 3.3.0
• Fix Version/s: 3.2.1
• Component/s: fs
• Target Version/s: 3.3.0
• Assignee: Stephen O'Donnell
• Reporter: Stephen O'Donnell
• Created: 22/Jul/19 15:10
• Updated: 23/Jul/19 11:56
• Resolved: 23/Jul/19 09:27

Description

The help text associated with the command "setfacl --set" states:

 --set       Fully replace the ACL, discarding all existing entries. The        
              <acl_spec> must include entries for user, group, and others for    
              compatibility with permission bits.               

However the actual behaviour is a bit more subtle:

If the ACL spec contains only access entries, then the existing default entries are retained. If the ACL spec contains only default entries, then the existing access entries are retained. If the ACL spec contains both access and default entries, then both are replaced.

This Jira will improve the help text to more align with the expected behaviour.

Issue Links

• links to: GitHub Pull Request #1138