Commit Graph

238 Commits

Author SHA1 Message Date
Pau Espin ce32ec2ab7 gsup: Document ePDG Tunnel Req/Res/Err
Related: OS#6091
Change-Id: I9d98d0fbb2d4d006bc980b40828ea38f358d7108
2024-03-14 17:35:42 +01:00
Pau Espin 970346666e gsup: Introduce a new PCO IE
This IE will be required by the UE creating a tunnel at the ePDG (EPDG Tunnel Req).
The ePDG will convert the IKEv2 Configuration Attributes into TS 29.060
PCO, and sends them in S2b GTPv2C CreateSessionReq+Resp as PCO.

Change-Id: Id912ead4e1205f84a40af6505a5ddf050d1e086d
2024-02-20 19:29:06 +01:00
Pau Espin 7e3ac12476 gsup.adoc: Add conditional 'PDP Info' IE to Auth Info Req
Change-Id: Iccb397410d1b08c8fbc87fdcad1e787f025a5d9f
2024-02-12 10:48:47 +01:00
Pau Espin 485d7f30ba gsup.adoc: Add links to section of each message type in table
Change-Id: Idbc8a8f2e41f90e545a420517bd030399fb229ac
2024-02-12 10:48:42 +01:00
Pau Espin d97354efb1 gsup.adoc: Fix Authentication Info message naming in table
Change-Id: I6d5c95334c961f1f0aa083107713c31d9894c7aa
2024-02-07 16:54:44 +01:00
Pau Espin 72110be614 gsup.adoc: Fix typo
Change-Id: I1e7be8eb34a465ac6b35fa61544087668311338a
2024-01-22 16:45:10 +01:00
Pau Espin 602fabc6d5 gsup: Convert PDP-Type IE to PDP-Address IE
The previous PDP-Type IE should have been a PDP-Address from the
start, since having only PDP-Type with no address is only a specific
case (dynamic addressing).
This becomes clear by looking at other similar protocols like:
* MAP: APN-Configuration IE has servedPartyIP-IP{v4,v6}-Address IEs
* Diameter S6b, 3GPP TS 29.272 7.3.35 APN-Configuration contains
  Served-Party-IP-Address AVPs
* Diameter SWx, 3GPP TS 29.273 APN-Configuration.
* GTPv1C Ts 29.060 7.7.29 PDP Context containing PDP Address.

Since PDP-Type on its own really makes no sense, being it a special case
of PDP-Address, let's keep the IE by renaming it (keeping old name too
for API backward compat) and extend it to support lengths > 2 bytes.

Old implementation of libosmogsm gsup actually ignored lengths > 2
bytes, so we are safe acting against older implementations here, both
on the sending and receiving side on the wire.

While at it, fix the packetdiag representation, which was already wrong
before:
* Length is 1 byte, not 2 (this happened probably due to confusion
  between TS 29.060 EUA and TS 24.008 PDP address, the former TLV being
  2 bytes like all of GTP, and TS 24.008 being 1 byte).
* The bytes sharing several fields were swapped.

Change-Id: Ifb4e44b23d19ea049f03a3602c39f2471ff1bff4
Related: OS#6091
Related: libosmocore.git Change-Id I775ff9c3be165d9f30d6ab55d03f99b6104eadd6
2024-01-19 19:51:31 +01:00
Pau Espin db5bc79c8a gsup.adoc: Update spec reference s/TS 09.60/TS 29.060/
Change-Id: I42f4c5ce96823a91918cb01a6263cb7075226551
2024-01-19 15:54:29 +01:00
Pau Espin 2e0f5ff661 Update spec reference s/TS 04.08/TS 24.008/
Change-Id: Ie9feade73eff8c61232deffbad24ef34d97d32ac
2024-01-19 15:42:56 +01:00
Pau Espin 08b5ff7ebb sigtran: Document SCTP INIT VTY parameters
Related: SYS#6558
Change-Id: I2a8c2b3708d72bf0974b17bf018f2c667ae6b824
2023-09-12 13:41:29 +02:00
Pau Espin 3460af57bc sigtran: Document SCTP (peer) primary address configuration
Related: OS#6076
Related: SYS#6501
Change-Id: I8737ca3033293391c999395e2db1fe19cac3e911
2023-08-29 11:39:13 +02:00
Pau Espin 3aba72f9e4 mgwpool: Document keepalive feature
Related: SYS#6481
Change-Id: I2cb4e2098b71b386278eb6026271a6d786a34c2a
2023-06-15 11:29:16 +02:00
Pau Espin eb6fa0a04c Write explicit role & sctp-role fields in ASP configurations
Change-Id: I00243a2d549e900f872826c2a4b025936797b5ef
2023-06-08 19:40:54 +02:00
Pau Espin 5c88351a1e sigtran: Update supported xUA Traffic modes
Related: SYS#6412
Change-Id: I22110440e23faa7facaa5bcd0d57b3a6ef24d4a7
2023-04-13 16:20:38 +02:00
Harald Welte 58e8146179 chapters/spectrum: Extend disclaimer to Osmocom authors
Change-Id: I22dc5bde7a8d48c1a7dc876343ee66954afc2f8d
2023-03-22 10:09:52 +01:00
Harald Welte 21808eb4d2 preface: indicate where to ask for commercial support
Change-Id: I386d9bd31afe363677f23751d9ffe99f14800484
2023-03-22 10:09:52 +01:00
Harald Welte e6e07a7101 common/chapters: http -> https
Change-Id: Idf88e6141aad37d731a1955ad8b30f956c44a417
2023-03-22 10:09:52 +01:00
Harald Welte 9ec6183ca9 chapters/preface: Thank NLnet and WaveMobile
Change-Id: Ib887489fce522981df298594931100b9e553c291
2023-03-22 10:09:52 +01:00
Harald Welte 063523d11a chapters/logging: Expand documentation on GSMTAP logging
Change-Id: I9d7a15fd81bb0f3bc89b97ebfd35e9efc48c94e2
2023-03-22 10:09:52 +01:00
Harald Welte 9ff23bca66 chapters/cell-broadcast: Bring up-to-date with reality
This chapter was written at a time where OsmoCBC and the related
BSC support didn't exist yet.

