PR_CAPBSET_READ(2const)

PR_CAPBSET_READ2const

Read the calling thread's capability bounding set

Usage

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

int prctl(PR_CAPBSET_READ, long cap);

Library

Standard C library (libc, -lc)

Overview

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

Releases

2 releases since Debian 13 (Trixie); the text changed 1 time.

  1. 13
  2. Arch

Standards

Linux.

History

Linux 2.6.25.

From man-pages 6.19-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.