s3:doc: update the ldap_user_dn documentation in the idmap_ldap manpage
[samba.git] / docs-xml / Samba3-Developers-Guide / packagers.xml
1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <!DOCTYPE chapter PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
3 <chapter id="Packaging">
4 <chapterinfo>
5         <author>
6                 <firstname>Jelmer</firstname><surname>Vernooij</surname>
7         </author>
8 </chapterinfo>
9
10 <title>Notes to packagers</title>
11
12 <sect1>
13 <title>Versioning</title>
14
15 <para>
16 Please, please set the vendor version suffix and number in <filename>source/VERSION</filename> and call
17 <filename>source/script/mkvesion.sh</filename> to include the versioning of your package. There is also
18 the possibility to set a function to create the vendor version. This makes it easier to distinguish
19 standard samba builds from custom-build samba builds (distributions often patch packages). For example,
20 a good version would be:
21 </para>
22
23 <para><programlisting>
24 Version 2.999+3.0.alpha21-5 for Debian
25 </programlisting></para>
26
27 </sect1>
28
29 <sect1>
30 <title>Modules</title>
31
32 <para>
33 Samba3 has support for building parts of samba as plugins. This makes it possible to, for example,
34 put ldap or mysql support in a separate package, thus making it possible to have a normal samba package not
35 depending on ldap or mysql. To build as much parts of samba as a plugin, run:
36 </para>
37
38 <para>
39 The option <literal>--with-shared-modules</literal> is maintained to support specific modules such as
40 idmap_XXX and vfs_XXX. For example, <literal>--with-shared-modules=idmap_ad</literal>. Use of this parameter
41 to the <command>configure</command> command as not been supported in official releases.
42 </para>
43
44 <para>
45 <programlisting>
46 ./configure --with-shared-modules=rpc,vfs,auth,pdb,charset
47 </programlisting>
48 </para>
49
50 </sect1>
51
52
53 </chapter>