git:master:5c621a9d: pkg/kamailio: updated to the docs about building the packages - sr-dev

12 Dec 2017

Module: kamailio
Branch: master
Commit: 5c621a9d483830e1dd6f9bafd4a525f3f83fa3c0
URL: https://github.com/kamailio/kamailio/commit/5c621a9d483830e1dd6f9bafd4a525f3...
Author: Daniel-Constantin Mierla miconda@gmail.com
Committer: Daniel-Constantin Mierla miconda@gmail.com
Date: 2017-12-12T09:09:56+01:00
pkg/kamailio: updated to the docs about building the packages
---
Modified: pkg/kamailio/Makefile
Modified: pkg/kamailio/README.md
---
Diff:  https://github.com/kamailio/kamailio/commit/5c621a9d483830e1dd6f9bafd4a525f3...
Patch: https://github.com/kamailio/kamailio/commit/5c621a9d483830e1dd6f9bafd4a525f3...
---

diff --git a/pkg/kamailio/Makefile b/pkg/kamailio/Makefile
index a72ca12ed8..766c52409d 100644
--- a/pkg/kamailio/Makefile
+++ b/pkg/kamailio/Makefile
@@ -1,14 +1,18 @@
+# Makefile to help building packages
+
 include ../../src/Makefile.defs
RPMBUILD_TOP := /tmp/rpmbuild
 DIST_ARCHIVE = ${shell echo "kamailio-$(RELEASE)_src.tar.gz" | sed -e "s/-dev[0-9]//" }
 RPMBUILD_OPT= --define "_topdir $(RPMBUILD_TOP)"
+# generate the tarball with source tree
 .PHONY: tar
 tar:
    rm -f ../../kamailio*_src.tar.gz
    $(MAKE) -C ../.. tar
+# build source rpm package
 .PHONY: src.rpm
 src.rpm: tar
    mkdir -p ${RPMBUILD_TOP}/SOURCES
@@ -18,10 +22,12 @@ src.rpm: tar
    mv ${RPMBUILD_TOP}/SRPMS/kamailio-$(RELEASE).*.src.rpm ../..
    rm -Rf ${RPMBUILD_TOP}
+# build rpm packages
 .PHONY: rpm
 rpm: src.rpm
    mock ../../kamailio-$(RELEASE).*.src.rpm
+# build debian packages
 .PHONY: deb
 deb:
    $(MAKE) -C ../.. deb
diff --git a/pkg/kamailio/README.md b/pkg/kamailio/README.md
index 9faf9c38aa..acf1b93c17 100644
--- a/pkg/kamailio/README.md
+++ b/pkg/kamailio/README.md
@@ -1,12 +1,77 @@
-This directory contains packaging script for several operation systems
+# Kamailio Packaging #
+
+The `pkg/kamailio/` directory contains packaging specs for several operation systems.
+
+Currently the DEB and RPM specs are actively maintained, the rest are still kept
+in case someone wants to pick up and update.
+
+## DEBS ##
+
+DEB packages can be generated for several flavours of Debian and Ubuntu
+operating systems.
+
+To generate deb packages, run:
+
+```
+make deb
+```
+
+This is using a generic Debian spec. To select a specific Debian or Ubuntu, go
+to root folder of Kamailio source tree, create a `debian` symlink to the
+desired distro from `pkg/kamailio/deb/` and run `make deb`. For example,
+on a Debian Stretch (9.x), do:
+
+```
+ln -s pkg/kamailio/deb/stretch debian
+make deb
+```
+
+The DEB files are generated in the parent folder.
+
+## RPMS ##
+
+There are couple of variants of RPM specs. The most actual one is stored in `obs/`
+subfolder and has conditional options to build for many operating systems that
+use RPM for packages (e.g., CenOS, RedHat, Fedora, OpenSuse). The folders with
+the name reflecting an operating system might be older, some not really
+maintained.
+
+To build RPM packages for CentOS, RHEL, Fedora, OpenSUSE and Oracle linux execute
+
+```
+make rpm
+```
+
+When utility is finished, you can see tge directory where compiled RPM files
+are located.
-To build RPM packages for CentOS, RHEL, Fedora, OpenSUSE and Oracle linux execure `make rpm`
-When utility is finished, you can see dricetory where compiled RPM files located.
 Example:
+
 ```
 Finish: rpmbuild kamailio-5.2.0-dev1.0.fc25.src.rpm
 Finish: build phase for kamailio-5.2.0-dev1.0.fc25.src.rpm
 INFO: Done(../../kamailio-5.2.0-dev1.0.fc25.src.rpm) Config(default) 8 minutes 30 seconds
 INFO: Results and/or logs in: /var/lib/mock/fedora-25-x86_64/result
 Finish: run
-```
\ No newline at end of file
+```
+
+The `obs` folder aims at using it also in OpenSuse Build Service.
+
+  * https://build.opensuse.org
+
+Kamailio build project on OBS is at:
+
+  * https://build.opensuse.org/project/show/home:kamailio
+
+## Gentoo ##
+
+Not actively mentained, still fairly recent updated.
+
+## BSD ##
+
+There are specs for FreeBSD, NetBST and OpenBSD. They are not actively
+maintained, being quite old.
+
+## Solaris ##
+
+Not actively maintained, being quite old.
\ No newline at end of file

    