semanage_user(3)

✨ semanage_user(3) ✨

okay bestie, welcome to the libsemanage API documentation for SELinux user management 💖 this is the page that tells you everything about the semanage_user thing — sit down, grab a strawberry 🍓, and let's get into it.

---

🌸 NAME 🌸

semanage_user — the SELinux User Management API 👑

---

🦋 SYNOPSIS 🦋

#include <semanage/user_record.h>
#include <semanage/users_policy.h>
#include <semanage/users_local.h>

So this object holds all the properties that go with a SELinux user. And here's the vibe: usually many Unix users get mapped to the same SELinux user. Like, one SELinux user, a whole crowd of Unix users, main character energy honestly.

If you want the big-picture overview of the Unix user API, go peek at semanage_seuser(3) 🫶

And if you're here for one specific function? Every function has its own manual page, so go read that one. no cap.

---

📋 Record API Overview

• semanage_user_create(3) — create a user ✨
• semanage_user_free(3) — release resources for this user 🧹
• semanage_user_key_create(3) — create a key, which can be used to identify a user 🔑
• semanage_user_key_free(3) — release resources for this user key 🫧
• semanage_user_key_extract(3) — create a key matching this user 🎯
• semanage_user_clone(3) — create an identical user (a deep-copy clone, so like a twin, not a copy-paste situation) 👯
• semanage_user_compare(3) — compare this user to the provided key ⚖️
• semanage_user_compare2(3) — compare this user to another 💅

---

💖 Properties API Overview

• semanage_user_get_name(3) — return the name of this user 🏷️
• semanage_user_set_name(3) — set the name of this user ✏️
• semanage_user_get_prefix(3) — return the labeling prefix for this user, which is used to control the contexts of user directories 📁
• semanage_user_set_prefix(3) — set the labeling prefix for this user 🖊️
• semanage_user_get_mlslevel(3) — return the default MLS level, which gets assigned to this user at login time 🌈
• semanage_user_set_mlslevel(3) — set the default MLS level 🎚️
• semanage_user_get_mlsrange(3) — return the range of valid MLS sensitivities and categories for this user 📏
• semanage_user_set_mlsrange(3) — set the range of valid MLS sensitivities and categories for this user 🎛️
• semanage_user_add_role(3) — add a role to the user's list of valid roles ➕
• semanage_user_del_role(3) — remove a role from the user's list of valid roles ➖
• semanage_user_has_role(3) — check if a role is valid for this user ✅
• semanage_user_get_num_roles(3) — return the number of valid roles for this user 🔢
• semanage_user_get_roles(3) — return an array containing the roles for this user 📦
• semanage_user_set_roles(3) — set the roles for this user 🎀

---

🗄️ Record Store API Overview

• semanage_user_modify_local(3) — add or update a user in the local store 🔄
• semanage_user_del_local(3) — delete a user from the local store 🗑️
• semanage_user_exists(3) — check if a user is defined in the persistent policy 🔍
• semanage_user_exists_local(3) — check if a user is defined in the local store 👀
• semanage_user_query(3) — query a user in the persistent policy ❓
• semanage_user_query_local(3) — query a user in the local store 🙋
• semanage_user_count(3) — count the number of users defined in the persistent policy 🧮
• semanage_user_count_local(3) — count the number of users defined in the local store 📊
• semanage_user_iterate(3) — execute a callback for each user in the persistent policy 🔁
• semanage_user_iterate_local(3) — execute a callback for each user in the local store 🌀
• semanage_user_list(3) — return an array containing all users in the persistent policy 📜
• semanage_user_list_local(3) — return an array containing all users in the local store 📃

---

okay that's the whole page bestie, every single function accounted for, nothing skipped, we ate and left no crumbs 💅✨

---

💌 cute sign-off time 💌

this iconic lil doc was brought to you by ivg2@cornell.edu, dated 16 March 2006, and it lives in the Libsemanage API documentation section as semanage_user(3). mwah 🫶🎀🦋