cap_clear,  cap_get_flag,  cap_set_flag  - capability data
       object manipulation


SYNOPSIS

       #include <sys/capability.h>

       int cap_clear(cap_t cap_p);

       int cap_get_flag(cap_t cap_p, cap_value_t cap,  cap_flag_t
       flag, cap_flag_value_t *value_p);

       int  cap_set_flag(cap_t  cap_p, cap_flag_t flag, int ncap,
       cap_value_t *caps, cap_flag_value_t value);


USAGE

       cc ... -lcap


DESCRIPTION

       cap_clear initializes  the  capability  state  in  working
       storage  identified  by cap_p in such a way that all capa­
       bility flags are cleared.

       cap_get_flag obtains the current value of  the  capability
       flag,  flag,  of  the capability, cap, from the capability
       state identified by cap_p and places it  in  the  location
       pointed to by value_p.

       cap_set_flag  sets  the  flag, flag, of each capability in
       the array caps in the capability state identified by cap_p
       to value.  The argument, ncap, is used to specify the num­
       ber of capabilities in the array, caps.

       A  cap_value_t  can  identify  any  capability,  such   as
       CAP_CHOWN.   A  cap_flag_t  can  be  set to CAP_EFFECTIVE,
       CAP_INHERITABLE or CAP_PERMITTED.  A cap_flag_value_t  can
       be CAP_CLEAR (0) or CAP_SET (1).


RETURN VALUE

       cap_clear,  cap_get_flag  and  cap_set_flag return zero on
       success, and -1 on failure.

       On failure, errno(3) is set to EINVAL, indicating that one
       of the arguments is invalid.


CONFORMING TO

       These functions are specified by POSIX.1e.


SEE ALSO

       cap_copy_ext(3),     cap_from_text(3),    cap_get_file(3),
       cap_get_proc(3), cap_init(3)


Man(1) output converted with man2html