xNightR00T File Manager

Binary packages and bug reporting
---------------------------------
Please check http://en.openSUSE.org/Samba for general information on Samba as
part of SUSE Linux Enterprise or openSUSE products, links to binary packages
of the most current Samba version, and a bug reporting how to.

Documented example configuration
--------------------------------
The installed sample configuration at /etc/samba/smb.conf is a stripped down
version of the full commented and with deactivates examples enriched file as
from /usr/share/doc/packages/samba/examples/smb.conf.VENDOR  While building
the package all comments are removed like running testparm on this file.

Samba packaging organisation
----------------------------
The packaging split Samba in several components.  This allows you to install
only the components you need.  The most common package is samba-client which
also includes the main configuration file /etc/samba/smb.conf.

As a result you can't install samba-winbind or the main Samba package, samba
without also installing samba-client.

Package name        Content
samba               smb and nmb daemon and utilities, SWAT
samba-client        smb.conf, client utilities
samba-doc           Documentation (noarch)
samba-python        Python bindings [*]
samba-winbind       Name Service Switch resolving names from NT servers

[*] Note: The samba-python package is left intentionally blank in SLE-15 as python2 is not supported in this release and samba-python is not yet fully functional in python3.

Printing
--------
To access printers, these samba packages use CUPS by default. If you want
to use a different printing subsystem, like LPRNG, set
"printing = LPRNG" and
"print name = /etc/printcap" in /etc/smb.conf.

Setup a particular environment for a Samba daemon
-------------------------------------------------
It's possible to pass extra environment settings to nmbd, smbd, and winbindd.
Therefore set SAMBA_NMBD_ENV, SAMBA_SMBD_ENV, or SAMBA_WINBINDD_ENV in
/etc/sysconfig/samba

For example SAMBA_WINBINDD_ENV="/usr/local/ldap:LDAPCONF=/usr/local/ldap/etc"
will only export LDAPCONF with the mentioned path if /usr/local/ldap exists.
It's possible to set a variable without a check by omitting the first path and
the colon.

umount.cifs permissions
-----------------------
By default umount.cifs isn't installed setuid root.  If you would like to
allow users a umount of CIFS filesystems please adjust the permissions via one
of the /etc/permissions* files.

usershares
----------
The usershare default directory /var/lib/samba/usershares is not packaged with
any Samba RPM.  The main reason is not to bother the users with changed
permissions after any package update.

To activate usershares you have to set 'usershare max shares' to something not
equal zero in smb.conf, create the directory, and set appropriate permissions.

In the following example any member of the group named 'users' will be able to
create usershares:

mkdir /var/lib/samba/usershares
chown root:users /var/lib/samba/usershares
chmod 1770 /var/lib/samba/usershares

/var/spool/samba no longer part of any Samba RPM package
--------------------------------------------------------
/var/spool/samba is no longer part of any Samba RPM package.  As the directory
never was shipped with the permissions required for a spool dir we had
recurrent complains about changed permissions after any update.  As the dir is
no longer in any package file list RPM will remove it while an update if it is
empty.  Therefore you have to recreate the dir by hand, set the appropriate
permissions one time and we'll never bother you with any changes.

You might even consider to use /var/tmp as the spool dir for Samba instead.

How to view the Samba package detailed changelog?
-------------------------------------------------
If the package is installed type: rpm -q --changelog samba | less
If not type: rpm -qp --changelog /path/to/the/samba*.rpm | less