summaryrefslogtreecommitdiffstats
path: root/docs-xml/Samba-Developers-Guide/packagers.xml
blob: 292b602810ac3d642c93dc5576f7be0fa47fa19f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
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>