| Message ID | 20220914173115.296058-2-plambri@redhat.com (mailing list archive) |
|---|---|
| State | New, archived |
| Headers | show |
| Series | [v2,1/2] nfs4_setfacl: add a specific option for indexes | expand |
On 9/14/22 1:31 PM, Pierguido Lambri wrote: > The man page now reflects the newly added syntax to handle indexes. > > Signed-off-by: Pierguido Lambri <plambri@redhat.com> Committed (tag: nfs4-acl-tools-0.4.1-rc3) steved. > --- > man/man1/nfs4_setfacl.1 | 26 ++++++++++++++------------ > 1 file changed, 14 insertions(+), 12 deletions(-) > > diff --git a/man/man1/nfs4_setfacl.1 b/man/man1/nfs4_setfacl.1 > index 47ab517..61699ae 100644 > --- a/man/man1/nfs4_setfacl.1 > +++ b/man/man1/nfs4_setfacl.1 > @@ -30,27 +30,21 @@ Refer to the > manpage for information about NFSv4 ACL terminology and syntax. > .SS COMMANDS > .TP > -.BR "-a " "\fIacl_spec\fP [\fIindex\fP]" > +.BR "-a " "\fIacl_spec\fP" > .RI "add the ACEs from " acl_spec " to " file "'s ACL." > -ACEs are inserted starting at the > -.IR index th > -position (DEFAULT: 1) of > +ACEs are inserted starting at the default position 1 of > .IR file "'s ACL." > .\".ns > .TP > -.BR "-A " "\fIacl_file\fP [\fIindex\fP]" > +.BR "-A " "\fIacl_file\fP " > .RI "add the ACEs from the acl_spec in " acl_file " to " file "'s ACL." > -ACEs are inserted starting at the > -.IR index th > -position (DEFAULT: 1) of > +ACEs are inserted starting at the default position 1 of > .IR file "'s ACL." > .TP > -.BI "-x " "acl_spec \fR|\fP index" > +.BI "-x " "acl_spec \fR" > delete ACEs matched from > .I acl_spec > -- or delete the > -.IR index th > -ACE - from > +from > .IR file 's > ACL. Note that the ordering of the ACEs in > .I acl_spec > @@ -61,6 +55,10 @@ delete ACEs matched from the acl_spec in > .IR acl_file " from " file "'s ACL." > Note that the ordering of the ACEs in the acl_spec does not matter. > .TP > +.BI "-i " "\fIindex\fP" > +.RI "ACEs are inserted or deleted starting at the " index "th position (DEFAULT: 1) of file's ACL. > +It can be used only with the add or delete action. > +.TP > .BI "-s " acl_spec > .RI "set " file "'s ACL to " acl_spec . > .TP > @@ -189,6 +187,10 @@ add the same ACE as above, but using aliases: > .br > $ nfs4_setfacl -a A::alice@nfsdomain.org:RX foo > .IP - 2 > +add the same ACE as above, at index 2: > +.br > + $ nfs4_setfacl -i 2 -a A::alice@nfsdomain.org:RX foo > +.IP - 2 > edit existing ACL in a text editor and set modified ACL on clean save/exit: > .br > $ nfs4_setfacl -e foo
diff --git a/man/man1/nfs4_setfacl.1 b/man/man1/nfs4_setfacl.1 index 47ab517..61699ae 100644 --- a/man/man1/nfs4_setfacl.1 +++ b/man/man1/nfs4_setfacl.1 @@ -30,27 +30,21 @@ Refer to the manpage for information about NFSv4 ACL terminology and syntax. .SS COMMANDS .TP -.BR "-a " "\fIacl_spec\fP [\fIindex\fP]" +.BR "-a " "\fIacl_spec\fP" .RI "add the ACEs from " acl_spec " to " file "'s ACL." -ACEs are inserted starting at the -.IR index th -position (DEFAULT: 1) of +ACEs are inserted starting at the default position 1 of .IR file "'s ACL." .\".ns .TP -.BR "-A " "\fIacl_file\fP [\fIindex\fP]" +.BR "-A " "\fIacl_file\fP " .RI "add the ACEs from the acl_spec in " acl_file " to " file "'s ACL." -ACEs are inserted starting at the -.IR index th -position (DEFAULT: 1) of +ACEs are inserted starting at the default position 1 of .IR file "'s ACL." .TP -.BI "-x " "acl_spec \fR|\fP index" +.BI "-x " "acl_spec \fR" delete ACEs matched from .I acl_spec -- or delete the -.IR index th -ACE - from +from .IR file 's ACL. Note that the ordering of the ACEs in .I acl_spec @@ -61,6 +55,10 @@ delete ACEs matched from the acl_spec in .IR acl_file " from " file "'s ACL." Note that the ordering of the ACEs in the acl_spec does not matter. .TP +.BI "-i " "\fIindex\fP" +.RI "ACEs are inserted or deleted starting at the " index "th position (DEFAULT: 1) of file's ACL. +It can be used only with the add or delete action. +.TP .BI "-s " acl_spec .RI "set " file "'s ACL to " acl_spec . .TP @@ -189,6 +187,10 @@ add the same ACE as above, but using aliases: .br $ nfs4_setfacl -a A::alice@nfsdomain.org:RX foo .IP - 2 +add the same ACE as above, at index 2: +.br + $ nfs4_setfacl -i 2 -a A::alice@nfsdomain.org:RX foo +.IP - 2 edit existing ACL in a text editor and set modified ACL on clean save/exit: .br $ nfs4_setfacl -e foo
The man page now reflects the newly added syntax to handle indexes. Signed-off-by: Pierguido Lambri <plambri@redhat.com> --- man/man1/nfs4_setfacl.1 | 26 ++++++++++++++------------ 1 file changed, 14 insertions(+), 12 deletions(-)