matchpath...eckmatches(3)

💖 matchpath...eckmatches(3) — SELinux API documentation 💖

okay bestie, gather round, because this one is the maintenance crew of matchpathcon and it is lowkey iconic. these four functions are all about checking and reporting whether any specification index has no matches with any inode, plus keeping maintenance and statistics on inode associations. no cap. 🦋

✨ SYNOPSIS ✨

#include <selinux/selinux.h>

void matchpathcon_checkmatches(char *str);

int matchpathcon_filespec_add(ino_t ino, int specind, const char *file);

void matchpathcon_filespec_destroy(void);

void matchpathcon_filespec_eval(void);

🌸 DESCRIPTION 🌸

so there's four of them and they each do a lil job, here's the tea:

• matchpathcon_checkmatches() — she checks whether any specification has no matches and then reports them. the str argument? that's the prefix for any warning messages, so your warnings come out looking cute and labelled. 💅
• matchpathcon_filespec_add() — this one maintains an association between an inode ino and a specification index specind, and also checks whether a conflicting specification is already associated with the same inode (think multiple hard links, that's the classic culprit). if there IS a conflict, it uses the latter of the two specifications based on their order in the file context configuration. she returns the specification index used, or -1 on error. not me being the whole referee of your inode drama 😭
• matchpathcon_filespec_destroy() — destroys any inode associations that have been added. it's giving "fresh start", e.g. when you wanna restart for a new filesystem. cleanse and reset, periodt. 🧚
• matchpathcon_filespec_eval() — displays statistics on the hash table usage for the inode associations. she's the one with the receipts. 📊✨

👑 RETURN VALUE 👑

returns zero on success or -1 otherwise. that's it, that's the whole vibe check. 💜

🫶 SEE ALSO 🫶

selinux(8), matchpathcon(3), matchpathcon_index(3), freecon(3), setfilecon(3), setfscreatecon(3)

heads up bestie: this page is part of the SELinux API documentation, and it's matchpath...eckmatches(3) — same title, same manual section, top and bottom. 💖

okay that's the whole page, slay, go forth and associate your inodes responsibly 🌈💀

sign-off kiss: stephen.smalley.work@gmail.com — 21 November 2009 🎀🦋⭐