docs-xml/Samba-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 Samba 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 configure option <literal>--with-shared-modules</literal> is provided to
  40 enable or disable specific modules such as idmap_XXX and vfs_XXX. For example,
  41 <literal>--with-shared-modules=idmap_ad</literal>. Disabled modules are
  42 prefixed with a '!'. E.g. <literal>--with-shared-modules='!idmap_ad'</literal>.
  43 </para>
  44
  45 <para>
  46 <programlisting>
  47 ./configure --with-shared-modules=rpc,vfs,auth,pdb,charset
  48 </programlisting>
  49 </para>
  50
  51 </sect1>
  52
  53
  54 </chapter>