update Debian packaging scripts

This commit extends and reorganizes the Debian packaging script
according to suggestions made by Ruben Undheim <ruben.undheim@gmail.com>.

debian/control

@@ -13,23 +13,91 @@ Build-Depends:
     libconfig++-dev,
     libsctp-dev,
     libuhd-dev,
-    uhd-host
+    uhd-host,
-Standards-Version: 4.1.1
+    txt2man
+Standards-Version: 4.2.1
 Homepage: http://www.softwareradiosystems.com
 Vcs-Git: https://github.com/srsLTE/srsLTE.git
 Vcs-Browser: https://github.com/srsLTE/srsLTE/
 
+Package: srslte-dev
+Architecture: any
+Multi-Arch: same
+Section: libdevel
+Depends: ${shlibs:Depends},
+         ${misc:Depends},
+         srslte-core:any (= ${binary:Version})
+Breaks: srslte (<= 18.09-0ubuntu1)
+Replaces: srslte (<= 18.09-0ubuntu1)
+Description: Static libraries and headers for srslte
+ This software allows you to run a full end-to-end, open-source LTE system.
+ It contains a UE, eNB and EPC implementation.
+ .
+ This package contains the development files - static libraries and headers
+
 Package: srslte
+Architecture: all
+Depends: ${shlibs:Depends},
+         ${misc:Depends},
+         srsenb       (>= ${source:Version}), srsenb (<< ${source:Upstream-Version}.0~),
+         srsue        (>= ${source:Version}), srsue  (<< ${source:Upstream-Version}.0~),
+         srsepc       (>= ${source:Version}), srsepc (<< ${source:Upstream-Version}.0~)
+Description: LTE software suite for software defined radios (metapackage)
+ This software allows you to run a full end-to-end, open-source LTE system.
+ It contains a UE, eNB and EPC implementation.
+ .
+ This package installs all srsLTE components.
+
+Package: srsenb
 Architecture: any
-Depends:
+Depends: ${shlibs:Depends},
-    libfftw3-3,
+         ${misc:Depends},
-    libboost-program-options1.55.0 | libboost-program-options1.62.0,
+         srslte-core (= ${binary:Version})
-    libmbedcrypto0 | libmbedcrypto1,
+Breaks: srslte (<= 18.09-0ubuntu1)
-    libconfig++9v5,
+Replaces: srslte (<= 18.09-0ubuntu1)
-    libsctp1,
+Description: Complete SDR LTE eNodeB application
-    uhd-host,
-    libuhd003 | libuhd003.010.003,
-    ${misc:Depends}
-Description: This is srsLTE, a free and open-source LTE software suite.
  This software allows you to run a full end-to-end, open-source LTE system.
  It contains a UE, eNB and EPC implementation.
+ .
+ This package contains srsENB only. For running a full network, a core network
+ component, such as srsEPC, is needed.
+
+Package: srsepc
+Architecture: any
+Depends: ${shlibs:Depends},
+         ${misc:Depends},
+         srslte-core (= ${binary:Version})
+Recommends: srsenb
+Breaks: srslte (<= 18.09-0ubuntu1)
+Replaces: srslte (<= 18.09-0ubuntu1)
+Description: Light-weight LTE core network implementation
+ This software allows you to run a full end-to-end, open-source LTE system.
+ It contains a UE, eNB and EPC implementation.
+ .
+ This package contains a light-weight LTE core network implementation with MME, HSS and S/P-GW.
+
+Package: srslte-core
+Architecture: any
+Multi-Arch: allowed
+Depends: ${shlibs:Depends},
+         ${misc:Depends}
+Breaks: srslte (<= 18.09-0ubuntu1)
+Replaces: srslte (<= 18.09-0ubuntu1)
+Description: Common files for srsLTE
+ This software allows you to run a full end-to-end, open-source LTE system.
+ It contains a UE, eNB and EPC implementation.
+ .
+ This package contains the common files for srsenb, srsue and srsepc.
+
+Package: srsue
+Architecture: any
+Depends: ${shlibs:Depends},
+         ${misc:Depends},
+         srslte-core (= ${binary:Version})
+Breaks: srslte (<= 18.09-0ubuntu1)
+Replaces: srslte (<= 18.09-0ubuntu1)
+Description: User Equipment implementation for LTE
+ This software enables using a software defined radio as the user equipment
+ connecting to an LTE network.
+ .
+ srsUE provides a complete SDR LTE UE application featuring all layers from PHY to IP.

debian/man/genmanpages.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+
+txt2man -d "${CHANGELOG_DATE}" -t SRSENB -s 8 srsenb.txt > srsenb.8
+txt2man -d "${CHANGELOG_DATE}" -t SRSEPC -s 8 srsepc.txt > srsepc.8
+txt2man -d "${CHANGELOG_DATE}" -t SRSUE  -s 8 srsue.txt > srsue.8

debian/man/srsenb.txt

@@ -0,0 +1,26 @@
+NAME
+  srsENB - A complete SDR LTE eNodeB application
+
+SYNOPSIS
+  srsenb [options] <config_file>
+
+DESCRIPTION
+
+  srsENB provides the Evolved Node B (eNodeB or eNB) part in the LTE network.
+
+  Features:
+
+    - Round Robin MAC scheduler with FAPI-like C++ API
+    - SR support
+    - Periodic and Aperiodic CQI feedback support
+    - Standard S1AP and GTP-U interfaces to the Core Network
+    - 150 Mbps DL in 20 MHz MIMO TM3/TM4 with commercial UEs
+    - 75 Mbps DL in SISO configuration with commercial UEs
+    - 50 Mbps UL in 20 MHz with commercial UEs
+
+  An example configuration file is available in /usr/share/srslte/enb.conf.example
+
+OPTIONS
+
+  -h/--help       Produce help message
+  -v/--version    Print version information and exit

