KEYCTL_CHOWN(3)

💖 KEYCTL_CHOWN — the keyctl_chown(3) glow-up 💖

okay bestie so this is a page from the Linux Key Management Calls manual, and it's literally about changing who owns a key. yes. keys have owners now. we love accountability. 🎀

✨ NAME ✨

keyctl_chown — change the ownership of a key 👑

🌸 SYNOPSIS 🌸

#include <keyutils.h>

long keyctl_chown(key_serial_t key, uid_t uid, gid_t gid);

she takes three args and she's not sorry about it 💅

🦋 DESCRIPTION 🦋

keyctl_chown() changes the user and group ownership details of a key. that's it. that's the whole vibe. transferring the deed, signing over the title, the whole ceremony. 🏠✨

A setting of -1 on either uid or gid will cause that setting to be ignored. so if you don't wanna touch one of them, just hit it with a -1 and move on, no cap. 🙈

now here's the part where the rules show up. a process that does not have the SysAdmin capability may not:

• change a key's UID, or
• set the key's GID to a value that doesn't match the process's own GID or one of its group list.

like, you can't just hand the keys to the kingdom to a random stranger. that's giving chaos. 😭

also the caller must have setattr permission on a key to be able to change its ownership. no setattr, no ownership change, periodt. 🔐

⭐ RETURN VALUE ⭐

On success keyctl_chown() returns 0. 🎉

On error, the value -1 will be returned and errno will have been set to an appropriate error. classic. she tells you what went wrong, you just have to look. 👀

💀 ERRORS 💀

• ENOKEY — The specified key does not exist. it's not there. gone. ghosted. 👻
• EKEYEXPIRED — The specified key has expired. bestie she's past her prime, she's expired like milk. 🥛
• EKEYREVOKED — The specified key has been revoked. someone took her privileges away and honestly? it was probably deserved. 🚫
• EDQUOT — Changing the UID to the one specified would run that UID out of quota. oop, they're at their limit, no more for them. 📉
• EACCES — The key exists, but does not grant setattr permission to the calling process. she's there, she's real, she's just not letting you in. 💅

🌈 LINKING 🌈

This is a library function that can be found in libkeyutils. when you're linking, -lkeyutils should be specified to the linker. don't forget it or the linker will simply not know her. 🫶

🧚 SEE ALSO 🧚

keyctl(1), add_key(2), keyctl(2), request_key(2), keyctl(3), keyrings(7), keyutils(7)

and that's the whole page, bestie!! go forth and reassign ownership responsibly, mwah 💖

this came from the Linux keyutils manual pages, dated 4 May 2006, and the page itself is KEYCTL_CHOWN(3) — icon behavior from 2006, honestly. slay. 🌟