Change in osmo-ggsn[master]: doc/manuals: describe GTP-U kernel module

osmith gerrit-no-reply at lists.osmocom.org
Mon Mar 1 15:04:40 UTC 2021


osmith has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-ggsn/+/23159 )


Change subject: doc/manuals: describe GTP-U kernel module
......................................................................

doc/manuals: describe GTP-U kernel module

Related: OS#3209
Change-Id: Ib45cbfe03077960f216a83cf500ab3203d02cb3b
---
M doc/manuals/chapters/running.adoc
1 file changed, 41 insertions(+), 0 deletions(-)



  git pull ssh://gerrit.osmocom.org:29418/osmo-ggsn refs/changes/59/23159/1

diff --git a/doc/manuals/chapters/running.adoc b/doc/manuals/chapters/running.adoc
index 51b8ae2..3a4d832 100644
--- a/doc/manuals/chapters/running.adoc
+++ b/doc/manuals/chapters/running.adoc
@@ -80,3 +80,44 @@
 ggsn ggsn0
  gtp bind-ip 127.0.0.2
 ----
+
+=== GTP-U kernel module
+
+OsmoGGSN has support to use the Linux kernel GTP-U code to accelerate the
+data/user plane while still implementing the control plane (GTP-C) in userspace
+in OsmoGGSN. The kernel code is included in Linux 4.7.0 and higher. Notably the
+Debian GNU/Linux distribution has it enabled by default (as module).
+
+In order to use this feature, make sure that your Linux kernel was configured
+to support it (`CONFIG_GTP=m` or `=y`). Furthermore, `osmo-ggsn` must have been
+built with `./configure` argument `--enable-gtp-linux`.
+
+Load the kernel module with:
+
+----
+$ sudo modprobe gtp
+----
+
+Then start OsmoGGSN with a configuration file that uses `gtpu-mode kernel-gtp`.
+
+A full example configuration is in `osmo-ggsn-kernel-gtp.cfg`.
+
+----
+$ sudo osmo-ggsn -c /usr/share/doc/osmo-ggsn/examples/osmo-ggsn-kernel-gtp.cfg
+----
+
+.Example: APN with kernel-gtp
+----
+ggsn ggsn0
+ gtp state-dir /tmp
+ gtp bind-ip 127.0.0.2
+ apn internet
+  gtpu-mode kernel-gtp
+  tun-device tun4
+  type-support v4
+  ip prefix dynamic 172.16.222.0/24
+  ip dns 0 8.8.8.8
+  ip dns 1 8.8.4.4
+  ip ifconfig 172.16.222.0/24
+  no shutdown
+----

-- 
To view, visit https://gerrit.osmocom.org/c/osmo-ggsn/+/23159
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings

Gerrit-Project: osmo-ggsn
Gerrit-Branch: master
Gerrit-Change-Id: Ib45cbfe03077960f216a83cf500ab3203d02cb3b
Gerrit-Change-Number: 23159
Gerrit-PatchSet: 1
Gerrit-Owner: osmith <osmith at sysmocom.de>
Gerrit-MessageType: newchange
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20210301/e201cbf8/attachment.htm>


More information about the gerrit-log mailing list