semanage_count(3)

✨ NAME ✨

semanage_count — this is part of the Libsemanage API documentation (aka the semanage_count(3) page, bestie, that's the manual we're living in rn) and it's literally the SELinux Management API 💖

🌸 SYNOPSIS 🌸

okay so here's the tea: the following count function is supported for any semanage record. You just replace the function and object name as necessary — mix and match, it's giving build-your-own-adventure 🦋

extern int COUNT_FUNCTION (
     semanage_handle_t *handle,
     unsigned int* response);

💅 DESCRIPTION 💅

🎀 Behavior

The count function will return the number of all objects in the selected location. That's it. That's the whole vibe. It counts. 👑

🍓 Parameters

• handle — used to track persistent state across semanage calls, and for error reporting. It's the main character keeping receipts. 💖
• response — the number of objects will be stored at the location pointed to by response. So like, pass it a pointer and it'll fill it in, no cap. ✨

⭐ Requirements

This function requires an semanage connection to be established (see semanage_connect(3)). No connection, no counting. Periodt. 🙈

🔥 RETURN VALUE 🔥

In case of failure, -1 is returned, and the semanage error callback is invoked, describing the error 😭 Otherwise a non-negative integer is returned (a commit number). The same number will be returned by all other semanage object read calls until the next commit. Consistency? We love to see it. 💯

🌈 SEE ALSO 🌈

• semanage_handle_create(3)
• semanage_connect(3)

and that's the whole page, bestie!! 🫶 this iconic lil doc was brought to you by ivg2@cornell.edu, dated 16 March 2006 — yes she's vintage, she's an elder, and she still eats 💅✨