setpriv: document accepted formats for naming caps

Since commit fbd15c4d4 (setpriv: support setting unnamed capabilities,
2017-07-17), it is possible to name capabilities not only by name, but
also by their index. While using the human-readable name is usually
recommended, using the index may be required in case new capabilities
have been introduced to the kernel for which we have no name yet. The
newly introduce format format is not documented inside of setpriv(1),
though, which is being fixed in this commit.

Signed-off-by: Patrick Steinhardt <ps@pks.im>

diff --git a/sys-utils/setpriv.1 b/sys-utils/setpriv.1
index b0cc33a2b1f96b331de91c122934f820560a37d3..75dadeca8652467b8879c64474b1d86ce28ca0a9 100644 (file)
--- a/sys-utils/setpriv.1
+++ b/sys-utils/setpriv.1
@@ -34,7 +34,12 @@ The argument is a comma-separated list of
 .BI + cap
 and
 .BI \- cap
-entries, which add or remove an entry respectively.
+entries, which add or remove an entry respectively. \fIcap\fR can either be a
+human-readable name as seen in
+.BR capabilities (7)
+without the \fIcap_\fR prefix or of the format
+.BI cap_N ,
+where \fIN\fR is the internal capability index used by Linux.
 .B +all
 and
 .B \-all