summaryrefslogtreecommitdiff
path: root/docs-xml/Samba3-Developers-Guide/packagers.xml
diff options
context:
space:
mode:
Diffstat (limited to 'docs-xml/Samba3-Developers-Guide/packagers.xml')
-rw-r--r--docs-xml/Samba3-Developers-Guide/packagers.xml51
1 files changed, 51 insertions, 0 deletions
diff --git a/docs-xml/Samba3-Developers-Guide/packagers.xml b/docs-xml/Samba3-Developers-Guide/packagers.xml
new file mode 100644
index 0000000000..8b8eccacc7
--- /dev/null
+++ b/docs-xml/Samba3-Developers-Guide/packagers.xml
@@ -0,0 +1,51 @@
+<?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 update the version number in <filename>source/include/version.h</filename> to include the
+versioning of your package. 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>
+Samba3 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 option <literal>--with-shared-modules</literal> is maintained to support specific modules such as
+idmap_XXX and vfs_XXX. For example, <literal>--with-shared-modules=idmap_ad</literal>. Use of this parameter
+to the <command>configure</command> command as not been supported in official releases.
+</para>
+
+<para>
+<programlisting>
+./configure --with-shared-modules=rpc,vfs,auth,pdb,charset
+</programlisting>
+</para>
+
+</sect1>
+
+
+</chapter>