Home

Awesome

gtp5g - 5G compatible GTP kernel module

gtp5g is a customized Linux kernel module gtp5g to handle packet by PFCP IEs such as PDR and FAR. For detailed information, please reference to 3GPP specification TS 29.281 and TS 29.244.

Note:1

The latest implementation of gtp5g and libgtp5gnl is in

https://github.com/free5gc/gtp5g

https://github.com/free5gc/libgtp5gnl

Notice

Due to the evolution of Linux kernel, this module would not work with every kernel version. Please run this module with kernel version 5.0.0-23-generic or upper than 5.4 (Ubuntu 20.04).

Please check the libgtp5gnl version is the same as gtp5g, because the type translating between libgtp5gnl and gtp5g had been changed.

Usage

Compile

make clean && make

Install kernel module

Install the module to the system and load automatically at boot

sudo make install

Remove kernel module

Remove the kernel module from the system

sudo make uninstall

Create a gtp5g interface and update Rules

The gtp5g interface will be created by using libgtp5gnl scripts

  1. Checkout the latest or compatible source of libgtp5gnl
  2. cd libgtp5gnl
  3. Create an interface and update rules
    • sudo ./run.sh UPF_PDR_FAR_QER
  4. Troubleshoot
    • dmesg
    • echo #interfaceName #ID > /proc/gtp5g/pdr
    • cat /proc/gtp5g/pdr
  5. Delete an interface
    • sudo ./run.sh Clean
    • Note: It will delete list of rules and interface

Change Log

v0.2.0

v0.1.0