GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
CAP_FCNTLS_LIMIT(2) FreeBSD System Calls Manual CAP_FCNTLS_LIMIT(2)

cap_fcntls_limit, cap_fcntls_get
manage allowed fcntl commands

Standard C Library (libc, -lc)

#include <sys/capsicum.h>

int
cap_fcntls_limit(int fd, uint32_t fcntlrights);

int
cap_fcntls_get(int fd, uint32_t *fcntlrightsp);

If a file descriptor is granted the CAP_FCNTL capability right, the list of allowed fcntl(2) commands can be selectively reduced (but never expanded) with the cap_fcntls_limit() system call.

A bitmask of allowed fcntls commands for a given file descriptor can be obtained with the cap_fcntls_get() system call.

The following flags may be specified in the fcntlrights argument or returned in the fcntlrightsp argument:
Permit F_GETFL command.
Permit F_SETFL command.
Permit F_GETOWN command.
Permit F_SETOWN command.

Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

cap_fcntls_limit() succeeds unless:
[]
The fd argument is not a valid descriptor.
[]
An invalid flag has been passed in fcntlrights.
[]
fcntlrights would expand the list of allowed fcntl(2) commands.

cap_fcntls_get() succeeds unless:

[]
The fd argument is not a valid descriptor.
[]
The fcntlrightsp argument points at an invalid address.

cap_ioctls_limit(2), cap_rights_limit(2), fcntl(2)

The cap_fcntls_get() and cap_fcntls_limit() system calls first appeared in FreeBSD 8.3. Support for capabilities and capabilities mode was developed as part of the TrustedBSD Project.

This function was created by Pawel Jakub Dawidek <pawel@dawidek.net> under sponsorship of the FreeBSD Foundation.
May 5, 2020 FreeBSD 13.1-RELEASE

Search for    or go to Top of page |  Section 2 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.