cap_set_flag

CAP_CLEAR(3)		  Linux Programmer’s Manual		 CAP_CLEAR(3)



NAME
       cap_clear, cap_get_flag, cap_set_flag - capability data object manipu-
       lation

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  identi-
       fied by cap_p in such a way that all capability 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 number 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_PERMIT-
       TED.  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)



				26th May 1997			 CAP_CLEAR(3)