CAPNG_APPLY_CAPS_FD(3)

📦
version 0.9.6 · 3 versions
, in arch rolling, fedora 43, fedora 44, nixpkgs unstable, ubuntu stonking

💖 CAPNG_APPLY_CAPS_FD(3) 💖

okay bestie, welcome to the Libcap-ng API corner of the man pages, where we make files hold their own capabilities like the little main characters they are ✨

🌸 NAME 🌸

capng_apply_caps_fd — write file-based capabilities to extended attributes 🎀

🦋 SYNOPSIS 🦋

#include <cap-ng.h>

int capng_apply_caps_fd(int fd);

✨ DESCRIPTION ✨

so here's the tea, bestie 🍓 — this function writes the file based capabilities to the extended attributes of the file that the descriptor was opened against. like, the fd you hand it? that's the file getting the glow-up 💅

real talk: the bounding set is NOT included in file based capabilities operations. it just doesn't come to this party 🙅‍♀️

also, lowkey important: this function will only work if it was compiled on a kernel that supports file based capabilities, such as 2.6.26 and later. if your kernel is giving ancient energy, this isn't happening 💀

🔥 RETURN VALUE 🔥

  • 0 — slay, it worked, success 💖
  • -1 — something besides a regular file got passed in, or the extended attribute operation failed 😭
  • -2 — the file capability data cannot be serialized 🙈

👑 SEE ALSO 👑

🫶 AUTHOR 🫶

Steve Grubb

and that's the whole vibe, bestie — this page came from the Libcap-ng API, brought to you by Red Hat, dated Sept 2020, and it's literally called CAPNG_APPLY_CAPS_FD(3). periodt. 💜🌈

📦 where this page comes from