| Current File : //proc/self/root/kunden/usr/share/selinux/devel/html/smbd.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>smbd_selinux</title>
</head>
<body>
<h1 align="center">smbd_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="#SHARING FILES">SHARING FILES</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">smbd_selinux
− Security Enhanced Linux Policy for the smbd
processes</p>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Security-Enhanced
Linux secures the smbd processes via flexible mandatory
access control.</p>
<p style="margin-left:11%; margin-top: 1em">The smbd
processes execute with the smbd_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 smbd_t</b></p>
<h2>ENTRYPOINTS
<a name="ENTRYPOINTS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The smbd_t
SELinux type can be entered via the <b>smbd_exec_t</b> file
type.</p>
<p style="margin-left:11%; margin-top: 1em">The default
entrypoint paths for the smbd_t domain are the
following:</p>
<p style="margin-left:11%; margin-top: 1em">/usr/sbin/smbd</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 smbd
policy is very flexible allowing users to setup their smbd
processes in as secure a method as possible.</p>
<p style="margin-left:11%; margin-top: 1em">The following
process types are defined for smbd:</p>
<p style="margin-left:11%; margin-top: 1em"><b>smbd_t</b></p>
<p style="margin-left:11%; margin-top: 1em">Note:
<b>semanage permissive -a smbd_t</b> can be used to make the
process type smbd_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. smbd policy
is extremely flexible and has several booleans that allow
you to manipulate the policy and run smbd with the tightest
access possible.</p>
<p style="margin-left:11%; margin-top: 1em">If you want to
dontaudit all daemons scheduling requests (setsched,
sys_nice), you must turn on the daemons_dontaudit_scheduling
boolean. Enabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
daemons_dontaudit_scheduling 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 confined applications to run with kerberos, you must
turn on the kerberos_enabled boolean. Enabled by
default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
kerberos_enabled 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 samba to create new home directories (e.g. via PAM),
you must turn on the samba_create_home_dirs boolean.
Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
samba_create_home_dirs 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow samba to act as the domain controller, add users,
groups and change passwords, you must turn on the
samba_domain_controller boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
samba_domain_controller 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow samba and winbind-rpcd to share users home
directories, you must turn on the samba_enable_home_dirs
boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
samba_enable_home_dirs 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow samba to share any file/directory read only, you must
turn on the samba_export_all_ro boolean. Disabled by
default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
samba_export_all_ro 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow samba to share any file/directory read/write, you must
turn on the samba_export_all_rw boolean. Disabled by
default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
samba_export_all_rw 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow smbd to load libgfapi from gluster, you must turn on
the samba_load_libgfapi boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
samba_load_libgfapi 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow samba to act as a portmapper, you must turn on the
samba_portmapper boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
samba_portmapper 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow samba to run unconfined scripts, you must turn on the
samba_run_unconfined boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
samba_run_unconfined 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow samba to export ntfs/fusefs volumes, you must turn on
the samba_share_fusefs boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
samba_share_fusefs 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow samba to export NFS volumes, you must turn on the
samba_share_nfs boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
samba_share_nfs 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
smbd policy is very flexible allowing users to setup their
smbd processes in as secure a method as possible.</p>
<p style="margin-left:11%; margin-top: 1em">The following
port types are defined for smbd: <b><br>
smbd_port_t</b></p>
<p style="margin-left:11%; margin-top: 1em">Default Defined
Ports:</p>
<p style="margin-left:26%;">tcp 445,137-139</p>
<h2>MANAGED FILES
<a name="MANAGED FILES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The SELinux
process type smbd_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>auth_cache_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/var/cache/coolkey(/.*)?</p>
<p style="margin-left:11%; margin-top: 1em"><b>cluster_conf_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/etc/cluster(/.*)?</p>
<p style="margin-left:11%; margin-top: 1em"><b>cluster_var_lib_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/var/lib/pcsd(/.*)?
<br>
/var/lib/cluster(/.*)? <br>
/var/lib/openais(/.*)? <br>
/var/lib/pengine(/.*)? <br>
/var/lib/corosync(/.*)? <br>
/usr/lib/heartbeat(/.*)? <br>
/var/lib/heartbeat(/.*)? <br>
/var/lib/pacemaker(/.*)?</p>
<p style="margin-left:11%; margin-top: 1em"><b>cluster_var_run_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/var/run/crm(/.*)?
<br>
/var/run/cman_.* <br>
/var/run/rsctmp(/.*)? <br>
/var/run/aisexec.* <br>
/var/run/heartbeat(/.*)? <br>
/var/run/pcsd-ruby.socket <br>
/var/run/corosync-qnetd(/.*)? <br>
/var/run/corosync-qdevice(/.*)? <br>
/var/run/pcsd.socket <br>
/var/run/corosync.pid <br>
/var/run/cpglockd.pid <br>
/var/run/rgmanager.pid <br>
/var/run/cluster/rgmanager.sk</p>
<p style="margin-left:11%; margin-top: 1em"><b>ctdbd_var_lib_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/var/lib/ctdb(/.*)?
<br>
/var/lib/ctdbd(/.*)?</p>
<p style="margin-left:11%; margin-top: 1em"><b>faillog_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/var/log/btmp.*
<br>
/var/log/faillog.* <br>
/var/log/tallylog.* <br>
/var/run/faillock(/.*)?</p>
<p style="margin-left:11%; margin-top: 1em"><b>fusefs_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/var/run/user/[0-9]+/gvfs</p>
<p style="margin-left:11%; margin-top: 1em"><b>httpd_user_content_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/home/[^/]+/((www)|(web)|(public_html))(/.+)?</p>
<p style="margin-left:11%; margin-top: 1em"><b>initrc_var_run_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/var/run/utmp
<br>
/var/run/random-seed <br>
/var/run/runlevel.dir <br>
/var/run/setmixer_flag</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>nfs_t</b></p>
<p style="margin-left:11%; margin-top: 1em"><b>nmbd_var_run_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/var/run/nmbd(/.*)?
<br>
/var/run/samba/nmbd(/.*)? <br>
/var/run/samba/nmbd.pid <br>
/var/run/samba/messages.tdb <br>
/var/run/samba/namelist.debug <br>
/var/run/samba/unexpected.tdb</p>
<p style="margin-left:11%; margin-top: 1em"><b>non_security_file_type</b></p>
<p style="margin-left:11%; margin-top: 1em"><b>noxattrfs</b></p>
<p style="margin-left:11%; margin-top: 1em">all files on
file systems which do not support extended attributes</p>
<p style="margin-left:11%; margin-top: 1em"><b>root_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/sysroot/ostree/deploy/.*-atomic/deploy(/.*)?
<br>
/ <br>
/initrd</p>
<p style="margin-left:11%; margin-top: 1em"><b>samba_log_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/var/log/samba(/.*)?</p>
<p style="margin-left:11%; margin-top: 1em"><b>samba_secrets_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/etc/samba/smbpasswd
<br>
/etc/samba/passdb.tdb <br>
/etc/samba/MACHINE.SID <br>
/etc/samba/secrets.tdb</p>
<p style="margin-left:11%; margin-top: 1em"><b>samba_share_t</b></p>
<p style="margin-left:11%; margin-top: 1em">use this label
for random content that will be shared using samba</p>
<p style="margin-left:11%; margin-top: 1em"><b>samba_spool_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/var/spool/samba(/.*)?</p>
<p style="margin-left:11%; margin-top: 1em"><b>security_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/selinux</p>
<p style="margin-left:11%; margin-top: 1em"><b>smbd_tmp_t</b></p>
<p style="margin-left:11%; margin-top: 1em"><b>smbd_tmpfs_t</b></p>
<p style="margin-left:11%; margin-top: 1em"><b>smbd_var_run_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/var/run/samba(/.*)?
<br>
/var/run/samba/smbd.pid <br>
/var/run/samba/brlock.tdb <br>
/var/run/samba/locking.tdb <br>
/var/run/samba/gencache.tdb <br>
/var/run/samba/sessionid.tdb <br>
/var/run/samba/share_info.tdb <br>
/var/run/samba/connections.tdb</p>
<p style="margin-left:11%; margin-top: 1em"><b>user_home_type</b></p>
<p style="margin-left:11%; margin-top: 1em">all user home
files</p>
<p style="margin-left:11%; margin-top: 1em"><b>wtmp_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/var/log/wtmp.*</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
smbd policy is very flexible allowing users to setup their
smbd 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">smbd policy
stores data with multiple different file context types under
the /var/run/samba 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/samba /srv/samba <br>
restorecon -R -v /srv/samba</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 smbd, 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 smbd_var_run_t
’/srv/mysmbd_content(/.*)?’ <br>
restorecon -R -v /srv/mysmbd_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 smbd:</i></p>
<p style="margin-left:11%; margin-top: 1em"><b>smbd_exec_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the smbd_exec_t type, if you want to transition an
executable to the smbd_t domain.</p>
<p style="margin-left:11%; margin-top: 1em"><b>smbd_keytab_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the smbd_keytab_t type, if you want to treat the files
as kerberos keytab files.</p>
<p style="margin-left:11%; margin-top: 1em"><b>smbd_tmp_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the smbd_tmp_t type, if you want to store smbd
temporary files in the /tmp directories.</p>
<p style="margin-left:11%; margin-top: 1em"><b>smbd_tmpfs_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the smbd_tmpfs_t type, if you want to store smbd files
on a tmpfs file system.</p>
<p style="margin-left:11%; margin-top: 1em"><b>smbd_var_run_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the smbd_var_run_t type, if you want to store the smbd
files under the /run or /var/run directory. <br>
Paths:</p>
<p style="margin-left:18%;">/var/run/samba(/.*)?,
/var/run/samba/smbd.pid, /var/run/samba/brlock.tdb,
/var/run/samba/locking.tdb, /var/run/samba/gencache.tdb,
/var/run/samba/sessionid.tdb, /var/run/samba/share_info.tdb,
/var/run/samba/connections.tdb</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>SHARING FILES
<a name="SHARING FILES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">If you want to
share files with multiple domains (Apache, FTP, rsync,
Samba), you can set a file context of public_content_t and
public_content_rw_t. These context allow any of the above
domains to read the content. If you want a particular domain
to write to the public_content_rw_t domain, you must set the
appropriate boolean. <br>
Allow smbd servers to read the /var/smbd directory by adding
the <br>
public_content_t file type to the directory and by restoring
the file <br>
type.</p>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
fcontext -a -t public_content_t "/var/smbd(/.*)?"
<br>
restorecon -F -R -v /var/smbd</b> <br>
Allow smbd servers to read and write /var/smbd/incoming by
adding the <br>
public_content_rw_t type to the directory and by restoring
the file <br>
type. You also need to turn on the smbd_anon_write
boolean.</p>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
fcontext -a -t public_content_rw_t
"/var/smbd/incoming(/.*)?" <br>
restorecon -F -R -v /var/smbd/incoming <br>
setsebool -P smbd_anon_write 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow samba to modify public files used for public file
transfer services. Files/Directories must be labeled
public_content_rw_t., you must turn on the smbd_anon_write
boolean.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
smbd_anon_write 1</b></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),
smbd(8), semanage(8), restorecon(8), chcon(1), sepolicy(8),
setsebool(8)</p>
<hr>
</body>
</html>