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>