enhance(ci): Add ability to generate RPM package
The CMake configuration was enhanced to add the ability to
generate an RPM package in addition to a Debian package
provided the rpmbuild command is available in the current
environment. The packages generated are now added to
the /tmp/build_output.yml file as fully qualified paths.
By default, the geneated package is a run-time package which
includes only the rmr libraries (no header files, and no
external libraries used to build RMr). If the cmake
option -DDEV_PKG=1 is given at configure time, a dev package
will be generated which includes the header files, and
will have -dev added following the version info in the
package name (e.g. rmr-1.0.34.x86_64-dev.deb).
Signed-off-by: E. Scott Daniels <daniels@research.att.com>
Change-Id: Ifb606e1f8b1ad0f08b3c4bd8b4012c0382947e04
Signed-off-by: E. Scott Daniels <daniels@research.att.com>
diff --git a/BUILD b/BUILD
index adae2f1..3bc677e 100644
--- a/BUILD
+++ b/BUILD
@@ -1,6 +1,6 @@
#
#==================================================================================
-# Copyright (c) 2019 Nokia
+# Copyright (c) 2019 Nokia
# Copyright (c) 2018-2019 AT&T Intellectual Property.
#
# Licensed under the Apache License, Version 2.0 (the "License");
@@ -43,10 +43,19 @@
This will create a .deb (provided the system supports this) in
the build directory. It's that simple.
-Continuous integration build
+Continuous integration build
Use the Dockerfile in the ci/ subdirectory. This installs all
the required tools and creates an image in the local registry.
+To support the distribution of package(s) created during the
+build by the CI process, the fully qualified path of each generated
+package will be placed into a well known YAML file:
+/tmp/build_output.yml. This file is created during CMake
+configuration and lists the package name(s) for packages which
+can be generated given the current environment. Currently
+Debian (.deb), and RPM packages are supported (the Ubuntu
+alien package must be installed in order to generate RPMs).
+
Alternatives
To build in a non-Linux environment, or to build with an
@@ -70,7 +79,7 @@
the build process and generally is not available on most systems.
-Compiling and Linking
+Compiling and Linking User Applications
Should the Rmr and NNG/Nano libraries be installed in a directory
outside of the normal system spots (e.g. not in /usr/local)
it might be necessary to define the specific directory for
@@ -118,3 +127,5 @@
and troff format. The troff pages are placed into the deb and
the postscript pages are left in the build directory for the
developer to convert to PDF, or otherwise use.
+
+