debian/man/srsepc.txt

@@ -0,0 +1,21 @@
+NAME
+  srsEPC - A light-weight LTE core network implementation with MME, HSS and S/P-GW.
+
+SYNOPSIS
+  srsepc [options] <config_file>
+
+DESCRIPTION
+
+  srsEPC provides a light-weight LTE core network implementation.
+  It constist of a single binary, and provides the following features:
+
+    - MME (Mobility Management Entity) with standard S1AP and GTP-U interface to eNB
+    - S/P-GW with standard SGi exposed as virtual network interface (TUN device)
+    - HSS (Home Subscriber Server) with configurable user database in CSV format
+
+  An example configuration file is available in /usr/share/srslte/epc.conf.example
+
+OPTIONS
+
+  -h/--help       Produce help message
+  -v/--version    Print version information and exit

debian/man/srsue.txt

@@ -0,0 +1,26 @@
+NAME
+  srsUE - A SDR LTE UE application featuring all layers from PHY to IP
+
+SYNOPSIS
+  srsue [options] <config_file>
+
+DESCRIPTION
+
+  srsUE provides a complete SDR LTE UE application featuring all layers from PHY to IP.
+
+  Features:
+
+    - Cell search and synchronization procedure for the UE
+    - Soft USIM supporting Milenage and XOR authentication
+    - Hard USIM support using PCSC framework
+    - Virtual network interface tun_srsue created upon network attach
+    - 150 Mbps DL in 20 MHz MIMO TM3/TM4 configuration in i7 Quad-Core CPU.
+    - 75 Mbps DL in 20 MHz SISO configuration in i7 Quad-Core CPU.
+    - 36 Mbps DL in 10 MHz SISO configuration in i5 Dual-Core CPU.
+
+  An example configuration file is available in /usr/share/srslte/ue.conf.example
+
+OPTIONS
+
+  -h/--help       Produce help message
+  -v/--version    Print version information and exit

debian/rules

@@ -16,3 +16,14 @@ override_dh_auto_configure:
 
 override_dh_auto_test:
 	# skip executing tests
+
+override_dh_installman:
+	cd debian/man ; CHANGELOG_DATE="$(CHANGELOG_DATE)" ./genmanpages.sh
+	dh_installman -a
+
+override_dh_auto_clean:
+	dh_auto_clean
+	$(RM) debian/man/*.1
+
+override_dh_installinit:
+	dh_installinit --no-start

debian/srsenb.install

@@ -0,0 +1,2 @@
+usr/bin/srsenb
+debian/srsenb.service  lib/systemd/system/

debian/srsenb.manpages

@@ -0,0 +1 @@
+debian/man/srsenb.8

debian/srsenb.service

@@ -0,0 +1,11 @@
+[Unit]
+Description=Software Radio System's LTE eNB implementation
+
+[Service]
+Type=simple
+Restart=always
+ExecStart=/usr/bin/srsenb /etc/srslte/enb.conf
+RestartSec=2
+
+[Install]
+WantedBy=multi-user.target

debian/srsepc.install

@@ -0,0 +1,4 @@
+usr/bin/srsepc
+usr/bin/srsepc_if_masq.sh
+debian/srsepc.service  lib/systemd/system/
+usr/bin/srsmbms

debian/srsepc.manpages

@@ -0,0 +1 @@
+debian/man/srsepc.8

debian/srsepc.service

@@ -0,0 +1,11 @@
+[Unit]
+Description=Software Radio System's light-weight EPC implementation
+
+[Service]
+Type=simple
+Restart=always
+ExecStart=/usr/bin/srsepc /etc/srslte/epc.conf
+RestartSec=2
+
+[Install]
+WantedBy=multi-user.target

debian/srslte-core.install

@@ -0,0 +1,3 @@
+usr/lib/*/libsrslte_rf.so
+usr/share/srslte
+usr/bin/srslte_install_configs.sh

debian/srslte-core.postinst

@@ -8,7 +8,7 @@ db_get srslte/install_configs_question
 ANSWER1=$RET
 
 if [ $ANSWER1 == "true" ]; then
-  srslte_install_configs.sh
+  srslte_install_configs.sh user
 fi
 
 #DEBHELPER#

debian/srslte-core.templates

@@ -3,4 +3,4 @@ Type: boolean
 Default: true
 Description: Install configs?
  This installs the default srsLTE configuration files to the user's
- home directory (~/.srs) but keeps any existing config files.
+ home directory (~/.config/srslte) but keeps any existing config files.

debian/srslte-dev.install

@@ -0,0 +1,2 @@
+usr/lib/*/*.a
+usr/include/srslte

debian/srsue.install

@@ -0,0 +1,2 @@
+usr/bin/srsue
+debian/srsue.service   lib/systemd/system/

debian/srsue.manpages

@@ -0,0 +1 @@
+debian/man/srsue.8

debian/srsue.service

@@ -0,0 +1,11 @@
+[Unit]
+Description=Software Radio Systems's LTE UE implementation
+
+[Service]
+Type=simple
+Restart=always
+ExecStart=/usr/bin/srsue /etc/srslte/ue.conf
+RestartSec=2
+
+[Install]
+WantedBy=multi-user.target