semanage_bool(3)

💖 semanage_bool — the SELinux Policy Booleans Management API 💖

okay bestie, pull up a chair 🪑 because we're about to talk about semanage_bool(3), which lives in the Libsemanage API documentation. This is the SELinux Policy Booleans Management API, and it's genuinely so much fun once you get it. Let's go 🌸

✨ SYNOPSIS ✨

#include <semanage/boolean_record.h>
#include <semanage/booleans_active.h>
#include <semanage/booleans_policy.h>
#include <semanage/booleans_local.h>

This object contains properties associated with a SELinux policy boolean.

For details on a specific function, see its manual page. no fr, each one has its own page — go read it, i'll wait 🫶

📝 Record API Overview 📝

the little guys that make a boolean a boolean:

• semanage_bool_create(3) — create a boolean ✨
• semanage_bool_free(3) — release resources for this boolean (give it back, babe)
• semanage_bool_key_create(3) — create a key, which can be used to identify a boolean 🔑
• semanage_bool_key_free(3) — release resources for this boolean key
• semanage_bool_key_extract(3) — create a key matching this boolean
• semanage_bool_clone(3) — create an identical boolean (deep-copy clone, like a twin but lowkey identical)
• semanage_bool_compare(3) — compare this boolean to the provided key
• semanage_bool_compare2(3) — compare this boolean to another

🎀 Properties API Overview 🎀

name and value, the whole personality:

• semanage_bool_get_name(3) — return the name of this boolean
• semanage_bool_set_name(3) — set the name of this boolean
• semanage_bool_get_value(3) — return the value of this boolean
• semanage_bool_set_value(3) — set the value of this boolean

👑 Record Store API Overview 👑

where the booleans actually live — persistent policy, local store, or currently active policy. three whole vibes 💅

• semanage_bool_modify_local(3) — add or update a boolean in the local store
• semanage_bool_set_active(3) — update a boolean in the currently active policy
• semanage_bool_del_local(3) — delete a boolean from the local store
• semanage_bool_exists(3) — check if a boolean is defined in the persistent policy
• semanage_bool_exists_local(3) — check if a boolean is defined in the local store
• semanage_bool_exists_active(3) — check if a boolean is defined in the currently active policy
• semanage_bool_query(3) — query a boolean in the persistent policy
• semanage_bool_query_local(3) — query a boolean in the local store
• semanage_bool_query_active(3) — query a boolean in the currently active policy
• semanage_bool_count(3) — count the number of booleans defined in the persistent policy
• semanage_bool_count_local(3) — count the number of booleans defined in the local store
• semanage_bool_count_active(3) — count the number of booleans defined in the currently active policy
• semanage_bool_iterate(3) — execute a callback for each boolean in the persistent policy
• semanage_bool_iterate_local(3) — execute a callback for each boolean in the local store
• semanage_bool_iterate_active(3) — execute a callback for each boolean in the currently active policy
• semanage_bool_list(3) — return an array containing all booleans in the persistent policy
• semanage_bool_list_local(3) — return an array containing all booleans in the local store
• semanage_bool_list_active(3) — return an array containing all booleans in the currently active policy

notice the pattern bestie? _local = local store, _active = currently active policy, and no suffix at all = the persistent policy. the way that's so consistent of them 😭 iconic.

that's the whole page, and honestly? it ate. 💖 this was written by ivg2@cornell.edu and dated 16 March 2006, sitting inside the Libsemanage API documentation — yeah it's vintage, and vintage is always in. mwah 💅✨🦋