KEYCTL_SET_TIMEOUT(3)

💖 KEYCTL_SET_TIMEOUT(3) 💖

okay bestie, welcome to section 3 of the Linux Key Management Calls — this one's all about giving your keys a lil expiration timer ⏰✨

🌸 NAME 🌸

keyctl_set_timeout — set the expiration timer on a key 🎀

✨ SYNOPSIS ✨

#include <keyutils.h>

long keyctl_set_timeout(key_serial_t key, unsigned timeout);

💅 DESCRIPTION 💅

so basically, keyctl_set_timeout() sets the expiration timer on a key to timeout seconds into the future. like, you're picking a countdown for it 🕰️

and if you set timeout to zero? that cancels the expiration entirely — assuming the key hasn't already expired, bestie. no takebacks if it's already gone 💀

once the key expires, any further attempts to access it will be met with error EKEYEXPIRED. it's giving locked out of your own notes app 🙈

also important: the caller must have setattr permission on the key to be able to change its permissions mask. no permission, no party 🚫

⭐ RETURN VALUE ⭐

on success, keyctl_set_timeout() returns 0. slay ✨

on error, the value -1 will be returned and errno will have been set to an appropriate error. not slay 😭

🔥 ERRORS 🔥

• ENOKEY — the specified key does not exist. it's not there, girl, it never was 💀
• EKEYEXPIRED — the specified key has already expired. too late bestie, the timer already ran out ⏳
• EKEYREVOKED — the specified key has been revoked. it's been cancelled, we don't talk to it anymore 🙅
• EACCES — the named key exists, but does not grant setattr permission to the calling process. it's there but it said no 💅

🦋 LINKING 🦋

this is a library function that can be found in libkeyutils. so when you're linking, you gotta pass -lkeyutils to the linker, periodt 🔗

🌈 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 🫶 this one came from the Linux key management crew, version dated 4 May 2006, filed under KEYCTL_SET_TIMEOUT(3) — go set some timeouts, ily, mwah 💖🎀🦋