pr_capbset_read(2const) - BetterMan

pr_capbset_read(2const)

read the calling thread's capability bounding set

distropkg manpages-dev@6.9.1-1dataset 2026-04-01T06:19:02Z+debian+ec4110e+mandoc:1.14.6-4

Synopsis

#include <linux/prctl.h>
  /* Definition of 
PR_*
 constants */
#include <sys/prctl.h>
int prctl(PR_CAPBSET_READ, long 
cap
);

—

Options · 1

EINVAL

cap does not specify a valid capability.

NAME

PR_CAPBSET_READ - read the calling thread's capability bounding set

LIBRARY

Standard C library (libc, -lc)

SYNOPSIS

bash

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

bash

int prctl(PR_CAPBSET_READ, long \ncap\n);

DESCRIPTION

Return 1 if the capability specified in cap is in the calling thread's capability bounding set, or 0 if it is not.

The capability constants are defined in <linux/capability.h>.

The capability bounding set dictates whether the process can receive the capability through a file's permitted capability set on a subsequent call to execve(2).

RETURN VALUE

On success, this call returns the boolean value described above. On error, -1 is returned, and errno is set to indicate the error.

ERRORS

EINVAL: cap does not specify a valid capability.

VERSIONS

A higher-level interface layered on top of this operation is provided in the libcap(3) library in the form of cap_get_bound(3).

STANDARDS

Linux.

HISTORY

Linux 2.6.25.