From 21920a0a2f368f65491623e68d7c66dfd09c46f4 Mon Sep 17 00:00:00 2001 From: Marcel Telka Date: Tue, 18 Nov 2014 16:02:27 +0100 Subject: [PATCH] 4228 chmod(1): SFI NFSv4 ACL inheritance flags are not documented Reviewed by: Richard Lowe Reviewed by: Gordon Ross Reviewed by: Yuri Pankov Approved by: Dan McDonald --- usr/src/man/man1/chmod.1 | 65 ++++++++++++++++++++++++++++++++++-------------- usr/src/man/man1/ls.1 | 6 ++--- usr/src/man/man5/acl.5 | 6 ++--- 3 files changed, 53 insertions(+), 24 deletions(-) diff --git a/usr/src/man/man1/chmod.1 b/usr/src/man/man1/chmod.1 index e5de56c1dc..4c04e2ce32 100644 --- a/usr/src/man/man1/chmod.1 +++ b/usr/src/man/man1/chmod.1 @@ -1085,6 +1085,35 @@ either \fBfile_inherit\fR and or \fBdir_inherit\fR also being specified. .RE .sp +.ne 2 +.na +\fBsuccessful_access (\fBS\fR)\fR +.ad +.RS 20n +Indicates whether an alarm or audit record should be initiated upon successful +accesses. Used with audit/alarm ACE types. +.RE + +.sp +.ne 2 +.na +\fBfailed_access (\fBF\fR)\fR +.ad +.RS 20n +Indicates whether an alarm or audit record should be initiated when access +fails. Used with audit/alarm ACE types. +.RE + +.sp +.ne 2 +.na +\fBinherited (\fBI\fR)\fR +.ad +.RS 20n +ACE was inherited. +.RE + +.sp .LP The inheritance flags listed can also be specified in the compact format or as positional arguments similar to the \fBls\fR \fB-V\fR format. A hyphen @@ -1105,7 +1134,7 @@ file_inherit/dir_inherit/no_propagate .sp .in +2 .nf -fd-n-- +fd-n--- .fi .in -2 .sp @@ -1493,7 +1522,7 @@ A path name of a file whose file mode bits are to be modified. .SH USAGE .LP See \fBlargefile\fR(5) for the description of the behavior of \fBchmod\fR when -encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). +encountering files greater than or equal to 2 Gbyte (2^31 bytes). .SH EXAMPLES .LP \fBExample 1 \fRDenying \fBexecute\fR Permission @@ -1702,13 +1731,13 @@ First, display the ACL to pick a location to insert a new ACE. .nf % ls -V file.1 -rw-r--r--+ 1 root root 0 Oct 6 12:16 file.1 - user:lp:rw------------:------:allow - owner@:--x-----------:------:deny - owner@:rw-p---A-W-Co-:------:allow - group@:-wxp----------:------:deny - group@:r-------------:------:allow - everyone@:-wxp---A-W-Co-:------:deny - everyone@:r-----a-R-c--s:------:allow + user:lp:rw------------:-------:allow + owner@:--x-----------:-------:deny + owner@:rw-p---A-W-Co-:-------:allow + group@:-wxp----------:-------:deny + group@:r-------------:-------:allow + everyone@:-wxp---A-W-Co-:-------:deny + everyone@:r-----a-R-c--s:-------:allow .fi .in -2 .sp @@ -1739,14 +1768,14 @@ Display the new ACL: .nf $ ls -V file.1 -rw-r--r--+ 1 root staff 0 Feb 3 14:13 file.1 - user:lp:rw------------:------:allow - owner@:--x-----------:------:deny - owner@:rw-p---A-W-Co-:------:allow - user:marks:r-------------:------:deny - group@:-wxp----------:------:deny - group@:r-------------:------:allow - everyone@:-wxp---A-W-Co-:------:deny - everyone@:r-----a-R-c--s:------:allow + user:lp:rw------------:-------:allow + owner@:--x-----------:-------:deny + owner@:rw-p---A-W-Co-:-------:allow + user:marks:r-------------:-------:deny + group@:-wxp----------:-------:deny + group@:r-------------:-------:allow + everyone@:-wxp---A-W-Co-:-------:deny + everyone@:r-----a-R-c--s:-------:allow .fi .in -2 .sp @@ -2628,5 +2657,5 @@ with \fBACL\fR entries, both the file group owner permissions and the \fBACL\fR mask are changed to the new permissions. Be aware that the new \fBACL\fR mask permissions can change the effective permissions for additional users and groups who have \fBACL\fR entries on the file. Use the \fBgetfacl\fR(1) or -\fBls\fR(1)command to make sure the appropriate permissions are set for all +\fBls\fR(1) command to make sure the appropriate permissions are set for all \fBACL\fR entries. diff --git a/usr/src/man/man1/ls.1 b/usr/src/man/man1/ls.1 index 3990ad10bc..9f35b76a62 100644 --- a/usr/src/man/man1/ls.1 +++ b/usr/src/man/man1/ls.1 @@ -1606,7 +1606,7 @@ either \fBfile_inherit\fR and or \fBdir_inherit\fR also being specified. .ad .sp .6 .RS 4n -Indicates if an alarm or audit record should be initiated upon successful +Indicates whether an alarm or audit record should be initiated upon successful accesses. Used with audit/alarm ACE types. .RE @@ -1617,8 +1617,8 @@ accesses. Used with audit/alarm ACE types. .ad .sp .6 .RS 4n -Indicates if an alarm or audit record should be initiated when access fails. -Used with audit/alarm ACE types. +Indicates whether an alarm or audit record should be initiated when access +fails. Used with audit/alarm ACE types. .RE .sp diff --git a/usr/src/man/man5/acl.5 b/usr/src/man/man5/acl.5 index 391fa338da..b1a0c97a1d 100644 --- a/usr/src/man/man5/acl.5 +++ b/usr/src/man/man5/acl.5 @@ -388,7 +388,7 @@ indicate what to inherit. \fBsuccessful_access (\fBS\fR)\fR .ad .RS 26n -Indicates if an alarm or audit record should be initiated upon successful +Indicates whether an alarm or audit record should be initiated upon successful accesses. Used with audit/alarm ACE types. .RE @@ -398,8 +398,8 @@ accesses. Used with audit/alarm ACE types. \fBfailed_access (\fBF\fR)\fR .ad .RS 26n -Indicates if an alarm or audit record should be initiated when access fails. -Used with audit/alarm ACE types. +Indicates whether an alarm or audit record should be initiated when access +fails. Used with audit/alarm ACE types. .RE .sp -- 2.11.4.GIT