CAP_GET_PROC(3C)					      CAP_GET_PROC(3C)

NAME    [Toc]    [Back]

     cap_get_proc, cap_set_proc, cap_set_proc_flags  - get or set process
     capabilities

SYNOPSIS    [Toc]    [Back]

     #include <sys/capability.h>

     cap_t cap_get_proc();
     int cap_set_proc(cap_t cap);
     int cap_set_proc_flags(cap_value_t	flags);

DESCRIPTION    [Toc]    [Back]

     cap_get_proc returns a pointer to an allocated cap_t associated with the
     process.

     cap_set_proc sets the capabilities	for the	process	from the cap_t cap.
     If	any flag in cap	is set for any capability not currently	permitted for
     the calling process, the function fails, and the capability state of the
     process shall remain unchanged.

     cap_set_proc_flags	sets the capability state flags	for the	process	from
     the cap_value_t flags.  If	the value of flags is CAP_FLAG_PURE_RECALC
     capabilities will not be inherited	through	exec(2)	unless the program
     file has a	capability set associated with it.

RETURN VALUES    [Toc]    [Back]

     cap_get_proc returns a pointer to an allocated cap_t if successful, NULL
     otherwise.	 The storage should be freed with a call to cap_free with the
     returned pointer as an argument when it is	no longer needed.

     cap_set_proc and cap_set_proc_flags return	0 if successful, -1 otherwise.

ERRORS    [Toc]    [Back]

     cap_get_proc:

     ENOMEM	     allocation	of the cap_t failed.

     cap_set_proc:

     EINVAL	     cap is not	valid

     EPERM	     The caller	attempted to set a capability flag of a
		     capability	that was not permitted to the invoking
		     process.

     ENOMEM	    The	function requires more memory than is allowed by the
		    hardware or	system-imposed memory management constraints.

     cap_set_proc:






									Page 1






CAP_GET_PROC(3C)					      CAP_GET_PROC(3C)



     EINVAL	     flags is not valid

SEE ALSO    [Toc]    [Back]

     capabilities(4)


									PPPPaaaaggggeeee 2222