summaryrefslogtreecommitdiff
path: root/docs/capng_updatev.3
blob: 2180f867fa23e988e046e0637d11998a956a4677 (plain)
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
.TH "CAPNG_UPDATEV" "3" "June 2009" "Red Hat" "Libcap-ng API"
.SH NAME
capng_updatev \- update the stored capabilities settings
.SH "SYNOPSIS"
.B #include <cap-ng.h>
.sp
int capng_updatev(capng_act_t action, capng_type_t type,
	unsigned int capability, ...);

.SH "DESCRIPTION"

capng_updatev will update the internal posix capabilities settings based on the options passed to it. The action should be eith CAPNG_DROP to set the capability bit to 0, or CAPNG_ADD to set the capability bit to 1. The operation is performed on the capability set specified in the type parameter. The values are: CAPNG_EFFECTIVE, CAPNG_PERMITTED, CAPNG_INHERITABLE, CAPNG_BOUNDING_SET. The values may be or'ed together to perform the same operation on multiple sets. The last paramter, capability, is the capability define as given in linux/capability.h.

This function differs from capng_update in that you may pass a list of capabilities. This list must be terminated with a -1 value.

.SH "RETURN VALUE"

This returns 0 on success and -1 on failure.

.SH "SEE ALSO"

.BR capng_update (3),
.BR capabilities (7) 

.SH AUTHOR
Steve Grubb