mptcplib 0.1.3

A Multipath TCP python support library

mptcplib

About

A Multipath TCP Python library. We encourage users to activate notifications since the library is still in it's early stages and the API may change. Certain functions are available starting from a specific kernel releases, we encourage the user's to check the MPTCP kernel implementation changelog.

For a deeper read about Multipath TCP, please consult this webpage.

Table of content

• Example Usage
• Description
• License

Example Usage

---

To be able to use the library we encourage to install using PyPi. Run the following command:

pip install mptcplib

Below you can find an example of a typical socket script :

import mptcplib
import socket 

sock = mptcplib.create_mptcp_socket(socket.AF_INET, socket.SOCK_STREAM):
# Do things ...
if mptcplib.is_socket_mptcp(sock):
    # Do things in case of an MPTCP socket ...
    used_subflows = mptcplib.get_nb_used_subflows(sock)
else:
    # Handle fallback to standard TCP ...
sock.close()

There are other useful functions i.e : Check if the os supports MPTCP and that it is enabled. We intend to add more functions that are supported by the kernel implementation.

Description

---

The library is currently supported on Linux kernels but the goal will be to extend it to MacOS. Below is a table containing operating systems that supports Multipath TCP and their support in mptcplib.

Operating System	mptcplib support
Linux based (kernel >= 5.6)	Yes
MacOS (Big Sur, Ventura)	Not yet

Contributing

---

Pull requests are more than welcome. For major changes, please open an issue discussing what you would like to change.

To install the library in developper mode run the following command in the root directory:

make dev-install

In order to run the tests, you have to first install the library in developper mode then you can follow up with:

make test

License

---

The repository is under the MIT License, welcoming anybody to play with the codebase.