This is merely a historical archive of years 2008-2021, before the migration to mailman3.
A maintained and still updated list archive can be found at https://lists.osmocom.org/hyperkitty/list/gerrit-log@lists.osmocom.org/.
laforge gerrit-no-reply at lists.osmocom.orglaforge has submitted this change. ( 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, 44 insertions(+), 0 deletions(-) Approvals: Jenkins Builder: Verified laforge: Looks good to me, approved diff --git a/doc/manuals/chapters/running.adoc b/doc/manuals/chapters/running.adoc index 51b8ae2..e3f6bbc 100644 --- a/doc/manuals/chapters/running.adoc +++ b/doc/manuals/chapters/running.adoc @@ -80,3 +80,47 @@ ggsn ggsn0 gtp bind-ip 127.0.0.2 ---- + +=== GTP-U kernel module + +WARNING: As of writing, the kernel module does not support IPv6. + +OsmoGGSN has support to use the Linux kernel GTP-U tunnel driver to accelerate +the data/user plane while still implementing the control plane (GTP-C) in +userspace in OsmoGGSN. The kernel module is included in Linux 4.7.0 and higher. +Notably the Debian GNU/Linux distribution has it enabled by default. + +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` (which requires libgtpnl +to be installed). + +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: 2 Gerrit-Owner: osmith <osmith at sysmocom.de> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: laforge <laforge at osmocom.org> Gerrit-CC: pespin <pespin at sysmocom.de> Gerrit-MessageType: merged -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20210302/aa31000c/attachment.htm>