summaryrefslogtreecommitdiffstats
path: root/docs-xml/Samba-Developers-Guide/packagers.xml
diff options
context:
space:
mode:
Diffstat (limited to 'docs-xml/Samba-Developers-Guide/packagers.xml')
-rw-r--r--docs-xml/Samba-Developers-Guide/packagers.xml54
1 files changed, 54 insertions, 0 deletions
diff --git a/docs-xml/Samba-Developers-Guide/packagers.xml b/docs-xml/Samba-Developers-Guide/packagers.xml
new file mode 100644
index 0000000..292b602
--- /dev/null
+++ b/docs-xml/Samba-Developers-Guide/packagers.xml
@@ -0,0 +1,54 @@
+<?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>