doc/developer/packaging-debian.rst

   1 Packaging Debian
   2 ================
   3
   4 (Tested on Ubuntu 14.04, 16.04, 17.10, 18.04, Debian jessie, stretch and
   5 buster.)
   6
   7 1. Install build dependencies for your platform as outlined in :ref:`building`.
   8
   9 2. Install the general Debian package building tools:
  10
  11    .. code-block:: shell
  12
  13       apt-get install equivs fakeroot debhelper devscripts
  14
  15 3. Checkout FRR under a **unprivileged** user account:
  16
  17    .. code-block:: shell
  18
  19       git clone https://github.com/frrouting/frr.git frr
  20       cd frr
  21
  22    If you wish to build a package for a branch other than master:
  23
  24    .. code-block:: shell
  25
  26       git checkout <branch>
  27
  28 4. Build Debian package dependencies and install them as needed.
  29
  30    .. code-block:: shell
  31
  32       sudo mk-build-deps --install debian/control
  33
  34 5. Run ``tools/tarsource.sh -V``:
  35
  36    .. code-block:: shell
  37
  38       ./tools/tarsource.sh -V
  39
  40    This script sets up the `debian/changelog-auto` file with proper version
  41    information.  If you want to append a local build identifier, look at the
  42    `-e` option.
  43
  44 6. Build Debian Package
  45
  46    Building with standard options:
  47
  48    .. code-block:: shell
  49
  50       debuild -b -uc -us
  51
  52 7. Done!
  53
  54 If all worked correctly, then you should end up with the Debian packages in
  55 the parent directory.  If distributed, please make sure you distribute it
  56 together with the sources (``frr_*.orig.tar.gz``, ``frr_*.debian.tar.xz`` and
  57 ``frr_*.dsc``)