PR_CAP_AMBIENT_LOWER(2const)                      PR_CAP_AMBIENT_LOWER(2const)

NAME
       PR_CAP_AMBIENT_LOWER - lower 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_LOWER, long cap, 0L, 0L);

DESCRIPTION
       The capability specified in cap is removed from the ambient capability
       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.

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.14              2025-05-06      PR_CAP_AMBIENT_LOWER(2const)