pr_cap_ambient_raise(2const) - BetterMan

pr_cap_ambient_raise(2const)

add to the ambient capability set of the calling thread

distropkg manpages-dev@6.9.1-1dataset 2026-05-31T07:14:03Z+debian+ec4110e+mandoc:1.14.6-4

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);

—

Options · 2

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.

NAME

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

SYNOPSIS

bash

#include <linux/prctl.h>\n  /* Definition of \nPR_*\n constants */
\n#include <sys/prctl.h>

bash

int prctl(PR_CAP_AMBIENT, PR_CAP_AMBIENT_RAISE, long \ncap\n, 0L, 0L);

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 permitted 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.