gpm_selinux(8)

📦
version 20250627+git412.dbf877ab7 · 7 versions
, in opensuse-leap 16.0

✨ gpm_selinux(8) — the SELinux glow-up for gpm 💅

okay bestie, welcome to gpm_selinux (8th section, manual page energy) — this is the whole lore drop on how Security-Enhanced Linux keeps an eye on the gpm processes. pull up a chair, we're getting into it 🎀

🌸 NAME

gpm_selinux — Security Enhanced Linux Policy for the gpm processes. literally that's the whole title, she's concise 👑

💖 DESCRIPTION

Security-Enhanced Linux secures the gpm processes via flexible mandatory access control. yes, mandatory. she doesn't ask, she just enforces 🔥

The gpm processes execute with the gpm_t SELinux type. wanna check if you've got these processes running? just run the ps command with the -Z qualifier. like this:

ps -eZ | grep gpm_t

that's it. that's the vibe check 🦋

✨ ENTRYPOINTS

The gpm_t SELinux type can be entered via the gpm_exec_t file type.

the default entrypoint paths for the gpm_t domain are, drumroll please:

/usr/bin/gpm

one path. she's lowkey exclusive 🙈

👑 PROCESS TYPES

SELinux defines process types (domains) for each process running on the system. yes, every process gets a little domain to live in 🏠

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

Policy governs the access confined processes have to files. SELinux gpm policy is very flexible, allowing users to setup their gpm processes in as secure a method as possible. maximum security, maximum slay 🔐

The following process types are defined for gpm:

  • gpm_t
Note: semanage permissive -a gpm_t can be used to make the process type gpm_t permissive. SELinux does not deny access to permissive process types, but the AVC (SELinux denials) messages are still generated. so like… she's not gonna block you, but she is gonna write it down in her notes 💀

💅 BOOLEANS

SELinux policy is customizable based on least access required. gpm policy is extremely flexible and has several booleans that allow you to manipulate the policy and run gpm with the tightest access possible. booleans are basically little on/off switches for policy behavior, and we love a toggle 🎚️

If you want to dontaudit all daemons scheduling requests (setsched, sys_nice), you must turn on the daemons_dontaudit_scheduling boolean. Enabled by default.

setsebool -P daemons_dontaudit_scheduling 1

If you want to allow all domains to execute in fips_mode, you must turn on the fips_mode boolean. Enabled by default.

setsebool -P fips_mode 1

both of these are already on out of the box, so no notes for you unless you're changing things 👀

🦋 MANAGED FILES

The SELinux process type gpm_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 needs to have DAC permissions — SELinux isn't out here overriding your regular perms, she's on top of them, okurrr 💜

cluster_conf_t

/etc/cluster(/.*)?

cluster_var_lib_t

/var/lib/pcsd(/.*)?
/var/lib/cluster(/.*)?
/var/lib/openais(/.*)?
/var/lib/pengine(/.*)?
/var/lib/corosync(/.*)?
/usr/lib/heartbeat(/.*)?
/var/lib/heartbeat(/.*)?
/var/lib/pacemaker(/.*)?

cluster_var_run_t

/run/crm(/.*)?
/run/cman_.*
/run/rsctmp(/.*)?
/run/aisexec.*
/run/heartbeat(/.*)?
/run/pcsd-ruby.socket
/run/corosync-qnetd(/.*)?
/run/corosync-qdevice(/.*)?
/run/pcsd.socket
/run/corosync.pid
/run/cpglockd.pid
/run/rgmanager.pid
/run/cluster/rgmanager.sk

gpm_tmp_t

(this one's got no paths listed, she's a mystery, we respect it 🙈)

gpm_var_run_t

/run/gpm.pid

root_t

/sysroot/.aleph-version.json
/sysroot/ostree/deploy/.*-atomic/deploy(/.*)?
/
/initrd
/var/lib/ntp

🎀 FILE CONTEXTS

SELinux requires files to have an extended attribute to define the file type. that's just how she rolls ✨

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

Policy governs the access confined processes have to these files. SELinux gpm policy is very flexible, allowing users to setup their gpm processes in as secure a method as possible. (yes, same sentence as before, she said it twice and honestly? consistency queen 💖)

⭐ STANDARD FILE CONTEXT

SELinux defines the file context types for the gpm. If you wanted to store files with these types in different paths, you need to execute the semanage command to specify alternate labeling, and then use restorecon to put the labels on disk. like so:

semanage fcontext -a -t gpm_exec_t '/srv/gpm/content(/.*)?'
restorecon -R -v /srv/mygpm_content
Note: SELinux often uses regular expressions to specify labels that match multiple files. regex girlies rise 🧚

The following file types are defined for gpm:

gpm_conf_t

  • Set files with the gpm_conf_t type if you want to treat the files as gpm configuration data, usually stored under the /etc directory.

Paths:

/etc/gpm(/.*)?, /etc/gpm-.*.conf

gpm_exec_t

  • Set files with the gpm_exec_t type if you want to transition an executable to the gpm_t domain. this is the entrypoint one, remember her 🫶

gpm_initrc_exec_t

  • Set files with the gpm_initrc_exec_t type if you want to transition an executable to the gpm_initrc_t domain.

gpm_tmp_t

  • Set files with the gpm_tmp_t type if you want to store gpm temporary files in the /tmp directories.

gpm_var_run_t

  • Set files with the gpm_var_run_t type if you want to store the gpm files under the /run or /var/run directory.

gpmctl_t

  • Set files with the gpmctl_t type if you want to treat the files as gpmctl data.

Paths:

/dev/gpmctl, /dev/gpmdata
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 "just for tonight" fix and semanage fcontext + restorecon is the committed relationship, no cap 💍

🌈 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. point-and-click girlies, this one's for you 🖱️✨

🍓 AUTHOR

This manual page was auto-generated using sepolicy manpage. a machine wrote this and she still ate 💅

🔥 SEE ALSO

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

and that's the whole page bestie, go forth and label responsibly 💖

sign-off: this was gpm's page, dated 26-10-06 — ily, stan SELinux, and remember: mandatory access control is not a suggestion 🎀✨

📦 where this page comes from