afs_vlserver_selinux(8)

💅 afs_vlserver_selinux — the glow-up guide

okay bestie, so this is afs_vlserver_selinux(8), and it's literally the SELinux policy page for the afs_vlserver processes. it lives in the SELinux Policy afs_vlserver section of the manual, and no cap, it's way more interesting than it sounds 💖

---

✨ NAME ✨

afs_vlserver_selinux — the Security Enhanced Linux Policy for the afs_vlserver processes 🫶

---

🌸 DESCRIPTION 🌸

so what's the vibe? Security-Enhanced Linux secures the afs_vlserver processes via flexible mandatory access control. that's the whole point. it's giving boundaries and honestly we love that for us 💅

the afs_vlserver processes execute with the afs_vlserver_t SELinux type. and like, how do you know if you even have these processes running? easy. just run the ps command with the -Z qualifier. iykyk.

for example:

ps -eZ | grep afs_vlserver_t

that's it. that's the whole vibe check ✨

---

🚪 ENTRYPOINTS 🚪

so the afs_vlserver_t SELinux type can be entered via the afs_vlserver_exec_t file type. that's the door, that's the entrance, that's the main character moment 🌟

the default entrypoint paths for the afs_vlserver_t domain are literally these:

/usr/afs/bin/vlserver, /usr/libexec/openafs/vlserver

periodt. those two paths, nothing more 🎀

---

👑 PROCESS TYPES 👑

okay so SELinux defines process types (domains) for each process running on the system. that's just how it is 🦋

you can see the context of a process using the -Z option to ps.

policy governs the access confined processes have to files. the SELinux afs_vlserver policy is very flexible, allowing users to setup their afs_vlserver processes in as secure a method as possible. flexible and secure, the duality of woman 💜

the following process types are defined for afs_vlserver:

• afs_vlserver_t

Note: semanage permissive -a afs_vlserver_t can be used to make the process type afs_vlserver_t permissive. SELinux does not deny access to permissive process types, but the AVC (SELinux denials) messages are still generated. so like, it won't block anything, but it WILL still read you to filth in the logs 😭

---

🎚️ BOOLEANS 🎚️

SELinux policy is customizable based on least access required. the afs_vlserver policy is extremely flexible and has several booleans that allow you to manipulate the policy and run afs_vlserver with the tightest access possible. tightest access possible, that's the goal, we love a minimalist queen 👑

if you want to allow all domains to execute in fips_mode, you must turn on the fips_mode boolean. enabled by default, bestie, so it's already slaying.

setsebool -P fips_mode 1

---

📁 MANAGED FILES 📁

the SELinux process type afs_vlserver_t can manage files labeled with the following file types. the paths listed are the default paths for these file types. note the processes UID still need to have DAC permissions — SELinux isn't out here doing everything for you 🙈

• afs_logfile_t

/usr/afs/logs(/.*)?

• afs_vl_db_t

/usr/afs/db/vl.*

those regex-looking things are intentional, that's just how we label whole directories, no cap 🔥

---

🗂️ FILE CONTEXTS 🗂️

SELinux requires files to have an extended attribute to define the file type. it's like a little name tag for your files, iconic honestly 🎀

you can see the context of a file using the -Z option to ls.

policy governs the access confined processes have to these files. the SELinux afs_vlserver policy is very flexible, allowing users to setup their afs_vlserver processes in as secure a method as possible. yes we said it again, because it's true twice 💖

🌈 STANDARD FILE CONTEXT 🌈

SELinux defines the file context types for the afs_vlserver, and if you wanted to store files with these types in a different paths, you need to execute the semanage command to specify alternate labeling and then use restorecon to put the labels on disk. move a file, re-label a file, that's the routine ✨

semanage fcontext -a -t afs_vlserver_exec_t
'/srv/afs_vlserver/content(/.*)?'
restorecon -R -v /srv/myafs_vlserver_content

Note: SELinux often uses regular expressions to specify labels that match multiple files. regex girlies rise 🧚

the following file types are defined for afs_vlserver:

afs_vlserver_exec_t

• set files with the afs_vlserver_exec_t type, if you want to transition an executable to the afs_vlserver_t domain.

paths:

/usr/afs/bin/vlserver, /usr/libexec/openafs/vlserver

Note: File context can be temporarily modified with the chcon command. If you want to permanently change the file context you need to use the semanage fcontext command. This will modify the SELinux labeling database. You will need to use restorecon to apply the labels. so chcon is the quick lil temp fix and semanage fcontext + restorecon is the committed relationship, choose wisely 💀

---

🛠️ COMMANDS 🛠️

semanage fcontext can also be used to manipulate default file context mappings.

semanage permissive can also be used to manipulate whether or not a process type is permissive.

semanage module can also be used to enable/disable/install/remove policy modules.

semanage boolean can also be used to manipulate the booleans.

system-config-selinux is a GUI tool available to customize SELinux policy settings. a GUI!! for when you want to click instead of type 🖱️✨

---

✍️ AUTHOR ✍️

This manual page was auto-generated using sepolicy manpage. (yes, a robot wrote this, and it ate 🤖💅)

---

👀 SEE ALSO 👀

selinux(8), afs_vlserver(8), semanage(8), restorecon(8), chcon(1), sepolicy(8), setsebool(8)

go read those next, bestie, the lore runs deep 📚💜

---

and that's the whole page, fr fr 🫶 this lil writeup is afs_vlserver dated 26-10-06, and it's version afs_vlserver_selinux(8) — okay ily, go label some files 💖✨🎀