packaging/Debian/README

   1 Building Samba Packages for Debian GNU/Linux
   2 --------------------------------------------
   3
   4 Building Debian packages is not as hard as some people might think. The
   5 following instructions will allow you to build your own Samba Debian
   6 packages. These instructions, and the files in packaging/Debian/, are
   7 current as of Samba 2.2.5, and should allow you to build Debian packages
   8 for Debian Potato (2.2), Debian Woody (3.0), and Debian unstable as of
   9 the date Samba 2.2.5 was released.
  10
  11 Instructions
  12 ------------
  13
  14 If you want to build Samba packages for Debian and you just want to use
  15 upstream sources, i.e. you don't want to wait for us to put official
  16 packages out, or you want packages for a Debian version for which we
  17 don't provide deb's, or you don't want to use official packages, or
  18 you want to add --this-cool-switch to configure, or whatever, follow
  19 these instructions:
  20
  21 0) Make sure you have the following packages installed (in addition
  22 to the normal Debian development packages -- dpkg-dev, libc6-dev,
  23 devscripts, etc.):
  24
  25   debhelper
  26   libpam0g-dev
  27   libreadline4-dev
  28   libcupsys2-dev
  29   autoconf
  30
  31   Notes about the packages required to build Samba Debian packages:
  32
  33   * The libcupsys2-dev is not available in Debian Potato (Debian 2.2).
  34   That's fine; the configure script won't detect CUPS support and the
  35   resulting binaries won't support CUPS.
  36
  37 1) cd samba[-<version>]. For example, "cd samba-2.2.5".
  38 2) cp -a packaging/Debian/debian/ debian
  39   It's important that you copy instead of symlink because the build
  40   tools in Potato have a problem that prevents the build to work with
  41   a symlink.
  42 3) dch -i (this is completely optional - only do it if you understand
  43    Debian version numbers! Don't complain later if you can't upgrade
  44    to official versions of the Samba packages for Debian.)
  45   - Edit the changelog and make sure the version is right. For example,
  46   for Samba 2.2.4, the version number should something like 2.2.4-0.1
  47   (use a number less than 1 like 0.1, 0.2, etc. so there is no conflict
  48   with future upgrades to the official Debian packages.)
  49 4) Run 'debian/rules binary'.
  50   - It is better that you prefix the above command with 'fakeroot'.
  51     If you have problems you might try building as root.
  52 5) That's it. Your new packages should be in ../. Install with dpkg.
  53
  54 Please e-mail samba@packages.debian.org with comments, questions or
  55 suggestions. Please talk to us and not to the Samba Team. They have
  56 better things to do and know nothing about the Debian packaging system.
  57
  58 Eloy A. Paris <peloy@debian.org>
  59 Steve Langasek <vorlon@debian.org>
  60