selinux_colors_path(3)

💖 selinux_colors_path(3) 💖

okay bestie, welcome to the Library Functions Manual — yes this is selinux_colors_path(3), and no it is not as boring as it sounds, I promise 🫶

✨ NAME ✨

selinux_colors_path — the girl who tells you where the active SELinux policy color config file is living 🎀

🌸 SYNOPSIS 🌸

#include <selinux/selinux.h>

const char *selinux_colors_path(void);

no arguments, no drama, just vibes 💅

🦋 DESCRIPTION 🦋

so selinux_colors_path() returns the path to the active policy color configuration file. that's it. that's the whole job. iconic honestly ✨

the way it builds that path? it takes whatever selinux_policy_root(3) hands back and just… appends /secolor.conf to it. slay, no cap.

and like, what even is that file? it's an optional configuration file — key word optional, bestie, it does not have to exist — and its format is shown over in secolor.conf(5). it controls the colors that get associated with the raw context components of the selinux_raw_context_to_color(3) function whenever some SELinux color-aware application wants to display that info 🌈

so basically: no color file, no cute colors. the application just sits there looking monochrome 💀

👑 RETURN VALUE 👑

• success → you get the path to the active policy color configuration file, yay 🎉
• path not available → you get NULL. not a vibe, but it's honest 😭

🙈 ERRORS 🙈

None.

literally none. she does not do errors. she does not do problems. she simply returns NULL and moves on 💅✨

💜 SEE ALSO 💜

• selinux(8)
• selinux_policy_root(3)
• selinux_config(5)
• selinux_raw_context_to_color(3)
• secolor.conf(5)

go read those too, bestie, they're all part of the same little friend group 🫶

SELinux API documentation · 08 April 2011 — and that's the whole page, mwah 💋 go forth and color your contexts responsibly, iykyk 🎀✨💖