Change-Id: If02adf2f9e7beeb7f238ab1c3aa74e8c0155db2b
2023-03-22 10:09:52 +01:00
Harald Welte 79a3b9e2c2 chapters/mncc: Update the wording to be less confusing and more up-to-date
Change-Id: Ic8876509878e565f140508dc2e3494b0e21c566c
2023-03-22 10:09:48 +01:00
Harald Welte cf76fcea5a chapters/*: Fix typos
Change-Id: I3c5cc64435c808f981d705d1d99c89fde2a6a74e
2023-03-22 10:09:25 +01:00
Vilius Panevėžys 832258a471 Fix mistypes
Change-Id: I87da6bec137c7be37ec748ec1f9f8d072517022d
2023-03-15 19:32:44 +02:00
Max d306b4da29 SIGTRAN: fix typo
Change-Id: Ieea85e57be0dc3526234d40af3708839af38908c
2023-02-25 19:10:11 +03:00
Max b22df211f5 rate counter: add StatsD note
Add passage explaining basic visualisation of stat and rate counter items
with Netdata so user can start utilizing them without any special
configuration.

Related: OS#5671
Change-Id: I124503c3707bbe005abbfb4245abe2829c6ff57c
2022-12-23 20:46:20 +03:00
Harald Welte 15b74288c0 merge gb-ns2 "chapters" in one
The files gb-nsw-{configuration-timer,configuration,maintenance} were
not actually chapters, but sub-chapters or sub-sub-chapters.  This
breaks our general idea that all of those files are top-level chapters.

It also breaks asciidoc validation on Debian 11:

asciidoc: WARNING: gb-ns2-configuration.adoc: line 1: section title out of sequence: expected level 1, got level 2
asciidoc: WARNING: gb-ns2-maintenance.adoc: line 6: section title out of sequence: expected level 2, got level 3

the only place where they were used was the osmo-gbproxy manual, and
there in the exact sequenc in which I now merged them over here.

Change-Id: I3c618e5af61b376435f400ef9c64245cec2f9b73
2022-11-28 17:46:55 +01:00
Harald Welte 6b21af4ff0 gfdl.adoc: Fix cross-reference typo
Change-Id: I56abfc7467f77ec662351df8b64b9bb4185fa865
2022-11-05 22:44:42 +01:00
Harald Welte 92d8990886 doc: Add a general chapter on installation of the Osmocom software
This is just a very high-level overview on the different options.

Change-Id: Ia13929a7f932e0c30b9d564b76ada1549ef2a589
2022-11-05 21:00:19 +00:00
Harald Welte 7c47922fdb add a documentation snippet for systemd services
... this can be included from the various user manuals to insert some
general language about the systemd service units we ship, and a few key
systemd commands to get users started.

Change-Id: I8b04047cbc4097676d69fad794bb3139c05a4a5f
2022-11-05 20:54:01 +01:00
Pau Espin 574b6a97a1 mgwpool.adoc: Use {program-name} instead of BSC
Change-Id: Iab6560d833e405a36bab142759719377ad302667
2022-10-20 17:07:20 +02:00
Pau Espin 43e5c52682 mgwpool.adoc: Fix typo
Change-Id: I10370b508caf06b08505933b306d79825674a8fa
2022-10-20 16:41:26 +02:00
Pau Espin 51e3f86b04 Copy mgwpool.adoc from osmo-bsc.git
Copied from osmo-bsc.git/doc/manuals/chapters/mgwpool.adoc, version from
Change-Id Id0d292506e8b2a888c8d7a682a38db80e9d0933a

Related: SYS#5987
Change-Id: Ieda0d4bfe6fc90da6e19c791d8ec2da89427ba3b
2022-10-20 16:14:24 +02:00
Harald Welte 4234cc99e0 port_numbers.adoc: Allocate VTY port number for osmo-isdntap
osmo-isdntap is an ISDN protocol + call tracing utility currently
under development, see
https://gitea.osmocom.org/retronetworking/osmo-isdntap

Change-Id: I3c5d681ba086ed7cf7fdb0408465a433000c799c
2022-10-16 17:14:48 +02:00
Pau Espin 370958df99 osmux: Improve NAT related documentation
Related: SYS#5987
Change-Id: I5ed7aa834bfd0d5ef84ff69ece6d1d5e5b920d4e
2022-10-13 12:38:26 +02:00
Pau Espin 4c9264e0ba Document osmux use in Abis interface
Related: SYS#5987
Change-Id: Ic02d379f35f29f633d0fb14da3597481a0b8b8ba
2022-09-16 12:54:58 +02:00
Pau Espin 1ab6dbc62a osmux: Use local/remote CID terminology
This terminology is much more common and used in other protocols, like
PFCP.

Related: SYS#5987
Change-Id: Ia5eb833c296c504555f273a7fc3af5d746af19c0
2022-09-15 16:19:15 +02:00
Vadim Yanitskiy 35b5e27b02 TRXD: further clarify meaning of Training / Synch. Sequence Code
Both Synch. sequence and Training sequence are basically the same thing,
only the length is different.  I guess this is why 3GPP TS 45.002 names
them differently.  Let's mention them both to avoid confusion.

Change-Id: I092af5ef6b66f8bdbd46cc3ae0c77fd806f2fe27
2022-08-19 17:37:36 +07:00
Pau Espin c948dc4491 port_number.adoc: Add default osmux port
This has been the port used historically in most existing deployments,
and it's the one already documented in the osmux section of user
manuals.

Change-Id: I9593e484a0df7cbfc3fa68f071246e3fb714bd4c
2022-08-12 14:11:55 +02:00
Pau Espin 6984a40c6b sigtran: Use caps in section header
Change-Id: Ie7ff0dced649a29817a5a46e37eaaaf7ee22aea6
2022-06-28 15:06:41 +02:00
Pau Espin 6be6ffb9f3 sigtran: Remove old comment about non-implemented stuff
As supports multiple ASP with loadshare and override since a long time
ago.

Change-Id: I703c64a85636c2f9ebbd809e49c0dc8891cb9527
2022-06-28 15:03:04 +02:00
Harald Welte 9ad5777ffc port_numbers: Add missing records for osmo-upf, pfcp-tool, hnodeb
Seems like the instructions for adding new port numbers were not
followed when those entires were added to
https://osmocom.org/projects/cellular-infrastructure/wiki/Port_Numbers

Change-Id: Ie077bc375d45202f6004d0a3d45e5fc772d5641d
2022-05-13 10:20:39 +02:00
Harald Welte 02525c816e glossary: add CBSP, CBC, CBS
Change-Id: Iac405366b2191415ebb1e71154fc3bf31ad37a59
2022-05-13 10:20:39 +02:00
Harald Welte 2106fce829 bibliography: Add reference to TS 48.049 (CBSP)
Change-Id: Id1504cb8f9331f36b6085d238a43fe041703ab23
2022-05-13 10:09:35 +02:00
Harald Welte 9d0ef861a1 Add CBSP port number to default list of ports
Change-Id: Ifff8eb076bef29a64d9d20237fe5c8ee402788dc
2022-05-13 10:06:52 +02:00
Alexander Couzens 1f8a888261 common: gb-ns2: add chapter Gb/NS maintenance
Add chapter to describe common maintenance

Change-Id: I5571001a127c933397a4bc26e85410288d50fc2f
2022-03-01 18:15:51 +01:00
Alexander Couzens 5cba08b88d common: gb-ns2: fix typo in configures
Change-Id: Ia3d41d5fae8af7a35e86feba6ecb37c0692206b1
2022-02-22 19:03:13 +01:00
Alexander Couzens b1318e3c63 common: gb-ns2: correct ip.access static configuration
Change-Id: I652f7cda1e79e452af7740c1cae192a9f2b1acab
2022-02-22 18:20:02 +01:00
Alexander Couzens 0d173b3b99 common: gb-ns2: update ip-sns configuration example
Change-Id: I0b20634d683ad8f93c1c8af35eacbb953c1db46b
2022-02-22 18:19:55 +01:00
Alexander Couzens 389cc79742 common: gb-ns2: remove empty VTY chapter
Change-Id: Iee28046fbb0a5a034c2a33c495a3ca6f8ef953c4
2022-02-22 18:19:51 +01:00
Philipp Maier cccc44ded3 counters-overview: add documentation about socket statistics
How and when socket statistics are generated is not immediately obvious.
Lets add some documentation about it.

Change-Id: Icb06b3934e9ea5f3526263dc8915bc3529a64324
Related: OS#5701
2022-01-07 12:45:40 +01:00