aboutsummaryrefslogtreecommitdiffstats
path: root/doc
AgeCommit message (Collapse)AuthorFilesLines
2018-11-27build manuals moved here from osmo-gsm-manuals.gitOliver Smith5-27/+34
Moved to doc/manuals/, with full commit history, in preceding merge commit. Now incorporate in the build system. Build with: $ autoreconf -fi $ ./configure --enable-manuals $ make Shared files from osmo-gsm-manuals.git are found automatically if - the repository is checked out in ../osmo-gsm-manuals; or - if it osmo-gsm-manuals was installed with "make install"; or - OSMO_GSM_MANUALS_DIR is set. Related: OS#3385 Change-Id: I0477d7c871413bd90b365d3064bac3cba23a0883
2018-11-27Merge history from osmo-gsm-manuals.gitNeels Hofmeyr12-0/+3291
Change-Id: I284bfe2fc61167986cf784eabdd57151d4981e7a
2018-11-27sgsn: update vty referenceNeels Hofmeyr1-55/+252
Change-Id: I64d775efa6791aca025d116905e951e10ffa5d04
2018-11-27vty-ref: Update URI of docbook 5.0 schemaHarald Welte1-2/+2
... to match the /etc/xml/catalog file on debian (no "www" in hostname) Change-Id: Id9f3579c7f2bc3af13fe30b5268f249b6f59ed0d
2018-11-27OsmoSGSN: update VTY referenceNeels Hofmeyr2-2113/+2315
This is the first update since the libosmocore changes to the 'show online-help' generated output. Hence the produced document now benefits from the structural improvements: - not repeating common commands for every node; - using section names that match the VTY prompt. Drop most of the sgsn_vty_additions.xml -- they merely repeat what the online VTY doc already explains. Many of these more verbose explanations have been absorbed into the VTY online doc in osmo-sgsn.git change-id I35984014424412e91437b7ed71576aef3819cb1e. Adjust remaining sgsn_vty_additions.xml to match the new node ID scheme. Change-Id: I71863e5056ad369d2055e9882a52a00fa999ab04
2018-11-27OsmoSGSN: overview: Fix typo and reference OpenGGSN->OsmoGGSNPau Espin Pedrol1-2/+2
Change-Id: I94cc362a4f52e6bd9f93299665e73dc4fd75a2c6
2018-11-27share chapters/gsup.adoc from OsmoSGSN to OsmoMSC + OsmoHLRHarald Welte2-860/+1
Since the NITB split, GSUP is used in all three network elements, so make the protocol a shared chapter Change-Id: Id2d7c27ef16eb0ebe5f60d625a1fcf42f1603f4f
2018-11-27OsmoSGSN: add rate counter documentationAlexander Couzens3-0/+127
Change-Id: I4c5d5744f961a92bc7c8888ca739d1e8a8a0be9c
2018-11-27OsmoSGSN: configuration: Document CDR CTRL interfacePau Espin Pedrol1-1/+15
Change-Id: Ib729e2fc4898c20d27e95fc0f13abe9c0656dda5
2018-11-27OsmoSGSN: configuration: Add missing pdp-periodic eventPau Espin Pedrol1-0/+1
Change-Id: I2d8b11496e75abd23a42efab8eabba2b5b0912e9
2018-11-27OsmoSGSN: configuration: Move pdp ctx specific CDR fields to its own tablePau Espin Pedrol1-1/+10
Change-Id: I056f278b64ab426b9455b6a667abf2fe7fc94022
2018-11-27refactor Makefile build rules, don't use the FORCENeels Hofmeyr1-39/+6
The initial goal was to make sure we don't have overall FORCE rules causing unnecessary rebuilds -- annoying while writing documentation. As I looked through possible dependencies, I finally understood what's going on here. Remove code dup and nicely sort which belongs where in build/Makefile.*.inc. In each, describe in a top comment how to use it, and also unify how they are used: - Rename Makefile.inc to Makefile.docbook.inc and refactor - Add Makefile.vty-reference.inc - Add Makefile.common.inc Make sure that we accurately pick up all dependencies. Drop use of the macro called 'command', that silenced the actual command lines invoked and replaced them with short strings: it obscures what is actually going on and makes the Makefiles hard to read and understand. Each manual's makefile is greatly reduced to few definitions and a Makefile include, e.g. one for asciidoc, one for VTY reference. Move common/bsc_vty_additions.xml to OsmoBSC/vty/libbsc_vty_additions.xml, link from OsmoNITB. It applies only to OsmoBSC and OsmoNITB. Add a script that combines a VTY reference file with *all* additions files found in a manual's vty/ dir. Call this from Makefile.vty-reference.inc. Change-Id: I9758e04162a480e28c7dc83475b514cf7fd25ec0
2018-11-27Allow easily disabling GFDL referencesPau Espin Pedrol1-0/+2
All parts referencing GFDL can be easily disabled by removing the 'gfdl-enabled' attribute from the document. Change-Id: I2489726ad2e90301bceadfada926e31ae0f85986
2018-11-27sgsn: Add charging characteristics to GSUPHolger Hans Peter Freyther1-0/+24
Reserve a new IE for the charging characteristics. We need to handle them as a GGSN might otherwise reject the PDP context creation. For the SGSN it is enough to send the two octets as it. Pick the 0x1X range for the IEs as it is used with the PDP contexts. Change-Id: I1d7423582e154728a240cf15c32772a06822f4ad
2018-11-27sgsn: Fix numbering of QoS and add basic description for APNHolger Hans Peter Freyther1-2/+9
QoS was supposed to be 13 as 12 has been used for the APN. Fix that and document the APN. Change-Id: Ib6113aa7c59841aada424e2cafd94ed88c7badc7
2018-11-27osmo-sgsn: fix arrow tips in flow diagramsPhilipp Maier1-37/+37
The arrow style used to desribe the flowcharts in gsup.adoc does not match the arrow style used in the protocol descriptions which are included from the common directory (gb.adoc, control_if.adoc, oap.adoc). This patch changes the arrow style to match the already existing common parts. Change-Id: I7faa0c97ee3705a64289a47bc63f311d05f988b3
2018-11-27osmo-sgsn: Explain TCP/IP header compressionPhilipp Maier1-0/+80
The does not mention TCP/IP header compression yet. This commit adds some info about it Change-Id: I98408e72020a474d378e39263a933eb7567de146
2018-11-27osmo-sgsn: improve auth-policy explainationPhilipp Maier1-14/+38
The explaination of the access policy is a bit unclear. Users that come from osmo-nitb might have trouble to grasp the functionality of the access control list based approack correctly. Change-Id: Iaae3035c4de3cb082f097441eff99289ee6dfc53
2018-11-27osmo-sgsn: Update VTY command referencePhilipp Maier2-17/+665
Change-Id: I6585144addd8501226572eda6f55db19d0e31c54
2018-11-27GSUP, OAP: fix AUTS length to 14, not 16ikostov1-1/+1
https://gerrit.osmocom.org/1731 Change-Id: Id33d300c4985be5f2602703a6d4dc83032f0a926
2018-11-27SGSN: add Auth. policy, NS Statistics and BSSGP state examples, tweaksikostov2-18/+47
Add semicoli in fig-gprs-pcubts digraph. Remove section from GMM Implementation about non-existence of HLR. The SGSN can access osmo-hlr via GSUP (and will have to do so in the libvlr future). Change-Id: I0164f418e453672321eed00bbc454c1e223ea158
2018-11-27fix 'make clean': shell glob, ignore failureNeels Hofmeyr1-2/+3
Unfortunately a glob like osmo-x__*.{svg,png} doesn't work, so have the suffixes in separate globs. Add dashes to indicate that failure should be ignored. Change-Id: I6bc4d9ea72b43a573acbc860c23397f748de2c7b
2018-11-27add 'make check' targetNeels Hofmeyr1-1/+1
Generate *.check files from asciidoc output and grep for WARNINGs. Add *.check files to gitignore and to 'make clean'. Change-Id: Ibccc83a3415930a528f2e8e4e4dda3b81c6d0b64
2018-11-27GSUP: Add ladder diagrams for protocol transactions / proceduresHarald Welte2-7/+153
2018-11-27Update GSUP chapter regarding UMTS AKA and other recent changesHarald Welte1-0/+91
The GSUP protocol has been enhanced with * Support for UMTS AKA in 'Auth Tuple' / SAI operations * Authentication Failure Report * CN Domain indicator Let's update the documentation accordingly.
2018-11-27Add OsmoSGSN control interface descriptionMax2-0/+25
2018-11-27fix various typos across all manualsJonathan Brielmaier2-3/+3
2018-11-27OsmoSGSN: Fix formatting/cross reference in CDR sectionHarald Welte1-1/+2
2018-11-27Add link to Asciidoc source code of manualHarald Welte1-0/+6
2018-11-27initial checkin of manuals to public repoHarald Welte10-0/+2549
The manuals existed in different form for several years in an internal sysmocom repository. However, since they had just recently been converted from docboox-xml to asciidoc and all files have been re-shuffled for enabling the public release, there's not much point in keeping the history with git-filter-branch.
2018-09-25gbproxy-legacy: Ensure well-formed config fileHarald Welte1-14/+14
Change-Id: I3495c8448459ba4f834744a1df6e7aa6a196d755
2018-09-13Install sample cfg file to /etc/osmocomPau Espin Pedrol1-0/+10
Change-Id: Id898e920b934fbfb0b9abe1e3085ac817fa4634d
2018-07-13examples: Enable by default echo req towards active GGSNsPau Espin Pedrol2-0/+2
60 seconds is used by default, which is the minimum accepted value for this timer as per 3GPP TS 29.060 section "7.2.1 Echo Request". Having it low by default is good for lab use in which a lot of stuff changes over time. Change-Id: Ia1898d172482bf6a25d829f8fc9a47824f49456f
2017-09-06drop files unrelated to osmo-sgsnNeels Hofmeyr16-882/+0
These either remain from openbsc.git or slipped in while applying recent patches from openbsc.git and do not belong in osmo-sgsn. Change-Id: Ie9dc7514c3850010d0e9b3ab716b4f4e8d83594f
2017-08-30MSC,SGSN: use OSMO_GSUP_PORT == 4222 instead of 2222Neels Hofmeyr1-1/+1
In SGSN, actually place the port in the SGSN config by default, so that the gsup port may now be omitted in the VTY config (the IP address suffices). Adjust the osmo-sgsn.cfg example. Depends: I4222e21686c823985be8ff1f16b1182be8ad6175 (libosmocore) Change-Id: I50f2040e2eb0baacb43849e93cfed10cbc2fc156
2017-08-30Implement AoIP, port to M3UA SIGTRAN (large addition and refactoring)Philipp Maier1-0/+8
This was originally a long series of commits converging to the final result seen in this patch. It does not make much sense to review the smaller steps' trial and error, we need to review this entire change as a whole. Implement AoIP in osmo-msc and osmo-bsc. Change over to the new libosmo-sigtran API with support for proper SCCP/M3UA/SCTP stacking, as mandated by 3GPP specifications for the IuCS and IuPS interfaces. From here on, a separate osmo-stp process is required for SCCP routing between OsmoBSC / OsmoHNBGW <-> OsmoMSC / OsmoSGSN jenkins.sh: build from libosmo-sccp and osmo-iuh master branches now for new M3UA SIGTRAN. Patch-by: pmaier, nhofmeyr, laforge Change-Id: I5ae4e05ee7c57cad341ea5e86af37c1f6b0ffa77
2017-08-27GSM timers: User reasonable defaults; don't save if equal defaultHarald Welte1-12/+0
A number of the GSM timers (including T3109) had no reasonable default values if not specified in the VTY / config file. Together with unconditional writing to the config file, this created config files with a persistent setting for important timers as '0'. To make things worse, many of our example cofig files suffered from the same problem. Let's avoid this from happening by * having reasonable defaults if nothing specified in the config file * conditionally savingg timers only if they differ from default * reject any timer values that state zero during start-up (see previous commit) Change-Id: Iaac0bfca423852b61d8b9eb1438157ef00d0d8c8 Closes: OS#2380
2017-08-27examples/sgsn: Use osmo-hlr with auth-policy remote by defaultDaniel Willmann2-0/+30
For the vty tests, add osmo-sgsn-accept-all.cfg (that does not need an HLR) and use in vty_test_runner.py, otherwise the 'show sgsn' command will reply that it could not connect to the HLR, failing the vty test which expects empty. Change-Id: Ie3b2013198d3e2b780a4e31c36b89b58129dcacd
2017-08-27examples: Change IP address of config filesDaniel Willmann3-5/+5
This helps in providing 3G software packages for the sysmoNITB hardware, which uses 10.23.24.1 for SGSN and 10.23.24.2 for GGSN. However, in order to not break the python tests, the osmo-sgsn.cfg example still uses 127.0.0.1 as local address. Change the GGSN address to 127.0.0.2, because SGSN and GGSN cannot co-exist on the same address (the GTP port number is fixed by spec: no IE to communicate a differing port, so it has to be the standard GTP port for both). Change-Id: Ie3a25f6771ed6e620cb2b315638c622a9a24e530
2017-08-27Implement IuCS (large refactoring and addition)Neels Hofmeyr11-1045/+23
osmo-nitb becomes osmo-msc add DIUCS debug log constant add iucs.[hc] add msc vty, remove nitb vty add libiudummy, to avoid linking Iu deps in tests Use new msc_tx_dtap() instead of gsm0808_submit_dtap() libmgcp: add mgcpgw client API bridge calls via mgcpgw Enable MSC specific CTRL commands, bsc_base_ctrl_cmds_install() still needs to be split up. Change-Id: I5b5b6a9678b458affa86800afb1ec726e66eed88
2017-08-27Use libvlr in libmsc (large refactoring)Harald Welte2-2/+0
Original libvlr code is by Harald Welte <laforge@gnumonks.org>, polished and tweaked by Neels Hofmeyr <nhofmeyr@sysmocom.de>. This is a long series of trial-and-error development collapsed in one patch. This may be split in smaller commits if reviewers prefer that. If we can keep it as one, we have saved ourselves the additional separation work. SMS: The SQL based lookup of SMS for attached subscribers no longer works since the SQL database no longer has the subscriber data. Replace with a round-robin on the SMS recipient MSISDNs paired with a VLR subscriber RAM lookup whether the subscriber is currently attached. If there are many SMS for not-attached subscribers in the SMS database, this will become inefficient: a DB hit returns a pending SMS, the RAM lookup will reveal that the subscriber is not attached, after which the DB is hit for the next SMS. It would become more efficient e.g. by having an MSISDN based hash list for the VLR subscribers and by marking non-attached SMS recipients in the SMS database so that they can be excluded with the SQL query already. There is a sanity limit to do at most 100 db hits per attempt to find a pending SMS. So if there are more than 100 stored SMS waiting for their recipients to actually attach to the MSC, it may take more than one SMS queue trigger to deliver SMS for subscribers that are actually attached. This is not very beautiful, but is merely intended to carry us over to a time when we have a proper separate SMSC entity. Introduce gsm_subscriber_connection ref-counting in libmsc. Remove/Disable VTY and CTRL commands to create subscribers, which is now a task of the OsmoHLR. Adjust the python tests accordingly. Remove VTY cmd subscriber-keep-in-ram. Use OSMO_GSUP_PORT = 4222 instead of 2222. See I4222e21686c823985be8ff1f16b1182be8ad6175. So far use the LAC from conn->bts, will be replaced by conn->lac in Id3705236350d5f69e447046b0a764bbabc3d493c. Related: OS#1592 OS#1974 Change-Id: I639544a6cdda77a3aafc4e3446a55393f60e4050
2017-08-27fix make distcheck with python testsNeels Hofmeyr2-1/+1
- bscs.config needed by the vty tests was not picked up as a dist file, because its suffix is not 'cfg'. Rename to *.cfg. Apply this rename in vty_test_runner.py and osmo-bsc_nat.cfg. - Remove restart counters after external tests, otherwise distcheck complains about uncleaned files. - Add contrib/ipa.py to EXTRA_DIST, hence add a Makefile.am to contrib/. Otherwise the python tests cannot find that dependency. Change-Id: I42b55cb1125099afc3a8e3f87c0e398426b2e2a9
2017-08-27move openbsc/* to repos rootNeels Hofmeyr32-0/+2170
This is the first step in creating this repository from the legacy openbsc.git. Like all other Osmocom repositories, keep the autoconf and automake files in the repository root. openbsc.git has been the sole exception, which ends now. Change-Id: I9c6f2a448d9cb1cc088cf1cf6918b69d7e69b4e7
2009-06-10move openbsc into its own subdirectoryHarald Welte3-228/+0
2009-02-17add bits and pieces of documentationHarald Welte3-0/+228