1
0
mirror of https://github.com/samba-team/samba.git synced 2024-12-25 23:21:54 +03:00
samba-mirror/docs-xml/Samba-Developers-Guide/packagers.xml
David Disseldorp 710196f0cc doc: improve --with-shared-modules documentation
Remove statement about lack of support. Add description and example for
how to explicitly disable modules via a '!' prefix.

Signed-off-by: David Disseldorp <ddiss@samba.org>
Reviewed-by: Jeremy Allison <jra@samba.org>

Autobuild-User(master): Jeremy Allison <jra@samba.org>
Autobuild-Date(master): Fri Nov  6 20:19:22 UTC 2020 on sn-devel-184
2020-11-06 20:19:22 +00:00

55 lines
1.7 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE chapter PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
<chapter id="Packaging">
<chapterinfo>
<author>
<firstname>Jelmer</firstname><surname>Vernooij</surname>
</author>
</chapterinfo>
<title>Notes to packagers</title>
<sect1>
<title>Versioning</title>
<para>
Please, please set the vendor version suffix and number in <filename>source/VERSION</filename> and call
<filename>source/script/mkvesion.sh</filename> to include the versioning of your package. There is also
the possibility to set a function to create the vendor version. This makes it easier to distinguish
standard samba builds from custom-build samba builds (distributions often patch packages). For example,
a good version would be:
</para>
<para><programlisting>
Version 2.999+3.0.alpha21-5 for Debian
</programlisting></para>
</sect1>
<sect1>
<title>Modules</title>
<para>
Samba has support for building parts of samba as plugins. This makes it possible to, for example,
put ldap or mysql support in a separate package, thus making it possible to have a normal samba package not
depending on ldap or mysql. To build as much parts of samba as a plugin, run:
</para>
<para>
The configure option <literal>--with-shared-modules</literal> is provided to
enable or disable specific modules such as idmap_XXX and vfs_XXX. For example,
<literal>--with-shared-modules=idmap_ad</literal>. Disabled modules are
prefixed with a '!'. E.g. <literal>--with-shared-modules='!idmap_ad'</literal>.
</para>
<para>
<programlisting>
./configure --with-shared-modules=rpc,vfs,auth,pdb,charset
</programlisting>
</para>
</sect1>
</chapter>