| Current File : //proc/thread-self/root/kunden/usr/share/selinux/devel/html/pulseaudio.html |
<!-- Creator : groff version 1.22.4 -->
<!-- CreationDate: Thu Apr 10 20:00:00 2025 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
p { margin-top: 0; margin-bottom: 0; vertical-align: top }
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
h1 { text-align: center }
</style>
<title>pulseaudio_selinux</title>
</head>
<body>
<h1 align="center">pulseaudio_selinux</h1>
<a href="#NAME">NAME</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#ENTRYPOINTS">ENTRYPOINTS</a><br>
<a href="#PROCESS TYPES">PROCESS TYPES</a><br>
<a href="#BOOLEANS">BOOLEANS</a><br>
<a href="#PORT TYPES">PORT TYPES</a><br>
<a href="#MANAGED FILES">MANAGED FILES</a><br>
<a href="#FILE CONTEXTS">FILE CONTEXTS</a><br>
<a href="#COMMANDS">COMMANDS</a><br>
<a href="#AUTHOR">AUTHOR</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<hr>
<h2>NAME
<a name="NAME"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">pulseaudio_selinux
− Security Enhanced Linux Policy for the pulseaudio
processes</p>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Security-Enhanced
Linux secures the pulseaudio processes via flexible
mandatory access control.</p>
<p style="margin-left:11%; margin-top: 1em">The pulseaudio
processes execute with the pulseaudio_t SELinux type. You
can check if you have these processes running by executing
the <b>ps</b> command with the <b>−Z</b>
qualifier.</p>
<p style="margin-left:11%; margin-top: 1em">For
example:</p>
<p style="margin-left:11%; margin-top: 1em"><b>ps -eZ |
grep pulseaudio_t</b></p>
<h2>ENTRYPOINTS
<a name="ENTRYPOINTS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The
pulseaudio_t SELinux type can be entered via the
<b>pulseaudio_exec_t</b> file type.</p>
<p style="margin-left:11%; margin-top: 1em">The default
entrypoint paths for the pulseaudio_t domain are the
following:</p>
<p style="margin-left:11%; margin-top: 1em">/usr/bin/pulseaudio</p>
<h2>PROCESS TYPES
<a name="PROCESS TYPES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">SELinux defines
process types (domains) for each process running on the
system</p>
<p style="margin-left:11%; margin-top: 1em">You can see the
context of a process using the <b>−Z</b> option to
<b>ps</b></p>
<p style="margin-left:11%; margin-top: 1em">Policy governs
the access confined processes have to files. SELinux
pulseaudio policy is very flexible allowing users to setup
their pulseaudio processes in as secure a method as
possible.</p>
<p style="margin-left:11%; margin-top: 1em">The following
process types are defined for pulseaudio:</p>
<p style="margin-left:11%; margin-top: 1em"><b>pulseaudio_t</b></p>
<p style="margin-left:11%; margin-top: 1em">Note:
<b>semanage permissive -a pulseaudio_t</b> can be used to
make the process type pulseaudio_t permissive. SELinux does
not deny access to permissive process types, but the AVC
(SELinux denials) messages are still generated.</p>
<h2>BOOLEANS
<a name="BOOLEANS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">SELinux policy
is customizable based on least access required. pulseaudio
policy is extremely flexible and has several booleans that
allow you to manipulate the policy and run pulseaudio with
the tightest access possible.</p>
<p style="margin-left:11%; margin-top: 1em">If you want to
deny all system processes and Linux users to use bluetooth
wireless technology, you must turn on the deny_bluetooth
boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
deny_bluetooth 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow all domains to execute in fips_mode, you must turn on
the fips_mode boolean. Enabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
fips_mode 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow system to run with NIS, you must turn on the
nis_enabled boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
nis_enabled 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow regular users direct dri device access, you must turn
on the selinuxuser_direct_dri_enabled boolean. Enabled by
default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
selinuxuser_direct_dri_enabled 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
support NFS home directories, you must turn on the
use_nfs_home_dirs boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
use_nfs_home_dirs 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
support SAMBA home directories, you must turn on the
use_samba_home_dirs boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
use_samba_home_dirs 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allows clients to write to the X server shared memory
segments, you must turn on the xserver_clients_write_xshm
boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
xserver_clients_write_xshm 1</b></p>
<h2>PORT TYPES
<a name="PORT TYPES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">SELinux defines
port types to represent TCP and UDP ports.</p>
<p style="margin-left:11%; margin-top: 1em">You can see the
types associated with a port by using the following
command:</p>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
port -l</b></p>
<p style="margin-left:11%; margin-top: 1em">Policy governs
the access confined processes have to these ports. SELinux
pulseaudio policy is very flexible allowing users to setup
their pulseaudio processes in as secure a method as
possible.</p>
<p style="margin-left:11%; margin-top: 1em">The following
port types are defined for pulseaudio: <b><br>
pulseaudio_port_t</b></p>
<p style="margin-left:11%; margin-top: 1em">Default Defined
Ports:</p>
<p style="margin-left:26%;">tcp 4713 <br>
udp 4713</p>
<h2>MANAGED FILES
<a name="MANAGED FILES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The SELinux
process type pulseaudio_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.</p>
<p style="margin-left:11%; margin-top: 1em"><b>cifs_t</b></p>
<p style="margin-left:11%; margin-top: 1em"><b>krb5_host_rcache_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/var/tmp/krb5_0.rcache2
<br>
/var/cache/krb5rcache(/.*)? <br>
/var/tmp/nfs_0 <br>
/var/tmp/DNS_25 <br>
/var/tmp/host_0 <br>
/var/tmp/imap_0 <br>
/var/tmp/HTTP_23 <br>
/var/tmp/HTTP_48 <br>
/var/tmp/ldap_55 <br>
/var/tmp/ldap_487 <br>
/var/tmp/ldapmap1_0</p>
<p style="margin-left:11%; margin-top: 1em"><b>pulseaudio_var_lib_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/var/lib/pulse(/.*)?</p>
<p style="margin-left:11%; margin-top: 1em"><b>pulseaudio_var_run_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/var/run/pulse(/.*)?</p>
<p style="margin-left:11%; margin-top: 1em"><b>user_tmp_type</b></p>
<p style="margin-left:11%; margin-top: 1em">all user tmp
files</p>
<p style="margin-left:11%; margin-top: 1em"><b>virt_tmpfs_type</b></p>
<h2>FILE CONTEXTS
<a name="FILE CONTEXTS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">SELinux
requires files to have an extended attribute to define the
file type.</p>
<p style="margin-left:11%; margin-top: 1em">You can see the
context of a file using the <b>−Z</b> option to
<b>ls</b></p>
<p style="margin-left:11%; margin-top: 1em">Policy governs
the access confined processes have to these files. SELinux
pulseaudio policy is very flexible allowing users to setup
their pulseaudio processes in as secure a method as
possible.</p>
<p style="margin-left:11%; margin-top: 1em"><b>STANDARD
FILE CONTEXT</b></p>
<p style="margin-left:11%; margin-top: 1em">SELinux defines
the file context types for the pulseaudio, 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.</p>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
fcontext -a -t pulseaudio_var_run_t
’/srv/mypulseaudio_content(/.*)?’ <br>
restorecon -R -v /srv/mypulseaudio_content</b></p>
<p style="margin-left:11%; margin-top: 1em">Note: SELinux
often uses regular expressions to specify labels that match
multiple files.</p>
<p style="margin-left:11%; margin-top: 1em"><i>The
following file types are defined for pulseaudio:</i></p>
<p style="margin-left:11%; margin-top: 1em"><b>pulseaudio_exec_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the pulseaudio_exec_t type, if you want to transition
an executable to the pulseaudio_t domain.</p>
<p style="margin-left:11%; margin-top: 1em"><b>pulseaudio_home_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the pulseaudio_home_t type, if you want to store
pulseaudio files in the users home directory. <br>
Paths:</p>
<p style="margin-left:18%;">/root/.pulse(/.*)?,
/root/.config/pulse(/.*)?, /root/.esd_auth,
/root/.pulse-cookie, /home/[^/]+/.pulse(/.*)?,
/home/[^/]+/.config/pulse(/.*)?, /home/[^/]+/.esd_auth,
/home/[^/]+/.pulse-cookie</p>
<p style="margin-left:11%; margin-top: 1em"><b>pulseaudio_tmpfs_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the pulseaudio_tmpfs_t type, if you want to store
pulseaudio files on a tmpfs file system.</p>
<p style="margin-left:11%; margin-top: 1em"><b>pulseaudio_var_lib_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the pulseaudio_var_lib_t type, if you want to store the
pulseaudio files under the /var/lib directory.</p>
<p style="margin-left:11%; margin-top: 1em"><b>pulseaudio_var_run_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the pulseaudio_var_run_t type, if you want to store the
pulseaudio files under the /run or /var/run directory.</p>
<p style="margin-left:11%; margin-top: 1em">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 <b>semanage fcontext</b> command. This will
modify the SELinux labeling database. You will need to use
<b>restorecon</b> to apply the labels.</p>
<h2>COMMANDS
<a name="COMMANDS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
fcontext</b> can also be used to manipulate default file
context mappings.</p>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
permissive</b> can also be used to manipulate whether or not
a process type is permissive.</p>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
module</b> can also be used to enable/disable/install/remove
policy modules.</p>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
port</b> can also be used to manipulate the port
definitions</p>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
boolean</b> can also be used to manipulate the booleans</p>
<p style="margin-left:11%; margin-top: 1em"><b>system-config-selinux</b>
is a GUI tool available to customize SELinux policy
settings.</p>
<h2>AUTHOR
<a name="AUTHOR"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">This manual
page was auto-generated using <b>sepolicy manpage .</b></p>
<h2>SEE ALSO
<a name="SEE ALSO"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">selinux(8),
pulseaudio(8), semanage(8), restorecon(8), chcon(1),
sepolicy(8), setsebool(8)</p>
<hr>
</body>
</html>