blob: 73108755ab7594e802e6f65f7758d173582bdb32 [file] [log] [blame]
Nick Kralevich1d1011a2012-09-06 10:14:03 -07001.TH "CAPNG_PRINT_CAPS_NUMERIC" "3" "June 2009" "Red Hat" "Libcap-ng API"
2.SH NAME
3capng_print_caps_text \- print names of values for capabilities set
4.SH "SYNOPSIS"
5.B #include <cap-ng.h>
6.sp
7char *capng_print_caps_text(capng_print_t where, capng_type_t which);
8
9.SH "DESCRIPTION"
10
11capng_print_caps_text will create a text string representation of the internal capability set specified. The representation can be sent to either stdout or a buffer by passing CAPNG_PRINT_STDOUT or CAPNG_PRINT_BUFFER respectively for the where parameter. If the option was for a buffer, this function will malloc a buffer that the caller must free.
12
13The legal values for the which paramemeter is CAPNG_EFFECTIVE, CAPNG_PERMITTED, CAPNG_INHERITABLE, or CAPNG_BOUNDING_SET.
14
15.SH "RETURN VALUE"
16
17If CAPNG_PRINT_BUFFER was selected for where, this will be the text buffer and NULL on failure. If CAPNG_PRINT_STDOUT was selected then this value will be NULL no matter what.
18
19.SH "SEE ALSO"
20
21.BR capabilities (7)
22
23.SH AUTHOR
24Steve Grubb