Commit Graph

417 Commits

Author SHA1 Message Date
Pau Espin 2333c9f0d1 Bump version: 0.1.1.9-5275 → 0.2.0
Change-Id: I0d1981a1b049bf5a5272210e8553698a6e1571da
2019-08-08 12:07:24 +02:00
Oliver Smith 5275f262c8 Makefile.asciidoc.inc: warnings check not default
Only check for asciidoc warnings in "make check" if
ASCIIDOC_WARNINGS_CHECK is set. Enable it in jenkins.sh by using the
new ./configure --enable-asciidoc-warnings-check parameter (similar to
--enable-werror in other Osmocom projects' configure.ac files).

Related: OS#4140
Change-Id: Iac993a0d1b17205397a1f1ef1a7bd3f9df739e36
2019-08-05 17:50:35 +00:00
Oliver Smith 2d5d6c54e8 Makefile.asciidoc.inc: always run verbose asciidoc
a2x is a "toolchain manager" for asciidoc, that runs the asciidoc
command internally. Replace the previous logic of first running a2x
without any verbose flags, and on failure running asciidoc standalone,
with a verbose flag, to print the errors the occured. Always run a2x
with -vv, so it runs asciidoc in verbose mode.

This prevents losing the error message in case asciidoc or a2x fail
when running with a2x, but then asciidoc succeeds when running
standalone.

Related: OS#4132
Change-Id: I2cbd2985645ecdecc7851849be6a9a95d4b3246e
2019-08-05 17:50:35 +00:00
Pau Espin 35ca68b762 common: trx_if.adoc: Add documentation about TRXDv1 and SETFORMAT
Change-Id: I320539fc9ffb7dd0f09ec18892299bd603cd7a85
2019-07-31 13:13:38 +02:00
Pau Espin c7fb3f28f4 common: trx_if.adoc: Improve documentation
Several fixes and improvements to the documentation.
This documentation still doesn't contain infrmation about TRXDv1, it
will be added in a follow-up commit.

Change-Id: I36e6206b90435964842f9f1ebd982cdaf9777018
2019-07-31 13:13:34 +02:00
Daniel Willmann abadcd5f8a counters-overview: Add a section about the stats reporter
Fixes: OS#3768
Change-Id: Ia338409e6cb1b1478429e3a99158b9d8255dbb2c
2019-07-25 17:26:25 +02:00
Oliver Smith c19708bf1a tests: pick up subdirs inside common/chapters
The Osmux documentation that will be introduced in [1] creates a
common/chapters/osmux/ subdir. Update tests/Makefile.am to pick up the
files in that directory too, so they get built by jenkins during gerrit
verification.

[1] I182d94c63f7d74ef882b77be59a95b1b7d8a4e5e
Change-Id: I4d1f440b7bfef159c98f918a2d23069594c4bc95
2019-07-22 19:49:16 +00:00
Pau Espin 061cca4d73 common: Introduce Osmux documentation
Change-Id: I182d94c63f7d74ef882b77be59a95b1b7d8a4e5e
2019-07-22 10:14:36 +02:00
Pau Espin 66f7bea317 Makefile.asciidoc.inc: Export commondir attribute to asciidoc files
Otherwise, adoc files in osmo-*/doc/manuals/chapters/*.adoc cannot
include files from osmo-gsm-manuals/common/chapters/*.adoc, since
symbolic link to common/ is only available in builddir, but not in
srcdir.

This way, those files can include commons files like this:
include::{commondir}/chapters/foobar.adoc

Change-Id: Ifc2fdaf1a87d0715213b4eab13c6c9a4f8a987fd
2019-07-19 16:39:13 +02:00
Oliver Smith 523862c2d5 contrib/jenkins.sh: run "make maintainer-clean"
Related: OS#3047
Change-Id: I99b9cd46e564cc1c5c1e92b9870368ff515a9356
2019-07-10 12:27:35 +02:00
Oliver Smith 001c5787fe Bump version: 0.1.0.8-09689 → 0.1.1
Change-Id: If5a1b56158f867f7f93a98e1a473a853c8c61439
2019-05-29 10:13:45 +02:00
Oliver Smith f4ba9ecd36 Makefile.am: include osmo-release.mk
Allow using the same release process, as with other Osmocom components:
https://osmocom.org/projects/cellular-infrastructure/wiki/Make_a_new_release

Related: OS#3899
Change-Id: Id31b8aa3f8c46509774c44ee027ab89862249766
2019-05-29 10:07:08 +02:00
Oliver Smith f1d55d9574 debian: more explicit dependencies for debian 8
Add dh-autoreconf to build dependencies, and libxml2-utils (provides
xmllint) to dependencies. Both need to be explicitly installed on
debian 8.

Related: OS#3899
Change-Id: If929fca73e3a88567e144eb296e7fadd32904dd5
2019-05-21 14:31:14 +02:00
Oliver Smith 92cf519c8d GSUP: document inter-MSC handover additions
Message formats of the new messages look mostly the same (IMSI,
Message Class, Source Name, Destination Name, AN-APDU). That is, because
AN-APDU is storing results, error reasons etc. This can be seen clearly
in osmo-msc.git:
* src/libmsc/msc_a_remote.c:msc_a_remote_fsm_communicating()
* src/libmsc/msc_i_remote.c:msc_i_remote_fsm_ready()

The message squence charts in the E Procedures section are directly
based on Neels' interMSC_HO_GSUP_msgs.txt [1].

It seems that using AN-APDU made some other new IEs redundant: RR Cause,
BSSAP Cause, Session Management Cause had been added to GSUP for the MSC
handover, and are documented now, but they are currently not used in
osmo-msc.git. The new message OSMO_GSUP_MSGT_E_ABORT is not used either,
so I left a stub for it in the message format section.

I mentioned in the Source Name IE section, that source and destination
names are sent as nul-terminated strings. This is for legacy reasons,
Neels wrote a nice summary in the commit message of [2].

[1] https://osmocom.org/attachments/3720/interMSC_HO_GSUP_msgs.txt
[2] Change-Id: I9ca8c9eef104519ed1ea46e2fef46dcdc0d554eb (osmo-msc)

Related: OS#3774, OS#3619
Change-Id: I6b9f23d08cfe53c8b77f51c6afb900c2badc9e2c
2019-05-21 10:30:38 +00:00
Oliver Smith 068153c39e debian: fix empty debian package
Replace '--with autotools_dev' with '--with autoreconf' in
debian/rules, so a ./configure file gets generated from configure.ac,
and the debian package scripts don't generate an empty package.

I did not notice this earlier, because when building the package locally
with dpkg-buildpackage, it was not empty. (That is probably, because my
local dir already had the configure script generated.)

Related: OS#3899
Change-Id: I483136cd28395ae8fc2c112cf659ee83255afe87
2019-05-21 11:56:59 +02:00
Harald Welte 5c1ac995db port_numbers: Add VTY + CTRL port of upcoming OsmoCBC
Change-Id: I57d88f2bddedb7a97c3fc7bacfe978ed4557c4bf
2019-05-08 15:49:50 +02:00
Oliver Smith 1d16a26c7e debian: add patch for debian 8
Add a patch file that removes the asciidoc-dblatex dependency in
debian/control, so the package builds for debian 8. In debian 8, the
files are all in the asciidoc package, which does get installed.

The jenkins scripts will copy the source package, apply the patch, and
upload it separately to OBS [1]. A similar debian 8 patch exists for
osmo-trx.

I have also tried to do it without a patch, by changing the OBS
configuration. It is possible to bypass the dependency check from OBS
and get the build started, but there's an additional check by
dpkg-checkbuilddepends and this one does not pass. So we really need
the patch method.

[1]: Change-Id I3570599ede51b974d350064f44f77e360fafd8b0 (osmo-ci)

Related: OS#3899
Change-Id: I5b9575ceb1141961e570643a5755a2bd6b6a4254
2019-05-08 11:52:26 +00:00
Daniel Willmann 37a7ce7f1d Change VTY samples from OsmoNITB to OsmoMSC
Change-Id: I9fb3c43ea56087900eee4427f1ae50a7c9e84698
Related: OS#2299
2019-04-15 16:47:18 +02:00
Daniel Willmann 95be64fc37 Add a chapter to explain our different counters
Change-Id: I01b8529136450cb50e48b0fb5c17cb2daa5e24c3
2019-04-15 14:06:32 +00:00
Oliver Smith a7b4d1b48f Bump version: 0.0.0 → 0.1.0
Change-Id: Ied515c46f7de5fb0224ac5b3d16ee2709d614202
2019-04-15 09:40:43 +02:00
Oliver Smith 754b29e023 Add debian packaging for osmo-gsm-manuals-dev
Allow including pdf manuals in each Osmocom repositories -doc debian
package, by depending on osmo-gsm-manuals-dev.

Related: OS#3899
Example usage: I4c184c62804c0b805a0a2425a5bd0312e94e49ab (osmo-bts.git)
Change-Id: I7edb5093e5b58eb3b0f7af2376476db4026db735
2019-04-12 14:32:25 +02:00
Oliver Smith b9a369c3e8 Makefile.am: proper noarch pkgconfig install dir
Don't install the noarch osmo-gsm-manuals.pc file to
$prefix/lib/x86_64-linux-gnu/pkgconfig when building a debian package
(dpkg-buildpackage seems to set $libdir accordingly). Always install to
$prefix/lib/pkgconfig.

The debian dir for creating a package from this repository will be added
in a follow up patch.

Related: OS#3899
Change-Id: I63bc8ab6d2845751079f40383d2aa92c709ce2fe
2019-04-12 14:32:25 +02:00
Oliver Smith 5501ba607b Makefile.common.inc: add {,un}install targets
Allow installing generated pdfs with 'make install' in all Osmocom
projects using osmo-gsm-manuals. This makes proper debian packaging of
the manuals easier.

Autotools will automatically run this file's install target, when
running 'make install' in the top source dir. Do not install anything,
when OSMO_GSM_MANUALS_NO_INSTALL is set, and set this variable for the
tests dir, so we don't install the test pdfs.

Related: OS#3899
Change-Id: I66f33172fa410681acbaef4592e9405627948705
2019-04-12 14:32:20 +02:00
Oliver Smith 7390b95c11 check-depends.sh: don't depend on git binary
Remove git from depends, because it isn't needed when building the
manuals from a source tarball. Avoid having git in the build
dependencies of the upcoming manuals packaging for debian.

Related: OS#3899
Change-Id: I46ad818a1d009c03357821f7c8100ecb5d62962e
2019-04-10 14:48:15 +02:00
Oliver Smith 89e1e74d86 build/unix-time-to-fmt.py: use default python ver
Don't explicitly depend on python 3, so we don't need to have python 2
*and* python 3 installed to build osmo-gsm-manuals.

The script is short and works fine with either python version.

Related: OS#3899
Change-Id: I8af9b8159f5c7e39b905f85edd1584cb4d5a33ef
2019-04-10 14:33:46 +02:00
Daniel Willmann ece90c1377 bts: Change VTY sample output from OpenBSC to OsmoBSC
Change-Id: Id473b625f47b3cf7ee10ced866d49eb678161719
2019-04-04 11:31:05 +02:00
Harald Welte 4c946ee293 fix typo: SIGTAN->SIGTRAN
Change-Id: I4b9ed7d61a23cf327889b3e513af74e8c86b161c
2019-03-13 07:59:41 +01:00
Oliver Smith 40c5c2827a chapters/gsup.adoc: move IMEI IEs to right place
Move the "IMEI" and "IMEI Check Result" IEs from the "Session
(transaction) management" chapter (which describes session IEs) to the
"Information Elements" chapter. Add a comment to prevent this mistake in
the future.

Related: OS#2541
Change-Id: I6fd66419350e018a763b8fac3daf567b339a2637
2019-02-22 13:20:11 +01:00
Harald Welte ac42b58909 chapters/gsup.adoc: add message sequence charts for SMS over GSUP
Change-Id: I9a0536f285f98f24fec4d7318f1923782ed2e18c
Related Change-Id: Ie0150756c33c1352bc4eb49421824542c711175c
Related Change-Id: I549b6c8840a1e86caac09e77fb8bc5042d939e62
2019-02-19 18:08:18 +00:00
Oliver Smith 68bbdc5f02 GSUP: message category indicated by last two bits
Make this part of the specification, so we can simplify libosmocore
code by knowing that error message is (request message | 0x000001).

Related: I46d9f2327791978710e2f90b4d28a3761d723d8f (libosmocore)
Change-Id: Iec1b4ce4b7d8eb157406f006e1c4241e8fba2cd6
2019-02-01 16:05:12 +01:00
Oliver Smith 2bca846fab common: extend glossary.adoc
Add EIR, IMEISV, LU, SS, TS, USSD, and VLR, clarify the difference
between IMEI and IMEISV.

Change-Id: I054a8599a78eb5e62ab7af914875e1c8a992af71
2019-01-21 15:08:39 +01:00
Oliver Smith 0f41399d36 chapters/gsup.adoc: document CHECK-IMEI
Related Change-Id: (core) I085819df0ea7f3bfeb0cabebb5fd1942a23c6155
Related: OS#3733
Change-Id: I51dd09cda3c595f1d252546285ced9f06c748617
2018-12-21 16:11:50 +01:00
Oliver Smith c7afad3f4e chapters/gsup.adoc: explain msg format columns
Explain the M, O, C and V, TLV letters in the presence and format
columns.

Change-Id: Idf8614d4d0f462174426fd3afdb34bedfb859951
2018-12-21 16:02:20 +01:00
Vadim Yanitskiy d1596fe75a chapters/gsup.adoc: document READY-FOR-SM message
Change-Id: I549b6c8840a1e86caac09e77fb8bc5042d939e62
Related Change-Id: (core) Ic37f3b2114b8095cfce22977e67133b9103942e3
Related Change-Id: (TTCN) If2256607527ecfcb10285583332fb8b0515d7c78
Related: OS#3587
2018-12-18 00:52:05 +07:00
Vadim Yanitskiy f26967aad5 chapters/gsup.adoc: document MO-/MT-forwardSM messages
Change-Id: Ie0150756c33c1352bc4eb49421824542c711175c
Related Change-Id: (core) Ibe325c64ae2d6c626b232533bb4cbc65fc2b5d71
Related Change-Id: (TTCN) Ibf49474a81235096c032ea21f217170f523bd94e
Related: OS#3587
2018-12-18 00:51:47 +07:00
Oliver Smith d379a0e33c Makefile.common.inc: publish: don't depend on check
The 'check' target is only available when including
Makefile.asciidoc.inc, which is not always the case. Some projects only
build the VTY reference. Do not depend on check, so publishing the
VTY reference for these projects is working as expected.

Related: OS#3385
Change-Id: I64aae0016095d81ca9e9ebda9a2e3336ac126639
2018-12-07 16:01:58 +01:00
Vadim Yanitskiy 01814068be chapters/gsup.adoc: fix direction for SS messages
Most likely, this was a copy-paste error. SGSN is not involved
in Supplemeptary Services handling, they are pure CS data.

Moreover, HLR is not the only entity that can initiate both
Process Supplementary Service Error and Response messages,
there is also EUSE (External USSD handling Entity).

Change-Id: I46ad7311747f2b392244c49d3df1e152e6f1bfe3
2018-12-03 07:40:14 +07:00
Oliver Smith 6e62e777cd remove leftovers from manuals move
Remove leftover OsmoMSC/Makefile.am, which should have been deleted
already in Ib234fe4f4ac36c27a4ad8a8d0050c1d6874232bc ("remove OsmoMSC
files (now avail in osmo-msc.git)").

Remove the upload taget in Makefile.am, as there are not project
specific files anymore.

Related: OS#3385
Change-Id: I8716c41b03b09250e61e6a29fe9589454258fe03
2018-11-29 16:32:27 +01:00
Oliver Smith 2d22f33f60 remove OsmoMGCP, OsmoNAT files (now avail in openbsc.git)
Files were added in openbsc.git Change-Id
Ibace91bc518079765e12529596a1763b6c5a04b5

Depends: openbsc.git Change-Id Ibace91bc518079765e12529596a1763b6c5a04b5
Related: OS#3385
Change-Id: Icdbdc4518b049135f18ac4a569ff5ffe4f3d5a86
2018-11-29 16:30:48 +01:00
Oliver Smith 633e6d92a8 INSTALL.txt: "make check" needs libxml2-utils
Change-Id: I6fba644cff833c912f6d83651a1ee27c1c4884d2
2018-11-29 14:23:18 +00:00
Oliver Smith ceb12eaa69 remove OsmocomBB files (now avail in osmocom-bb.git)
Files were added in osmocom-bb.git Change-Id
I7d1226d3865da9595b730b716a8d4ba07be1e0d5

Depends: osmocom-bb.git Change-Id I7d1226d3865da9595b730b716a8d4ba07be1e0d5
Related: OS#3385
Change-Id: I5a4839be7a3122ab566023a3e7b3bc955db98ba4
2018-11-29 10:52:42 +01:00
Oliver Smith b7f198f087 remove OsmoNITB files (now avail in openbsc.git)
Files were added in openbsc.git Change-Id
I4466d820cb3a5609a4a8534b1581684f891a04cd

Depends: openbsc.git Change-Id I4466d820cb3a5609a4a8534b1581684f891a04cd
Related: OS#3385
Change-Id: I2d4f4d6dc5a70e27de464921f4fe0aab4ca8ec72
2018-11-29 10:50:16 +01:00
Oliver Smith f8bddfae15 remove OsmoGSMTester files (now avail in osmo-gsm-tester.git)
Files were added in osmo-gsm-tester.git Change-Id
I8a34871948425ea40f40dbb11a59806905e4bed1

Depends: osmo-gsm-tester.git Change-Id I8a34871948425ea40f40dbb11a59806905e4bed1
Related: OS#3385
Change-Id: I89429a306d37e267fdb335d1c177c9ede3b64444
2018-11-29 10:48:13 +01:00
Oliver Smith aecc41b749 remove OsmoTRX files (now avail in osmo-trx.git)
Files were added in osmo-trx.git Change-Id
I2762171af0bf719a34ba12a0c2e4dcc206098beb

Depends: osmo-trx.git Change-Id I2762171af0bf719a34ba12a0c2e4dcc206098beb
Related: OS#3385
Change-Id: If7cd43eec5f9d20f7f4200340e96ed0e0908e253
2018-11-28 11:23:48 +01:00
Oliver Smith af87a34845 remove OsmoSTP files (now avail in libosmo-sccp.git)
Files were added in libosmo-sccp.git Change-Id
Ib5a22c2ea81fdde036bf9efb47d785a830b88c93

Depends: libosmo-sccp.git Change-Id Ib5a22c2ea81fdde036bf9efb47d785a830b88c93
Related: OS#3385
Change-Id: I971ef93a675412ea27d8bf193db6b9b35428f0bc
2018-11-28 11:23:48 +01:00
Oliver Smith e4b6db024c remove OsmoSIPConnector files (now avail in osmo-sip-connector.git)
Files were added in osmo-sip-connector.git Change-Id
I1317131ed6765fec996344fc6ed08350187b615b

Depends: osmo-sip-connector.git Change-Id I1317131ed6765fec996344fc6ed08350187b615b
Related: OS#3385
Change-Id: Id77812586eb21932b563b57e75cd85b721b7d6ab
2018-11-28 11:23:48 +01:00
Oliver Smith 05883a1011 remove OsmoSGSN files (now avail in osmo-sgsn.git)
Files were added in osmo-sgsn.git Change-Id
I0477d7c871413bd90b365d3064bac3cba23a0883

Depends: osmo-sgsn.git Change-Id I0477d7c871413bd90b365d3064bac3cba23a0883
Related: OS#3385
Change-Id: Ia6fae983bbcabceb3f470af750c724e12c96423e
2018-11-28 11:23:48 +01:00
Oliver Smith dc066c112d remove OsmoPCU files (now avail in osmo-pcu.git)
Files were added in osmo-pcu.git Change-Id
I7270652de393a98748c0cdc51e626c17ab8f44c2

Depends: osmo-pcu.git Change-Id I7270652de393a98748c0cdc51e626c17ab8f44c2
Related: OS#3385
Change-Id: I2a1de294883491487aa270b1e30160d559ef063a
2018-11-28 11:23:48 +01:00
Oliver Smith a7bd01b248 remove OsmoMGW files (now avail in osmo-mgw.git)
Files were added in osmo-mgw.git Change-Id
I504f05a49721f2dfe105b6c5fd1995c4e7a0be9c

Depends: osmo-mgw.git Change-Id I504f05a49721f2dfe105b6c5fd1995c4e7a0be9c
Related: OS#3385
Change-Id: I793a7150b676837cfa8591f7504872b04d4b1f7f
2018-11-28 11:23:48 +01:00
Oliver Smith 7898364664 remove OsmoHLR files (now avail in osmo-hlr.git)
Files were added in osmo-hlr.git Change-Id
I52b7b06fddd77c6dc272004f434e9e7651f6b349

Depends: osmo-hlr.git Change-Id I52b7b06fddd77c6dc272004f434e9e7651f6b349
Related: OS#3385
Change-Id: Ice3f24888deed8affec40d5d91d71d5e1f3827c8
2018-11-28 11:23:48 +01:00