search..
No manual entry for -- in section 2const
PR_CAP_AMBIENT_RAISE(2const)			   PR_CAP_AMBIENT_RAISE(2const)

NAME
       PR_CAP_AMBIENT_RAISE  - add to the ambient capability set of the calling
       thread

LIBRARY
       Standard C library (libc, -lc)

SYNOPSIS
       #include <linux/prctl.h>	 /* Definition of PR_* constants */
       #include <sys/prctl.h>

       int prctl(PR_CAP_AMBIENT, PR_CAP_AMBIENT_RAISE, long cap, 0L, 0L);

DESCRIPTION
       The capability specified in cap is added to the ambient capability  set.
       The  specified  capability must already be present in both the permitted
       and the inheritable sets of the process.	 This operation is not	permit-
       ted if the SECBIT_NO_CAP_AMBIENT_RAISE securebit is set.

RETURN VALUE
       On  success,  0 is returned.  On error, -1 is returned, and errno is set
       to indicate the error.

ERRORS
       EINVAL cap does not specify a valid capability.

       EPERM  either the capability specified in cap  is  not  present	in  the
	      process's	 permitted  and	 inheritable  capability  sets,	 or the
	      PR_CAP_AMBIENT_LOWER securebit has been set.

VERSIONS
       See PR_CAP_AMBIENT(2const).

STANDARDS
       Linux.

HISTORY
       Linux 4.3.

SEE ALSO
       prctl(2), PR_CAP_AMBIENT(2const), libcap(3)

Linux man-pages 6.9.1		   2024-06-01	   PR_CAP_AMBIENT_RAISE(2const)