PERFORCE change 147367 for review

[Edward Tomasz Napierala]

http://perforce.freebsd.org/chv.cgi?CH=147367

Change 147367 by trasz at trasz_traszkan on 2008/08/14 07:42:03

	Update setfacl(1) manual page and usage().

Affected files ...

.. //depot/projects/soc2008/trasz_nfs4acl/bin/setfacl/setfacl.1#4 edit
.. //depot/projects/soc2008/trasz_nfs4acl/bin/setfacl/setfacl.c#10 edit

Differences ...

==== //depot/projects/soc2008/trasz_nfs4acl/bin/setfacl/setfacl.1#4 (text+ko) ====

@@ -33,11 +33,11 @@
 .Nd set ACL information
 .Sh SYNOPSIS
 .Nm
+.Op Fl bdhkn
 .Op Fl a Ar position entries
-.Op Fl bdhkn
 .Op Fl m Ar entries
 .Op Fl M Ar file
-.Op Fl x Ar entries
+.Op Fl x Ar entries | position
 .Op Fl X Ar file
 .Op Ar
 .Sh DESCRIPTION
@@ -57,7 +57,8 @@
 specified in
 .Ar entries ,
 starting at position
-.Ar position .
+.Ar position ,
+counting from zero.
 This option is only applicable to NFS4 ACLs.
 .It Fl b
 Remove all ACL entries except for the three required entries
@@ -106,10 +107,14 @@
 .It Fl n
 Do not recalculate the permissions associated with the ACL
 mask entry.  This option is not applicable to NFS4 ACLs.
-.It Fl x Ar entries
-Remove the ACL entries specified in
+.It Fl x Ar entries | position
+If
 .Ar entries
+is specified, remove the ACL entries specified there
 from the access or default ACL of the specified files.
+Otherwise, remove entry at index
+.Ar position ,
+counting from zero.
 .It Fl X Ar file
 Remove the ACL entries specified in the file
 .Ar file
@@ -386,6 +391,11 @@
 from
 .Pa file .
 .Pp
+.Dl setfacl -x0 file
+.Pp
+Remove the first entry from the NFS4 ACL from
+.Pa file .
+.Pp
 .Dl setfacl -bn file
 .Pp
 Remove all

==== //depot/projects/soc2008/trasz_nfs4acl/bin/setfacl/setfacl.c#10 (text+ko) ====

@@ -102,8 +102,8 @@
 usage(void)
 {
 
-	fprintf(stderr, "usage: setfacl [-bdhkn] [-m entries] [-M file] "
-	    "[-x entries] [-X file] [file ...]\n");
+	fprintf(stderr, "usage: setfacl [-bdhkn] [-a position entries] "
+	    "[-m entries] [-M file] [-x entries] [-X file] [file ...]\n");
 	exit(1);
 }