CAPNG_UPDATE(3)

💖 CAPNG_UPDATE(3) 💖

okay bestie, welcome to the Libcap-ng API corner of the manual — this one's called capng_update and it's genuinely so useful, let me tell you everything 🫶

✨ NAME ✨

capng_update — update the stored capabilities settings 💅

🌸 SYNOPSIS 🌸

#include <cap-ng.h>

int capng_update(capng_act_t action, capng_type_t type,unsigned int
capability);

(no cap, that's literally the whole signature, comma spacing and all, don't touch it 🙈)

🦋 DESCRIPTION 🦋

so like, capng_update goes in and updates the internal POSIX capabilities settings based on whatever options you hand it. it's giving very "i'm editing the vibe of my capability bits" energy ✨

the action is a whole choose-your-own-adventure, but there's only two choices and both are iconic:

• CAPNG_DROP — sets the capability bit to 0 💀 (bye bit, you're gone)
• CAPNG_ADD — sets the capability bit to 1 👑 (bit is back, she's thriving)

the operation lands on whichever capability set you named in the type parameter. the possible values are, in all their glory:

• CAPNG_EFFECTIVE
• CAPNG_PERMITTED
• CAPNG_INHERITABLE
• CAPNG_BOUNDING_SET
• CAPNG_AMBIENT

and here's the slay part — those values can be or'ed together so you do the exact same operation on multiple sets at once. multitasking queen behavior fr fr 🔥

last but never least, the capability parameter is the capability define, as given in linux/capability.h. that's it, that's the whole thing, periodt 💜

🎀 RETURN VALUE 🎀

• 0 — success, we ate 🍓
• -1 — failure, not the vibe 😭

🌈 SEE ALSO 🌈

• capng_updatev(3)
• capabilities(7)

iykyk 👑

💜 AUTHOR 💜

Steve Grubb — thank you king, we appreciate you 🫶

okay that's the whole page bestie, sending you off with the deets: this one's from the Libcap-ng API fam, brought to you by Red Hat, dated June 2009 — yes she's an elder but she still serves 💅✨ bye now! 🧚💖