File: setcap.8

package info (click to toggle)
libcap2 1%3A2.19-3
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 576 kB
  • ctags: 402
  • sloc: ansic: 2,695; sh: 663; makefile: 167
file content (49 lines) | stat: -rw-r--r-- 1,150 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
.\"
.\" $Id: setcap.8,v 1.1.1.1 1999/04/17 22:16:31 morgan Exp $
.\"
.TH SETCAP 8 "24th October 2008"
.SH NAME
setcap \- set file capabilities
.SH SYNOPSIS
\fBsetcap\fP [-q] [-v] (\fIcapabilities|-|-r) filename\fP [ ... \fIcapabilitiesN\fP \fIfileN\fP ]
.SH DESCRIPTION
In the absence of the
.B -v
(verify) option
.B setcap
sets the capabilities of each specified
.I filename
to the
.I capabilities
specified.  The
.B -v
option is used to verify that the specified capabilities are currently
associated with the file.
.PP
The
.I capabilities
are specified in the form described in
.IR cap_from_text (3).
.PP
The special capability string,
.BR '-' ,
can be used to indicate that capabilities are read from the standard
input. In such cases, the capability set is terminated with a blank
line.
.PP
The special capability string,
.BR '-r' ,
is used to remove a capability set from a file.
.PP
The
.B -q
flag is used to make the program less verbose in its output.
.SH "EXIT CODE"
The
.B setcap
program will exit with a 0 exit code if successful. On failure, the
exit code is 1.
.SH "SEE ALSO"
.BR cap_from_text (3),
.BR cap_set_file (3),
.BR getcap (8)