| Current File : //usr/share/selinux/devel/html/lvm.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>lvm_selinux</title>
</head>
<body>
<h1 align="center">lvm_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="#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">lvm_selinux
− Security Enhanced Linux Policy for the lvm
processes</p>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Security-Enhanced
Linux secures the lvm processes via flexible mandatory
access control.</p>
<p style="margin-left:11%; margin-top: 1em">The lvm
processes execute with the lvm_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 lvm_t</b></p>
<h2>ENTRYPOINTS
<a name="ENTRYPOINTS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The lvm_t
SELinux type can be entered via the <b>lvm_exec_t</b> file
type.</p>
<p style="margin-left:11%; margin-top: 1em">The default
entrypoint paths for the lvm_t domain are the following:</p>
<p style="margin-left:11%; margin-top: 1em">/lib/lvm-10/.*,
/lib/lvm-200/.*, /usr/lib/lvm-10/.*, /usr/lib/lvm-200/.*,
/usr/lib/systemd/system-generators/lvm2.*, /sbin/lvm,
/sbin/lvs, /sbin/pvs, /sbin/vgs, /sbin/vgck, /sbin/dmraid,
/sbin/kpartx, /sbin/lvmsar, /sbin/lvscan, /sbin/pvdata,
/sbin/pvmove, /sbin/pvscan, /sbin/vgscan, /sbin/dmsetup,
/sbin/e2fsadm, /sbin/lvmetad, /sbin/lvmsadc, /sbin/vgmerge,
/sbin/vgsplit, /usr/sbin/lvm, /usr/sbin/lvs, /usr/sbin/pvs,
/usr/sbin/vgs, /sbin/lvchange, /sbin/lvcreate,
/sbin/lvextend, /sbin/lvmpolld, /sbin/lvreduce,
/sbin/lvremove, /sbin/lvrename, /sbin/lvresize,
/sbin/pvchange, /sbin/pvcreate, /sbin/pvremove,
/sbin/vgchange, /sbin/vgcreate, /sbin/vgexport,
/sbin/vgextend, /sbin/vgimport, /sbin/vgreduce,
/sbin/vgremove, /sbin/vgrename, /usr/sbin/vgck,
/sbin/lvdisplay, /sbin/lvmchange, /sbin/pvdisplay,
/sbin/vgdisplay, /sbin/vgmknodes, /sbin/vgwrapper,
/sbin/cryptsetup, /sbin/lvm.static, /sbin/multipathd,
/usr/sbin/dmraid, /usr/sbin/kpartx, /usr/sbin/lvmsar,
/usr/sbin/lvscan, /usr/sbin/pvdata, /usr/sbin/pvmove,
/usr/sbin/pvscan, /usr/sbin/vgscan, /sbin/lvmdiskscan,
/sbin/mount.crypt, /sbin/vgcfgbackup, /usr/sbin/dmsetup,
/usr/sbin/e2fsadm, /usr/sbin/lvmetad, /usr/sbin/lvmsadc,
/usr/sbin/vgmerge, /usr/sbin/vgsplit, /sbin/umount.crypt,
/sbin/vgcfgrestore, /usr/sbin/dmeventd, /usr/sbin/lvchange,
/usr/sbin/lvcreate, /usr/sbin/lvextend, /usr/sbin/lvmdbusd,
/usr/sbin/lvmlockd, /usr/sbin/lvmpolld, /usr/sbin/lvreduce,
/usr/sbin/lvremove, /usr/sbin/lvrename, /usr/sbin/lvresize,
/usr/sbin/pvchange, /usr/sbin/pvcreate, /usr/sbin/pvremove,
/usr/sbin/vgchange, /usr/sbin/vgcreate, /usr/sbin/vgexport,
/usr/sbin/vgextend, /usr/sbin/vgimport, /usr/sbin/vgreduce,
/usr/sbin/vgremove, /usr/sbin/vgrename, /sbin/lvmiopversion,
/sbin/vgscan.static, /usr/sbin/lvdisplay,
/usr/sbin/lvmchange, /usr/sbin/pvdisplay,
/usr/sbin/vgdisplay, /usr/sbin/vgmknodes,
/usr/sbin/vgwrapper, /sbin/dmsetup.static,
/usr/sbin/cryptsetup, /usr/sbin/lvm.static,
/usr/sbin/lvmlockctl, /usr/sbin/multipathd,
/sbin/vgchange.static, /usr/sbin/lvmdiskscan,
/usr/sbin/mount.crypt, /usr/sbin/vgcfgbackup,
/sbin/multipath.static, /usr/sbin/vgcfgrestore,
/usr/sbin/lvmiopversion, /usr/sbin/vgscan.static,
/usr/sbin/dmsetup.static, /usr/sbin/vgchange.static,
/usr/lib/storaged/storaged, /usr/sbin/multipath.static,
/lib/udev/udisks-lvm-pv-export,
/usr/libexec/storaged/storaged,
/usr/lib/udev/udisks-lvm-pv-export,
/usr/lib/systemd/systemd-cryptsetup,
/usr/lib/storaged/storaged-lvm-helper</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 lvm
policy is very flexible allowing users to setup their lvm
processes in as secure a method as possible.</p>
<p style="margin-left:11%; margin-top: 1em">The following
process types are defined for lvm:</p>
<p style="margin-left:11%; margin-top: 1em"><b>lvm_t</b></p>
<p style="margin-left:11%; margin-top: 1em">Note:
<b>semanage permissive -a lvm_t</b> can be used to make the
process type lvm_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. lvm policy
is extremely flexible and has several booleans that allow
you to manipulate the policy and run lvm with the tightest
access possible.</p>
<p style="margin-left:11%; margin-top: 1em">If you want to
deny user domains applications to map a memory region as
both executable and writable, this is dangerous and the
executable should be reported in bugzilla, you must turn on
the deny_execmem boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
deny_execmem 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
control the ability to mmap a low area of the address space,
as configured by /proc/sys/vm/mmap_min_addr, you must turn
on the mmap_low_allowed boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
mmap_low_allowed 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
disable kernel module loading, you must turn on the
secure_mode_insmod boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
secure_mode_insmod 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow unconfined executables to make their heap memory
executable. Doing this is a really bad idea. Probably
indicates a badly coded executable, but could indicate an
attack. This executable should be reported in bugzilla, you
must turn on the selinuxuser_execheap boolean. Disabled by
default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
selinuxuser_execheap 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow unconfined executables to make their stack executable.
This should never, ever be necessary. Probably indicates a
badly coded executable, but could indicate an attack. This
executable should be reported in bugzilla, you must turn on
the selinuxuser_execstack boolean. Enabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
selinuxuser_execstack 1</b></p>
<h2>MANAGED FILES
<a name="MANAGED FILES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The SELinux
process type lvm_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>file_type</b></p>
<p style="margin-left:11%; margin-top: 1em">all files on
the system</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
lvm policy is very flexible allowing users to setup their
lvm processes in as secure a method as possible.</p>
<p style="margin-left:11%; margin-top: 1em"><b>EQUIVALENCE
DIRECTORIES</b></p>
<p style="margin-left:11%; margin-top: 1em">lvm policy
stores data with multiple different file context types under
the /var/run/multipathd directory. If you would like to
store the data in a different directory you can use the
semanage command to create an equivalence mapping. If you
wanted to store this data under the /srv directory you would
execute the following command:</p>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
fcontext -a -e /var/run/multipathd /srv/multipathd <br>
restorecon -R -v /srv/multipathd</b></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 lvm, 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 lvm_unit_file_t
’/srv/mylvm_content(/.*)?’ <br>
restorecon -R -v /srv/mylvm_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 lvm:</i></p>
<p style="margin-left:11%; margin-top: 1em"><b>lvm_etc_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the lvm_etc_t type, if you want to store lvm files in
the /etc directories.</p>
<p style="margin-left:11%; margin-top: 1em"><b>lvm_exec_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the lvm_exec_t type, if you want to transition an
executable to the lvm_t domain. <br>
Paths:</p>
<p style="margin-left:18%;">/lib/lvm-10/.*,
/lib/lvm-200/.*, /usr/lib/lvm-10/.*, /usr/lib/lvm-200/.*,
/usr/lib/systemd/system-generators/lvm2.*, /sbin/lvm,
/sbin/lvs, /sbin/pvs, /sbin/vgs, /sbin/vgck, /sbin/dmraid,
/sbin/kpartx, /sbin/lvmsar, /sbin/lvscan, /sbin/pvdata,
/sbin/pvmove, /sbin/pvscan, /sbin/vgscan, /sbin/dmsetup,
/sbin/e2fsadm, /sbin/lvmetad, /sbin/lvmsadc, /sbin/vgmerge,
/sbin/vgsplit, /usr/sbin/lvm, /usr/sbin/lvs, /usr/sbin/pvs,
/usr/sbin/vgs, /sbin/lvchange, /sbin/lvcreate,
/sbin/lvextend, /sbin/lvmpolld, /sbin/lvreduce,
/sbin/lvremove, /sbin/lvrename, /sbin/lvresize,
/sbin/pvchange, /sbin/pvcreate, /sbin/pvremove,
/sbin/vgchange, /sbin/vgcreate, /sbin/vgexport,
/sbin/vgextend, /sbin/vgimport, /sbin/vgreduce,
/sbin/vgremove, /sbin/vgrename, /usr/sbin/vgck,
/sbin/lvdisplay, /sbin/lvmchange, /sbin/pvdisplay,
/sbin/vgdisplay, /sbin/vgmknodes, /sbin/vgwrapper,
/sbin/cryptsetup, /sbin/lvm.static, /sbin/multipathd,
/usr/sbin/dmraid, /usr/sbin/kpartx, /usr/sbin/lvmsar,
/usr/sbin/lvscan, /usr/sbin/pvdata, /usr/sbin/pvmove,
/usr/sbin/pvscan, /usr/sbin/vgscan, /sbin/lvmdiskscan,
/sbin/mount.crypt, /sbin/vgcfgbackup, /usr/sbin/dmsetup,
/usr/sbin/e2fsadm, /usr/sbin/lvmetad, /usr/sbin/lvmsadc,
/usr/sbin/vgmerge, /usr/sbin/vgsplit, /sbin/umount.crypt,
/sbin/vgcfgrestore, /usr/sbin/dmeventd, /usr/sbin/lvchange,
/usr/sbin/lvcreate, /usr/sbin/lvextend, /usr/sbin/lvmdbusd,
/usr/sbin/lvmlockd, /usr/sbin/lvmpolld, /usr/sbin/lvreduce,
/usr/sbin/lvremove, /usr/sbin/lvrename, /usr/sbin/lvresize,
/usr/sbin/pvchange, /usr/sbin/pvcreate, /usr/sbin/pvremove,
/usr/sbin/vgchange, /usr/sbin/vgcreate, /usr/sbin/vgexport,
/usr/sbin/vgextend, /usr/sbin/vgimport, /usr/sbin/vgreduce,
/usr/sbin/vgremove, /usr/sbin/vgrename, /sbin/lvmiopversion,
/sbin/vgscan.static, /usr/sbin/lvdisplay,
/usr/sbin/lvmchange, /usr/sbin/pvdisplay,
/usr/sbin/vgdisplay, /usr/sbin/vgmknodes,
/usr/sbin/vgwrapper, /sbin/dmsetup.static,
/usr/sbin/cryptsetup, /usr/sbin/lvm.static,
/usr/sbin/lvmlockctl, /usr/sbin/multipathd,
/sbin/vgchange.static, /usr/sbin/lvmdiskscan,
/usr/sbin/mount.crypt, /usr/sbin/vgcfgbackup,
/sbin/multipath.static, /usr/sbin/vgcfgrestore,
/usr/sbin/lvmiopversion, /usr/sbin/vgscan.static,
/usr/sbin/dmsetup.static, /usr/sbin/vgchange.static,
/usr/lib/storaged/storaged, /usr/sbin/multipath.static,
/lib/udev/udisks-lvm-pv-export,
/usr/libexec/storaged/storaged,
/usr/lib/udev/udisks-lvm-pv-export,
/usr/lib/systemd/systemd-cryptsetup,
/usr/lib/storaged/storaged-lvm-helper</p>
<p style="margin-left:11%; margin-top: 1em"><b>lvm_lock_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the lvm_lock_t type, if you want to treat the files as
lvm lock data, stored under the /var/lock directory <br>
Paths:</p>
<p style="margin-left:18%;">/etc/lvm/lock(/.*)?,
/var/lock/lvm(/.*)?, /var/lock/dmraid(/.*)?</p>
<p style="margin-left:11%; margin-top: 1em"><b>lvm_metadata_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the lvm_metadata_t type, if you want to treat the files
as lvm metadata data. <br>
Paths:</p>
<p style="margin-left:18%;">/etc/lvmtab(/.*)?,
/etc/lvmtab.d(/.*)?, /etc/lvm/cache(/.*)?,
/etc/multipath(/.*)?, /etc/lvm/backup(/.*)?,
/etc/lvm/archive(/.*)?, /var/cache/multipathd(/.*)?,
/etc/lvm/.cache</p>
<p style="margin-left:11%; margin-top: 1em"><b>lvm_tmp_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the lvm_tmp_t type, if you want to store lvm temporary
files in the /tmp directories.</p>
<p style="margin-left:11%; margin-top: 1em"><b>lvm_unit_file_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the lvm_unit_file_t type, if you want to treat the
files as lvm unit content. <br>
Paths:</p>
<p style="margin-left:18%;">/usr/lib/systemd/system/lvm2.*.service,
/usr/lib/systemd/generator/lvm.*</p>
<p style="margin-left:11%; margin-top: 1em"><b>lvm_var_lib_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the lvm_var_lib_t type, if you want to store the lvm
files under the /var/lib directory.</p>
<p style="margin-left:11%; margin-top: 1em"><b>lvm_var_run_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the lvm_var_run_t type, if you want to store the lvm
files under the /run or /var/run directory. <br>
Paths:</p>
<p style="margin-left:18%;">/var/run/lvm(/.*)?,
/var/run/dmevent.*, /var/run/storaged(/.*)?,
/var/run/cryptsetup(/.*)?, /var/run/multipathd(/.*)?,
/var/run/multipathd.sock</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
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),
lvm(8), semanage(8), restorecon(8), chcon(1), sepolicy(8),
setsebool(8)</p>
<hr>
</body>
</html>